Tables interactives et entrepôts interactifs Snowflake¶

Limitations des entrepôts interactifs¶

• Les entrepôts interactifs Snowflake ne prennent pas en charge les requêtes de longue durée. Le délai d’expiration des requêtes pour les commandes SELECT est de cinq secondes par défaut. Après cinq secondes, la requête est annulée. Vous pouvez réduire la valeur du délai d’expiration des requêtes, mais pas l’augmenter. Les autres types de commandes, par exemple SHOW et INSERT OVERWRITE, ne sont pas soumis à l’intervalle du délai d’expiration de cinq secondes.

  Les entrepôts interactifs ne sont pas destinés à être utilisés avec des requêtes de longue durée. Si une requête expire systématiquement, cela indique qu’elle n’est peut-être pas adaptée à une utilisation avec des entrepôts interactifs. Sinon, vous devez appliquer certaines techniques de réglage des performances afin de réduire le délai à moins de cinq secondes.

• Un entrepôt interactif est toujours opérationnel grâce à sa conception. Sa suspension n’est pas automatique lorsqu’il est inactif. Bien que vous puissiez suspendre manuellement un entrepôt interactif, attendez-vous à une latence importante des requêtes lorsque vous reprenez l’entrepôt.

• Vous ne pouvez pas interroger de tables Snowflake standard à partir d’un entrepôt interactif. Pour interroger des tables standard et des tables interactives dans la même session, exécutez USE WAREHOUSE pour passer au type d’entrepôt approprié en fonction du type de table.

• Si un entrepôt interactif est un entrepôt multi-clusters, il ne se met pas automatiquement à l’échelle. Dans un entrepôt interactif multi-clusters, laissez toujours MIN_CLUSTER_COUNT et MAX_CLUSTER_COUNT définis sur la même valeur.

• Vous ne pouvez pas exécuter de commandes CALL pour appeler des procédures stockées dans un entrepôt interactif.

• Vous ne pouvez pas utiliser l’opérateur de canal ->>. Cet opérateur utilise des procédures stockées en arrière-plan.

• Les entrepôts interactifs ne prennent actuellement pas en charge la réplication. Ils ne sont pas inclus dans les groupes de basculement et dans les groupes de réplication.

Limitations des tables interactives¶

• Les tables interactives ne prennent pas en charge les fonctionnalités suivantes :

  • Commandes de langage de manipulation de données (DML) telles que UPDATE et DELETE. Le seul DML que vous pouvez exécuter est INSERT OVERWRITE.

  • Réplication. Ils ne sont pas inclus dans les groupes de basculement et dans les groupes de réplication.

• Les informations sur les requêtes ne sont actuellement pas collectées ou disponibles pour les requêtes exécutées sur des tables interactives.

• Vous ne pouvez pas effectuer les opérations suivantes :

  • Utiliser une table interactive comme source d’une vue matérialisée.

  • Modifier les propriétés d’une table interactive via des clauses ALTER TABLE telles que ADD COLUMN ou REMOVE COLUMN. La seule modification ALTER TABLE que vous pouvez effectuer est de renommer la table.

  • Utiliser des politiques de masquage des données avec une table interactive.

  • Utiliser des politiques de jointure avec une table interactive.

  • Utiliser des politiques d’agrégation avec une table interactive.

  • Utiliser des politiques d’accès aux lignes avec une table interactive.

  • Utiliser des flux avec une table interactive.

  • Créer une table dynamique avec une table interactive comme table de base.

  • Utiliser la clause RESAMPLE pour les requêtes sur une table interactive.

Création d’une table interactive¶

La création d’une table suit la syntaxe standard CTAS (CREATE TABLE AS SELECT), avec le mot-clé INTERACTIVE additionnel qui définit le type de table.

