ALTER STREAMING TABLE

Se aplica a:casilla marcada como Sí Databricks SQL

Importante

Esta característica está en versión preliminar pública. Para registrarse para obtener acceso, rellene este formulario.

Le permite:

  • Agregue una programación para actualizar una vista materializada existente o una tabla de streaming.
  • Modifique una programación de actualización existente para una vista materializada o una tabla de streaming.
  • Quite la programación de actualización de una vista materializada o una tabla de streaming. Si se quita la programación, el objeto debe actualizarse manualmente para reflejar los datos más recientes.

Sintaxis

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

Parámetros

  • table_name

    Nombre de la tabla de streaming de la que se va a modificar la definición. El nombre no debe incluir una especificación temporal.

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

    Si se proporciona, programa la tabla de streaming para actualizar sus datos con la programación quartz cron especificada. Solo se aceptan valores time_zone_values. No se admite AT TIME ZONE LOCAL. Si AT TIME ZONE no está presente, se usa la zona horaria de la sesión. Si AT TIME ZONE no está presente y no se establece la zona horaria de la sesión, se produce un error. SCHEDULE es equivalente semánticamente a SCHEDULE REFRESH.

    No se puede usar la sintaxis SCHEDULE en una definición de canalización de Delta Live Tables.

Ejemplos

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