QUIESCE DATABASE コマンド (ADMIN_CMD プロシージャーを使用)

指定したデータベースからすべてのユーザーを強制的に切断して、静止モードにします。

データベースが静止モードにある間、それに対して管理タスクを実行できます。 管理タスクの完了後、UNQUIESCE コマンドを使用してデータベースをアクティブ化して、シャットダウンしたり他のデータベースの開始を実行したりすることなく、他のユーザーがデータベースに接続できるようにします。

このモードでは、この制限モード中に権限を持つユーザーだけがデータベースに接続することができます。 SYSADM および DBADM 権限を持つユーザーは、データベースの静止中に常にそのデータベースにアクセスできます。

有効範囲

QUIESCE DATABASE を使用すると、データベース内のすべてのオブジェクトは静止モードに入ります。 許可が与えられたユーザー/グループ、 および SYSADM、SYSMAINT、DBADM、または SYSCTRL だけが、 データベースまたはそのオブジェクトにアクセスできます。

データベースが SUSPEND_WRITE 状態の場合、そのデータベースを静止モードにはできません。

許可

以下の権限のいずれか。

データベース・レベルの静止の場合:
  • SYSADM
  • DBADM

必要な接続

データベース

コマンド構文

構文図を読む構文図をスキップするQUIESCE DATABASEDB IMMEDIATEDEFERWITH TIMEOUTminutesFORCE CONNECTIONS

コマンド・パラメーター

DEFER
QUISCE の実行をアプリケーションが現行の作業単位をコミットするまで待ちます。
WITH TIMEOUT minutes
アプリケーションが現在の作業単位をコミットするのを待機する時間を分単位で指定します。 値を指定しない場合、 単一パーティション・データベース環境では、 デフォルト値が 10 分になります。 パーティション・データベース環境では、データベース・マネージャー構成パラメーター start_stop_time によって指定された値が使用されます。
IMMEDIATE
トランザクションがコミットされるのを待たず、 即時にトランザクションをロールバックします。
FORCE CONNECTIONS
接続を強制的にオフにします。
DATABASE
データベースを静止します。データベース内のすべてのオブジェクトを静止モードにします。 指定したグループのユーザーと、 SYSADM、SYSMAINT、および SYSCTRL 権限を持つユーザーだけが、 データベースまたはそのオブジェクトにアクセスすることができます。

例

データベースと接続しているすべてのユーザーを強制的に切断します。
CALL SYSPROC.ADMIN_CMD( 'quiesce db immediate' )
  • このコマンドとともに FORCE CONNECTIONS オプションを指定すると、データベースからすべてのユーザーを強制的に切断します。 FORCE CONNECTIONS はデフォルトの動作です。 コマンドのパラメーターは、互換性の理由により許容されています。
  • コマンドは FORCE CONNECTIONS と同期され、FORCE CONNECTIONS が完了しないと完了しません。

使用上の注意

  • QUIESCE DATABASE の後、SYSADM、 SYSMAINT、SYSCTRL、または DBADM 権限、および GRANT または REVOKE 特権を持つユーザーは、接続可能なユーザーを指定できます。この情報は永続的にデータベース・カタログ表に保管されます。

    以下に例を示します。

    grant quiesce_connect on database to username/groupname
revoke quiesce_connect on database from username/groupname
  • コマンドの実行状況は、CALL ステートメントからの結果である SQLCA で戻されます。
  • Db2® pureScale® 環境では、データベースの静止およびインスタンスの再始動の後、データベースはすべてのメンバーにわたり静止状態のままになります。 静止状態を解除するには、明示的な UNQUIESCE DATABASE コマンド呼び出しが必要です。
  • Db2 pureScale 環境では、インスタンスの静止および再始動の後、インスタンスはすべてのメンバーにわたり静止状態のままになります。静止状態を解除するには、明示的な UNQUIESCE INSTANCE コマンド呼び出しが必要です。