La commande CREATE INTERACTIVE TABLE nécessite également une clause CLUSTER BY. Spécifiez une ou plusieurs colonnes dans la clause CLUSTER BY pour faire correspondre les clauses WHERE dans vos requêtes les plus urgentes. Les colonnes que vous spécifiez dans la clause CLUSTER BY peuvent affecter significativement les performances des requêtes sur la table interactive. Par conséquent, choisissez soigneusement les colonnes de clustering. Pour plus d’informations sur le choix des meilleures colonnes de clustering, consultez Clés de clustering et tables en cluster.

La commande suivante crée une table interactive contenant les mêmes colonnes et les mêmes données qu’une table standard. La clause CLUSTER BY fait référence à une colonne nommée id à partir de la table source.

CREATE INTERACTIVE TABLE
  IF NOT EXISTS orders
  CLUSTER BY (id)
AS
  SELECT * FROM demoSource;

Spécification de l’actualisation automatique d’une table interactive¶

Pour qu’une table interactive s’actualise automatiquement à l’aide des données d’une autre table, spécifiez la clause TARGET_LAG avec un intervalle. Lorsque vous spécifiez TARGET_LAG, vous devez aussi spécifier la clause WAREHOUSE et le nom d’un entrepôt standard que Snowflake utilisera pour effectuer des opérations d’actualisation.

L’intervalle de temps pour la clause TARGET_LAG vous permet de spécifier la latence maximale en termes de nombre de secondes, de minutes, d’heures ou de jours :

TARGET_LAG = '<num> { seconds | minutes | hours | days }'

Si vous ne spécifiez pas d’unité, le nombre représente les secondes. La valeur minimale est de 60 secondes, ou 1 minute.

Par exemple, l’instruction CREATE INTERACTIVE TABLE suivante définit une table interactive dynamique qui ne présente pas plus de 20 minutes de latence par rapport à une table source spécifiée et utilise un entrepôt standard nommé my_standard_warehouse pour effectuer des opérations d’actualisation :

CREATE INTERACTIVE TABLE my_dynamic_interactive_table
  CLUSTER BY (c1, c2)
  TARGET_LAG = '20 minutes'
  WAREHOUSE = my_standard_warehouse
AS SELECT c1, SUM(c2) FROM my_source_table GROUP BY c1;

Pour plus d’informations sur le choix d’un temps de latence approprié qui équilibre les coûts et le niveau d’actualisation des données, consultez Déterminer la latence cible optimale pour une table dynamique. Des considérations similaires s’appliquent aux tables interactives et aux tables dynamiques.

Création d’un entrepôt interactif¶

Une fois que vous avez créé une table interactive, l’interrogation de cette table avec des performances optimales nécessite un entrepôt interactif. Spécifiez le mot-clé INTERACTIVE dans la commande CREATE WAREHOUSE ou CREATE OR REPLACE WAREHOUSE.

En option, vous pouvez spécifier une clause TABLES avec une liste de noms de tables interactives séparés par des virgules. L’utilisation de cette clause associe immédiatement ces tables interactives à l’entrepôt interactif.

La commande suivante crée un entrepôt interactif associé à la table interactive nommée orders. Dans ce cas, vous pouvez exécuter immédiatement une commande USE WAREHOUSE pour l’entrepôt interactif et commencer à exécuter des requêtes pour la table interactive :

CREATE OR REPLACE INTERACTIVE WAREHOUSE interactive_demo
  TABLES (orders)
  WAREHOUSE_SIZE = 'XSMALL';

La commande suivante crée un entrepôt interactif sans table interactive associée. Dans ce cas, vous exécutez ensuite les commandes ALTER WAREHOUSE pour associer les tables interactives à l’entrepôt interactif :

CREATE or REPLACE INTERACTIVE WAREHOUSE interactive_demo
  WAREHOUSE_SIZE = 'XSMALL';

Une fois que vous avez créé un entrepôt interactif, l’entrepôt reste actif indéfiniment par défaut. Contrairement à un entrepôt classique, un entrepôt interactif n’offre pas la possibilité d’être suspendu automatiquement s’il est inactif pendant un certain temps.

