Adaptive Compute¶

MAX_QUERY_PERFORMANCE_LEVEL¶

MAX_QUERY_PERFORMANCE_LEVEL exprime la limite supérieure des performances pour toute requête individuelle. Elle est définie au niveau de l’entrepôt et sert de mécanisme pour indiquer au système d’« accélérer » ou de « ralentir » l’exécution des requêtes.

Cette propriété est exprimée en tailles de t-shirt (XSMALL à X4LARGE). Chaque taille de t-shirt offre un niveau de performances similaire ou supérieur à celui de la taille d’entrepôt classique correspondante.

Type:

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

Par défaut:

XLARGE

Sémantique :

• Des valeurs plus élevées offrent une plus grande marge de calcul par instruction, ce qui améliore la latence pour les requêtes volumineuses et complexes, et augmente le coût instantané potentiel d’une seule instruction.

• Des valeurs plus petites limitent les dépenses par instruction, mais peuvent ralentir les requêtes volumineuses tout en laissant plus de marge pour la concurrence.

• Cette valeur ne correspond pas à une configuration de calcul sous-jacente spécifique. Elle n’exprime qu’un niveau de performances : Snowflake détermine les ressources réelles nécessaires pour chaque requête.

Comportement :

Adaptive Compute détermine le calcul optimal nécessaire pour une requête sur la base du plan de requête. Si le service détermine que les besoins de calcul pour des performances optimales sont supérieurs à MAX_QUERY_PERFORMANCE_LEVEL, Snowflake les plafonne à MAX_QUERY_PERFORMANCE_LEVEL. Pour les requêtes plus petites, Snowflake choisit le calcul offrant des performances optimales en dessous de MAX_QUERY_PERFORMANCE_LEVEL, proportionnellement aux besoins de la requête.

Conseils :

Définissez MAX_QUERY_PERFORMANCE_LEVEL sur les performances de requête maximales que vous jugez acceptables pour vos requêtes les plus importantes. Utilisez les budgets et les moniteurs de ressources pour gouverner les dépenses totales dans le temps.

QUERY_THROUGHPUT_MULTIPLIER¶

QUERY_THROUGHPUT_MULTIPLIER exprime le multiplicateur utilisé pour calculer le débit maximal à un moment donné. Plutôt que de spécifier un débit maximal absolu, vous spécifiez un facteur d’échelle entier par rapport au minimum calculé par le système.

Pour exécuter des instructions N en parallèle au MAX_QUERY_PERFORMANCE_LEVEL, définissez le multiplicateur sur N. Étant donné que MAX_QUERY_PERFORMANCE_LEVEL représente la limite supérieure, ce paramètre permet généralement d’exécuter plus de requêtes N en parallèle, car de nombreuses requêtes nécessitent moins que le maximum.

Type:

Entier non négatif

Par défaut:

2

Définir cette valeur sur 0 implique un débit illimité : l’entrepôt peut utiliser toute la capacité de pointe disponible, sans limite.

Sémantique :

Lorsqu’il est défini sur une valeur positive, le débit maximal est calculé comme suit :

MAX_THROUGHPUT = QUERY_THROUGHPUT_MULTIPLIER * MINIMUM

Où MINIMUM est une capacité de base calculée par le système pour le MAX_QUERY_PERFORMANCE_LEVEL défini sur l’entrepôt.

• Sert de facteur d’échelle sur cette capacité de base calculée par le système.

• Des valeurs plus élevées augmentent le débit de pointe (plus de travail simultané) et réduisent les files d’attente, au prix de dépenses instantanées potentiellement plus élevées.

• Des valeurs plus basses limitent le débit maximal et réduisent le risque de pics bruts dans les dépenses, mais peuvent entraîner des files d’attente.

Comportement :

Snowflake calcule un taux de capacité de base interne pour l’entrepôt sur la base du MAX_QUERY_PERFORMANCE_LEVEL, de l’historique de la migration (taille classique, nombre maximal de clusters, facteur d’échelle QAS), et d’autres paramètres de réglage du système.

QUERY_THROUGHPUT_MULTIPLIER est multiplié par cette capacité de base pour déterminer le nombre total de requêtes pouvant être exécutées simultanément. Lorsque le système est en dessous de cette cible, il autorise l’exécution de la requête. Lorsqu’il atteint la cible, il met la requête en file d’attente.

Conseils :

Si vous observez un temps de file d’attente persistant et que vous souhaitez un débit plus élevé, augmentez QUERY_THROUGHPUT_MULTIPLIER. Si vous êtes plus préoccupé par le fait de limiter les dépenses instantanées, réduisez QUERY_THROUGHPUT_MULTIPLIER et appuyez-vous sur des budgets et des moniteurs de ressources pour un contrôle absolu des coûts.

Comportement des propriétés lors de la conversion¶

Lorsque vous convertissez un entrepôt standard en entrepôt adaptatif, la seule propriété que vous devez modifier est WAREHOUSE_TYPE. Snowflake calcule automatiquement les valeurs appropriées pour MAX_QUERY_PERFORMANCE_LEVEL et QUERY_THROUGHPUT_MULTIPLIER.

Le système les dérive de la configuration existante de l’entrepôt standard :

• Taille de l’entrepôt.

• MAX_CLUSTER_COUNT (pour les entrepôts multi-clusters).

• Facteur d’échelle QAS.

• Génération de l’entrepôt (génération matérielle/logicielle).

L’objectif est de préserver ou d’améliorer les performances par rapport à l’entrepôt standard d’origine, de fournir une capacité de pointe suffisante pour les pics de charge typiques, et d’éviter d’avoir à effectuer un réglage manuel lors du passage à un entrepôt adaptatif.

Après la conversion, vous pouvez éventuellement remplacer MAX_QUERY_PERFORMANCE_LEVEL etQUERY_THROUGHPUT_MULTIPLIER en utilisant ALTER WAREHOUSE. Les propriétés d’entrepôt standard telles que WAREHOUSE_SIZE et MAX_CLUSTER_COUNT ne s’appliquent plus après la conversion en entrepôt adaptatif, et les propriétés adaptatives ne s’appliquent plus après la reconversion en entrepôt standard.

CREATE ADAPTIVE WAREHOUSE¶

Crée un nouvel entrepôt virtuel adaptatif.

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>

Vous pouvez également créer un entrepôt adaptatif à l’aide de la syntaxe CREATE WAREHOUSE standard avec WAREHOUSE_TYPE = 'ADAPTIVE' :

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 (adaptatif)¶

Vous pouvez utiliser ALTER WAREHOUSE pour convertir un entrepôt standard en entrepôt adaptatif, modifier les propriétés d’un entrepôt adaptatif, ou reconvertir un entrepôt adaptatif en entrepôt standard.

Convertir un entrepôt standard en entrepôt adaptatif :

ALTER WAREHOUSE my_warehouse SET WAREHOUSE_TYPE = 'ADAPTIVE';

Modifier les propriétés de l’entrepôt adaptatif après la création ou la conversion :

ALTER WAREHOUSE my_adaptive_wh SET
  MAX_QUERY_PERFORMANCE_LEVEL = XLARGE
  QUERY_THROUGHPUT_MULTIPLIER = 8;

Reconvertir un entrepôt adaptatif en entrepôt standard :

ALTER WAREHOUSE my_warehouse SET WAREHOUSE_TYPE = 'STANDARD';