自動クラスタリング¶

自動クラスタリングの利点¶

自動クラスタリングのクレジット使用状況とウェアハウス¶

自動クラスタリングはSnowflakeクレジットを消費しますが、仮想ウェアハウスを提供する必要はありません。代わりに、Snowflakeは内部的に管理し、テーブルを再クラスタリングするための効率的なリソース使用率を達成します。

アカウントは、クラスタ化されたテーブルでの自動クラスタリング操作によって消費された実際のクレジットに対してのみ請求されます。

テーブルの自動クラスタリングを有効にする¶

多くの場合、テーブルの自動クラスタリングを有効にするためのタスクは必要ありません。テーブルに クラスタリングキー を定義するだけです。

ただし、このルールは、クラスタリングキーを持つソーステーブルからクローニング（CREATE TABLE ... CLONE ...）によって作成されたテーブルには適用されません。新しいテーブルは、ソーステーブルの自動クラスタリングが一時停止されていない場合でも、自動クラスタリングが一時停止された状態で始まります。（これは、 CLONE コマンドがテーブル、テーブルを含むスキーマ、またはテーブルを含むデータベースのクローンを作成したかどうかに関係なく当てはまります。）

最適なクラスタリングキーの選択については、 クラスタリングキーを選択するための戦略 をご参照ください。

テーブルにクラスタリングを追加するには、テーブルを含むスキーマとデータベースに対する USAGE または OWNERSHIP 権限も必要です。

テーブルの自動クラスタリングステータスの表示¶

SQL を使用して、テーブルで自動クラスタリングが有効になっているかどうかを表示できます。

• SHOW TABLES コマンド。

• TABLES ビュー（Snowflake Information Schema 内）。

• TABLES ビュー（Account Usage 共有データベース内）。

出力の AUTO_CLUSTERING_ON 列には、各テーブルの自動クラスタリングステータスが表示されます。これは、特定のテーブルの自動クラスタリングを一時停止または再開するかどうかを決定するために使用できます。

さらに、 CLUSTER_BY 列（SHOW TABLES）または CLUSTERING_KEY 列（TABLES ビュー）には、各テーブルのクラスタリングキーとして定義された列が表示されます。

テーブルの自動クラスタリングの一時停止¶

テーブルの自動クラスタリングを一時停止するには、 SUSPEND RECLUSTER 句を指定して ALTER TABLE コマンドを使用します。例:

ALTER TABLE t1 SUSPEND RECLUSTER;

SHOW TABLES LIKE 't1';

+---------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+----------+----------------+----------------------+
|           created_on            | name | database_name | schema_name | kind  | comment | cluster_by | rows | bytes |  owner   | retention_time | automatic_clustering |
+---------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+----------+----------------+----------------------+
| Thu, 12 Apr 2018 13:29:01 -0700 | T1   | TESTDB        | MY_SCHEMA   | TABLE |         | LINEAR(C1) | 0    | 0     | SYSADMIN | 1              | OFF                  |
+---------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+----------+----------------+----------------------+

Copy

テーブルの自動クラスタリングの再開¶

クラスタ化されたテーブルの自動クラスタリングを再開するには、 RESUME RECLUSTER 句を指定して ALTER TABLE コマンドを使用します。例:

ALTER TABLE t1 RESUME RECLUSTER;

SHOW TABLES LIKE 't1';

+---------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+----------+----------------+----------------------+
|           created_on            | name | database_name | schema_name | kind  | comment | cluster_by | rows | bytes |  owner   | retention_time | automatic_clustering |
+---------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+----------+----------------+----------------------+
| Thu, 12 Apr 2018 13:29:01 -0700 | T1   | TESTDB        | MY_SCHEMA   | TABLE |         | LINEAR(C1) | 0    | 0     | SYSADMIN | 1              | ON                   |
+---------------------------------+------+---------------+-------------+-------+---------+------------+------+-------+----------+----------------+----------------------+

Copy

自動クラスタリングのコストの表示¶

自動クラスタリングは、必要に応じた初期クラスタリングおよび再クラスタリングを含む、各クラスター化テーブルの自動バックグラウンドメンテナンスに、 サーバーレスコンピューティングリソース を使用するため、クレジットを消費します。自動クラスタリングにより消費されたコンピューティング時間あたりのクレジット量を知る方法については、 Snowflakeサービス利用テーブル の「サーバーレス機能クレジットテーブル」をご参照ください。

適切な権限を持つユーザーは、 Snowsight、 Classic Console、または SQL を使用して、自動クラスタリングのコストを表示できます。

Snowsight

Select Admin » Cost Management。

Classic Console

Account » Billing & Usage をクリックします

自動クラスタリングのコストは、Snowflakeが別途提供する AUTOMATIC_CLUSTERING という名前のウェアハウスとして表示されます。

SQL

次のいずれかをクエリします。

• AUTOMATIC_CLUSTERING_HISTORY テーブル関数（ Snowflake Information Schema 内）。

• AUTOMATIC_CLUSTERING_HISTORY ビュー （Account Usage 内）。

  AUTOMATIC_CLUSTERING_HISTORY ビューに対して次のクエリを実行できます。

  クエリ: 自動クラスタリングのコスト履歴（日別、オブジェクト別）

  このクエリは、自動クラスタリングを使用したテーブルのリストと、過去30日間にサービスを介して消費したクレジット量を日別に表示します。クレジットの消費に不規則性があるか、一貫して消費量が多い場合は、さらに調査する必要があることを表します。

  SELECT TO_DATE(start_time) AS date,
    database_name,
    schema_name,
    table_name,
    SUM(credits_used) AS credits_used
  FROM snowflake.account_usage.automatic_clustering_history
  WHERE start_time >= DATEADD(month,-1,CURRENT_TIMESTAMP())
  GROUP BY 1,2,3,4
  ORDER BY 5 DESC;
  

  Copy

  クエリ: 自動クラスタリング履歴およびm日平均

  このクエリは、自動クラスタリングによって消費された日次の平均クレジットを、前年の週ごとにグループ化して表示します。1年間の日次平均の異常を特定するのに役立ちます。これにより、消費の急増や予期しない変化をさらに調査することができます。

  WITH credits_by_day AS (
    SELECT TO_DATE(start_time) AS date,
      SUM(credits_used) AS credits_used
    FROM snowflake.account_usage.automatic_clustering_history
    WHERE start_time >= DATEADD(year,-1,CURRENT_TIMESTAMP())
    GROUP BY 1
    ORDER BY 2 DESC
  )
  
  SELECT DATE_TRUNC('week',date),
        AVG(credits_used) AS avg_daily_credits
  FROM credits_by_day
  GROUP BY 1
  ORDER BY 1;
  

  Copy