Compartir a través de

ALTER STREAMING TABLE

  • Artículo

Se aplica a: casilla marcada como Sí Databricks SQL

Le permite:

  • Agregue una programación para actualizar una tabla de streaming existente.
  • Modifique una programación de actualización existente para una tabla de streaming.
  • Quite la programación de actualización de 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 ] schedule_clause |
    DROP SCHEDULE
  }

  schedule_clause
  { EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } |
    CRON cron_string [ AT TIME ZONE timezone_id ] }

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 ] schedule_clause

    Permite agregar una programación a una tabla de streaming o modificarla.

    • EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS }

      Importante

      Esta característica está en versión preliminar pública.

      Para programar una actualización que se produce periódicamente, use EVERY la sintaxis . Si EVERY se especifica la sintaxis, la tabla de streaming o la vista materializada se actualiza periódicamente en el intervalo especificado según el valor proporcionado, como HOUR, HOURS, DAY, DAYS, WEEKo WEEKS. En la tabla siguiente se enumeran los valores enteros aceptados para number.

      Time unit Valor entero
      HOUR or HOURS 1 <= H <= 72
      DAY or DAYS 1 <= D <= 31
      WEEK or WEEKS 1 <= W <= 8

      Nota:

      Las formas singulares y plurales de la unidad de tiempo incluida son semánticamente equivalentes.

    • CRON cron_string [ AT TIME ZONE timezone_id ]

      Para programar una actualización utilizando un valor cron de cuarzo. Se aceptan time_zone_values válidos. 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.

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;