Tsurugi ODBC Driver (ja)

[akirakw]

Tsurugi ODBCドライバー

はじめに

Tsubakuro/Rust では Tsubakuro/Rust のコア機能をベースにODBCインターフェースを実装したODBCドライバ「Tsurugi ODBCドライバー」を提供しています。

• Tsurugi ODBCドライバー

Tsurugi ODBCドライバーを利用することで、ODBC対応の様々なアプリケーションやツール、ライブラリなどからTsurugiに接続し、データベースの各種機能を利用することができるようになります。

動作環境

• Tsurugi ODBCドライバーは、現時点では以下の環境での動作を検証しています。
  • Windows環境では、64bit環境での動作を検証しています。
  • Linux環境では、unixODBCをODBCドライバーマネージャーとした基本的な動作のみを検証しています。
• Tsurugi ODBCドライバーは、Tsurugi 1.5.0 及びこれ以降のバージョンで動作します。

対応機能

• Tsurugi ODBCドライバー は Microsoft ODBC 3.0 の仕様に準拠しています。ただし現時点では一部の関数や機能には対応していません。
  • 詳細についてはドキュメント Tsurugi ODBCドライバー 関数一覧 を参照してください。
• Tsurugi ODBCドライバーは Tsurugiが提供する BLOB型、CLOB型 以外のデータ型に対応しています。ただし ODBC 3.0 でサポートされていないデータ型（タイムゾーン付のデータ型など）については、ODBCドライバーの仕様に従い未サポートです。
  • 詳細についてはドキュメント Tsurugi ODBCドライバー データ型一覧 を参照してください。
• Tsurugi ODBCドライバーは TsurugiのTCP接続に対応しています。IPC接続には対応していません。
• Tsurugi ODBCドライバーの利用時には、Tsurugiが提供する各種トランザクションやセッションに関する動作はTsurugi ODBCドライバーが規定するデフォルトの動作設定に従います。例えばトランザクション種別は常に OCC が指定されます。
  • 詳細についてはドキュメント tsubakuro-rust-odbc/README.md - Limitation を参照してください。

Tsurugi ODBCドライバーのインストール

以下に示す手順でTsurugi ODBCドライバーのライブラリファイルを入手し、インストールを行ってください。

NOTE: Tsubakuro/Rust 0.5.0 以降では、Tsurugi ODBCドライバーはインストーラーを提供しています。本セクションではインストーラーを利用したインストール方法について説明しています。
その他のインストール方法については、以下のドキュメントを参照してください:

• Tsurugi ODBCドライバー インストール方法

また、Tsubakuro/Rust 0.4.0 向けのインストール方法については、後述のセクション 「(Tsubakuro/Rust 0.4.0) Tsurugi ODBCドライバーのインストール」 を参照してください。

Tsurugi ODBCドライバーインストーラーの入手

Tsubakuro/Rust のリリースページ Tsubakuro/Rust Releases から、利用するバージョンに対応するリリースのアセットとして提供されている Tsurugi ODBCドライバーのインストーラーファイル tsurugi_odbc_driver_installer.exe をダウンロードします。

IMPORTANT: インストーラーには64bit版向けのDLLファイルが含まれています。32bit版のODBCドライバーは提供していません。

Tsurugi ODBCドライバーのインストール

上記の手順で入手した Tsurugi ODBCドライバーのインストーラーファイルを実行し、インストールを行います。

インストーラーの画面が表示されるので、それに従ってセットアップを進めてください。

IMPORTANT: 現時点では、インストーラーファイルにはデジタル署名が付与されていません。そのためインストーラーの実行時に環境によっては Microsoft Defender SmartScreen のセキュリティ警告が表示される場合があります。

Tsurugiサーバへの接続

Tsurugi ODBCドライバーはTCP接続を利用してTsurugiサーバへ接続します。
Tsurugiサーバの設定でTCP接続エンドポイントが有効になっていること、および接続ポートの設定などを確認してください。

ODBCドライバーではその接続方式としてドライバーの接続文字列を利用する方法、およびODBCデータソースのDSN (Data Source Name) を利用する方法があります。

接続文字列を利用する場合の接続パラメーター例は以下の通りです。

DRIVER={Tsurugi Driver};ENDPOINT=tcp://localhost:12345;

