CREATE TAG

Cria uma nova tag ou substitui uma tag existente no sistema.

Consulte também:

Especificação de valores da tag, Exibição TAGS, Referência DDL de tags

Sintaxe

CREATE [ OR REPLACE ] TAG [ IF NOT EXISTS ] <name> [ COMMENT = '<string_literal>' ]

CREATE [ OR REPLACE ] TAG [ IF NOT EXISTS ] <name>
    [ ALLOWED_VALUES '<val_1>' [ , '<val_2>' [ , ... ] ] ]
    [ COMMENT = '<string_literal>' ]
Copy

Importante

O parâmetro ALLOWED_VALUES deve sempre ser definido antes de todos os outros parâmetros, como COMMENT, para que ALLOWED_VALUES funcione.

Parâmetros obrigatórios

name

Identificador para a tag. Atribuir o valor da tag de cadeia de caracteres em um objeto usando uma instrução CREATE <objeto> ou uma instrução ALTER <objeto>.

O valor do identificador deve começar com um caractere alfabético e não pode conter espaços ou caracteres especiais, a menos que toda a cadeia de caracteres do identificador esteja entre aspas duplas (por exemplo “Meu objeto”). Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais detalhes, consulte Requisitos para identificadores.

Parâmetros opcionais

ALLOWED_VALUES 'val_1' [ , 'val_2' [ , ... ] ]

Especifica uma lista separada por vírgula dos possíveis valores de cadeia de caracteres que podem ser atribuídos à tag quando a tag é definida em um objeto usando o comando correspondente CREATE <objeto> ou ALTER <objeto>.

Deve vir antes de todos os outros parâmetros para funcionar.

O número máximo de valores de tag nesta lista é 300.

Padrão: NULL (todos os valores de cadeia de caracteres são permitidos, incluindo um valor de cadeia de caracteres vazio (isto é, ' ')).

COMMENT = 'string_literal'

Especifica um comentário para a tag.

Padrão: sem valor

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

CREATE TAG

Esquema

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.

Para detalhes adicionais sobre a tag DDL e privilégios, consulte Gerenciamento de tags.

Notas de uso

  • O Snowflake limita o número de tags em uma conta a 10.000.

  • Para obter mais informações sobre como as tags podem ser associadas aos objetos Snowflake, consulte Marcação de objetos.

  • Para obter mais informações sobre a autorização da tag DDL, consulte os privilégios obrigatórios.

  • 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.

  • Instruções CREATE OR REPLACE <object> são atômicas. Ou seja, quando um objeto é substituído, o objeto antigo é excluído e o novo objeto é criado em uma única transação.

Exemplos

Criar uma tag com a chave cost_center.

CREATE TAG cost_center COMMENT = 'cost_center tag';
Copy