ALTER VIEW

Aplica-se a: Databricks SQL Databricks Runtime

Altera os metadados associados à exibição. Ela pode alterar a definição da exibição, alterar o nome de uma exibição para um nome diferente, definir e remover a definição dos metadados da exibição ao definir TBLPROPERTIES.

Se a exibição estiver armazenada em cache, o comando limpará os dados armazenados em cache da exibição e todos os dependentes que se referem a ela. O cache da exibição será preenchido ociosamente quando a exibição for acessada na próxima vez. O comando deixa os dependentes da exibição sem armazenamento em cache.

Sintaxe

ALTER [ MATERIALIZED ] VIEW view_name
  { rename |
    SET TBLPROPERTIES clause |
    UNSET TBLPROPERTIES clause |
    alter_body |
    owner_to |
    schedule
    SET TAGS clause |
    UNSET TAGS clause }}}

rename
  RENAME TO to_view_name

alter_body
  AS query

property_key
  { idenitifier [. ...] | string_literal }

owner_to
  [ SET ] OWNER TO principal

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

Parâmetros

• view_name

  Identifica a exibição a ser alterada. Se a exibição não puder ser encontrada, o Azure Databricks gerará um erro TABLE_OR_VIEW_NOT_FOUND.

• RENAME TO to_view_name

  Renomeia a exibição existente dentro do esquema. As exibições materializadas não podem ser renomeadas.

  to_view_name especifica o novo nome da exibição. Caso to_view_name já exista, é gerado um TableAlreadyExistsException. Caso to_view_name esteja qualificado, deve corresponder ao nome de esquema de view_name.

• SET TBLPROPERTIES

  Configura ou reconfigura uma ou mais propriedades definidas pelo usuário.

• UNSET TBLPROPERTIES

  Remove uma ou mais propriedades definidas pelo usuário.

• AS query

  Uma consulta que constrói a exibição com base em tabelas base ou em outras exibições.

  Essa cláusula é equivalente a uma instrução CREATE OR REPLACE VIEW em uma exibição existente, exceto que os privilégios concedidos na exibição são preservados.

• [ SET ] OWNER TO principal

  Transfere a propriedade da exibição para principal. A menos que a exibição seja definida no hive_metastore, você só poderá transferir a propriedade para um grupo ao qual você pertence.

  Aplica-se a: Databricks SQL Databricks Runtime 11.3 LTS e superior

  SET é permitido como uma palavra-chave opcional.

• MARCAÇÕES DEFINIDAS ( { tag_name = tag_value } [, ...] )

  Aplicar marcas à exibição. Você precisa ter a permissão apply_tag para adicionar marcas à exibição.

  Aplica-se a: Databricks SQL Databricks Runtime 13.3 LTS e superior

• MARCAÇÕES NÃO DEFINIDAS ( nome_da_marca [, ...] )

  Remove as tags da tabela. Você precisa ter a permissão apply_tag para remover marcas da exibição.

  Aplica-se a: Databricks SQL Databricks Runtime 13.3 LTS e superior

• nome_da_tag

  Um literal STRING. O tag_name deve ser exclusivo no esquema.

• tag_value

  Um literal STRING.

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

  Permite que você adicione um agendamento ou altere o agendamento de uma exibição materializada.

  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.

  Não é possível usar a sintaxe SCHEDULE em uma definição de pipeline do Delta Live Tables.

Exemplos

-- Rename only changes the view name.
-- The source and target schemas of the view have to be the same.
-- Use qualified or unqualified name for the source and target view.
> ALTER VIEW tempsc1.v1 RENAME TO tempsc1.v2;

-- Verify that the new view is created.
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1       int   NULL
                            c2    string   NULL

  # Detailed Table Information
                      Database   tempsc1
                         Table        v2

-- Before ALTER VIEW SET TBLPROPERTIES
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1       int   null
                            c2    string   null

  # Detailed Table Information
                      Database   tempsc1
                         Table        v2
              Table Properties    [....]

-- Set properties in TBLPROPERTIES
> ALTER VIEW tempsc1.v2 SET TBLPROPERTIES ('created.by.user' = "John", 'created.date' = '01-01-2001' );

-- Use `DESCRIBE TABLE EXTENDED tempsc1.v2` to verify
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1                                                   int   NULL
                            c2                                                string   NULL

  # Detailed Table Information
                      Database                                               tempsc1
                         Table                                                    v2
              Table Properties [created.by.user=John, created.date=01-01-2001, ....]

-- Remove the key created.by.user and created.date from `TBLPROPERTIES`
> ALTER VIEW tempsc1.v2 UNSET TBLPROPERTIES (`created`.`by`.`user`, created.date);

-- Use `DESCRIBE TABLE EXTENDED tempsc1.v2` to verify the changes
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1       int   NULL
                            c2    string   NULL

  # Detailed Table Information
                      Database   tempsc1
                         Table        v2
              Table Properties    [....]

-- Change the view definition
> ALTER VIEW tempsc1.v2 AS SELECT * FROM tempsc1.v1;

-- Use `DESCRIBE TABLE EXTENDED` to verify
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1                        int   NULL
                            c2                     string   NULL

  # Detailed Table Information
                      Database                    tempsc1
                         Table                         v2
                          Type                       VIEW
                     View Text   select * from tempsc1.v1
            View Original Text   select * from tempsc1.v1

-- Transfer ownership of a view to another user
> ALTER VIEW v1 OWNER TO `alf@melmak.et`

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

-- Applies three tags to the view named `test`.
> ALTER VIEW test SET TAGS ('tag1' = 'val1', 'tag2' = 'val2', 'tag3' = 'val3');

-- Removes three tags from the view named `test`.
> ALTER VIEW test UNSET TAGS ('tag1', 'tag2', 'tag3');

Artigos relacionados

• DESCRIBE TABLE
• CREATE VIEW
• CRIAR A EXIBIÇÃO MATERIALIZADA
• DROP VIEW
• SHOW VIEWS