CData ODBC Driver for PostgreSQL 2019J - Online Help

macOS DSN の構成

CData ODBC Driver for PostgreSQL 2019J - Build 19.0.7354

このセクションでは、macOS でODBC 接続をセットアップしDSN を設定する方法を示します:

macOS の最小バージョン

本製品 にはmacOS Sierra (10.12) 以上が必要です。

ドライバーのライセンス

端末で次のコマンドを実行して、本製品 のライセンスを取得します。評価版をアクティベートするには、<key> の入力を省略してください。

cd "/Applications/CData ODBC Driver for PostgreSQL/bin"
sudo ./install-license <key>

名前とパスワードを入力するよう求められます。これらは、あなたの名前とマシンのパスワードを指します。

ドライバーマネージャー経由の接続

macOS では、CData ODBC Driver for PostgreSQL 2019J はFilemaker Pro、Microsoft Excel、Tableau のような他の多くの製品と同様に、iODBC ドライバーマネージャー用にあらかじめ設定されています。iODBC の最新バージョンは、iODBC サイトで入手できます。

ドライバーのインストールでは、iODBC にドライバーを登録しシステムDSN を作成します。これは、ODBC 接続をサポートするあらゆるツールやアプリケーションで使用できます。

ドライバーマネージャーはドライバーをロードし、アプリケーションからドライバーに関数呼び出しを渡します。ドライバーをドライバーマネージャーに登録して、DSN をドライバーマネージャーのコンフィギュレーションファイルに定義する必要があります。

DSN の設定

DSN の設定には、iODBC と同時にインストールされたGUI のiODBC アドミニストレータ64-bit を使用できます。ODBC マネージャーは、ODBC ドライバーのビット数と一致している必要があります。最新のCData ODBC Driver for PostgreSQL 2019J のバージョンは64-bit のみです。また、iODBC コンフィギュレーションファイルを編集することもできます。

ユーザーDSN またはシステムDSN を構成できます。ユーザーデータソースは、ユーザーアカウントに制限されています。システムデータソースは、すべてのユーザーがアクセスできます。

iODBC アドミニストレータでのDSN の設定

Launchpad からiODBC アドミニストレータ64-bit を起動することで、ユーザーDSN を作成できます。

ドライバーによってインストールされたシステムDSN を変更する、またはシステムDSN を作成するには、iODBC アドミニストレータ64-bit を昇格権限で起動します。それには、次のコマンドをターミナルに入力します。

sudo /Applications/iODBC/iODBC\ Administrator64.app/Contents/MacOS/iODBC\ Administrator64
iODBC アドミニストレータ64-bit を起動すると、CData PostgreSQL Source がSystem タブにリストされます。 DSN を選んで[設定]ボタンをクリックし、接続プロパティを名前と値のペアで設定します。

自分でDSN を作成するには、代わりに[User]か[System]タブで[Add]をクリックし、CData ODBC Driver for PostgreSQL オプションを選択します。

Connecting to PostgreSQL

The following connection properties are required in order to connect to data.

  • Server: The host name or IP of the server hosting the PostgreSQL database.
  • Port: The port of the server hosting the PostgreSQL database.

You can also optionally set the following:

  • Database: The default database to connect to when connecting to the PostgreSQL Server. If this is not set, the user's default database will be used.

Connect Using Standard Authentication

To authenticate using standard authentication, set the following:

  • User: The user which will be used to authenticate with the PostgreSQL server.
  • Password: The password which will be used to authenticate with the PostgreSQL server.

Connect Using SSL Authentication

You can leverage SSL authentication to connect to PostgreSQL data via a secure session. Configure the following connection properties to connect to data:

  • SSLClientCert: Set this to the name of the certificate store for the client certificate. Used in the case of 2-way SSL, where truststore and keystore are kept on both the client and server machines.
  • SSLClientCertPassword: If a client certificate store is password-protected, set this value to the store's password.
  • SSLClientCertSubject: The subject of the TLS/SSL client certificate. Used to locate the certificate in the store.
  • SSLClientCertType:; The certificate type of the client store.
  • SSLServerCert: The certificate to be accepted from the server.

iODBC INI ファイルでのDSN の設定

odbc.ini でDSN を設定します。ODBC ドライバーをodbcinst.ini に登録します。

odbc.ini

