Python環境にpyodbcをインストールしてSQLServerに接続する手順

＜目次＞

(１) PythonにpyodbcをインストールしてSQLServerに接続する手順
　 (１-１) 手順１：ODBCドライバのインストール
　 (１-２) 手順２：pythonパッケージの導入
　 (１-３) 手順３：疎通テスト
 (２) エラー対処
　 (２-１) エラー概要
　 (２-２) エラー原因
　 (２-３) エラー対処
 (３) その他メモ

(１) PythonにpyodbcをインストールしてSQLServerに接続する手順

手順は大きく２つに分かれています。
「手順１」では「ODBCドライバー」のインストールを行います。ODBCドライバーはクライアントがDBと連携するためのモジュール（DLL）で、DBに対してSQLを連携して結果を受け取る等の仲介を行います。
「手順２」では「pyodbcライブラリ」のインストールを行います。pyodbcはPythonのライブラリで、DB接続に必要となるDBAPIの仕様を実装したモジュール（DLL）です。
この２つの手順を経る事で『PythonのプログラムからSQLServerのデータベースにアクセスしてSQLを発行する事』が可能になります。

ODBCドライバーとアプリやデータベースの関係性については別記事で整理しています。
⇒（★作成中）

(１-１) 手順１：ODBCドライバのインストール

前半部分に相当するODBCドライバーのインストール手順を紹介します。
(※ただし、画面等は2020年1月時点のため実際と異なる場合がございますのでご留意ください)

①ドライバーのダウンロード
Microsoftの下記サイトにアクセスし「～ODBC Driver 17 for SQL Server ～をダウンロード」と書かれたリンクを選択します。
https://docs.microsoft.com/ja-jp/sql/connect/odbc/download-odbc-driver-for-sql-server?view=sql-server-ver15

（図１１１）①

↓
②Downloadを押下します。
（図１１１）②

↓
③ご自身のOSバージョンに合ったインストーラを選択します（32bitならx86を、64bitならx64を選択）
（図１１１）③

↓
④ダウンロードが開始されます。
（図１１１）④

↓
⑤資源（.msiファイル）をインストール先のサーバに配置して実行します（ダブルクリック）。
（図１１１）⑤

↓
⑥インストーラの案内に沿ってインストールを進めます。
（図１１１）⑥

↓
⑦ライセンス条件がOKならNextを押下
（図１１１）⑦

↓
⑧インストールしたい機能を選択します。
（図１１１）⑧

↓
⑨インストールに伴うディスクの使用量を確認します。
（図１１１）⑨

↓
⑩「Install」を押下してインストールを開始します。
（図１１１）⑩

↓
（図１１１）⑪進行中

↓
（図１１１）⑫完了

(１-２) 手順２：pythonパッケージの導入

①pyodbc資源のダウンロード
PyPIページにアクセスして、pyodbcのパッケージをダウンロードします。
https://pypi.org/project/pyodbc/

（図１２１）①

↓
②「pyodbc-X.X.XX.tar.gz」ファイルをダウンロードします。
（図１２１）②

↓
③ダウンロードした資源をインストール先のサーバに配備して実行します。
（図１２１）③

↓

④インストールの開始
まずはpyodbcのダウンロード済みパッケージがある階層まで移動します（～\pyodbc\srcなど各自のパス）。移動できたらpipコマンドを実行します。

# pip install pyodbc_4.0.2.tar.gz

（図１２１）④移動できたらdirコマンドでファイルの存在をチェック

↓
（図１２１）⑤pipコマンドの実行

↓
（図１２１）⑥インストール完了

(１-３) 接続テスト

最後に接続テストとして、PythonのプログラムからSQLServerのテーブルにアクセスできるか？を確認します。

Python側で次の例のようなサンプルプログラムを実行して、疎通チェックを行います。

（サンプルプログラム）

import pyodbc

def DbConnection():
    driver='{SQL Server}'
    server='[DB IP address]'
    database='[Database Name]'
    uid='[DB User]'
    pwd='[DB Password]'
    cnxn=pyodbc.connect('DRIVER='+driver+';SERVER='+server+';DATABASE='+database+';UID='+uid+';PWD='+pwd+';')
    cursor=cnxn.cursor()
    sql="SELECT * FROM dbo.spt_monitor"
    cursor.execute(sql)
    row=cursor.fetchone()
    while row:
        print(row[0])
        row=cursor.fetchone()
    cursor.close()

def main():
    DbConnection()
    pass

if __name__ == '__main__':
    main()

（図１２１）⑦
プログラムを実行した結果、データベースのテーブル内容がPythonの実行結果に表示されています。

＞目次にもどる

(２) エラー対処

(２-１) エラー概要

もし次のようなエラーが出た場合の対処についても触れておきます。

（図１３１）①

（エラーメッセージ例）

copying build\lib.win-amd64-3.7\pyodbc.cp37-win_amd64.pyd -> c:\program files (x86)\microsoft visual studio\shared\python37_64\Lib\site-packages
    error: could not create 'c:\program files (x86)\microsoft visual studio\shared\python37_64\Lib\site-packages\pyodbc.cp37-win_amd64.pyd': Permission denied

＞目次にもどる

(２-２) エラー原因

メッセージの最後の部分にあるように、Permission Deniedつまり権限の不足が原因です。具体的にはエラーメッセージに書かれているパス（上記の例では「c:\program files (x86)\microsoft visual studio\shared\python37_64」へのアクセス権限が不足している事が読み取れます）。

＞目次にもどる