QUERY_HISTORY ビュー(Account Usage): 列への変更および新しい列(保留中)

注意

この動作変更は2024_02バンドルにあります。

バンドルの現在のステータスについては、 バンドル履歴 をご参照ください。

QUERY_HISTORY ビュー には、以下の 新しい列列への変更 が含まれます。

QUERY_HISTORY ビューの新しい列

この動作変更バンドルを有効にすると、Account Usage QUERY_HISTORY ビューに以下の新しい列が追加されます。

列名

データ型

説明

SECONDARY_ROLE_STATS

VARCHAR

クエリで評価されたセカンダリロールに関する3つのフィールドを含む JSON 形式の文字列: セッションに応じてセカンダリロールのリストまたは ALL、セカンダリロールの数のカウント、および各セカンダリロールの内部/システム生成 ID。IDs のカウントと数は最大で50です。

ROWS_WRITTEN_TO_RESULT

NUMBER

結果オブジェクトに書き込まれる行数。CREATE TABLE AS SELECT (CTAS)とすべての DML 操作については、この結果は 1 です。ROWS_INSERTED、 ROWS_UPDATED、また ROWS_DELETED 列の値は、実際に挿入、更新、削除された行の数を反映しています。

詳細については、 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