システムカタログのクエリの実行

Amazon QLDB 台帳で作成する各テーブルには、システムによって割り当てられた一意の ID があります。システムカタログテーブル information_schema.user_tables のクエリを実行することで、テーブルの ID、インデックスのリスト、およびその他のメタデータを見つけることができます。

システムによって割り当てられた ID はすべて汎用一意 ID (UUID、Universally Unique Identifier) であり、それぞれ Base62 エンコード文字列で表されます。詳細については、「Amazon QLDB で割り当てられる一意の ID」を参照してください。

以下の例では、VehicleRegistration テーブルのメタデータ属性を返すクエリの結果を示しています。

SELECT * FROM information_schema.user_tables
WHERE name = 'VehicleRegistration'

{
    tableId: "5PLf9SXwndd63lPaSIa0O6",
    name: "VehicleRegistration",
    indexes: [
        { indexId: "Djg2nt0yIs2GY0T29Kud1z", expr: "[VIN]", status: "ONLINE" },
        { indexId: "4tPW3fUhaVhDinRgKRLhGU", expr: "[LicensePlateNumber]", status: "BUILDING" }
    ],
    status: "ACTIVE"
}

テーブルメタデータフィールド

• tableId: テーブルの一意の ID。

• name: テーブル名。

• indexes: テーブルのインデックスのリスト。

  • indexId: インデックスの一意の ID。

  • expr: インデックス付きドキュメントパス。このフィールドは、[fieldName] 形式の文字列です。

  • status: インデックスの現在のステータス (BUILDING、FINALIZING、ONLINE、FAILED、または DELETING)。QLDB は、ステータスが ONLINE になるまで、クエリのインデックスを使用しません。

  • message: インデックスに FAILED ステータスがある理由を説明するエラーメッセージ。このフィールドは、失敗したインデックスにのみ含まれます。

• status: テーブルの現在のステータス (ACTIVE または INACTIVE)。テーブルは、DROP すると INACTIVE になります。

DROP TABLE および UNDROP TABLE ステートメントを使用してテーブルを管理する方法については、テーブルの管理 に進みます。