スキーマ：

ACCOUNT_USAGE

TABLE_PRUNING_HISTORY ビュー

このAccount Usageビューを使用して、すべてのテーブルに対する排除の効率性を判断したり、テーブルのデフォルトの(自然な)データ並び替えが排除にどのように影響するかを理解したりできます。

排除されたパーティションの数 (PARTITIONS_PRUNED) と、スキャンおよび排除されたパーティションの合計数 (PARTITIONS_SCANNED + PARTITIONS_PRUNED) を比較できます。

このビューの各行は、指定された時間間隔内の特定のテーブルのプルーニング履歴を表します。データは時間間隔ごとに集計され、スキャン数、スキャンされたパーティション数、プルーニングされたパーティション数、スキャンされた行数、プルーニングされた行数に関する情報が含まれます。

またこのビューを使用して、テーブルの 自動クラスタリング および 検索の最適化 を有効化する前と後の排除の効果を比較できます。

TABLE_QUERY_PRUNING_HISTORY ビュー および COLUMN_QUERY_PRUNING_HISTORY ビュー もご参照ください。

列

列名

データ型

説明

START_TIME

TIMESTAMP_LTZ

クエリが実行され、完了した時間範囲の開始時刻（時間単位）。

END_TIME

TIMESTAMP_LTZ

クエリが実行され、完了した時間範囲の終了時刻（時間単位）。

TABLE_ID

NUMBER

クエリされたテーブルの内部/システム生成識別子。

TABLE_NAME

VARCHAR

クエリされたテーブルの名前。

SCHEMA_ID

NUMBER

クエリされたテーブルを含むスキーマの内部/システム生成識別子。

SCHEMA_NAME

VARCHAR

クエリされたテーブルを含むスキーマの名前。

DATABASE_ID

NUMBER

クエリされたテーブルを含むデータベースの内部/システム生成識別子。

DATABASE_NAME

VARCHAR

クエリされたテーブルを含むデータベースの名前。

NUM_SCANS

NUMBER

テーブルの START_TIME から END_TIME の期間の全クエリ(SELECT ステートメントや DML ステートメントを含む)からのスキャン操作の数。クエリによっては、同じテーブルに対してスキャン操作が複数回行われる場合があります。

PARTITIONS_SCANNED

NUMBER

NUM_SCANS に記述されているスキャン処理中にスキャンされたパーティションの数。

PARTITIONS_PRUNED

NUMBER

NUM_SCANS で説明されているクエリに対してプルーニングされたパーティションの数。これらのパーティションはクエリ処理中に削除され、クエリの効率が向上しました。

ROWS_SCANNED

NUMBER

NUM_SCANS に記述されているスキャン処理中にスキャンされた行の数。

ROWS_PRUNED

NUMBER

NUM_SCANS で説明されているクエリに対してプルーニングされた行の数。これらの行はクエリ処理中に削除され、クエリの効率が向上しました。

使用上の注意

  • ビューの待機時間は最大6時間です。

  • このビューには、 ハイブリッドテーブル の排除情報は含まれません。

  • このビューには、クエリごとに実行時間の長い上位1,000件のテーブルスキャンのデータが保持されます。非常に複雑なクエリだけがこのスキャン数を超えるため、データが省略されることはほとんどありません。

例

過去7日以内に排除の効率が最も低かったテーブルの上位5つを表示します。

SELECT table_id, ANY_VALUE(table_name) AS table_name, SUM(num_scans) AS total_num_scans, SUM(partitions_scanned) AS total_partitions_scanned, SUM(partitions_pruned) AS total_partitions_pruned, SUM(rows_scanned) AS total_rows_scanned, SUM(rows_pruned) AS total_rows_pruned FROM SNOWFLAKE.ACCOUNT_USAGE.TABLE_PRUNING_HISTORY WHERE start_time >= DATEADD(day, -7, CURRENT_TIMESTAMP()) GROUP BY table_id ORDER BY total_partitions_pruned / GREATEST(total_partitions_scanned + total_partitions_pruned, 1), total_partitions_scanned DESC LIMIT 5;
Copy
+----------+----------------+-----------------+--------------------------+-------------------------+--------------------+-------------------+ | TABLE_ID | TABLE_NAME | TOTAL_NUM_SCANS | TOTAL_PARTITIONS_SCANNED | TOTAL_PARTITIONS_PRUNED | TOTAL_ROWS_SCANNED | TOTAL_ROWS_PRUNED | |----------+----------------+-----------------+--------------------------+-------------------------+--------------------+-------------------| | 308226 | SENSOR_DATA_TS | 11 | 21 | 1 | 52500000 | 2500000 | | 185364 | MATCH | 16 | 14 | 2 | 240968 | 34424 | | 209932 | ORDER_HEADER | 2 | 300 | 56 | 421051748 | 75350790 | | 209922 | K7_T1 | 261 | 261 | 52 | 30421 | 3272 | | 338948 | SENSOR_DATA_TS | 9 | 15 | 3 | 38880000 | 8035200 | +----------+----------------+-----------------+--------------------------+-------------------------+--------------------+-------------------+

上の例では GREATEST を使用して、スキャンされたパーティションの合計数と、排除されたパーティションの数がゼロの場合に、ゼロ除算が起きることを防いでいます。

言語: 日本語