ALTER TYPE¶

Modifica as propriedades de um tipo definido pelo usuário existente.

Consulte também:: CREATE TYPE , DESCRIBE TYPE , SHOW TYPES , DROP TYPE , UNDROP TYPE

Sintaxe¶

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

ALTER TYPE [ IF EXISTS ] <name> UNSET COMMENT

Parâmetros¶

name

Especifica o identificador para o tipo definido pelo usuário a ser alterado.

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

Especifica as propriedades a serem definidas para o tipo definido pelo usuário:

COMMENT = 'string_literal': Adiciona um comentário ou substitui um comentário existente para o tipo definido pelo usuário.

UNSET ...

Especifica de quais propriedades remover a definição para o tipo definido pelo usuário, o que as restaura para os padrões.

Atualmente, a única propriedade da qual você pode remover a definição é COMMENT, o que remove o comentário, se existir, para o tipo definido pelo usuário.

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	Tipo definido pelo usuário	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).

Operar em um objeto em um esquema requer pelo menos um privilégio no banco de dados pai e pelo menos um privilégio no esquema pai.

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¶

Adicionar um comentário ao tipo definido pelo usuário age:

ALTER TYPE age SET COMMENT = 'User-defined type for storing age values';

Remover o comentário do tipo definido pelo usuário age:

ALTER TYPE age UNSET COMMENT;