如何使用 FreeTDS ODBC 连接到 SQL Server答案

【问题标题】：How to connect to SQL Server using FreeTDS ODBC如何使用 FreeTDS ODBC 连接到 SQL Server
【发布时间】：2019-12-12 12:34:09
【问题描述】：

我正在尝试通过我的 MacBook 连接到我公司的 SQL Server 数据库，并已按照此处列出的步骤进行操作：https://github.com/mkleehammer/pyodbc/wiki/Connecting-to-SQL-Server-from-Mac-OSX，但在执行以下步骤时仍然出现以下错误：

通过运行isql TEST myuser mypassword 检查一切是否正常。您应该看到以下内容：

+---------------------------------------+
| Connected!                            |
|                                       |
| sql-statement                         |
| help [tablename]                      |
| quit                                  |
|                                       |
+---------------------------------------+

我已经验证了以下工作：

使用 tsql 实用程序测试连接，例如tsql -S TEST -U myuser -P mypassword。如果这有效，您应该会看到以下内容：

locale is "en_US.UTF-8"
locale charset is "UTF-8"
using default charset "UTF-8"
1>

odbcinst.ini 和 odbc.ini 配置文件都在同一个目录中。

MacBook-Pro: myname$ odbcinst -j
unixODBC 2.3.7
DRIVERS............: /etc/odbcinst.ini
SYSTEM DATA SOURCES: /etc/odbc.ini
FILE DATA SOURCES..: /etc/ODBCDataSources
USER DATA SOURCES..: /Users/myname/.odbc.ini
SQLULEN Size.......: 8
SQLLEN Size........: 8
SQLSETPOSIROW Size.: 8

odbcinst.ini 文件配置：

[FreeTDS]
Description=FreeTDS Driver for Linux & MSSQL
Driver=/usr/local/lib/libtdsodbc.so
Setup=/usr/local/lib/libtdsodbc.so
UsageCount=1

odbc.ini 配置：

[TEST]
Description         = Test to SQLServer
Driver              = FreeTDS
Servername          = ServerName

freetdf.conf

#   $Id: freetds.conf,v 1.12 2007-12-25 06:02:36 jklowden Exp $
#
# This file is installed by FreeTDS if no file by the same 
# name is found in the installation directory.  
#
# For information about the layout of this file and its settings, 
# see the freetds.conf manpage "man freetds.conf".  

# Global settings are overridden by those in a database
# server specific section
[global]
        # TDS protocol version
    tds version = auto

    # Whether to write a TDSDUMP file for diagnostic purposes
    # (setting this to /tmp is insecure on a multi-user system)
;   dump file = /tmp/freetds.log
;   debug flags = 0xffff

    # Command and connection timeouts
;   timeout = 10
;   connect timeout = 10

    # If you get out-of-memory errors, it may mean that your client
    # is trying to allocate a huge buffer for a TEXT field.  
    # Try setting 'text size' to a more reasonable limit 
    text size = 64512

    # If you experience TLS handshake errors and are using openssl,
    # try adjusting the cipher list (don't surround in double or single quotes)
    # openssl ciphers = HIGH:!SSLv2:!aNULL:-DH

# A typical Sybase server
[egServer50]
    host = symachine.domain.com
    port = 5000
    tds version = 5.0

# A typical Microsoft server
[TEST]
    host = ServerName
    port = 1433
    tds version = 7.3
    client charset = UTF-8

我的命令和输出： isql TEST myuser mypass -v [IM002][unixODBC][Driver Manager]未找到数据源名称且未指定默认驱动程序 [ISQL]错误：无法 SQLConnect

【问题讨论】：