DSNを利用する場合、事前に「ODBC データソース アドミニストレーター」からDSNの登録行います。ODBC データソース アドミニストレーターの「ユーザーDSN」タブから「追加」ボタンをクリックし、ドライバー一覧から「Tsurugi Driver」を選択して「完了」ボタンをクリックします。表示されるダイアログでデータソース名とTsurugiサーバの接続情報や認証に関する情報を入力し、「OK」ボタンをクリックして登録を完了します。

その上で、登録したデータソース名を指定して接続します。例えばデータソース名が MyTsurugiDSN の場合、接続文字列は以下のようになります。

DSN=MyTsurugiDSN;

その他、Tsurugi ODBCドライバーの利用方法については以下のドキュメントを参照してください:

• Tsurugi ODBCドライバー 使用方法

(Tsubakuro/Rust 0.4.0) Tsurugi ODBCドライバーのインストール

ここでは Tsubakuro/Rust 0.4.0 向けの Tsurugi ODBCドライバーのインストール方法について説明します。

以下に示す手順でTsurugi ODBCドライバーのライブラリファイルを入手し、インストールを行ってください。

NOTE: 以降の手順内で示す Tsubakuro/Rust リポジトリ内の各リンクは Tsubakuro/Rust 0.4.0 のバージョンに対応するタグを参照しています。

Tsurugi ODBCドライバーライブラリファイルの入手

Tsurugi ODBCドライバーライブラリファイルは、ODBCドライバーマネージャーが利用できる形式のDLLファイル (Windows) または共有ライブラリファイル (Linux等) です。

Tsurugi ODBCドライバーライブラリファイルを入手するには、以下の2つの方法があります。

1. Tsubakuro/Rust のソースコードからライブラリファイルをビルド
2. ビルド済みDLLファイルのダウンロード

Tsubakuro/Rust のソースコードからライブラリファイルをビルド

Tsubakuro/Rust のソースコードからTsurugi ODBCドライバーのライブラリファイルをビルドします。以下はその手順です。

1. Tsubakuro/Rust のソースコードを入手

   • 以下のTsubakuro/RustのGitHubリポジトリ からソースコードをcloneまたはダウンロードします。
   • https://github.com/project-tsurugi/tsubakuro-rust/tree/0.4.0

2. tsubakuro-rust-core のビルド環境の準備

   • 後述のビルド手順では内部で tsubakuro-rust-core が自動的にビルドされるため、これに必要なビルド環境を準備します。
   • 必要となるビルド環境については tsubakuro-rust-core/README.md - How to build を参照してください。

3. tsubakuro-rust-odbc のビルド

   • Tsurugi ODBCドライバー用バイナリクレート tsubakuro-rust-odbc をビルドします。
   • ビルド手順については tsubakuro-rust-odbc/README.md - How to build を参照してください。

ビルド済みDLLファイルのダウンロード

開発や動作検証のために、GitHub Actions上でビルド済みの64bit版DLLファイルをダウンロードすることができます。以下のリンクからダウンロードしてください。

• Tsubakuro/Rust 0.4.0: tsubakuro-rust-odbc.dll.zip
  • ダウンロードするには GitHub へのサインインが必要です。
  • 上記のリンクは 2025/10/28 まで有効です。

IMPORTANT: このビルド済みDLLファイルは開発環境や特定の検証環境での利用を想定しています。すべての環境での動作を保証するものではありません。

Tsurugi ODBCドライバーの配置と登録

上記の手順で入手した Tsurugi ODBCドライバーライブラリファイルを実行環境へ配置し、実行環境のODBCドライバーマネージャーに対してODBCのドライバーの定義情報を登録します。

Windows環境への登録

Windows環境へのドライバーの登録は、Windowsのレジストリにドライバに関する定義情報を登録することで行います。
レジストリへの登録方法については Tsubakuro/Rust 内のドキュメント (Tsubakuro/Rust 0.4.0) Tsurugi ODBCドライバー インストール方法 を参照してください。

NOTE: Tsubakuro/Rust 0.4.0 時点では、Windowsが提供する「ODBC データソース アドミニストレーター」からのデータソース登録はサポートしていません。データソースを登録する場合は (Tsubakuro/Rust 0.4.0) Tsurugi ODBCドライバー インストール方法 を参考にしてレジストリに対する登録を行ってください。

その他環境への登録

Linux環境などへの登録方法については、各プラットフォームで利用するODBCドライバーマネージャー (例: unixODBC) のドキュメントを参照してください。