UNDROP TAG¶

Restaura a versão mais recente de uma tag no sistema.

Para obter mais detalhes sobre este comando e referências de tags, consulte Cotas de tags para objetos e colunas.

Consulte também:: Referência DDL de tags

Sintaxe¶

UNDROP TAG <name>

Copy

Parâmetros¶

name

Identificador para a tag.

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, "My object"). Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais detalhes, consulte Requisitos para identificadores.

Requisitos de controle de acesso¶

Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:

Privilégio	Objeto	Notas
OWNERSHIP	Tag	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).

Observe que operar em qualquer objeto de um esquema também requer o privilégio USAGE no banco de dados e esquema principais.

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¶

A restauração de tags só é suportada no esquema atual ou no banco de dados atual, mesmo que o nome da tabela esteja totalmente qualificado.
Se a tag foi atribuída a um ou mais objetos quando o comando DROP TAG foi executado, o comando UNDROP restaura as atribuições da tag para os objetos. Para obter mais detalhes, consulte Cotas de tags para objetos e colunas.
Se já existir uma tag com o mesmo nome, um erro é devolvido.

UNDROP conta com o recurso Snowflake Time Travel. Um objeto só pode ser restaurado se o objeto foi excluído dentro do Período de retenção de dados. O valor padrão é 24 horas.

Exemplo¶

O exemplo a seguir restaura a versão mais recente da tag chamada cost_center:

UNDROP TAG cost_center;

Copy