ALTER SEMANTIC VIEW

Modifica o comentário de uma visualização semântica existente.

Nota

Você não pode usar o comando ALTER SEMANTIC VIEW para alterar propriedades diferentes do comentário. Substitua a visualização semântica para alterar outras propriedades dela. Consulte Substituição de uma exibição semântica existente.

Consulte também:

CREATE SEMANTIC VIEW , DESCRIBE SEMANTIC VIEW , DROP SEMANTIC VIEW , SHOW SEMANTIC VIEWS , SHOW SEMANTIC DIMENSIONS , SHOW SEMANTIC METRICS , SHOW SEMANTIC DIMENSIONS FOR METRIC

Sintaxe

ALTER SEMANTIC VIEW [ IF EXISTS ] <name> SET
  COMMENT = '<string_literal>'

ALTER SEMANTIC VIEW [ IF EXISTS ] <name> UNSET
  COMMENT
Copy

Parâmetros

name

Especifica o identificador da visualização semântica a ser alterada.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

SET ...

Define uma ou mais propriedades ou parâmetros especificados para a visualização semântica:

COMMENT = 'string_literal'

Adiciona um comentário ou substitui um comentário existente para a visualização semântica.

UNSET ...

Desmarca uma ou mais propriedades ou parâmetros especificados para a visualização semântica, o que redefine as propriedades para seus padrões:

  • COMMENT

Para desmarcar várias propriedades ou parâmetros com uma única instrução ALTER, separe cada propriedade ou parâmetro com uma vírgula.

Ao desmarcar uma propriedade ou parâmetro, especifique apenas o nome da propriedade ou parâmetro (a menos que a sintaxe acima indique que você deve especificar o valor). Especificar o valor retorna um erro.

Requisitos de controle de acesso

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Privilégio

Objeto

Notas

OWNERSHIP

Exibição semântica

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um esquema.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso

  • Em relação aos metadados:

    Atenção

    Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

Exemplos

O exemplo a seguir define o comentário para uma visualização semântica:

ALTER SEMANTIC VIEW my_semantic_view SET COMMENT = 'my comment';
Copy

O exemplo a seguir desativa o comentário existente para uma visualização semântica:

ALTER SEMANTIC VIEW my_semantic_view UNSET COMMENT;
Copy
Linguagem: Português