Partager via

RAFRAÎCHIR (VUE MATÉRIALISÉE ou TABLE DE STREAMING)

  • Article

S’applique à : coche marquée oui Databricks SQL

Actualisez les données d’un streaming de tableau ou d’une vue matérialisée. Les données sont actualisées de manière synchrone par défaut. Vous pouvez suivre le statut de l’actualisation en exécutant DESCRIBE EXTENDED.

Remarque

Les opérations de création et d’actualisation sur les vues matérialisées et les tables de diffusion en continu sont alimentées par un pipeline Delta Live Tables serverless. Vous pouvez utiliser l’Explorateur de catalogues pour afficher des détails sur les pipelines de stockage dans l’interface utilisateur. Consultez Qu’est-ce que Catalog Explorer ?.

Syntaxe

REFRESH { MATERIALIZED VIEW | [ STREAMING ] TABLE } table_name [ FULL | { SYNC | ASYNC }]

Paramètres

  • table_name

    Identifie la vue matérialisée ou le tableau de streaming à actualiser. Le nom ne doit pas inclure de spécification temporelle ou de spécification d’options. Si le tableau est introuvable, Azure Databricks génère une erreur TABLE_OR_VIEW_NOT_FOUND.

  • FULL

    Indique s’il faut effectuer une actualisation complète.

    • Pour les vues matérialisées, une actualisation complète traite toutes les données disponibles dans la source.
    • Pour les tables de streaming, une actualisation complète tronque la table et traite toutes les données disponibles dans la source avec la dernière définition de la table de streaming.

    Il n’est pas recommandé d’appeler des actualisations complètes sur des sources qui ne conservent pas l’historique complet des données ou qui ont de courtes périodes de rétention, telles que Kafka, car l’actualisation complète tronque les données existantes. Vous ne pourrez peut-être pas récupérer d’anciennes données si les données ne sont plus disponibles dans la source.

  • SYNC

    Indique s’il faut effectuer une actualisation synchrone. La commande se bloque jusqu'à ce que la vue matérialisée ou la table de streaming soit créée et que le chargement initial des données soit terminé.

    C’est le paramétrage par défaut.

  • ASYNCHRONE

    Indique s'il faut effectuer un rafraîchissement asynchrone, qui lance un travail d'arrière-plan sur les tables Delta Live. La commande revient immédiatement avant la fin du chargement des données avec un lien vers le pipeline Delta Live Tables qui soutient la vue matérialisée ou la table en continu. Vous pouvez consulter le lien pour voir l’état d’avancement de l’actualisation.

    Vous devez spécifier ASYNC si vous souhaitez effectuer des actualisations asynchrones. L’opération est effectuée de manière synchrone si aucun mot clé n’est spécifié.

Exemples

-- Refreshes the materialized view to reflect the latest available data
> REFRESH MATERIALIZED VIEW catalog.schema.view_name;

-- Refreshes the streaming table to process the latest available data
-- The current catalog and schema will be used to qualify the table
> REFRESH STREAMING TABLE st_name;

-- Truncates the table and processes all data from scratch for the streaming table
> REFRESH TABLE cat.db.st_name FULL;