CONNECT (タイプ 2) ステートメント

呼び出し

対話式 SQL 機能には外見上対話式の実行に見えるインターフェースが用意されている場合がありますが、 このステートメントはアプリケーション・プログラムに組み込むことだけが可能です。 これは、動的に作成できない実行可能ステートメントです。 コマンド行プロセッサーを使用して呼び出した場合は、追加オプションを指定できます。

詳しくは、 コマンド行 SQL ステートメントおよび XQuery ステートメントの使用 を参照してください。

許可

CONNECT 処理は 2 レベルのアクセス制御を経ます。 接続を成功させるには、両方のレベルで条件を満たす必要があります。

構文

タイプ 1 とタイプ 2 のどちらを選択するかは、プリコンパイラー・オプションによって決められます。 これらのオプションの概要については、 分散リレーショナル・データベースへの接続を参照してください。

authorization

passwords

accesstoken

lock-block

Notes:

• ¹ This form is only valid if implicit connect is enabled.
• ² This feature is available starting from Db2 Version 11.5 Mod Pack 4.
• ³ This feature is available starting from Db2 Version 11.5 Mod Pack 4.
• ⁴ This feature is available starting from Db2 Version 11.5 Mod Pack 4.

説明

TO server-name/host-variable

サーバーの名前のコーディング規則は、タイプ 1 と同じです。

SQLRULES(STD) オプションが有効な場合、server-name は、 アプリケーション・プロセスの既存の接続を指定するものであってはなりません。 そのように指定すると、エラー (SQLSTATE 08002) になります。

SQLRULES(Db2) オプションが有効で、 server-name がアプリケーション・プロセスの既存の接続を指定している場合、 その接続が現行接続になり、古い接続は休止状態になります。 つまり、この状況での CONNECT ステートメントの効果は、 SET CONNECTION ステートメントの効果と同じです。

SQLRULES の指定の詳細に関しては、分散作業単位のセマンティクスを制御するオプションを参照してください。

正常に接続された場合

CONNECT ステートメントが正常に実行された場合、

• アプリケーション・サーバーとの接続は作成されるか、 または休止でない状態になり、現行接続かつ保留状態になります。
• CONNECT TO が現行サーバー以外のサーバーに出されると、 現行の接続は休止状態になります。
• CURRENT SERVER 特殊レジスターと SQLCA は、CONNECT (タイプ 1) の場合と同じ方法で更新されます。

正常に接続されなかった場合

CONNECT ステートメントが正常に実行されなかった場合、

• エラーの理由に関係なく、 アプリケーション・プロセスの接続状態とその接続の状態は変更されません。
• 失敗したタイプ 1 の CONNECT の場合と同様に、SQLCA の SQLERRP フィールドは、 エラーを検出したアプリケーション・リクエスターまたはサーバーのモジュール名に設定されます。

CONNECT (オペランドなし)、IN SHARE/EXCLUSIVE MODE、USER、および USING

接続が存在する場合、タイプ 2 はタイプ 1 と同様に動作します。 許可 ID とデータベース別名は、SQLCA の SQLERRMC フィールドに入れられます。 接続が存在しない場合、暗黙接続の試みは行われず、 SQLERRP および SQLERRMC の各フィールドはブランクを戻します。 (アプリケーションでは、これらのフィールドを調べることによって、 現行接続が存在しているか否かの検査を行うことができます。)

USER と USING を含むオペランドのない CONNECT は、DB2DBDFT 環境変数を使用することによって、 アプリケーション・プロセスをデータベースに接続することができます。 この方法は、タイプ 2 の CONNECT RESET に相当しますが、 ユーザー ID とパスワードの使用が可能です。

RESET

デフォルトのデータベースが使用可能な場合、 そのデータベースへの明示接続と同等です。 デフォルトのデータベースが使用できない場合、 アプリケーション・プロセスの接続状態とその接続の状態は変更されません。

デフォルトのデータベースが使用可能か否かは、インストール・オプション、環境変数、 および認証設定値によって決まります。

ルール

