適応型コンピューティング¶

MAX_QUERY_PERFORMANCE_LEVEL¶

MAX_QUERY_PERFORMANCE_LEVELは、任意の個別クエリに関するパフォーマンスの上限を表します。ウェアハウスレベルで設定され、システムにクエリ実行の「高速化」または「速度低下」を指示するメカニズムとして機能します。

プロパティは、Tシャツのサイズ（XSMALL～X4LARGE）の単位で表されます。各Tシャツのサイズは、従来のウェアハウスサイズと同等以上のパフォーマンスを実現します。

型:

{ XSMALL | SMALL | MEDIUM | LARGE | XLARGE | XXLARGE | XXXLARGE | X4LARGE }

デフォルト:

XLARGE

セマンティクス:

• 値を引き上げると、ステートメントごとのコンピューティングヘッドルームが拡充され、大規模で複雑なクエリの遅延が改善されるとともに、単一のステートメントの潜在的な瞬時コストが増加します。

• 値を引き下げると、ステートメントごとのコストが制限されますが、同時実行のためのより多くのヘッドルームを確保する一方で、大規模なクエリ実行の速度が低下する可能性があります。

• この値は、特定の基盤となるコンピューティング構成にはマッピングされません。パフォーマンスレベルのみを表します。Snowflakeは、各クエリに必要な実際のリソースを決定します。

動作:

適応型コンピューティングは、クエリプランに基づいて、クエリに必要な最適なコンピューティングを決定します。最適なパフォーマンスを実現するためのコンピューティングの必要性が、MAX_QUERY_PERFORMANCE_LEVELSnowflakeの上限を超えるものであるとサービスが判断した場合、Snowflakeは上限をMAX_QUERY_PERFORMANCE_LEVELに設定します。小規模クエリの場合、Snowflakeは最適なパフォーマンスを確保するためにクエリが必要とするMAX_QUERY_PERFORMANCE_LEVEL以下のコンピューティングを選択します。

ガイダンス:

MAX_QUERY_PERFORMANCE_LEVELをユーザーが最大のクエリに対して得られることを想定している最高のクエリパフォーマンスレベルに設定します。:doc:`予算</user-guide/budgets>`および:doc:`リソースモニター</user-guide/resource-monitors>`を使用して、一定期間の総支出を管理します。

QUERY_THROUGHPUT_MULTIPLIER¶

QUERY_THROUGHPUT_MULTIPLIERは、特定の時間における最大スループットを計算するために使用される乗数を表します。絶対最大スループットを指定するのではなく、システムにより計算された最小値の整数スケール係数を指定します。

MAX_QUERY_PERFORMANCE_LEVELで``N``ステートメントを並列実行するには、乗数を``N``に設定します。MAX_QUERY_PERFORMANCE_LEVELは上限を表すため、この設定は通常、並列実行される``N``件より多くのクエリをサポートします。これは、多くのクエリが必要とする対象が最大値を下回るためです。

型:

負でない整数

デフォルト:

2

この値を``0``に設定することは、スループットに上限がないことを表します。ウェアハウスは、上限なしで使用可能な量のバースト容量を使用できます。

セマンティクス:

正の値に設定すると、最大スループットは次のように計算されます。

MAX_THROUGHPUT = QUERY_THROUGHPUT_MULTIPLIER * MINIMUM

``MINIMUM``は、ウェアハウスに設定されているMAX_QUERY_PERFORMANCE_LEVELについてシステムによって計算された基本容量です。

• このシステムによって計算された基本容量のスケール係数として機能します。

• 値が高いほど、ピークスループット（より多くの同時作業）が向上し、キューイングが減少しますが、瞬時に高いコストが発生する可能性があります。

• 値が低いほど、バーストスループットが制限され、費用が急増するリスクが軽減されますが、キューイングにつながる可能性があります。

動作:

Snowflakeは、MAX_QUERY_PERFORMANCE_LEVEL、移行履歴（従来のサイズ、最大クラスター数、QASスケール係数）、およびその他のシステム調整パラメーターに基づいてウェアハウスの内部の基本容量レートを計算します。

QUERY_THROUGHPUT_MULTIPLIERは、この基本容量に乗算して、同時に実行できるクエリの総数を決定します。システムがこのターゲットを下回ると、クエリの実行が許可されます。ターゲットに達すると、クエリをキューに入れます。

ガイダンス:

永続的なキューイングオンロード時間が見られ、より高いスループットが必要な場合は、QUERY_THROUGHPUT_MULTIPLIERの値を引き上げます。一時的な費用の上限設定について懸念がある場合は、QUERY_THROUGHPUT_MULTIPLIERの値を引き下げて、絶対的なコストを管理するための予算とリソースモニターに準拠します。

