]> git.ipfire.org Git - thirdparty/sqlalchemy/sqlalchemy.git/commit
Improve SQL Server pyodbc documentation
authorMike Bayer <mike_mp@zzzcomputing.com>
Thu, 31 Oct 2019 14:30:46 +0000 (10:30 -0400)
committerMike Bayer <mike_mp@zzzcomputing.com>
Thu, 31 Oct 2019 14:37:27 +0000 (10:37 -0400)
commit9cf02d6703f7d3084e40a7248023f10ed20a4724
treeb8776ba3d6ee59633224b2613862e8d40810e203
parentad0bece8645612335a4acb54b2097debde8dce1d
Improve SQL Server pyodbc documentation

While we were told years ago that ODBC is intended to be used with
DSNs only, however this use does not correspond well with how most
other database connectivity systems work in that modern systems
already have their own registries of connection information in any
case, meaning this is usually the best place to add details such
as hostnames and driver names, rather than having them locked away
in a server-specific ODBC registry.    So here we dial back the
language that one style or another of connecting is "preferred";
both styles are supported equally, and the critical advantage of
hostname mapping in that the target database name is both explicit
as well as modifyable is also added.

Add additional background for how DSNs work and refine other
sentences.   "URL encoding" is the correct terminology for
adding spaces and special characters to a URL.

Change-Id: I13a74432976e6d3166633b98f9bb84c4856caac8
(cherry picked from commit 65466dec6346ad84340af1cf3e431020add0f9a5)
(cherry picked from commit e2dc03ff0983a36ce132733b6a1f82ec3ee344da)
lib/sqlalchemy/dialects/mssql/pyodbc.py