Controle de acesso a tabelas dinâmicas¶

Transferência de propriedade¶

Para fornecer a um usuário acesso total a uma tabela dinâmica, você pode fazer o seguinte:

• Conceda OWNERSHIP na tabela dinâmica a uma função.

• Conceda todos os privilégios, exceto OWNERSHIP, na tabela dinâmica a uma função.

• Conceda o privilégio OWNERSHIP ou ALL PRIVILEGES em futuras tabelas dinâmicas a uma função.

Ao atribuir concessões, certifique-se de especificar o tipo de objeto como DYNAMIC TABLE porque as tabelas dinâmicas têm um conjunto de privilégios diferente das tabelas regulares.

Para conceder o privilégio OWNERSHIP em tabelas dinâmicas, certifique-se de que a função receptora tenha o privilégio USAGE nos seguintes itens. Caso contrário, as atualizações agendadas subsequentes falharão.

• O banco de dados e o esquema que contém a tabela dinâmica.

• O warehouse usado para atualizar a tabela.

Para transferir a propriedade de uma tabela dinâmica, você pode usar o comando GRANT OWNERSHIP ou o Snowsight.

GRANT OWNERSHIP ON DYNAMIC TABLE my_dynamic_table TO ROLE budget_admin;

GRANT OWNERSHIP ON FUTURE DYNAMIC TABLES IN SCHEMA mydb.myschema TO ROLE budget_admin;

Para saber mais sobre o modelo de privilégio Snowflake, consulte Visão geral do controle de acesso e Privilégios de controle de acesso.

Atualizar tabelas dinâmicas com funções secundárias e privilégios de usuário específicos¶

As tabelas dinâmicas podem ser configuradas para serem atualizadas com os privilégios de um usuário específico, além dos privilégios da função de proprietário. As tabelas dinâmicas que especificam EXECUTE AS USER são executadas em nome do usuário nomeado, em vez do usuário do sistema.

Por exemplo, você pode conceder a um usuário uma função primária que fornece acesso a uma tabela e uma função secundária que fornece acesso a um warehouse virtual. O usuário pode então criar uma tabela dinâmica que opera com os privilégios combinados de ambas as funções, simplificando o gerenciamento de privilégios e aumentando a flexibilidade das suas operações de dados.

Embora a opção EXECUTE AS USER permita que as tabelas dinâmicas sejam atualizadas sob a função do usuário, todas as outras operações nessas tabelas dinâmicas seguem o modelo de privilégio padrão.

CREATE DYNAMIC TABLE my_dynamic_table
  [ EXECUTE AS USER my_user_name
    [ USE SECONDARY ROLES { ALL | NONE | (<role1>, <role2>, ... ) } ]
  ]

ALTER DYNAMIC TABLE my_dynamic_table SET
  EXECUTE AS USER my_user_name
  [ USE SECONDARY ROLES { ALL | NONE | (<role1>, <role2>, ... ) } ]

ALTER DYNAMIC TABLE my_dynamic_table UNSET EXECUTE AS USER;

Privilégios para criar uma tabela dinâmica¶

Para criar uma tabela dinâmica, você deve usar uma função que tenha os seguintes privilégios:

Para criar uma tabela dinâmica que depende de outra tabela dinâmica, você deve usar uma função que tenha os seguintes privilégios:

Privilégios para consultar uma tabela dinâmica¶

Para consultar uma tabela dinâmica, você pode usar uma função que tenha privilégios para criar uma tabela dinâmica. Para cenários em que um usuário só precisa consultar uma tabela dinâmica – por exemplo, um analista de dados – use uma função que tenha os seguintes privilégios:

Privilégios para alterar uma tabela dinâmica¶

Para alterar uma tabela dinâmica, você deve usar uma função que tenha o privilégio OWNERSHIP ou OPERATE nessa tabela dinâmica.

Se você tiver o privilégio OPERATE em uma tabela dinâmica, poderá fazer o seguinte com o comando ALTER DYNAMIC TABLE:

• Suspender uma tabela dinâmica usando ALTER … SUSPEND.

• Retomar uma tabela dinâmica usando ALTER … RESUME.

• Atualizar uma tabela dinâmica usando ALTER … REFRESH.

• Definir ou alterar o warehouse e/ou o meta de atraso usando ALTER … SET.

Se você tiver o privilégio OWNERSHIP em uma tabela dinâmica, poderá fazer o seguinte, além das operações listadas acima:

• Defina ou desmarque um comentário usando ALTER … SET | UNSET COMMENT.

• Renomeie uma tabela dinâmica usando ALTER … RENAME TO.

• Troque uma tabela dinâmica por outra usando ALTER … SWAP WITH

• Defina um novo parâmetro usando ALTER … SET

• Especifique ou elimine as chaves de clustering. Consulte Ações de clustering (clusteringAction).

• Altere as políticas de governança. Consulte Política de governança de dados e ações de tag (dataGovnPolicyTagAction).

• Altere a otimização de pesquisa. Consulte Ações de otimização de pesquisa (searchOptimizationAction).

Privilégios para visualizar os metadados de uma tabela dinâmica¶

Para exibir metadados, você deve usar uma função que tenha privilégio MONITOR nessa tabela dinâmica.

Para cenários em que o usuário só precisa visualizar os metadados e a exibição Information Schema de uma tabela dinâmica (por exemplo, funções ocupadas por cientistas de dados), use uma função que tenha o privilégio MONITOR nessa tabela dinâmica. Embora o privilégio OPERATE conceda esse acesso, ele também inclui a capacidade de alterar tabelas dinâmicas, tornando MONITOR a opção mais adequada para cenários em que um usuário não precisa alterar uma tabela dinâmica.

Se você tiver o privilégio MONITOR em uma tabela dinâmica, poderá fazer o seguinte:

• Usar o comando DESCRIBE DYNAMIC TABLE e a página de detalhes de tabelas dinâmicas Snowsight para visualizar os detalhes específicos de uma tabela dinâmica. Os campos a seguir ficarão ocultos se você tiver apenas o privilégio SELECT em uma tabela dinâmica: text, warehouse, scheduling_state, last_suspended_on e suspend_reason_code (somente UI).

• Usar o comando SHOW DYNAMIC TABLES para visualizar a quais tabelas dinâmicas você tem acesso.

• Chame a função de tabela DYNAMIC_TABLE_GRAPH_HISTORY para exibir o histórico do gráficos.

• Chame a função de tabela DYNAMIC_TABLE_REFRESH_HISTORY para exibir o histórico de atualizações.

Privilégios para descartar uma tabela dinâmica¶

Para descartar uma tabela dinâmica, você deve usar uma função que tenha o privilégio OWNERSHIP nessa tabela dinâmica.

Privilégios para uso de warehouses duplos¶

Todos os requisitos de privilégio para usar INITIALIZATION_WAREHOUSE são os mesmos que WAREHOUSE.

Para obter mais informações, consulte Entender o uso do warehouse para tabelas dinâmicas.