ADMIN_GET_INTRA_PARALLEL スカラー関数 - パーティション内並列処理の状態の取得

ADMIN_GET_INTRA_PARALLEL スカラー関数は、 アプリケーションのパーティション内並列処理の現在の状態を戻します。

この関数を使用して、現行ステートメントが並列化照会アクセス・プランで実行されているかどうかを検査できます。

構文

構文図を読む構文図をスキップするADMIN_GET_INTRA_PARALLEL()

スキーマは SYSPROC です。

許可

このルーチンを実行するには、以下のいずれかの権限が必要です。
  • ルーチンに対する EXECUTE 特権
  • DATAACCESS 権限
  • DBADM 権限
  • SQLADM 権限

デフォルトの PUBLIC 特権

なし

戻される情報

この関数は、データベース・アプリケーションのパーティション内並列処理の現在の状態を指定する、タイプ VARCHAR(3) の値を返します。以下のいずれかの値が返されます。
YES
データベース・アプリケーションは、パーティション内並列処理が有効な状態で実行されます。
NO
データベース・アプリケーションは、パーティション内並列処理が無効な状態で実行されます。

使用上の注意

以下のケースでは、ADMIN_GET_INTRA_PARALLEL によって戻される値が ADMIN_SET_INTRA_PARALLEL で設定された状態と異なる場合があります。
  • トランザクション中に ADMIN_SET_INTRA_PARALLEL が呼び出され、そのトランザクションがまだコミット/ロールバックされていない。
  • WITH HOLD カーソルを開くトランザクション中に ADMIN_SET_INTRA_PARALLEL が呼び出されて、現行トランザクションがそのカーソルをまだ閉じていない。
  • ADMIN_SET_INTRA_PARALLEL 呼び出しにより指定される値とは異なる MAX DEGREE ワークロード属性値が適用されたデータベース・ワークロードに、アプリケーションが関連付けられている。

例

CLP からパーティション内並列処理の現在の状態を検出します。

VALUES SYSPROC.ADMIN_GET_INTRA_PARALLEL

1  
---
NO 

  1 record(s) selected.