]> 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:35:26 +0000 (10:35 -0400)
commite2dc03ff0983a36ce132733b6a1f82ec3ee344da
tree9752b673ddd8ddb221016bcb5c5ab2686fe95a73
parent8fec7990431092e3732e8ce1c4b3e0557b9f3098
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)
lib/sqlalchemy/dialects/mssql/pyodbc.py