データベースとの CLI 接続のテスト

ローカル・アプリケーションおよびツールを Db2 データベースに接続するには、ご使用の環境を構成する必要があります。

始める前に

データベースへの接続をテストする前に、以下の前提タスクが完了していることを確認してください。 Db2 データベースへの接続をテストする前に

をインストールしてください。 IBM Data Server Driver Package をインストールしてください。
Transport Layer Security (TLS) を使用してデータベースに接続するかどうかを決定します。
サーバーのホスト名とデータベース・ユーザー ID およびパスワードを含む、データベースの詳細と接続資格情報を収集します。

プロシージャー

コマンド・プロンプトから、ドライバー構成ファイル db2dsdriver.cfgに項目を追加せずに db2cli validate コマンドを発行します。
```
 db2dsdriver.cfg: db2cli validate -connstring “<ODBC Connection String>”
```
ここで、 ODBC Connection String は、 SQLDriverConnect API 関数の InConnectionString 引数で定義された形式で指定します。
データベースのドライバー構成ファイル db2dsdriver.cfgにエントリーを追加します。
構成手順は、TLS を使用してデータベースに接続するかどうかによって異なります。

TLS なし
TLSを使用せずにアプリケーションやツールをデータベースに接続するには、 Linux オペレーティング・システムのコマンド・シェル、Windowsのコマンド・プロンプト、またはコマンド・ウィンドウで次のコマンドを入力します。 Db2® コマンド・ウィンドウに入力する：
```
db2cli writecfg add -database SAMPLEDB -host hostname -port 50000
db2cli writecfg add -dsn alias -database SAMPLEDB -host hostname -port 50000
```
説明:
- hostname は、サーバーのホスト名です。
- alias は、選択した別名です。この別名を、データベース名 SAMPLEDB と同じ名前にすることはできません。別名にスペースを使用する場合は、その別名を二重引用符で囲みます。
TLS による
TLS を使用してアプリケーションおよびツールをデータベースに接続するには、 Linux オペレーティング・システムのコマンド・シェル、Windows コマンド・プロンプト、または Db2 コマンド・ウィンドウで以下のコマンドを入力します。
```
db2cli writecfg add -database SAMPLEDB -host hostname -port 50001 
db2cli writecfg add -dsn alias -database SAMPLEDB -host hostname -port 50001 
db2cli writecfg add -database SAMPLEDB -host hostname -port 50001 -parameter "SecurityTransportMode=SSL" 
db2cli writecfg add -database SAMPLEDB -host hostname -port 50001 -parameter "SSLServerCertificate=SampleSSLCert.crt" 
```
説明:
- hostname は、サーバーのホスト名です。
- alias は、選択した別名です。この別名を、データベース名 SAMPLEDB と同じ名前にすることはできません。別名にスペースを使用する場合は、その別名を二重引用符で囲みます。
- SampleSSLCert.crt は、自己署名サーバー証明書または認証局 (CA) 証明書の完全修飾名を指定します。
注: Bluemix データベースに接続するために SSLServerCertificate キーワードを構成する必要はありません。
コマンド・プロンプトから db2cli validate コマンドを発行して、接続をテストします。
```
db2cli validate -dsn alias -connect -user userid -passwd password
```
説明:
- alias は、db2cli writecfg コマンドを使用して作成した別名です。
- userid は Db2 ユーザー ID です。
- password は Db2 パスワードです。
[オプション] ローカルの ODBC アプリケーションやツールをデータベースに接続できるようにするには、以下のように DSN を ODBC ドライバー・マネージャーに登録します。
コマンド行から次のコマンドを実行します。
```
db2cli registerdsn -add -dsn  alias
```
ここで、alias は、db2cli writecfg コマンドを使用して作成した別名です。デフォルトでは、DSN はユーザー DSN として作成されます。

例

以下の例は、3 つの異なる接続ストリング値を使用して db2cli validate コマンドを実行した場合のコマンド構文と出力を示しています。これらのコマンドは、ドライバー構成ファイル db2dsdriver.cfg に項目を追加せずに実行されます (ステップ 1を参照)。

db2cli validate -connstring “DATABASE=SAMPLE=SAMPLE;HOSTNAME=test.ibm.com;PORT=50000;UID=db2user;PWD=db2pwd”

db2cli validate -connstring “DATABASE=SAMPLE;HOSTNAME=test.ibm.com;PORT=50000;AutoCommit=1;CurrentSchema=OWNER1” -connect -user db2user -passwd db2pwd

db2cli validate -connstring “DATABASE=SAMPLE;HOSTNAME=test.ibm.com;PORT=50000;UID=db2user;PWD=db2pwd;Protocol=TCPIP;Security=SSL;SSLServerCertificate=C:\myservercert.arm”