ALTER DATABASE ROLE

Modifica as propriedades de uma função de banco de dados existente.

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

Consulte também:

CREATE DATABASE ROLE , DROP DATABASE ROLE , SHOW DATABASE ROLES

Sintaxe

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

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

ALTER DATABASE ROLE [ IF EXISTS ] <name> UNSET COMMENT

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

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

Parâmetros

name

Especifica o identificador (ou seja, nome) para a função do banco de dados; deve ser único no banco de dados no qual a função é criada.

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

Se o identificador não estiver totalmente qualificado na forma de db_name.database_role_name, o comando procura a função do banco de dados no banco de dados atual para a sessão.

RENAME TO new_name

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

Para obter mais detalhes, consulte Requisitos para identificadores.

Observe que ao especificar o nome totalmente qualificado da função do banco de dados, você não poderá especificar um banco de dados diferente. O nome do banco de dados, db_name, deve permanecer o mesmo. Somente o database_role_name pode mudar durante uma operação de renomeação.

SET ...

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

COMMENT = 'string_literal'

Adiciona um comentário ou substitui um comentário existente para a função do banco de dados.

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 mais detalhes sobre como especificar tags em uma instrução, consulte Cotas de tags para objetos e colunas.

UNSET ...

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

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

Privilégios 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

Função de banco de dados

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

A função de proprietário não herda nenhuma permissão concedida à função do banco de dados que possui. Para herdar permissões de um função de banco de dados, essa função de banco de dados precisa ser concedida a outra, criando uma relação pai-filho em uma hierarquia de funções.

APPLY

Tag

Permite definir uma tag em uma função do banco de dados.

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

Renomeie a função do banco de dados dr1 como dbr2 no banco de dados d1:

ALTER DATABASE ROLE d1.dr1 RENAME TO d1.dbr2;
Copy

Adicione um comentário para a função de banco de dados d1.dbr2:

ALTER DATABASE ROLE d1.dbr2 SET COMMENT = 'New comment for database role';
Copy