DB2_MEMBER および DB2_CF 管理ビューと DB2_GET_INSTANCE_INFO 表関数
DB2_MEMBER および DB2_CF 管理ビューと DB2_GET_INSTANCE_INFO 表関数は、単一パーティション・インスタンスと複数パーティション・インスタンスのデータベース・ メンバー 、および Db2® pureScale® インスタンスの メンバー と CF に関する情報 (該当する場合) を返します。
DB2_MEMBER および DB2_CF 管理ビュー
DB2_MEMBER 管理ビューは、 メンバー が現在実行されているマシン名、その状態、アラートが存在するかどうか、および内部データベース通信の高速相互接続の名前などの情報を戻します。
DB2_CF 管理ビューは、 クラスター・キャッシング・ファシリティー (CF とも呼ばれる) について同様の情報を戻します。
スキーマは SYSIBMADM です。
戻される可能性のある情報の完全なリストについては、 戻される情報 の表を参照してください。
許可
- 管理ビューに対する SELECT 特権
- 管理ビューに対する CONTROL 特権
- DATAACCESS 権限
- DBADM 権限
- SQLADM 権限
- ACCESSCTRL 権限
- SECADM 権限
例
- Db2 pureScale インスタンス
- 高可用性災害時リカバリー (HADR) フィーチャーを使用するパーティションまたは非パーティション・データベース・インスタンス。
SELECT * FROM SYSIBMADM.DB2_MEMBERID HOME_HOST CURRENT_HOST STATE ALERT
------ --------- ------------ ---------- -----
0 so1 so1 STARTED NO
2 so2 so2 STARTED NO
4 so3 so3 STARTED NO
3 record(s) selected.以下の例では、 DB2_CF 管理ビューを使用して、データベース・インスタンス内のすべての CF の状況を表示します。 これは、 Db2 pureScale インスタンスにのみ適しています。
SELECT * FROM SYSIBMADM.DB2_CFID CURRENT_HOST STATE ALERT
------ ------------ ---------- -----
128 so5 PRIMARY NO
129 so6 PEER NO
2 record(s) selected.DB2_GET_INSTANCE_INFO 表関数
DB2_GET_INSTANCE_INFO 表関数は DB2_MEMBER および DB2_CF 管理ビューと同じ情報を戻しますが、現行ホストなどの入力パラメーターを渡すことにより、戻される情報をフィルターに掛けることが可能です。 現行ホストは、 メンバー が現在実行されているホストです。
構文
スキーマは SYSPROC です。
表関数パラメーター
- id
- 有効な メンバー または クラスター・キャッシング・ファシリティー ID を指定する、タイプ INTEGER のオプション入力引数。 入力に一致するすべてのデータベース・ メンバー または クラスター・キャッシング・ファシリティー の項目が返されます。 このパラメーターが NULL または -2 である場合、すべてのレコードが戻されます。 このパラメーターが -1 の場合、現在接続されている メンバー の情報が戻されます。
- ホーム・ホスト
- レコードが戻される対象のホーム・ホスト を指定する、タイプ VARCHAR(255) のオプション入力引数。 ホーム・ホストは、 メンバー の作成時に特定の メンバー に関連付けられた元のホスト名です。 home_host 引数には短形式のホスト名を使用します (IP アドレスは使用しないでください)。 このパラメーターが NULL または空ストリングである場合、すべてのレコードが戻されます。
- ホスト (current_host)
- レコードが戻される対象の現行ホストを指定する、タイプ VARCHAR(255) のオプション入力引数。 現行ホストは、 メンバー が現在実行されているホストです。これは、restart light 操作の一環として別のホストで メンバー を開始する必要があった場合など、ホーム・ホストとは異なる可能性があります。 current_host 引数には短形式のホスト名を使用します (IP アドレスは使用しないでください)。
- タイプ
- メンバー または クラスター・キャッシング・ファシリティーの情報を取得するかどうかを指定する、タイプ VARCHAR (32) のオプション入力引数。 可能な値は次のとおりです。
- CF-現在の Db2 pureScale インスタンスの クラスター・キャッシング・ファシリティー のすべてのレコードを返します。
- MEMBER-現行データベース・インスタンス内の メンバー のすべてのレコードを戻します。
- 「db_partition_num」
- 有効なデータベース・パーティション番号を指定する、タイプ INTEGER のオプション入力引数。 入力に一致するすべてのデータベース・パーティション番号についての情報が戻されます。 このパラメーターが NULL または -2 である場合、すべてのレコードが戻されます。 このパラメーターが -1 の場合、現在接続されている メンバー の情報が戻されます。 Db2 pureScale インスタンスの場合、有効な入力は 0 または NULL のみです。その他のすべての入力値はデータを返しません。
許可
DB2_GET_INSTANCE_INFO 表関数に対する EXECUTE 特権。
デフォルトの PUBLIC 特権
なし
例
SELECT * FROM TABLE(DB2_GET_INSTANCE_INFO(null,'','','',null)) as T ID HOME_HOST CURRENT_HOST TYPE STATE ALERT DB_P..._NUM LOGICAL_PORT NETNAME
--- --------- ------------ ------ ---------- ----- ----------- ------------ -------
0 so1 so1 MEMBER STARTED NO 0 0 so1-ib0
1 so2 so1 MEMBER RESTARTING NO 0 0 so2-ib0
2 so3 so3 MEMBER STARTED NO 0 0 so3-ib0
3 so4 so4 MEMBER STARTED NO 0 0 so4-ib0
128 so5 so5 CF PRIMARY NO - 0 so5-ib0
129 so6 so6 CF PEER NO - 0 so6-ib0
6 record(s) selected.SELECT * FROM TABLE(DB2_GET_INSTANCE_INFO(null,'','','',null)) as T ID HOME_HOST CURRENT_HOST TYPE STATE ALERT DB_PARTITION_NUM LOGICAL_PORT NETNAME
-- --------- ------------ ------ ------- ----- ---------------- ------------ -----
0 so1 so1 MEMBER STARTED NO 0 0 so1-ib0
2 so2 so2 MEMBER STARTED NO 2 0 so2-ib0
4 so3 so3 MEMBER STARTED NO 4 0 so3-ib0
7 so4 so4 MEMBER STARTED NO 7 0 so4-ib0
4 record(s) selected.戻される情報
| 列名 | データ・タイプ | 説明 |
|---|---|---|
| ID | SMALLINT | id-クラスター・キャッシング・ファシリティー ID: モニター・エレメント |
| HOME_HOST | VARCHAR(255) | 最初にインスタンスに追加されたときに メンバー に関連付けられていたマシン。 |
| CURRENT_HOST | VARCHAR(255) | メンバー が現在実行されているマシンの名前。 |
| STATE | VARCHAR(32) | メンバー または クラスター・キャッシング・ファシリティーの状態。 メンバー の潜在的な状態は、STARTED、STOPPED、RESTARTING、WAITING_FOR_FAILBACK、ERROR、および UNKNOWN です。 クラスター・キャッシング・ファシリティー の状態には、STOPPED、RESTARTING、ING_PRIMARY、PRIMARY、CATCHUP1、PEER、ERROR、および UNKNOWN があります。 メンバー または クラスター・キャッシング・ファシリティー の NULL 状態は、その状態が適用外であることを示します。 例えば、パーティション・データベース環境の場合などです。 詳しくは、 メンバーおよびクラスター・キャッシング・ファシリティーの状態およびアラートの値 を参照してください。 |
| ALERT | VARCHAR(8) | インスタンスに関するアラートの情報。
アラートについての詳細情報を取得するには、DB2_INSTANCE_ALERTS 管理ビューを使用します。 |
| 列名 | データ・タイプ | 説明 |
|---|---|---|
| ID | SMALLINT | id-クラスター・キャッシング・ファシリティー ID: モニター・エレメント |
| CURRENT_HOST | VARCHAR(255) | メンバー が現在実行されているマシンの名前。 |
| STATE | VARCHAR(32) | メンバー または クラスター・キャッシング・ファシリティーの状態。 メンバー の潜在的な状態は、STARTED、STOPPED、RESTARTING、WAITING_FOR_FAILBACK、ERROR、および UNKNOWN です。 クラスター・キャッシング・ファシリティー の状態には、STOPPED、RESTARTING、ING_PRIMARY、PRIMARY、CATCHUP1、PEER、ERROR、および UNKNOWN があります。 メンバー または クラスター・キャッシング・ファシリティー の NULL 状態は、その状態が適用外であることを示します。 例えば、パーティション・データベース環境の場合などです。 詳しくは、 メンバーおよびクラスター・キャッシング・ファシリティーの状態およびアラートの値 を参照してください。 |
| ALERT | VARCHAR(8) | インスタンスに関するアラートの情報。
アラートについての詳細情報を取得するには、DB2_INSTANCE_ALERTS 管理ビューを使用します。 |
| 列名 | データ・タイプ | 説明 |
|---|---|---|
| ID | SMALLINT | id-クラスター・キャッシング・ファシリティー ID: モニター・エレメント |
| HOME_HOST | VARCHAR(255) | 最初にインスタンスに追加されたときに メンバー に関連付けられていたマシン。 |
| CURRENT_HOST | VARCHAR(255) | メンバー が現在実行されているマシンの名前。 |
| TYPE | VARCHAR(32) | 「MEMBER」または「CF」のどちらか。 |
| STATE | VARCHAR(32) | メンバー または クラスター・キャッシング・ファシリティーの状態。 メンバー の潜在的な状態は、STARTED、STOPPED、RESTARTING、WAITING_FOR_FAILBACK、ERROR、および UNKNOWN です。 クラスター・キャッシング・ファシリティー の状態には、STOPPED、RESTARTING、ING_PRIMARY、PRIMARY、CATCHUP1、PEER、ERROR、および UNKNOWN があります。 メンバー または クラスター・キャッシング・ファシリティー の NULL 状態は、その状態が適用外であることを示します。 例えば、パーティション・データベース環境の場合などです。 詳しくは、 メンバーおよびクラスター・キャッシング・ファシリティーの状態およびアラートの値 を参照してください。 |
| ALERT | VARCHAR(8) | インスタンスに関するアラートの情報。
アラートについての詳細情報を取得するには、DB2_INSTANCE_ALERTS 管理ビューを使用します。 |
| DB_PARTITION_NUM | SMALLINT | この メンバーのデータベース・パーティション番号。 |
| LOGICAL_PORT | SMALLINT | メンバー または クラスター・キャッシング・ファシリティーの論理ポート番号。 |
| NETNAME | VARCHAR(255) | 内部データベース通信用の高速相互接続の名前。 |
- CATCHUP の場合、戻される状態の一部としてパーセンテージ値が含まれます。 このパーセンテージ値は、2 次クラスター・キャッシング・ファシリティーが 1 次キャッシング・ファシリティーの現在の状態にキャッチアップした量を表します。