Compartir a través de

ALTER MATERIALIZED VIEW

  • Artículo

Se aplica a: casilla marcada como Sí Databricks SQL

Altera los metadatos asociados a la vista.

Permite realizar cualquiera de las siguientes acciones:

  • Agregar una programación para actualizar una vista materializada existente.
  • Alterar una programación de actualización existente para una vista materializada.
  • Anular la programación de actualización de una vista materializada. Si se quita la programación, el objeto debe actualizarse manualmente para reflejar los datos más recientes.

Sintaxis

ALTER MATERIALIZED VIEW view_name
  { schedule }

schedule
  {
    { 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

  • SCHEDULE [ REFRESH ] schedule_clause

    Permite agregar una programación a una vista materializada 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 a materialized view once a day
  -- at midnight in Los Angeles
  > ALTER MATERIALIZED VIEW my_mv
      ADD SCHEDULE CRON '0 0 0 * * ? *' AT TIME ZONE 'America/Los_Angeles';

  -- Alters the schedule to run every 15 minutes for a materialized view
  > ALTER MATERIALIZED VIEW my_mv
      ALTER SCHEDULE CRON '0 0/15 * * * ? *';

  -- Drops the schedule for a materialized view
  > ALTER MATERIALIZED VIEW my_mv
      DROP SCHEDULE;