Partilhar via

ALTER VIEW

  • Artigo

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime

Altera os metadados associados à exibição. Ele pode alterar a definição do modo de exibição, alterar o nome de um modo de exibição para um nome diferente, definir e desdefinir os metadados do modo de exibição definindo TBLPROPERTIES.

Para adicionar ou alterar um comentário sobre uma visualização ou suas colunas, use COMENTAR SOBRE.

Se o modo de exibição estiver armazenado em cache, o comando limpará os dados armazenados em cache do modo de exibição e todos os seus dependentes que se referem a ele. O cache da exibição será preenchido preguiçosamente quando a exibição for acessada na próxima vez. O comando deixa os dependentes da exibição como não armazenados em cache.

Sintaxe

ALTER VIEW view_name
  { rename |
    SET TBLPROPERTIES clause |
    UNSET TBLPROPERTIES clause |
    alter_body |
    schema_binding |
    owner_to |
    SET TAGS clause |
    UNSET TAGS clause }

rename
  RENAME TO to_view_name

alter_body
  AS query

schema_binding
  WITH SCHEMA { BINDING | [ TYPE ] EVOLUTION | COMPENSATION }

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

owner_to
  [ SET ] OWNER TO principal

Parâmetros

  • view_name

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

  • RENOMEIE PARA to_view_name

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

    to_view_name especifica o novo nome do modo de exibição. Se o to_view_name já existe, um TableAlreadyExistsException é jogado. Se to_view_name for qualificado, deve corresponder ao nome do esquema de view_name.

  • DEFINIR TBLPROPERTIES

    Define ou redefine uma ou mais propriedades definidas pelo usuário.

  • UNSET TBLPROPERTIES

    Remove uma ou mais propriedades definidas pelo usuário.

  • Consulta AS

    Uma consulta que constrói o modo de exibição a partir de tabelas base ou outros modos de exibição.

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

  • schema_binding

    Aplica-se a:Marque Sim Databricks Runtime 15.3 e superior

    Especifica como a consulta subsequente do modo de exibição se adapta às alterações no esquema do modo de exibição devido a alterações nas definições de objeto subjacentes. Consulte CREATE VIEW... WITH SCHEMA para obter detalhes sobre os modos de vinculação de esquema.

  • [ CONJUNTO ] DO PROPRIETÁRIO AO Principal

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

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

    SET é permitido como palavra-chave opcional.

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

    Aplique tags à exibição. Você precisa ter APPLY TAG permissão para adicionar tags à exibição.

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

  • TAGS NÃO DEFINIDAS ( tag_name [, ...] )

    Remova as tags da tabela. Você precisa ter APPLY TAG permissão para remover tags da exibição.

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

  • tag_name

    Um literal STRING. O tag_name deve ser único dentro da vista.

  • tag_value

    Um literal STRING.

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`

-- Change the view schema binding to adopt type evolution
> ALTER VIEW v1 WITH SCHEMA TYPE EVOLUTION;

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