Partilhar via

REFRESH (MATERIALIZED VIEW ou STREAMING TABLE)

  • Artigo

Aplica-se a:Marque Sim Databricks SQL

Refresh os dados para uma table de streaming ou uma visualização materializada. Os dados são atualizados de forma síncrona por padrão. Você pode acompanhar o status do refresh executando DESCRIBE EXTENDED.

Nota

As operações de criação e refresh em views materializados e tables de streaming são executadas por um pipeline sem servidor Delta Live de Tables. Você pode usar o Catalog Explorer para exibir detalhes sobre os pipelines de backup na interface do usuário. Consulte O que é Catalog Explorer?.

Sintaxe

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

Parameters

  • table_name

    Identifica a visualização materializada ou o streaming de table para refresh. O nome não deve incluir uma especificação temporal ou uma especificação de opções. Se o objeto não puder ser encontrado, o Azure Databricks gerará um erro TABLE_OR_VIEW_NOT_FOUND .

  • COMPLETO

    Devemos realizar uma refreshcompleta?

    • No caso de viewsmaterializado, um refresh completo processa todos os dados disponíveis na origem.
    • Para o streaming tables, um refresh totalmente trunca o table e processa todos os dados disponíveis na fonte com a definição mais recente do tablede streaming.

    Não é recomendável chamar atualizações completas em fontes que não mantêm todo o histórico dos dados ou têm períodos de retenção curtos, como Kafka, pois o refresh completo trunca os dados existentes. Talvez não seja possível recuperar dados antigos se os dados não estiverem mais disponíveis na fonte.

  • SYNC

    Se deseja executar uma refreshsíncrona . O comando bloqueia até que a visualização materializada ou a table de streaming seja criada e a carga inicial de dados seja concluída.

    Este é o comportamento predefinido.

  • ASSÍNCRONO

    Se deseja executar uma refreshassíncrona , que inicia um trabalho em segundo plano no Delta Live Tables. O comando retorna imediatamente antes de a carga de dados ser concluída com um link para o pipeline Delta Live Tables que suporta a vista materializada ou o streaming table. Você pode visitar o link para ver o status do refresh.

    Você deve especificar ASYNC se deseja executar atualizações assíncronas. A operação é executada de forma síncrona se nenhuma palavra-chave for especificada.

Exemplos

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