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¶

A função de banco de dados ML_USER SNOWFLAKE é concedida à função PUBLIC em todas as contas Snowflake com um banco de dados SNOWFLAKE compartilhado e permite que os clientes acessem e utilizem funções de ML. Os usuários também devem ter o privilégio USAGE no esquema de ML para chamar essas funções.

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 sensitive data classification.

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

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.

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

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.

Por padrão, essa função não é concedida a nenhuma função. Se você quiser que os usuários tenham acesso às funções de incorporação, conceda essa função de banco de dados às funções apropriadas. Para obter mais detalhes, consulte Privilégios obrigatórios para as funções de LLM do Cortex

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

A função de banco de dados SNOWFLAKE.CORTEX_USER é usada para conceder aos clientes acesso aos recursos do Snowflake Cortex. Por padrão, esta função é concedida à função PUBLIC. A função PUBLIC é concedida automaticamente a todos os usuários e funções, portanto, isto permite que todos os usuários em sua conta usem os funções de LLM do Snowflake Cortex.

Se não quiser que todos os usuários tenham esse privilégio, você pode revogar o acesso na função PUBLIC e conceder acesso a funções específicas. Para obter detalhes, consulte Privilégios necessários das funções LLM do Cortex.

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

A função de banco de dados SNOWFLAKE.COPILOT_USER permite que os clientes acessem os recursos do Snowflake Copilot. Inicialmente, essa função de banco de dados é concedida à função PUBLIC. A função PUBLIC é concedida automaticamente a todos os usuários e funções, o que permite que todos os usuários de sua conta utilizem o Snowflake Copilot. Se quiser limitar o acesso a recursos do Snowflake Copilot, é possível revogar o acesso na função PUBLIC e conceder acesso a funções específicas. Para obter mais detalhes, consulte 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.

No exemplo a seguir é criada uma função que pode ser usada para visualizar metadados de objetos de banco de dados SNOWFLAKE, e faz o seguinte:

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