Funções de banco de dados SNOWFLAKE¶

Esquema ACCOUNT_USAGE¶

Os esquemas ACCOUNT_USAGE têm quatro funções de banco de dados SNOWFLAKE definidas, cada uma concedendo o privilégio SELECT em exibições específicas.

Esquema READER_ACCOUNT_USAGE¶

A função READER_USAGE_VIEWER SNOWFLAKE do banco de dados recebe o privilégio SELECT em todas as exibições READER_ACCOUNT_USAGE. Como as contas de leitores são criadas pelos clientes, espera-se que a função READER_USAGE_VIEWER seja concedida às funções usadas para monitorar o uso das contas de leitores.

Esquema ORGANIZATION_USAGE¶

As funções de banco de dados SNOWFLAKE ORGANIZATION_USAGE_VIEWER, ORGANIZATION_BILLING_VIEWER e ORGANIZATION_ACCOUNTS_VIEWER recebem o privilégio SELECT nas exibições do Uso da organização no banco de dados SNOWFLAKE compartilhado.

Esquema CORE¶

A função CORE_VIEWER SNOWFLAKE do banco de dados é concedida à função PUBLIC em todas as contas Snowflake contendo um banco de dados SNOWFLAKE compartilhado. O privilégio USAGE é concedido a todas as funções e pacotes definidos pelo Snowflake no esquema CORE.

Esquema ALERT¶

A função ALERT_VIEWER SNOWFLAKE do banco de dados recebe o privilégio USAGE nas funções definidas neste esquema.

Esquema ML¶

The ML_USER SNOWFLAKE database role is granted to the PUBLIC role in all Snowflake accounts that contain a shared SNOWFLAKE database and allows customers to access and use ML functions. Users must also have the USAGE privilege on the ML schema to call these functions.

Esquema MONITORING¶

A função de banco de dados MONITORING_VIEWER tem privilégio SELECT em todas as exibições no esquema MONITORING.

A função de banco de dados MONITORING_VIEWER é concedida à função PUBLIC em todas as contas Snowflake com um banco de dados SNOWFLAKE compartilhado.

Função de banco de dados SNOWFLAKE.CLASSIFICATION_ADMIN¶

The SNOWFLAKE.CLASSIFICATION_ADMIN database role allows a data engineer or steward to create an instance of the CLASSIFICATION_PROFILE class. A classification profile is used to implement automatic sensitive data classification.

SNOWFLAKE.CORTEX_AGENT_USER database role¶

Você pode usar a função de banco de dados SNOWFLAKE.CORTEX_AGENT_USER para conceder aos seus usuários acesso à API Snowflake Cortex Agents sem conceder acesso a outros recursos do Cortex. O uso da API Cortex Agents requer ou a função de banco de dados SNOWFLAKE.CORTEX_USER ou a função de banco de dados SNOWFLAKE.CORTEX_AGENT_USER.

Por padrão, a função de banco de dados SNOWFLAKE.CORTEX_USER é concedida à função PUBLIC. Para um controle de acesso mais granular, revogue o acesso da função PUBLIC e conceda acesso à função de banco de dados SNOWFLAKE.CORTEX_AGENT_USER. Para obter mais informações, consulte Configuração do acesso ao agente.

SNOWFLAKE.CORTEX_EMBED_USER database role¶

A função de banco de dados SNOWFLAKE.CORTEX_EMBED_USER é utilizada para conceder aos clientes acesso às funções de incorporação AI_EMBED, SNOWFLAKE.CORTEX.EMBED_768 e SNOWFLAKE.CORTEX_EMBED_TEXT_1024 do Snowflake Cortex sem conceder acesso a outros recursos do Cortex. Chamar essas funções de incorporação requer ou o SNOWFLAKE.CORTEX_USER Função de banco de dados ou o SNOWFLAKE.CORTEX_EMBED_USER Função de banco de dados do. Esta função não é concedida a nenhuma função por padrão.

By default, this role is not granted to any roles. If you want users to have access to the embedding functions, grant this database role to appropriate roles. For details, see Cortex LLM Functions required privileges

SNOWFLAKE.CORTEX_USER database role¶

This SNOWFLAKE.CORTEX_USER database role is used to grant customers access to Snowflake Cortex features. By default, this role is granted to the PUBLIC role. The PUBLIC role is automatically granted to all users and roles, so this allows all users in your account to use Snowflake Cortex LLM functions.

If you don’t want all users to have this privilege, you can revoke access from the PUBLIC role and grant access to specific roles. For details, see Cortex LLM Functions required privileges.

Função de banco de dados SNOWFLAKE.COPILOT_USER¶

The SNOWFLAKE.COPILOT_USER database role allows customers to access Snowflake Copilot features. Initially, this database role is granted to the PUBLIC role. The PUBLIC role is automatically granted to all users and roles, so this allows all users in your account to use Snowflake Copilot. If you want to limit access to Snowflake Copilot features, you can revoke access from the PUBLIC role and grant access to specific roles. For details, see Requisitos de controle de acesso.

Como usar as funções de banco de dados SNOWFLAKE¶

Os administradores podem usar o GRANT DATABASE ROLE para atribuir uma função de banco de dados SNOWFLAKE a outra função, que pode então ser concedida a um usuário. Isto permitiria ao usuário acessar um subconjunto específico de exibições no banco de dados SNOWFLAKE.

In the following example a role is created which can be used to view SNOWFLAKE database object metadata, and does the following:

1. Cria uma função personalizada.

2. Concede a função OBJECT_VIEWER à função personalizada.

3. Concede a função personalizada a um usuário.

Para criar e conceder a função personalizada, faça o seguinte:

1. Crie a função CAN_VIEWMD, usando CREATE ROLE que será usada para conceder acesso aos metadados dos objetos.

   Somente usuários com a função do sistema USERADMIN ou superior, ou outra função com o privilégio CREATE ROLE para a conta podem criar funções.

   CREATE ROLE CAN_VIEWMD COMMENT = 'This role can view metadata per SNOWFLAKE database role definitions';
   

   Copy

2. Concede a função OBJECT_VIEWER à função CAN_VIEWMD.

   Somente usuários com a função OWNERSHIP podem conceder funções de banco de dados SNOWFLAKE. Para obter informações adicionais, consulte GRANT DATABASE ROLE.

   GRANT DATABASE ROLE OBJECT_VIEWER TO ROLE CAN_VIEWMD;
   

   Copy

3. Atribua a função CAN_VIEWMD ao usuário smith.

   Somente usuários com a função SECURITYADMIN podem conceder funções aos usuários. Para opções adicionais, consulte GRANT ROLE.

   GRANT ROLE CAN_VIEWMD TO USER smith;
   

   Copy