ALTER ROLE

Modifica as propriedades de uma função personalizada existente. Atualmente, as únicas operações suportadas são a renomeação de uma função ou a adição/substituição/exclusão de um comentário para uma função.

Consulte também:

CREATE ROLE , DROP ROLE , SHOW ROLES

Sintaxe

ALTER ROLE [ IF EXISTS ] <name> RENAME TO <new_name>

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

ALTER ROLE [ IF EXISTS ] <name> UNSET COMMENT

ALTER ROLE [ IF EXISTS ] <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER ROLE [ IF EXISTS ] <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
Copy

Parâmetros

name

Especifica o identificador da função 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.

RENAME TO new_name

Especifica o novo identificador da função; deve ser único para sua conta.

Para obter mais detalhes, consulte Requisitos para identificadores.

SET ...

Especifica as propriedades a serem definidas para a função:

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Especifica o nome da tag e o valor da cadeia de caracteres dela.

O valor de tag é sempre uma cadeia de caracteres, e o número máximo de caracteres do valor da tag é 256.

Para obter informações sobre como especificar tags em uma instrução, consulte Cotas de tags para objetos e colunas.

COMMENT = 'string_literal'

Adiciona um comentário ou substitui um comentário existente para a função.

UNSET ...

Especifica as propriedades a serem removidas para a função, o que as restaura para os padrões.

  • TAG tag_name [ , tag_name ... ]

  • COMMENT

Notas de uso

  • Somente o proprietário da função (ou seja, a função com o privilégio OWNERSHIP na função), ou uma função superior, pode executar este comando.

  • Para renomear uma função (usando o parâmetro RENAME TO new_name), a função que executa este comando também deve ter o privilégio global CREATE ROLE.

  • 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

Renomear a função role1 como role2:

ALTER ROLE role1 RENAME TO role2;
Copy

Adicionar um comentário para a função myrole:

ALTER ROLE myrole SET COMMENT = 'New comment for role';
Copy