在MacOS下使用sqlalchemy 連接sqlserver2012 數據庫

在MacOS下使用sqlalchemy 連接sqlserver 數據庫

前言

最近有要求，要將數據庫換成巨硬家的sqlserver 2012 因為在網上苦苦找不到sqlalchemy 配置連接SqlServer的具體中文步驟，翻了官方文檔后把步驟整理出來

前期准備

已經安裝好sqlalchemy

運行環境介紹

系統：MacOS 10.13.1 Beta Python 環境: 3.6.0 sqlalchemy 1.1.4 pycode 4.0.19 sqlserver 2012

實施步驟

在sqlalchemy里對於連接sqlserver 是這樣介紹的 原文地址http://docs.sqlalchemy.org/en/latest/core/engines.html#sqlalchemy.create_engine

Microsoft SQL Server

The SQL Server dialect uses pyodbc as the default DBAPI. pymssql is also available:

pyodbc

engine = create_engine('mssql+pyodbc://scott:tiger@mydsn')

pymssql

engine = create_engine('mssql+pymssql://scott:tiger@hostname:port/dbname')

因此要想使用sqlalchemy 先要配置pyodbc正常使用當然要是比較省事兒的話可以選擇安裝pymssql

方法一、安裝pymssql

pip3 install pymssql

安裝pymssql 需要提前安裝依賴

brew install freetds@0.91

brew link freetds@0.91

數據庫鏈接字符串為

ENGINE = create_engine( mssql+pymssql://sa:123456@localhost/test?charset=utf8)

方法二、 安裝 pyodbc

如果覺得太慢的話可以后面使用加 -i 參數選擇國內源 比如豆瓣

pip3 install pyodbc

pip install pyodbc

配置pyodbc

在Mac os 下pyodbc不是僅僅安裝上就可以使用的還需要一些配置才可以 關於pyodbc的官方文檔見https://github.com/mkleehammer/pyodbc/wiki

Macos 配置文檔見https://github.com/mkleehammer/pyodbc/wiki/Connecting-to-SQL-Server-from-Mac-OSX

以下是對文檔中步驟的大致翻譯

安裝Install FreeTDS and unixODBC 使用Mac 上的命令行軟件安裝工具

brew update brew install unixodbc brew install freetds --with-unixodbc

遇到的坑

在安裝過程中有可能因為網絡原因導致下載的包不完整導致報類似SHA256 Checksum mismatch 的錯誤，只要根據提示到到下載路徑刪除掉不完整的包就可以了

Treetds 配置

使用命令得到freetds.conf的位置

tsql -C

然后在這個文件的后面追加自己的sql server 配置

例如：

[MYMSSQL]
host = mssqlhost.xyz.com port = 1433 tds version = 7.3

關於不同的數據庫與對於的tds version看下面http://www.freetds.org/userguide/choosingtdsprotocol.htm通過上面的配置 mac就可以和SqlServer服務器連接上了，可以使用下面的命令連接進入到sql命令行狀態

tsql -S MYMSSQL -U myuser -P mypassword

MYMSSQL 在配置文件總給一個數據庫連接起的名字

myuser 連接用的用戶

mypassword 用戶對應的密碼

連接成功后的狀態

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

可以使用一條sql語句測試一下例如"SELECT @@VERSION"

注意輸入完sql語句后 在下一行(enter)輸入go才會執行

編輯odbcinst.ini 和 odbc.ini 配置文件

通過命令來 獲取odbcinst.ini 和odbc.ini的文件位置

odbcinst -j

將如下內容寫入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

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

注意這里的 Servername 就是freetds.conf中配置的名字

接着輸入

isql MYMSSQL myuser mypassword

可以輸入一些sql語句測試一下

示例代碼

通過pyodbc連接數據庫

import pyodbc
# the DSN value should be the name of the entry in odbc.ini, not freetds.conf #將myuser 和mypassword 自己環境中的 conn = pyodbc.connect('DSN=MYMSSQL;UID=myuser;PWD=mypassword') crsr = conn.cursor() rows = crsr.execute("select @@VERSION").fetchall() print(rows) crsr.close() conn.close()

如果能出現結果證明連接正常

通過sqlalchemy 操作數據庫 例如創建一張表

#!/usr/bin/env python3 import pyodbc,sqlalchemy from sqlalchemy.ext.declarative import declarative_base from sqlalchemy import Column,Integer,String,create_engine from sqlalchemy.orm import sessionmaker from sqlalchemy.sql import sqltypes ENGINE = create_engine('mssql+pyodbc://admin:123456@MYMSSQL') Base = declarative_base() class Userinfo(Base): __tablename__ = 'userinfo' id = Column(Integer, primary_key=True, autoincrement=True) account_id = Column(String(255), nullable=False) username = Column(String(255),nullable=False) encrypted_password = Column(sqltypes.VARBINARY(500), nullable=False) token = Column(String(255)) def init_db(): Base.metadata.create_all(ENGINE) def drop_db(): Base.metadata.drop_all(ENGINE) def session(): cls = sessionmaker(bind=ENGINE) return cls() #drop_db() init_db()