PostgreSQL

1. psqlODBC とは

psqlODBCはオープンソースソフトウェアとして開発されている PostgreSQL の ODBC ドライバです。完全ではありませんが ODBC 3.0 に対応しています。ほかに商用製品のドライバも存在しますが、大部分の用途では psqlODBC を使用すれば十分といえます。psqlODBC の難点としては、公式ドキュメントの記述量が少ないこと、利用方法を解説した文書が少ない、あるいは、ひどく古いバージョンを前提とした公開文書が多く、取捨選択が難しいことがあります。

本文書は、PostgreSQL 9.6.2 と psqlODBC 09.06.0100 を使って、psqlODBC の Linux 上と Windows 上での使い方を解説します。2023年 4月時点で、psqlODBC 13.02.0000 までリリースされています。バージョン 13.02.0000 までで変更された点について加筆しています。スクリーンショットは変更していませんが、設定パラメータの表には新たなパラメータも記載しています。

2. 導入方法 （Windows）

◆ パッケージの取得

psqlODBC ソフトウェアは以下ページから入手できます。ソースコード（src）に加えてバイナリファイルが MSI インストーラ（msi）、マージモジュール（mm）、DLL（dll）の各形式から選べます。単体で導入するなら MSI インストーラ、アプリケーションのインストーラに組み入れるならマージモジュールを、Windows のコンポーネント管理下に置かずに使用するなら DLL を選べば良いでしょう。

https://www.postgresql.org/ftp/odbc/versions/

◆ 32bit 版と 64bit 版

バイナリ配布については同バージョンでも 64bit （ファイル名に「-x64」が含まれます） と 32bit （ファイル名に「-x86」が含まれます／古いものは何もサフィックスがなければ 32bitです）の 2 種類があります。Windows が 32bit か 64bit かによって使い分けます。

64bit の Windows でも 32bit ビルドされたアプリケーションで ODBC を使うために 32bit 版を使用したい場合があります。この場合、インストールと使用は可能ですが、Windows の［コントロールパネル］→［管理ツール］→ ［データソース（ODBC）］から 32bit 版 ODBC の設定画面（ODBC データ ソース アドミニストレーター ）が開けません。この場合、Windows システムディレクトリ内にある 32bit 版の odbcad32.exe を直接実行する必要があります。

◆ ANSI 版と UNICODE 版

psqlODBC には ANSI 版と UNICODE 版の二つのドライバが含まれています。ODBC ドライバを使用する Windows アプリケーションのビルドオプションと合わせます。ANSI 版は Visual Studio における「マルチバイト文字セットを使用する」ビルドに対応します。

psqlODBC ドライバは UNICODE 版では PostgreSQL サーバとの間を UTF8 クライアント文字エンコーディングで通信します。データベース文字エンコーディングが UTF8 以外（EUC_JP など）である場合、アプリケーションから SQL として送られてくる文字列をデータベース文字エンコーディングに変換するのに失敗する可能性があります。最終的に格納可能な文字のみをデータとして投入するようにアプリケーション設計しておく必要があります。

ANSI 版の場合には、クライアント側 Windows のコードページを調べて、それに合わせて PostgreSQL のクライアント文字エンコーディングを宣言します。コードページが 932 なら SJIS になるはずです。どのクライアントエンコーディングであると宣言するかはデータソースの構成で上書き設定可能です。

3. 設定方法 （Windows）

◆ データソース作成

ODBC 接続を利用するには、Windows に ODBC 接続のデータソース定義を作り、そのデータソースをアプリケーションが利用します。インタラクティブにデータソース定義を加えるには、コントロールパネル］→［管理ツール］→ ［データソース（ODBC）］から設定画面（ODBC データ ソース アドミニストレーター ）を起動します。

「追加」ボタンを押して、PostgreSQL UNICODE または PostgreSQL ANSI のドライバを選択すると下記の ODBC セットアップ画面になります。ここでサーバホスト名、ポート番号、データベース名を指定します。ユーザ名・パスワードは必須ではありません。

図 1： ODBC セットアップ画面

「オプション（高度な設定）」の「データソース」から各種の設定ができます。次項にて詳細を説明します。

「全体設定」からは接続前に採取するログの種類とログ出力先ディレクトリが設定できます。「管理」からはANSI版ドライバ・UNICODE 版ドライバの切替ができます。
「SSL Mode」では SSL 接続について無効、考慮、優先、必須、必須:証明書認証、必須:証明書完全認証を指定できます。INI ファイルでのパラメータ名は SSLmode 、短縮名は CA です。選択肢の意味はそれぞれ libpq 接続ライブラリにおける sslmode オプションの disable 、 allow 、 prefer 、 require 、 verify-ca 、 verify-full に相当します（INI ファイルではこれら文字列で指定します）。

◆ プログラムによるセットアップ

データソースをプログラム的に追加するには、SQLConfigDataSource ODBC API 関数が利用できます。

◆ データソース高度な設定

データソースの「高度な設定」画面は３ページに分かれています。多数のパラメータがあり、これらの大部分は接続文字列や INI ファイル指定でも与えられます。

図 2： 高度な設定 – 設定 1 画面

