Compartir a través de

REFRESH (MATERIALIZED VIEW or STREAMING TABLE)

  • Artículo

Se aplica a: casilla marcada como Sí Databricks SQL

Actualizar datos de una tabla de streaming o una vista materializada. Los datos se actualizan de manera sincrónica de forma predeterminada. Puede realizar un seguimiento del estado de la actualización ejecutando DESCRIBE EXTENDED.

Nota:

Las operaciones de creación y actualización en vistas materializadas y tablas de streaming están realizadas con tecnología de una canalización de Delta Live Tables sin servidor. Puede usar el Explorador de catálogos para ver detalles sobre las canalizaciones de respaldo en la interfaz de usuario. Consulte ¿Qué es el Catalog Explorer?.

Sintaxis

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

Parámetros

  • table_name

    Identifica la vista materializada o la tabla de streaming que se va a actualizar. El nombre no debe incluir una especificación temporal ni una especificación de opciones. Si no se encuentra el objeto, Azure Databricks genera un error TABLE_OR_VIEW_NOT_FOUND.

  • FULL

    Indica si se va a realizar una actualización completa.

    • Para las vistas materializadas, una actualización completa procesa todos los datos disponibles en el origen.
    • Para las tablas de streaming, una actualización completa trunca la tabla y procesa todos los datos disponibles en el origen con la última definición de dicha tabla.

    No se recomienda llamar a actualizaciones completas en orígenes que no mantengan todo el historial de los datos o tengan períodos de retención cortos, como Kafka, ya que la actualización completa trunca los datos existentes. Es posible que no pueda recuperar datos antiguos si los datos ya no están disponibles en el origen.

  • SINCRONIZAR

    Si se va a realizar una actualización sincrónica. El comando se bloquea hasta que se crea la vista materializada o la tabla de streaming y finaliza la carga de datos inicial.

    Este es el comportamiento predeterminado.

  • ASINCRÓNICO

    Si se va a realizar una actualización asincrónica, que inicia un trabajo en segundo plano en Delta Live Tables. El comando devuelve inmediatamente antes de que la carga de datos se complete con un vínculo a la canalización de Delta Live Tables que respalda la vista materializada o la tabla de streaming. Puede visitar el vínculo para ver el estado de la actualización.

    Debe especificar ASYNC si desea realizar actualizaciones asincrónicas. La operación se realiza de forma sincrónica si no se especifica ninguna palabra clave.

Ejemplos

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