您是在告诉我们tsql -S MYMSSQL ... 适合您吗？如果是这样，那么您并没有向我们提供整个故事，因为在您的任何配置文件中都没有名为MYMSSQL 的条目。请edit您的问题准确（简洁地）描述您真正在做什么，什么有效，什么无效。
另外，tds version = 8.0 也不是无效的。这不会阻止连接，但您应该选择合适的tds version，具体取决于您的 FreeTDS 版本。见本页第二张表：freetds.org/userguide/choosingtdsprotocol.htm
@GordThompson 我更新了问题 - 不确定这会如何改变任何事情，因为您可以从我的配置文件中推断出我在命令中使用 TEST 而不是 MYMSSQL。
@FlipperPA 我将它更新到正确的版本，7.3，但仍然没有运气
@dir101 是的，这不能解决这个问题，但它可以让你在路上省去头疼的问题。 :)

标签： python sql-server pyodbc freetds unixodbc

【解决方案1】：

首先确认您正在编辑正确的配置文件。

您可以通过以下方式确认 FreeTDS 的世界观：

$ tsql -C
Compile-time settings (established with the "configure" script)
                            Version: freetds v1.1.11
             freetds.conf directory: /usr/local/etc
     MS db-lib source compatibility: no
        Sybase binary compatibility: yes
                      Thread safety: yes
                      iconv library: yes
                        TDS version: 7.3
                              iODBC: no
                           unixodbc: yes
              SSPI "trusted" logins: no
                           Kerberos: yes
                            OpenSSL: yes
                             GnuTLS: no
                               MARS: yes

这表明系统范围的 freetds.conf 文件将位于路径 /usr/local/etc/freetds.conf，尽管您可以在 ~/.freetds.conf 拥有自己的用户特定版本。

如果您尝试连接到网络上的 SQL Server fred.example.com，您可以在 freetds.conf 中为其创建别名：

[fred]
    host = fred.example.com
    port = 1433
    tds version = auto
    client charset = UTF-8

[fred] 别名不区分大小写。 TSQL 可以通过以下任何方式连接到它：

$ tsql -S fred -U "FRED\YourSQLUserName" -P "YourSQLPassword"
$ tsql -S FRED -U "FRED\YourSQLUserName" -P "YourSQLPassword"
$ tsql -S FrEd -U "FRED\YourSQLUserName" -P "YourSQLPassword"

...等等。

一旦您确定 FreeTDS 正在工作，您就可以继续使用 ODBC。您可以通过以下方式检查 ODBC 的世界观：

$ odbcinst -j
unixODBC 2.3.7
DRIVERS............: /usr/local/etc/odbcinst.ini
SYSTEM DATA SOURCES: /usr/local/etc/odbc.ini
FILE DATA SOURCES..: /usr/local/etc/ODBCDataSources
USER DATA SOURCES..: /Users/YourUserName/.odbc.ini
SQLULEN Size.......: 8
SQLLEN Size........: 8
SQLSETPOSIROW Size.: 8

首先编辑/usr/local/etc/odbcinst.ini 文件（开始时为空）并添加以下内容：

[FreeTDS]
Description=FreeTDS Driver for Linux & MSSQL
Driver=/usr/local/lib/libtdsodbc.so
Setup=/usr/local/lib/libtdsodbc.so
UsageCount=1

接下来，您可以在 /usr/local/etc/odbc.ini 中为 Fred 添加系统范围的数据源，或者在 ~/.odbc.ini 中添加用户特定的数据源：

[fred]
Description         = Test to SQLServer
Driver              = FreeTDS
Servername          = fred

注意这里的Servername = fred 指向freetds.conf 中的[fred]。它也不区分大小写，但你不应该有一个叫fred，另一个叫daphne。

现在您应该能够使用 ODBC 连接：

$ isql fred "FRED\YourSQLUserName" "YourSQLPassword"

希望这会有所帮助。

【讨论】：

