View a markdown version of this page

SQL ステートメントに関するメタデータの記述を取得する - Amazon Redshift

Amazon Redshift は、2026 年 6 月 30 日以降、Python UDF の使用をサポートしなくなります。これは段階的に実施されます。Python のサポート終了と移行オプションの詳細については、2025 年 6 月 30 日に公開されたブログ記事を参照してください。

SQL ステートメントに関するメタデータの記述を取得する

SQL ステートメントのメタデータの記述を取得するには、aws redshift-data describe-statement AWS CLI コマンドを使用します。このコマンドを使用して、サブステートメント ID を指定してバッチ内の個々のサブステートメントを記述することもできます。このコマンドの実行の承認は、呼び出し元の IAM アクセス許可に基づいています。

必要に応じて、ポーリングリクエストの数を減らすには、WaitTimeSeconds パラメータを使用して、この API コール内でオペレーションのステータスが更新されるまでの追加の時間を確保します。詳細については、「ロングポーリングによる API コールの削減」を参照してください。

次の AWS CLI コマンドは、SQL ステートメントを記述します。


aws redshift-data describe-statement 
    --id d9b6c0c9-0747-4bf4-b142-e8883122f766

次は、レスポンスの例です。

{
    "ClusterIdentifier": "mycluster-test",
    "CreatedAt": 1598306924.632,
    "Duration": 1095981511,
    "Id": "d9b6c0c9-0747-4bf4-b142-e8883122f766",
    "QueryString": "select * from stl_query limit 1",
    "RedshiftPid": 20859,
    "RedshiftQueryId": 48879,
    "ResultRows": 1,
    "ResultSize": 4489,
    "Status": "FINISHED",
    "UpdatedAt": 1598306926.667
}

次に、複数の SQL ステートメントで batch-execute-statement コマンドを実行した後の describe-statement レスポンスの例を示します。

{
    "ClusterIdentifier": "mayo",
    "CreatedAt": 1623979777.126,
    "Duration": 6591877,
    "HasResultSet": true,
    "Id": "b2906c76-fa6e-4cdf-8c5f-4de1ff9b7652",
    "RedshiftPid": 31459,
    "RedshiftQueryId": 0,
    "ResultRows": 2,
    "ResultSize": 22,
    "Status": "FINISHED",
    "SubStatements": [
        {
            "CreatedAt": 1623979777.274,
            "Duration": 3396637,
            "HasResultSet": true,
            "Id": "b2906c76-fa6e-4cdf-8c5f-4de1ff9b7652:1",
            "QueryString": "select 1;",
            "RedshiftQueryId": -1,
            "ResultRows": 1,
            "ResultSize": 11,
            "Status": "FINISHED",
            "UpdatedAt": 1623979777.903
        },
        {
            "CreatedAt": 1623979777.274,
            "Duration": 3195240,
            "HasResultSet": true,
            "Id": "b2906c76-fa6e-4cdf-8c5f-4de1ff9b7652:2",
            "QueryString": "select 2;",
            "RedshiftQueryId": -1,
            "ResultRows": 1,
            "ResultSize": 11,
            "Status": "FINISHED",
            "UpdatedAt": 1623979778.076
        }
    ],
    "UpdatedAt": 1623979778.183
}

次の AWS CLI コマンドは、サブステートメント ID を指定して、バッチ内の特定のサブステートメントを記述します。


aws redshift-data describe-statement
    --id b2906c76-fa6e-4cdf-8c5f-4de1ff9b7652:2

次は、レスポンスの例です。バッチがまだ完了していないため、親ステートメントのステータスは STARTED です。SubStatements 配列には、リクエストされたサブステートメントのみが含まれます。

{
    "ClusterIdentifier": "mayo",
    "CreatedAt": 1623979777.126,
    "Duration": 0,
    "HasResultSet": false,
    "Id": "b2906c76-fa6e-4cdf-8c5f-4de1ff9b7652",
    "RedshiftPid": 31459,
    "RedshiftQueryId": 0,
    "Status": "STARTED",
    "SubStatements": [
        {
            "CreatedAt": 1623979777.274,
            "Duration": 3195240,
            "HasResultSet": true,
            "Id": "b2906c76-fa6e-4cdf-8c5f-4de1ff9b7652:2",
            "QueryString": "select 2;",
            "RedshiftQueryId": -1,
            "ResultRows": 1,
            "ResultSize": 11,
            "Status": "FINISHED",
            "UpdatedAt": 1623979778.076
        }
    ],
    "UpdatedAt": 1623979777.503
}