メインコンテンツまでスキップ
に最終更新

ANALYZE

説明​

このステートメントは、列の統計情報を収集するために使用します。テーブル(特定の列を指定可能)またはデータベース全体の列統計情報を収集できます。

構文​

ANALYZE {TABLE <table_name> [ (<column_name> [, ...]) ] | DATABASE <database_name>}
[ [ WITH SYNC ] [ WITH SAMPLE {PERCENT | ROWS} <sample_rate> ] ];

必須パラメータ​

1. <table_name>

指定した対象テーブル。このパラメータと <database_name> パラメータは、いずれか一方のみを指定する必要があります。

2. <database_name>

指定した対象データベース。このパラメータと <table_name> パラメータは、いずれか一方のみを指定する必要があります。

オプションパラメータ​

1. <column_name>

指定した対象列。table_name に存在する列である必要があります。複数の列名をカンマ区切りで指定できます。

2. WITH SYNC

統計情報を同期的に収集します。収集が完了すると戻ります。指定しない場合は非同期で実行されます。

3. WITH SAMPLE {PERCENT | ROWS} <sample_rate>

収集にサンプリング方式を使用するよう指定します。指定しない場合、デフォルトは全量収集です。<sample_rate> はサンプリングパラメータです。PERCENT サンプリングではサンプリング率を、ROWS サンプリングではサンプリングする行数を指定します。

戻り値​

列注記
Job_Id一意のジョブ ID
Catalog_NameCatalog 名
DB_Nameデータベース名
Columns列名の一覧

アクセス制御要件​

この SQL を実行するユーザーには、少なくとも次の権限が必要です。

権限オブジェクト注記
SELECT_PRIVテーブルANALYZE の実行時には、クエリ対象テーブルに対する SELECT_PRIV 権限が必要です。

例​

  1. lineitem テーブルから 10% をサンプリングして統計情報を収集します。
ANALYZE TABLE lineitem WITH SAMPLE PERCENT 10;
  1. lineitem テーブルから 100,000 行をサンプリングして統計情報を収集します。
ANALYZE TABLE lineitem WITH SAMPLE ROWS 100000;