我正在尝试连接到名为 TEST 的 SQL Server，我只是使用了上面链接中的示例命令。它仍然无法正常工作。我更新了问题。
@dir101 你的问题的odbc.ini 文件中还有Servername = ServerName，freetds.conf 文件中还有host = ServerName。您的网络上有名为 ServerName 的 SQL 服务器吗？
我只是用 ServerName 掩盖了实际服务器的名称。无论您在我的文件中哪里看到 ServerName，我都有服务器的名称。
@dir101 - 您的描述需要更加准确。当您说“服务器名称”时，您是指 TDS 名称（在 freetds.conf 中定义）还是 DNS 名称（例如 someserver.example.com）？
@AlwaysLearning - 如果您不使用 MYMSSQL 作为所有内容的名称，则此答案的混淆程度会大大降低。或许调用 ODBC DSN MYMSSQL_DSN（在 odbc.ini 中）、FreeTDS 服务器 MYMSSQL_SERVER，并使用 host = mymssql.example.com 来帮助区分不同的名称。

【解决方案2】：

您的部分困惑可能是由于您将所有内容命名为“TEST”。这对我有用：

freetds.conf

[MYMSSQL_SERVER]
    host = 192.168.0.179
    port = 49242
    tds version = 7.0

odbcinst.ini

[FreeTDS]
Description=FreeTDS ODBC
Driver=/usr/lib/x86_64-linux-gnu/odbc/libtdsodbc.so

odbc.ini

[TEST]
Description         = Test to SQLServer
Driver              = FreeTDS
Servername          = MYMSSQL_SERVER

isql 需要 DSN 名称

gord@xubu-Inspiron-1720:~$ isql TEST sa sapassword
+---------------------------------------+
| Connected!                            |
|                                       |
| sql-statement                         |
| help [tablename]                      |
| quit                                  |
|                                       |
+---------------------------------------+
SQL> SELECT @@SERVERNAME
+---------------------------------------------------------------------------------------------------------------------------------+
|                                                                                                                                 |
+---------------------------------------------------------------------------------------------------------------------------------+
| GORD-HP\SQLEXPRESS                                                                                                              |
+---------------------------------------------------------------------------------------------------------------------------------+
SQLRowCount returns 1
1 rows fetched

tsql 需要 FreeTDS 服务器名称

gord@xubu-Inspiron-1720:~$ tsql -S MYMSSQL_SERVER -U sa -P sapassword
locale is "en_CA.UTF-8"
locale charset is "UTF-8"
using default charset "UTF-8"
1> SELECT @@SERVERNAME
2> GO

GORD-HP\SQLEXPRESS
(1 row affected)

请注意，如果您只使用 ODBC，则不需要在 freetds.conf 中添加条目。诀窍是让 DSN 使用Server 而不是Servername。这也有效：

odbc.ini

[TEST_ODBC_ONLY]
DRIVER=FreeTDS
SERVER=192.168.0.179
PORT=49242
TDS_Version=7.0

isql 喜欢就好了：

gord@xubu-Inspiron-1720:~$ isql TEST_ODBC_ONLY sa sapassword
+---------------------------------------+
| Connected!                            |
|                                       |
| sql-statement                         |
| help [tablename]                      |
| quit                                  |
|                                       |
+---------------------------------------+
SQL> SELECT @@SERVERNAME
+---------------------------------------------------------------------------------------------------------------------------------+
|                                                                                                                                 |
+---------------------------------------------------------------------------------------------------------------------------------+
| GORD-HP\SQLEXPRESS                                                                                                              |
+---------------------------------------------------------------------------------------------------------------------------------+
SQLRowCount returns 1
1 rows fetched

此外，通过 pyodbc，如果您使用 DSN-less 连接，您甚至不需要 DSN：

connection_string = (
    'DRIVER=FreeTDS;'
    'SERVER=192.168.0.179;'
    'PORT=49242;'
    'TDS_Version=7.0;'
    'UID=sa;PWD=sapassword;'
)
cnxn = pyodbc.connect(connection_string)
crsr = cnxn.cursor()
print(crsr.execute("SELECT @@SERVERNAME").fetchval())
# GORD-HP\SQLEXPRESS

【讨论】：