• 分散作業単位のセマンティクスを制御するオプションに概説されているように、接続管理のセマンティクスは、一連の接続オプションによって制御されます。 すべてのプリプロセス済みソース・ファイルには、デフォルト値が割り当てられます。 1 つのアプリケーションが、 異なるさまざまな接続オプションでプリコンパイルされた複数のソース・ファイルで構成されている場合もあります。

  SET CLIENT コマンドまたは API を最初に実行しない限り、 実行時に実行される最初の SQL ステートメントを含むソース・ファイルのプリプロセスに使用された接続オプションが、 有効な接続オプションになります。

  ソース・ファイルの 1 つの CONNECT ステートメントが、異なる接続オプションで次々にプリプロセスされ、 その合間に SET CLIENT コマンドまたは API を実行することなく実行されると、 エラー (SQLSTATE 08001) が戻されます。 SET CLIENT コマンドまたは API を実行すると、 アプリケーション内のすべてのソース・ファイルをプリプロセスするために使用された接続オプションは無視されます。

  このステートメントの 例 セクションの例 1 は、これらの規則を示しています。

• CONNECT ステートメントを使用して接続を確立したり切り替えたりすることができますが、USER/USING 節を使用した CONNECT は、指定したサーバーとの現行接続や休止接続がない場合にしか受け入れられません。 USER/USING 節によって同じサーバーとの接続を発行するには、その前に接続を解放する必要があります。 そうでない場合、リジェクトされます (SQLSTATE 51022)。 接続を解放するには、DISCONNECT ステートメントまたは RELEASE ステートメントを出し、 次に COMMIT ステートメントを出します。

タイプ 1 とタイプ 2 の CONNECT ステートメントの比較

CONNECT ステートメントのセマンティクスは、CONNECT プリコンパイラー・オプションまたは SET CLIENT API によって決定されます ( 分散作業単位のセマンティクスを制御するオプションを参照してください)。 CONNECT タイプ 1 または CONNECT タイプ 2 は指定することができ、 それらのプログラムの CONNECT ステートメントは、 それぞれタイプ 1 およびタイプ 2 の CONNECT ステートメントと呼ばれます。 それらの意味について、以下の表に説明します。

CONNECTの使用:

使用 接続 ...ユーザー ...USING:

暗黙の CONNECT、CONNECT RESET の使用、 および切断

CONNECT のエラー

注

• 暗黙接続は、タイプ 2 の接続を行うアプリケーションの最初の SQL ステートメントでサポートされます。 SQL ステートメントをデフォルトのデータベースに対して実行するには、 まず CONNECT RESET ステートメントまたは CONNECT USER/USING ステートメントを使用して、 接続を確立する必要があります。 オペランドのない CONNECT ステートメントでは、 現行接続があればそれに関する情報が表示されますが、 現行接続がない場合にはデフォルトのデータベースには接続しません。
• authorization-name SYSTEM を CONNECT ステートメントで明示的に指定することはできません。 ただし、Windows オペレーティング・システムでは、ローカル・システム・アカウントの下で実行されているローカル・アプリケーションは、暗黙的にデータベースに接続して、ユーザー ID が SYSTEM になるようにすることができます。
• Windows Server に明示的に接続する場合、 authorization-name またはユーザー host-variable は、 Microsoft Windows Security Account Manager (SAM) 互換を使用して指定できます。 名前。
• 接続の終了: 接続の終了時に、まだトランザクションがコミットまたはロールバックされていない場合、このようなトランザクションがどうなるかについて詳しくは、『暗黙の CONNECT、CONNECT RESET の使用、および切断』セクションを参照してください。 動作を確実に整合させるには、COMMIT ステートメントまたは ROLLBACK ステートメントを、CONNECT ステートメントの動作に従属させずに明示的にコード化します。
• 代替構文: 以前のバージョンの Db2® および他のデータベース製品との互換性のために、以下がサポートされています。 これらの代替は非標準であり、使用すべきではありません。
  • DB2_ENFORCE_MEMBER_SYNTAX レジストリー変数が ON に設定されている場合を除き、DBPARTITIONNUM または NODE を MEMBER の代わりに指定できます。

例

