QUERY_HISTORY ビュー(Account Usage): 列への変更および新しい列(保留中)¶
QUERY_HISTORY ビュー には、以下の 新しい列 と 列への変更 が含まれます。
QUERY_HISTORY ビューの新しい列¶
この動作変更バンドルを有効にすると、Account Usage QUERY_HISTORY ビューに以下の新しい列が追加されます。
列名 |
データ型 |
説明 |
---|---|---|
SECONDARY_ROLE_STATS |
VARCHAR |
クエリで評価されたセカンダリロールに関する3つのフィールドを含む JSON 形式の文字列: セッションに応じてセカンダリロールのリストまたは |
ROWS_WRITTEN_TO_RESULT |
NUMBER |
結果オブジェクトに書き込まれる行数。CREATE TABLE AS SELECT (CTAS)とすべての DML 操作については、この結果は 詳細については、 ROWS_PRODUCED の廃止 をご参照ください |
ROWS_INSERTED |
NUMBER |
クエリによって挿入された行の数。 |
QUERY_RETRY_TIME |
NUMBER |
アクション可能なエラーによるクエリ再試行の実行合計時間(ミリ秒)。詳細については、 クエリ再試行列 をご参照ください。 |
QUERY_RETRY_CAUSE |
VARIANT |
アクション可能なエラーのエラーメッセージの配列。この配列には、クエリの再試行ごとに1つのエラーメッセージが格納されます。クエリの再試行がない場合、配列は空です。詳細については、 クエリ再試行列 をご参照ください。 |
FAULT_HANDLING_TIME |
NUMBER |
アクション 不可能 なエラーによるクエリ再試行の実行合計時間(ミリ秒)。詳細については、 クエリ再試行列 をご参照ください。 |
これらの列は、ビューの最後(一番右側)の列として追加されます。
詳細については、 Information Schema: QUERY_HISTORY、 QUERY_HISTORY_BY_* 関数の出力に新しい列(保留中) もご参照ください。
クエリ再試行列¶
クエリが正常に完了するためには、1回または複数回の再試行が必要な場合があります。クエリが再試行される原因には複数が考えられます。これらの原因の中には、 アクション可能 なものがあります。つまり、ユーザーは、特定のクエリについてクエリを変更して再試行を減らす、または排除することができます。たとえば、メモリ不足のエラーによってクエリが再試行された場合、ウェアハウスの設定を変更すると問題が解決する可能性があります。
クエリの再試行には、アクション不可能なフォールトトレランスが原因のものもあります。つまり、クエリの再試行を防ぐためにユーザーができる変更はありません。たとえば、ネットワークが停止した場合には、クエリが再試行される可能性があります。この場合、クエリやそれを実行するウェアハウスに変更はなく、クエリの再試行を防ぐことができます。
QUERY_RETRY_TIME、 QUERY_RETRY_CAUSE、 FAULT_HANDLING_TIME 列は、再試行されるクエリを最適化し、クエリパフォーマンスの変動をより良く理解するのに役立ちます。
ROWS_PRODUCED の廃止¶
ROWS_PRODUCED 列は、将来のリリースで廃止される予定です。ROWS_PRODUCED 列の値は、クエリによって影響を受ける論理的な行数を反映しているとは限りません。たとえば、 ROWS_PRODUCED 列の値には、マイクロパーティションの書き換えによって削除された行が含まれる可能性があり、影響を受けた実際の行数よりも大きくなる場合があります。Snowflakeは、代わりに ROWS_INSERTED、 ROWS_UPDATED、 ROWS_WRITTEN_TO RESULTS、または ROWS_DELETED 列を使用することを推奨します。
QUERY_HISTORY ビューの列への変更¶
以下の列がAccount Usage QUERY_HISTORY ビュー に含まれます。
BYTES_WRITTEN_TO_RESULT
ROWS_INSERTED
特定の型のクエリに対するこれらの列の値は以下のとおりです。
- 変更前:
BYTES_WRITTEN_TO_RESULT
0
は小規模クエリ向け。ROWS_INSERTED:
0
は CREATE TABLE AS SELECT (CTAS)クエリ向け。- 変更後:
BYTES_WRITTEN_TO_RESULT
小規模クエリの結果オブジェクトに書き込まれるバイト数。
ROWS_INSERTED:
CREATE TABLE AS SELECT (CTAS)に挿入された行数。
詳細については、 Information Schema: QUERY_HISTORY、 QUERY_HISTORY_BY_* 関数の出力に新しい列(保留中) もご参照ください。
参照: 1431、1524、1540