ODBC データソースを、odbc.ini ファイルのセクションに定義します。ユーザーデータソースにアクセスできるのは、odbc.ini ファイルがホームフォルダに格納されているユーザーアカウントだけです。システムデータソースは、すべてのユーザーがアクセスできます。

PrivilegesPath
User/Users/myuser/Library/ODBC/odbc.ini
System/Library/ODBC/odbc.ini

iODBC のシステム全体の設定を変更するには、権限を上げる必要があります。そのためには、root またはsudo コマンドを使用できます。次に例を示します。

sudo nano /Library/ODBC/odbc.ini

データソースへの接続に必要な接続プロパティに加えて、Driver プロパティでodbcinst.ini ファイルのドライバー定義またはドライバーライブラリへのパスを指定します。

[CData PostgreSQL Source]
Driver = CData ODBC Driver for PostgreSQL
User=postgres
Password=admin
Database=postgres
Server=127.0.0.1
Port=5432

さらに、ODBC データソースセクション内で、DSN をodbcinst.ini ファイルで定義されたドライバーに設定する必要があります。例えば、ドライバーのインストール時に作成されるDSN のエントリーは次のとおりです。

[ODBC Data Sources]
CData PostgreSQL Source = CData ODBC Driver for PostgreSQL

odbcinst.ini

パスを本製品 ライブラリに変更する場合は、インストールされたドライバー定義を変更する必要があります。

ODBC ドライバーを登録するには、odbcinst.ini ファイルを変更します。iODBC では、ドライバーは一つのユーザーアカウントでのみ、またはシステム全体で利用可能です。

PrivilegesPath
User/Users/myuser/Library/ODBC/odbcinst.ini
System/Library/ODBC/odbcinst.ini

ドライバーは、odbcinst.ini ファイルのセクションに定義されます。セクション名はドライバーの名前を指定します。このセクションでは、Driver プロパティはドライバーライブラリへのパスを指定します。ドライバーライブラリは、インストールディレクトリの[lib]サブフォルダにある.dylib ファイルです。デフォルトでは、/Applications/CData ODBC Driver for PostgreSQL 内に格納されます。

[CData ODBC Driver for PostgreSQL]
Driver = /Applications/CData ODBC Driver for PostgreSQL/lib/libpostgresqlodbc.dylib

ODBC ドライバーセクションには、ドライバー名が "Installed" に設定されたプロパティも含まれている必要があります。次に例を示します。

[ODBC Drivers]
CData ODBC Driver for PostgreSQL = Installed

接続のテスト

ほとんどのiODBC インストールで利用可能なiODBC デモを使って、PostgreSQL に接続しSQL クエリを実行できます。

iODBC デモ

iODBC デモから接続するには次の手順を実行してください。

  • Launchpad を開き"iODBC" を検索します。
  • ANSI ODBC API のみが使用可能なアプリケーションからPostgreSQL に接続する場合は、iODBC Demo Ansi をクリックします。それ以外の場合は、iODBC Demo Unicode をクリックします。
  • [Environment]メニューで[Open Connection]をクリックします。
  • 対応するタブでDSN を選択し、接続をテストします。
これで、SQL メニューで[Execute SQL]をクリックすることで&service; にSQL ステートメントを実行できます。

ドライバーエンコーディングの設定

ODBC ドライバーは、ODBC ドライバーマネージャーで使用するエンコーディングを指定する必要があります。デフォルトでは、Mac 用のCData ODBC ドライバーはiODBC と互換性のあるUTF-32 を使用するように設定されていますが、他のドライバーマネージャーでは代替エンコーディングが必要な場合があります。

また、ANSI ODBC API を使用するアプリケーションからODBC ドライバーを使用している場合は、ANSI コードページを設定する必要があります。例えば、ANSI アプリケーションに日本語の文字をインポートするには、設定ファイル'/Applications/CData ODBC Driver for PostgreSQL/lib/cdata.odbc.postgresql.ini' でコードページを指定できます。

[Driver]
AnsiCodePage = 932

ドライバーのアンインストール

ドライバーをアンインストールする最も簡単な方法は、ターミナルを開いて、インストールディレクトリにあるuninstall.sh スクリプトを実行します。次に例を示します。

cd "/Applications/CData ODBC Driver for PostgreSQL"
sudo ./uninstall.sh

Note:このスクリプトはインストールディレクトリから実行される必要があります。

 
 
Copyright (c) 2020 CData Software, Inc. - All rights reserved.
Build 19.0.7354.0