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

本文書は、PostgreSQL 18.3 と psqlODBC 18_00_0001 を使って、psqlODBC の Windows 上と Linux 上での使い方を解説します。

2. 導入方法 （Windows）

◆ パッケージの取得

psqlODBC ソフトウェアは以下ページから入手できます。セットアッププログラム(*-setup.exe)、MSI インストーラ（.msi）、マージモジュール（.msm）の各形式から選べます。さらにメモリ管理にmimallocライブラリを使った版も用意されています。

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

ソースコードは psqlodbc の githubページ から取得できます。

◆ 32bit 版と 64bit 版

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

64bit の Windows でも 32bit ビルドされたアプリケーションで ODBC を使うために 32bit 版を使用したい場合があります。この場合、設定画面（ODBCデータソースアドミニストレーター）としては「コントロールパネル」→「Windowsツール」から「ODBCデータソース(32ビット)」を選びます。対応するアイコンが無い場合には、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 にデータソース定義を作る方法と、全ての接続情報を直接指定する方法があります。データソース定義を作るには、「コントロールパネル」→「Windowsツール」から「ODBCデータソース」から設定画面（ODBC データ ソース アドミニストレーター）を起動します。

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

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

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

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

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

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

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

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

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

各refcursorから結果を取得しますFetchRefcursors / DA設定が 1 なら refcursor を返す関数の結果を自動的に FETCH して、複数行を返す関数と同様に振舞う。デフォルトの 0 なら単にカーソル名が返る。バージョン 13.02.0000 から。

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

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

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

4. 使用例 (Windows)

◆ Officeから使う

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

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

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

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

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

◆ PowerShellから使う

続いて、クライアントプログラムから使う例の 1つとして、PowerShell から ODBC を通してデータベースアクセスする例を示します。

以下は、作成済のデータソース「pgsql18_db1_ANSI」にユーザ名、パスワードを指定して、データベース接続を行って、t1 テーブルから 5行を取り出しています。

PS> $conn = New-Object System.Data.Odbc.OdbcConnection
PS> $conn.ConnectionString = "DSN=pgsql18_db1_ANSI;Uid=dbuser1;Pwd=passwd1;"
PS> $conn.Open()
PS> $cmd = $conn.CreateCommand()
PS> $cmd.CommandText = "SELECT * FROM t1 LIMIT 5"
PS> $reader = $cmd.ExecuteReader()
PS> while ($reader.Read()) { Write-Output "$($reader['id']) : $($reader['v'])" }
1 : AAA
2 : BBB
3 : CCC
4 : DDD
5 : EEE
PS> $conn.Close()

5. Linux での使用

Linux や各種 UNIX 上で動作する ODBC API を提供するライブラリを使用して、 ODBC 接続をすることができます。オープンソースでよく使われているのが unixODBC です。これは RedHat Enterprise Linux などの主要ディストリビューションで標準パッケージとして含まれています。本節では Rocky 8.x にて unixODBC を使用する例を説明します。

◆ インストール

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

# dnf install unixODBC unixODBC-devel

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

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

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

# dnf install postgresql18-odbc

◆ 設定

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

[PostgreSQL]
Description     = ODBC for PostgreSQL
Driver64        = /usr/pgsql-18/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_ で始まるログファイルが出力されます。

◆ クライアントプログラムから使う

もっとも基本的なC言語でのクライアントプログラム例は、unixODBC の付属文書が参考になります。各種プログラミング言語からの ODBC を使ったデータベースアクセスをするコードの書き方は、それぞれのプログラミング言語の ODBC接続ライブラリのドキュメントを参照してください。

6. まとめ

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