変換時のプロパティの動作¶

標準ウェアハウスを適応型ウェアハウスに変換する場合に、変更する必要があるプロパティはWAREHOUSE_TYPEのみです。Snowflakeは、MAX_QUERY_PERFORMANCE_LEVELおよびQUERY_THROUGHPUT_MULTIPLIERの適切な値を自動的に計算します。

システムは、標準ウェアハウスの既存の構成からこれらを派生します。

• ウェアハウスのサイズ

• MAX_CLUSTER_COUNT（マルチクラスターウェアハウスの場合）。

• QASスケール係数。

• ウェアハウスの生成（ハードウェア/ソフトウェアの生成）。

元の標準ウェアハウスと比較してパフォーマンスを維持または向上させ、典型的な負荷の急増に十分なバースト容量を確保し、適応型に切り替えるときに手動のチューニングを必要としないようにすることを目標としています。

変換後、オプションでALTERWAREHOUSEを使用してMAX_QUERY_PERFORMANCE_LEVELおよびQUERY_THROUGHPUT_MULTIPLIERをオーバーライドすることができます。WAREHOUSE_SIZEおよびMAX_CLUSTER_COUNTなどの標準ウェアハウスのプロパティは、適応型への変換後には適用されなくなり、変換により標準に戻すと、適応型プロパティは適用されなくなります。

CREATE ADAPTIVE WAREHOUSE¶

新しい適応型仮想ウェアハウスを作成します。

CREATE [ OR REPLACE ] ADAPTIVE WAREHOUSE [ IF NOT EXISTS ] <name>
  [ [ WITH ] adaptiveProperties ]
  [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , ... ] ) ]
  [ objectParams ]

adaptiveProperties ::=
  COMMENT = '<string_literal>'
  MAX_QUERY_PERFORMANCE_LEVEL = { XSMALL | SMALL | MEDIUM | LARGE
                                | XLARGE | XXLARGE | XXXLARGE | X4LARGE }
  QUERY_THROUGHPUT_MULTIPLIER = <integer>

objectParams ::=
  STATEMENT_QUEUED_TIMEOUT_IN_SECONDS = <num>
  STATEMENT_TIMEOUT_IN_SECONDS = <num>

``WAREHOUSE_TYPE = 'ADAPTIVE'``に設定されている標準の:doc:`CREATE WAREHOUSE </sql-reference/sql/create-warehouse>`構文を使用して、適応型ウェアハウスを作成することもできます。

CREATE [ OR REPLACE ] WAREHOUSE [ IF NOT EXISTS ] <name>
  [ [ WITH ] WAREHOUSE_TYPE = 'ADAPTIVE'
    [ adaptiveProperties ]
  ]
  [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , ... ] ) ]
  [ objectParams ]

CREATE ADAPTIVE WAREHOUSE my_adaptive_wh;

CREATE ADAPTIVE WAREHOUSE my_adaptive_wh
  WITH MAX_QUERY_PERFORMANCE_LEVEL = XXLARGE;

CREATE ADAPTIVE WAREHOUSE my_adaptive_wh
  WITH MAX_QUERY_PERFORMANCE_LEVEL = MEDIUM
       QUERY_THROUGHPUT_MULTIPLIER = 6;

CREATE WAREHOUSE my_adaptive_wh
  WITH WAREHOUSE_TYPE = 'ADAPTIVE'
       MAX_QUERY_PERFORMANCE_LEVEL = LARGE
       QUERY_THROUGHPUT_MULTIPLIER = 3;

ALTER WAREHOUSE（適応型）¶

:doc:`ALTER WAREHOUSE </sql-reference/sql/alter-warehouse>`を使用して、標準ウェアハウスを適応型に変換する、適応型ウェアハウスのプロパティを変更する、または適応型ウェアハウスを変換して標準に戻すことができます。

標準のウェアハウスを適応型に変換します。

ALTER WAREHOUSE my_warehouse SET WAREHOUSE_TYPE = 'ADAPTIVE';

作成または変換後に適応型ウェアハウスのプロパティを変更します。

ALTER WAREHOUSE my_adaptive_wh SET
  MAX_QUERY_PERFORMANCE_LEVEL = XLARGE
  QUERY_THROUGHPUT_MULTIPLIER = 8;

適応型ウェアハウスを変換して標準に戻します。

ALTER WAREHOUSE my_warehouse SET WAREHOUSE_TYPE = 'STANDARD';