Bonnes pratiques en matière de requêtes pour les entrepôts interactifs¶

Les entrepôts interactifs sont optimisés pour les requêtes avec des charges de travail sélectives. Cela signifie que les requêtes présentant une bonne sélectivité voient leurs performances s’améliorer sensiblement par rapport aux autres types de requêtes.

SELECT col1, col4, AVG(col_x)
  FROM my_table
  GROUP BY col1, col2;

SELECT * FROM my_table;

SELECT col1, col2
  FROM my_table
  WHERE
    col_x IN (1,4,7,8)
    AND event_time >=
      DATEADD(hour, -1, CURRENT_TIMESTAMP());

SELECT col1, col2
  FROM my_table
  WHERE
    event_time >=
      DATEADD(day, -365, CURRENT_TIMESTAMP());

D’autres complexités telles que les jointures volumineuses (comme la jointure de deux tables de faits), ou les expressions à forte intensité de calcul telles que les expressions régulières, peuvent entraîner une plus faible concurrence en raison d’une utilisation plus importante des ressources de calcul. Consultez Sélection d’une taille pour un entrepôt interactif pour obtenir des informations sur l’optimisation pour ces situations.

Bonnes pratiques en matière de mise en page des données pour les tables interactives¶

Les tables interactives suivent les bonnes pratiques de Snowflake en matière de performances. En particulier, les tables interactives bénéficient d’une table correctement clusterisée, c’est-à-dire d’une table triée en fonction de la même colonne ou des mêmes colonnes que celle(s) sur laquelle ou sur lesquelles vous effectuez un filtrage. Par exemple, si votre requête effectue souvent un filtrage sur une colonne TIMESTAMP telle que sale_date, il est logique d’utiliser cette colonne comme clé de clustering lors de la création de la table interactive. Par exemple, vous pouvez créer la table interactive comme suit :

CREATE INTERACTIVE TABLE product_sales (<column definitions>) CLUSTER BY (sale_date);

De cette façon, les requêtes SELECT qui effectuent un filtrage sur sale_date peuvent rapidement ignorer toutes les données non pertinentes et renvoyer les résultats. Par exemple, la requête suivante effectue un filtrage sur une plage de dates en testant la colonne sale_date :

SELECT... WHERE sale_date > '2025-10-24' AND ...

Pour plus de détails sur le choix des meilleures clés de clustering, consultez Clés de clustering et tables en cluster.

Utilisation de l’optimisation de la recherche pour les recherches de points¶

Nous vous recommandons d’ajouter l’optimisation de la recherche lorsque vous effectuez des requêtes de recherche de points sur votre table interactive. Les recherches de points sont des requêtes qui effectuent un filtrage sur une seule colonne pour récupérer une ou quelques lignes de données. Un bon exemple est WHERE some_id = some_UUID.

Sélection d’une taille pour un entrepôt interactif¶

Une fois que vous avez terminé toutes vos requêtes et optimisations de mise en page, envisagez de mettre votre entrepôt à l’échelle pour répondre à la demande. Les entrepôts interactifs ont une gamme de tailles allant de XSMALL à 3XLARGE, tout comme les Entrepôts multi-clusters.

Nous vous recommandons de commencer par dimensionner votre entrepôt en fonction de la taille approximative de l’ensemble des données de travail dans la table interactive. L’ensemble des données de travail fait référence à la partie des données qui est fréquemment interrogée. Par exemple, si vos requêtes n’interrogent généralement que les sept derniers jours de données de vente, l’ensemble de travail est la fraction de la table interactive correspondant à ces sept jours.

En effet, l’entrepôt interactif utilise la mise en cache du stockage local. Bien que les données de votre ensemble de données (table) soient toujours accessibles, l’accès aux données non mises en cache entraîne une latence de lecture plus élevée lors de la première lecture.

