Todos os produtos
Search
Central de documentação

MaxCompute:Operações de usuários e funções

Última atualização: Jun 26, 2026

Utilize instruções SQL para gerencie usuários e funções em um projeto do MaxCompute. O fluxo de trabalho típico é:

  1. Adicione usuários ao projeto.

  2. Crie uma função e conceda a ela permissões sobre objetos do projeto.

  3. Atribua a função aos usuários.

Para remover o acesso, revogue a função do usuário antes de removê-lo ou exclua a função.

Execute essas instruções no cliente MaxCompute, no console do DataWorks ou no MaxCompute Studio.

A tabela a seguir resume as operações disponíveis.

Operação

Descrição

Adicionar um usuário

Adicione uma conta Alibaba Cloud ou um usuário RAM a um projeto.

Remover um usuário

Remova uma conta Alibaba Cloud ou um usuário RAM de um projeto.

Listar usuários

Visualize todos os usuários em um projeto.

Criar uma função

Crie uma função em um projeto.

Listar funções

Visualize todas as funções em um projeto.

Conceder uma função a um usuário

Atribua uma função a um usuário.

Revogar uma função de um usuário

Remova a atribuição de uma função de um usuário.

Excluir uma função

Exclua uma função de um projeto.

Adicionar um usuário

Adiciona uma conta Alibaba Cloud ou um usuário do Resource Access Management (RAM) a um projeto do MaxCompute.

Importante

Apenas usuários RAM pertencentes à sua própria conta Alibaba Cloud podem ser adicionados. Não é possível adicionar usuários RAM de outras contas Alibaba Cloud.

Função necessária: Proprietário do projeto ou função Super_Administrator.

Sintaxe

add user <user_name>;

Parâmetro

Parâmetro

Obrigatório

Descrição

user_name

Sim

Nome da conta a ser adicionada. Formato: ALIYUN$<username>@aliyun.com para contas Alibaba Cloud ou RAM$<username> para usuários RAM.

Exemplos

Adicione uma conta Alibaba Cloud:

add user ALIYUN$test_user@aliyun.com;

Adicione um usuário RAM:

add user RAM$ram_test_user;

Remover um usuário

Remove uma conta Alibaba Cloud ou um usuário RAM de um projeto do MaxCompute. Após a remoção, o usuário não poderá mais acessar os recursos do projeto.

Importante

Revogue a função do usuário antes de removê-lo. O MaxCompute retém os dados de permissão após a remoção — se você adicionar o usuário novamente, as permissões de acesso históricas serão restauradas automaticamente.

Sintaxe

remove user <user_name>;

Parâmetro

Parâmetro

Obrigatório

Descrição

user_name

Sim

Nome da conta a ser removida. Formato: ALIYUN$<username>@aliyun.com para contas Alibaba Cloud ou RAM$<username> para usuários RAM.

Exemplos

Remova uma conta Alibaba Cloud:

remove user ALIYUN$test_user@aliyun.com;

Remova um usuário RAM:

remove user RAM$ram_test_user;

Listar usuários

Lista todos os usuários em um projeto do MaxCompute.

list users;

Criar uma função

Cria uma função em um projeto do MaxCompute. Após crie a função, conceda a ela permissões sobre objetos do projeto antes de atribuí-la aos usuários. Para obter detalhes, consulte Conceder permissão a uma função ou usuário.

Sintaxe

create role <role_name>;

Parâmetro

Parâmetro

Obrigatório

Descrição

role_name

Sim

Nome da função a ser criada.

Exemplo

-- Create the player role.
create role player;

Listar funções

Lista todas as funções em um projeto do MaxCompute.

list roles;

Conceder uma função a um usuário

Atribui uma função a um usuário. O usuário herda todas as permissões associadas à função.

Importante

Conceda permissões à função sobre objetos do projeto antes de atribuí-la aos usuários. Para obter detalhes, consulte Conceder permissão a uma função ou usuário.

Sintaxe

grant <role_name> to <user_name>;

Parâmetros

Parâmetro

Obrigatório

Descrição

role_name

Sim

Nome da função a ser atribuída.

user_name

Sim

Nome da conta à qual a função será atribuída. Formato: ALIYUN$<username>@aliyun.com para contas Alibaba Cloud ou RAM$<username> para usuários RAM.

Exemplo

-- Grant the player role to the Alibaba Cloud account test_user@aliyun.com.
grant player to ALIYUN$test_user@aliyun.com;

Revogar uma função de um usuário

Remove a atribuição de uma função de um usuário. O usuário perde todas as permissões associadas à função.

Sintaxe

revoke <role_name> from <user_name>;

Parâmetros

Parâmetro

Obrigatório

Descrição

role_name

Sim

Nome da função a ser revogada.

user_name

Sim

Nome da conta da qual a função será revogada. Formato: ALIYUN$<username>@aliyun.com para contas Alibaba Cloud ou RAM$<username> para usuários RAM.

Exemplo

-- Revoke the player role from the Alibaba Cloud account alice@aliyun.com.
revoke player from ALIYUN$alice@aliyun.com;

Excluir uma função

Exclui uma função de um projeto do MaxCompute.

Importante

Certifique-se de que nenhum usuário esteja atribuído à função antes de excluí-la. Primeiro, revogue a função de todos os usuários.

Sintaxe

drop role <role_name>;

Parâmetro

Parâmetro

Obrigatório

Descrição

role_name

Sim

Nome da função a ser excluída.

Exemplo

-- Delete the player role.
drop role player;