Compartir a través de

ALTER MATERIALIZED VIEW

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.

Para agregar o modificar un comentario en una vista o sus columnas, usa COMMENT ON.

Sintaxis

ALTER MATERIALIZED VIEW view_name
  { schedule |
    ALTER COLUMN clause |
    SET ROW FILTER clause |
    DROP ROW FILTER |
    SET TAGS clause |
    UNSET TAGS clause }

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 ] cláusula de programación

    Permite agregar una programación a una vista materializada o modificarla.

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

      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.

      Unidad de tiempo 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.

  • ALTERAR COLUMN

    Importante

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

    Cambia una propiedad de una columna.

  • SET Cláusula ROW FILTER

    Importante

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

    Agrega una función de filtro de fila a la vista materializada. Todas las consultas posteriores a la vista materializada reciben un subconjunto de las filas donde la función se evalúa como booleana TRUE. Esto puede ser útil para fines de control de acceso específicos en los que la función puede inspeccionar la identidad o las pertenencias a grupos del usuario que realiza la invocación para decidir si se filtran determinadas filas.

  • DROP ROW FILTER

    Importante

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

    Quita el filtro de fila de la vista materializada, si hay alguno. Las consultas futuras devolverán todas las filas de la tabla sin ningún filtrado automático.

  • SET TAGS ( { tag_name = tag_value } [, ...] )

    Importante

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

    Aplique etiquetas a la vista materializada. Debe contar con APPLY TAG permiso para agregar etiquetas a la vista materializada.

    • tag_name

      Un literal de STRING. tag_name debe ser único dentro de la vista o columna materializada.

    • tag_value

      Un literal de STRING.

  • UNSET TAGS ( tag_name [, ...] )

    Importante

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

    Elimine las etiquetas de la vista materializada. Debes tener APPLY TAG permiso para quitar tags de la vista materializada.

    • tag_name

      Un literal de STRING. tag_name debe ser único dentro de la vista o columna materializada.

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 two hours for a materialized view
  > ALTER MATERIALIZED VIEW my_mv
      ALTER SCHEDULE EVERY 2 HOURS;

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