Compartilhar via

ALTER STREAMING TABLE

  • Artigo

Aplica-se a: marca de seleção positiva SQL do Databricks

Permite que você:

  • Adicionar uma agenda para atualizar uma tabela de streaming existente.
  • Alterar uma agenda de atualização existente para uma tabela de streaming.
  • Eliminar a agenda de atualização de uma tabela de streaming. Se a agenda for descartada, o objeto precisará ser atualizado manualmente para refletir os dados mais recentes.

Sintaxe

ALTER STREAMING TABLE table_name
  {
    { ADD | ALTER } SCHEDULE [ REFRESH ]
      CRON cron_string [ AT TIME ZONE timezone_id ] |
    DROP SCHEDULE
  }

Parâmetros

  • table_name

    O nome da tabela de streaming da qual alterar a definição. O nome não deve incluir uma especificação temporal.

  • SCHEDULE [ REFRESH ] CRON cron_string [ AT TIME ZONE timezone_id ]

    Se fornecido, agenda a tabela de fluxo contínuo ou a exibição materializada para atualizar seus dados com a agenda cron de quartzo fornecida. Somente time_zone_values são aceitos. Não há suporte para AT TIME ZONE LOCAL. Se AT TIME ZONE estiver ausente, o fuso horário da sessão será usado. Se AT TIME ZONE estiver ausente e o fuso horário da sessão não estiver definido, um erro será lançado. SCHEDULE é semanticamente equivalente a SCHEDULE REFRESH.

Exemplos

-- Adds a schedule to refresh the streaming table once a day
-- at midnight in Los Angeles
> ALTER STREAMING TABLE my_st
  ADD SCHEDULE CRON '0 0 0 * * ? *' AT TIME ZONE 'America/Los_Angeles';

-- Alters the schedule to run every 15 minutes for a streaming table
> ALTER STREAMING TABLE my_st
  ALTER SCHEDULE CRON '0 0/15 * * * ? *';

-- Drops the schedule for a streaming table
> ALTER STREAMING TABLE my_st
  DROP SCHEDULE;