ALTER APPLICATION ROLE¶

Sintaxe¶

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

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

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

Parâmetros¶

name

Especifica o identificador da função do aplicativo. 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 do aplicativo. O identificador deve ser exclusivo dentro do aplicativo.

Para obter mais detalhes, consulte Requisitos para identificadores.

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

SET ...

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

COMMENT = 'string_literal'

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

UNSET ...

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

• COMMENT

Notas de uso¶

• Este comando só pode ser executado no contexto de um aplicativo criado usando o Native Apps Framework.

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

• A renomeação de uma função do aplicativo só é permitida dentro do mesmo aplicativo.

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

ALTER APPLICATION ROLE app_role RENAME TO new_app_role;

ALTER APPLICATION ROLE app_role SET
  COMMENT = 'Application role for the Hello Snowflake application.';

ALTER APPLICATION ROLE app_role UNSET COMMENT;