• 例 1: この例では、複数のソース・プログラム (枠で囲んでいるもの) の使用法を示します。 いくつかは異なる接続オプション (コードの上のステートメント内に示しているもの) を指定してプリプロセスされ、 そのうち 1 つは SET CLIENT API 呼び出しを含んでいます。
  PGM1: CONNECT(2) SQLRULES(DB2) DISCONNECT(CONDITIONAL)

     ...
     exec sql CONNECT TO OTTAWA;
     exec sql SELECT col1 INTO :hv1
     FROM tbl1;
     ...

  PGM2: CONNECT(2) SQLRULES(STD) DISCONNECT(AUTOMATIC)

     ...
     exec sql CONNECT TO QUEBEC;
     exec sql SELECT col1 INTO :hv1
     FROM tbl2;
     ...

  PGM3: CONNECT(2) SQLRULES(STD) DISCONNECT(EXPLICIT)

     ...
     SET CLIENT CONNECT 2  SQLRULES DB2  DISCONNECT EXPLICIT 1
     exec sql CONNECT TO LONDON;
     exec sql SELECT col1 INTO :hv1 
     FROM tbl3;
     ...

  注:

  1. SET CLIENT API の実際の構文ではありません。
  PGM4: CONNECT(2) SQLRULES(DB2) DISCONNECT(CONDITIONAL)

     ...
     exec sql CONNECT TO REGINA;
     exec sql SELECT col1 INTO :hv1 
     FROM tbl4;
     ...

  アプリケーションが PGM1 に続いて PGM2 を実行すると、次のようになります。

  • OTTAWA への接続が実行されます。 connect=2、 sqlrules=DB2、 disconnect=CONDITIONAL
  • QUEBEC への接続はエラー (SQLSTATE 08001) になります。 これは、SQLRULES と DISCONNECT が共に異なっているためです。
  アプリケーションが PGM1 に続いて PGM3 を実行すると、次のようになります。

  • OTTAWA への接続が実行されます。 connect=2、 sqlrules=DB2、 disconnect=CONDITIONAL
  • LONDON への接続が実行されます。 connect=2、 sqlrules=DB2、 disconnect=EXPLICIT

  2 番目の CONNECT ステートメントの前に SET CLIENT API が実行されるため、問題ありません。
  アプリケーションが PGM1 に続いて PGM4 を実行すると、次のようになります。

  • OTTAWA への接続が実行されます。 connect=2、 sqlrules=DB2、 disconnect=CONDITIONAL
  • REGINA への接続が実行されます。 connect=2 sqlrules=DB2、 disconnect=CONDITIONAL

  これは、PGM1 のプリプロセッサー・オプションが PGM4 と同じなので、問題ありません。
• 例 2: この例では、CONNECT (タイプ 2)、SET CONNECTION、RELEASE、 および DISCONNECT の各ステートメントの相互関係を示します。 S0、S1、S2、および S3 は 4 つのサーバーを示します。

  シーケンス	ステートメント	現行サーバー	休止接続	解放ペンディング
  0	ステートメントはない	なし	なし	なし
  1	SELECT * FROM TBLA	S0 (デフォルト値)	なし	なし
  2	CONNECT TO S1 SELECT * FROM TBLB	S1 S1	S0 S0	なし なし
  3	CONNECT TO S2 UPDATE TBLC SET ...	S2 S2	S0, S1 S0, S1	なし なし
  4	CONNECT TO S3 SELECT * FROM TBLD	S3 S3	S0, S1, S2 S0, S1, S2	なし なし
  5	SET CONNECTION S2	S2	S0, S1, S3	なし
  6	RELEASE S3	S2	S0, S1	S3
  7	COMMIT	S2	S0, S1	なし
  8	SELECT * FROM TBLE	S2	S0, S1	なし
  9	DISCONNECT S1 SELECT * FROM TBLF	S2 S2	S0 S0	なし なし

• 例 3: JWT アクセス・トークンを使用して SAMPLE データベースに接続します。

  connect to sample accesstoken <access_token> accesstokentype jwt
  
     Database Connection Information
  
   Database server        = DB2/LINUXX8664 11.5.4.0
   SQL authorization ID   = NEWTON
   Local database alias   = SAMPLE