システムカタログのクエリの実行 - Amazon Quantum Ledger Database (Amazon QLDB)

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

重要

サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了まで Amazon QLDB を使用できます。詳細については、「Amazon QLDB 台帳を Amazon Aurora PostgreSQL に移行する」を参照してください。

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 ステートメントを使用してテーブルを管理する方法については、テーブルの管理 に進みます。