Introdução às organizações¶
Este tópico discute como trabalhar com organizações, incluindo como atribuir a função ORGADMIN aos administradores da organização.
Criação de organização¶
Os clientes do Snowflake nunca criam diretamente uma organização. Para os usuários que se inscrevem em uma conta Snowflake usando a opção de autoatendimento, uma organização é criada automaticamente com um nome gerado pelo sistema quando a conta é criada. Para entidades que trabalham diretamente com o pessoal do Snowflake para criar contas, o Snowflake cria a organização à qual as contas pertencem usando um nome personalizado. Em ambos os casos, os usuários podem criar contas adicionais que pertencem à organização depois que ela é criada com a conta inicial.
Exibição do nome da sua organização e das contas¶
Se você for o administrador da organização, poderá visualizar o nome de sua organização e de suas contas por meio da interface da Web ou usando SQL:
- SQL:
Execute um comando SHOW ACCOUNTS.
- Snowsight:
Selecione Admin » Accounts. O nome da organização é listado acima dos nomes das contas.
Usuários com qualquer função, não apenas ORGADMIN, podem executar a função CURRENT_ORGANIZATION_NAME para retornar a organização da conta atual.
Os usuários com qualquer função também podem encontrar o nome da organização e o nome da conta de uma conta específica na qual fizeram login anteriormente. Consulte Como encontrar o nome da conta e organização de uma conta.
Alteração do nome de sua organização¶
Se você quiser mudar o nome de uma organização, por exemplo, mudar de um nome gerado pelo sistema para um nome mais fácil de usar, entre em contato com o suporte Snowflake.
Ao entrar em contato com o suporte do Snowflake, você deve decidir se os usuários podem acessar temporariamente as contas na organização usando o URL da conta original. Se você mantiver o URL da conta original, ele será cancelado automaticamente após 90 dias, momento em que os usuários deverão usar o novo URL da conta para acessá-la. Se você quiser descartar o URL da conta antes que os 90 dias expirem, consulte Exclusão de um URL da organização.
Exclusão de uma organização¶
Para excluir sua organização Snowflake:
Use uma conta habilitada pelo ORGADMIN para excluir todas as contas na organização, exceto a conta que está sendo usada para a exclusão.
Entre em contato com o Suporte da Snowflake para excluir a última conta e a organização.
Ativação da função ORGADMIN em uma conta¶
Um administrador da organização usa uma conta com a função ORGADMIN ativada para trabalhar com dados e recursos pertencentes a todas as contas da organização. Depois que a função ORGADMIN for ativada, o administrador da organização poderá fazer login na conta e usar a função para executar tarefas focadas na organização, como listar todas as contas da organização e criar novas contas.
Cada organização tem pelo menos uma conta com a função ORGADMIN ativada. O administrador da organização pode usar o comando ALTER ACCOUNT … SET IS_ORG_ADMIN para ativar a função em contas adicionais.
Por exemplo, para ativar a função ORGADMIN para a conta existente my_account1
, o administrador da organização pode executar o seguinte comando a partir de uma conta que já tenha a função ORGADMIN ativada:
USE ROLE orgadmin;
ALTER ACCOUNT my_account1 SET IS_ORG_ADMIN = TRUE;
Lembre-se do seguinte ao ativar a função ORGADMIN:
A sintaxe ALTER ACCOUNT aceita apenas o formato de nome da conta do identificador da conta. Você não pode usar o localizador de contas para especificar a conta.
Por padrão, a função ORGADMIN pode ser habilitada em, no máximo, 8 contas. Se sua organização precisar de mais contas com a função ORGADMIN, entre em contato com o suporte Snowflake.
A função ORGADMIN não pode ser ativada para uma conta de leitor.
Desativação da função ORGADMIN¶
Um administrador da organização pode usar o comando ALTER ACCOUNT para remover a função ORGADMIN de uma conta definindo a propriedade IS_ORG_ADMIN como FALSE
. Por exemplo:
ALTER ACCOUNT my_account1 SET IS_ORG_ADMIN = FALSE;
Dica
A função ORGADMIN não pode ser removida da conta atual. Como solução alternativa, ative a função em uma conta diferente e alterne para essa conta antes de executar o comando ALTER ACCOUNT.
Atribuição da função ORGADMIN para um usuário ou função¶
Uma vez ativada em uma conta, a função ORGADMIN pode ser concedida a qualquer usuário ou função na conta por um ACCOUNTADMIN usando o comando GRANT ROLE. Para obter mais informações sobre as funções do sistema e práticas recomendadas para gerenciar o controle de acesso, consulte Considerações sobre o controle de acesso.
Exemplos¶
-- Assume the ACCOUNTADMIN role
USE ROLE accountadmin;
-- Grant the ORGADMIN role to a user
GRANT ROLE orgadmin TO USER user1;
-- Grant ORGADMIN to a role
GRANT ROLE orgadmin TO ROLE custom_role;