設定１画面で指定できる項目は以下の通りです。INI ファイルでのパラメータ名、接続文字列に使える短縮形パラメータ名との対応付けも示します。なお、スクリーンショットの内容はデフォルトの値です。

設定2画面の設定項目は以下の通りです。

設定3画面の設定項目は以下の通りです。

◆ パラメータ設定のポイント

ほとんどのパラメータはデフォルトのままで問題ありません。
特定のアプリケーションで動作しないことに対する対策としてパラメータが追加された結果、パラメータ数が多数となっています。

4. 使用例 (Windows)

ODBC データソースは様々なアプリケーション、開発言語・環境にて使用できます。ここでは Microsoft Office の Excel を使って接続と SQL 実行のテストをしてみます。「その他のデータソース」の「 Microsoft Query 」を選択します。

データソースの選択で作成した PostgreSQL のデータソースを選択します

クエリウィザードでテーブルを選択します。ここでは仮に 1テーブルだけ追加します。

テーブルの結合を GUI 操作で記述できます。ここで任意に SQL を追加したり、結合や選択条件を指定できます。

Microsoft Query で SQL 実行した結果を Excel に取り込むことができます。

5. Linux での使用

Linux や各種 UNIX 上で動作する ODBC API を提供するライブラリを使用して、 ODBC 接続をすることができます。オープンソースでよく使われているのが unixODBC と iODBC です。これらは RHEL / CentOS 6 や 7 で標準パッケージとして含まれています。本節では CentOS 6.x にて unixODBC を使用する例を説明します。

◆ インストール

unixODBC は以下のように OS パッケージからインストールします。

# yum install unixODBC unixODBC-devel

psqlODBC を unixODBC むけにソースコードからビルドする手順は以下のようになります。ただし、 psqlODBC はビルドしにくい部類のソフトウェアです。ODBC API ライブラリ（ここでは unixODBC ）とのバージョン組み合わせにもよるのですが、エラーが発生し、ビルドを成功させるために CFLAGS 環境変数でプリプロセッサ変数を指定したり、Makefile の補正が必要になることがあります。

$ ./configure --with-unixodbc=/usr/lib64 
    --with-libpq=/usr/pgsql-9.6
$ make
$ su -c 'make install'

お勧めは バイナリパッケージを使うことです。
PostgreSQL RPM Building Project のパッケージとして「 postgresql96-odbc 」という名前でパッケージが用意されています。「 96 」部分はリポジトリの PostgreSQL バージョン系列が 9.6 系であれば 96 、 9.5 系であれば 95 となります。依存関係はクライアントライブラリだけですので、 PostgreSQL サーバのパッケージを導入する必要がありません。

# yum install postgresql96-odbc

本パッケージでは UNICODE 版のドライバのみがインストールされます。

◆ 設定

unixODBC の設定方法を示します。
以下のようにドライバの定義を /etc/odbcinst.ini に記述します。32 bit 環境なら Driver64 でなく Driver にライブラリを指定します。FileUsage は必ず 1 です。 Threading はマルチスレッド動作での保護レベルの指定で、通常は接続単位で保護する 2 を指定します。

[PostgreSQL]
Description     = ODBC for PostgreSQL
Driver64        = /usr/pgsql-9.6/lib/psqlODBCw.so
FileUsage       = 1
Threading       = 2

データソースの定義を /etc/odbc.ini または、ユーザ毎の ~/.odbc.ini に以下のように記述します。ここで設定できる項目は、前節の設定一覧表で「 INI 設定名」として示したものとなります。

[PostgreSQL_DS1]
Description         = PostgreSQL Datasource 1
Driver              = PostgreSQL
Database            = db1
Servername          = dbhost.example.com
Port                = 5432
Protocol            = 7.4-2
CommLog             = 0
Debug               = 0

接続テストをするには unixODBC に付属する isql コマンドを使うのが簡単です。以下のように使用できます。

[host]$ isql PostgreSQL_DS1 dbuser pass
+---------------------------------------+
| Connected!                            |
|                                       |
| sql-statement                         |
| help [tablename]                      |
| quit                                  |
|                                       |
+---------------------------------------+
SQL> SELECT id FROM t1 ;
+------------+
| id         |
+------------+
| 1          |
| 2          |
| 3          |
+------------+
SQLRowCount returns 3
3 rows fetched
SQL> quit
[host]$

なお、ログファイルは /tmp 以下に出力されます。今のところログディレクトリは指定できません。CommLog = 1 なら psqlODBC_ で始まるログファイルが、Debug = 1 なら mylog_ で始まるログファイルが出力されます。

6. まとめ

本文書では psqlODBC について基本的な情報を取りまとめました。
このほか実際に使用するには、各アプリケーションあるいはアプリケーション開発言語・環境における ODBC 接続によるデータベースアクセスを行うライブラリ関数群の使用方法を把握する必要があります。これらは多岐にわたるため、本文書での説明は割愛しています。
特定アプリケーション、アプリケーション開発言語・環境にて動作しない場合については、 psqlODBC 公式ページにある FAQ や HOWTOs 文書の記載が役立つことがあります。これらも確認してください。