Partage via

ACTUALISER (VUE MATÉRIALISÉE et TABLE DE DIFFUSION EN CONTINU)

  • Article

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

Important

Cette fonctionnalité est disponible en préversion publique.

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.

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 une spécification temporelle. Si le tableau est introuvable, Azure Databricks génère une erreur TABLE_OR_VIEW_NOT_FOUND.

  • FULL

    S’il faut effectuer une actualisation complète, qui tronque le tableau et traite toutes les données disponibles dans la source avec la dernière définition du streaming de tableau. Les vues matérialisées ne prennent pas en charge les actualisations complètes.

    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 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;