]> 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:34:40 +0000 (10:34 -0400)
commita1ba2211f4a6954f15f2fe21e16c6de4a2663019
tree53f566af25f04c4be8a17655428ae65fc03a5219
parenta82c7d2992f7d6180f1b6a5c08207ec665950d2d
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