Choisissez une taille d’entrepôt adaptée aux besoins de vos charges de travail. Expérimentez avec vos données et votre charge de travail particulières pour déterminer la taille optimale de votre entrepôt interactif. Vous pouvez créer un entrepôt multi-clusters interactif. Cependant, actuellement, le nombre minimum et maximum de clusters doit être égal. Autrement dit, l’entrepôt interactif multi-clusters ne se met pas automatiquement à l’échelle.

Nous vous recommandons de commencer par les tailles d’entrepôt suivantes, en fonction de la taille de l’ensemble des données de travail.

Ajout d’une table interactive à un entrepôt interactif¶

Pour obtenir des performances de requête optimales pour une table interactive, vous devez utiliser un entrepôt interactif.

Avant de pouvoir interroger la table interactive à partir d’un entrepôt interactif, vous devez effectuer une opération unique pour ajouter la table interactive à l’entrepôt interactif. Sinon, vous verrez une erreur « objet introuvable » lors de l’exécution d’une requête sur ce type de table de l’entrepôt interactif. Si vous n’avez pas spécifié les tables interactives à associer aux entrepôts interactifs via la clause TABLES dans votre commande CREATE INTERACTIVE WAREHOUSE, vous pouvez le faire plus tard en utilisant une commande ALTER WAREHOUSE.

La commande suivante associe la table orders à l’entrepôt interactive_demo. Vous pouvez spécifier plusieurs noms de tables, séparés par des virgules, avec la clause ADD TABLES.

ALTER WAREHOUSE interactive_demo ADD TABLES (orders);

Cette action lance le processus de préparation du cache. Ce processus peut prendre un certain temps.

Si la table interactive est déjà associée à l’entrepôt interactif, la commande aboutit mais n’a aucun effet.

Vous pouvez associer une table interactive à plusieurs entrepôts interactifs.

Suppression d’une table interactive d’un entrepôt interactif¶

Vous pouvez détacher une ou plusieurs tables interactives d’un entrepôt interactif en exécutant une commande ALTER WAREHOUSE avec la clause DROP TABLES.

ALTER WAREHOUSE interactive_demo DROP TABLES (orders, customers);

Reprise et suspension d’un entrepôt¶

La commande suivante reprend un entrepôt interactif. Vous devez effectuer cette action après la création de l’entrepôt, car celui-ci est créé dans un état suspendu :

ALTER WAREHOUSE interactive_demo RESUME;

Vous devez également effectuer cette action pour commencer à exécuter des requêtes dans l’entrepôt si vous avez suspendu manuellement l’entrepôt.

Les requêtes seront lentes pendant la préparation du cache après la reprise. Cette opération peut prendre de quelques minutes à une heure, en fonction de la quantité de données contenues dans cette table.

La commande suivante suspend un entrepôt interactif :

ALTER WAREHOUSE interactive_demo SUSPEND;

Vous pouvez suspendre l’entrepôt dans les environnements de développement et de test où il ne sera pas utilisé pendant de nombreuses heures. Dans un environnement de production, vous utilisez généralement des entrepôts interactifs pour les charges de travail exécutant de nombreuses requêtes concurrentes 24 heures sur 24 et 7 jours sur 7, ou lorsqu’une faible latence est cruciale pour les requêtes. Ainsi, vous ne suspendez généralement pas les entrepôts interactifs que vous utilisez en production. Snowflake ne suspend pas automatiquement les entrepôts interactifs.

Suppression d’un entrepôt interactif¶

Vous pouvez exécuter la commande DROP WAREHOUSE pour supprimer entièrement un entrepôt interactif. La destruction d’un entrepôt interactif supprime les associations entre cet entrepôt et toutes les tables interactives. Cependant, vous pouvez toujours utiliser d’autres entrepôts interactifs pour interroger ces mêmes tables interactives.

Interrogation d’une table interactive¶

Dans votre session de requête, assurez-vous que l’entrepôt de votre session actuelle est un entrepôt interactif :

USE WAREHOUSE interactive_demo;

Après cela, vous pouvez interroger votre table interactive normalement.