CREATE APPLICATION ROLE

Cria uma nova função de aplicativo ou substitui uma função de aplicativo existente. Use funções de aplicativo para ativar a segurança de controle de acesso para objetos dentro de um objeto de aplicativo.

Consulte Sobre as funções de aplicativo para obter mais informações.

Nota

As funções de aplicativo são válidas apenas no contexto de um objeto de aplicativo.

Ao criar uma função de aplicativo, você pode conceder privilégios em objetos à função de aplicativo. No script de configuração, você pode conceder a função de aplicativo a outras funções de aplicativo.

Depois de instalar um Snowflake Native App, os consumidores podem conceder funções de aplicativo a funções de conta para permitir o acesso ao aplicativo.

Com as funções do aplicativo, você pode conceder privilégios a outros objetos dentro do aplicativo ou a objetos de propriedade do aplicativo na conta do consumidor.

As funções do aplicativo são concedidas implicitamente ao proprietário do aplicativo WITH GRANT OPTION. O proprietário do aplicativo pode conceder essas funções a funções de nível de conta, fornecendo acesso aos objetos pertencentes ao aplicativo.

Consulte também:

ALTER APPLICATION ROLE, GRANT APPLICATION ROLE, REVOKE APPLICATION ROLE, SHOW APPLICATION ROLES

Sintaxe

CREATE [ OR REPLACE ] APPLICATION ROLE [ IF NOT EXISTS ] <name>
  [ COMMENT = '<string_literal>' ]
Copy

Parâmetros obrigatórios

name

Especifica o identificador da função do aplicativo. Esse valor deve ser exclusivo no objeto de aplicativo 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 application_name.application_role_name, o comando cria a função do aplicativo no aplicativo atual para a sessão.

Para obter mais detalhes, consulte Requisitos para identificadores.

Parâmetros opcionais

COMMENT = 'string_literal'

Especifica um comentário para a função do aplicativo.

Padrão: sem valor

Notas de uso

  • O número máximo de funções de aplicativo que podem ser criadas em um objeto de aplicativo é 20.

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

  • Instruções CREATE OR REPLACE <object> são atômicas. Ou seja, quando um objeto é substituído, o objeto antigo é excluído e o novo objeto é criado em uma única transação.

Exemplos

CREATE APPLICATION ROLE app_role
  COMMENT = 'Application role for the Hello Snowflake application.';
Copy
Linguagem: Português