MaxCompute:Comandos de projeto

A tabela a seguir lista os comandos comuns para operações de projeto.

O MaxCompute não fornece comandos para criar ou excluir projetos. Para mais informações, consulte Create a MaxCompute project.

Obter o nome de um projeto

Um projeto MaxCompute difere de um workspace do DataWorks. Obtenha o nome do projeto da seguinte forma:

1. Faça login no MaxCompute console e selecione uma região no canto superior esquerdo.

2. No painel de navegação à esquerda, escolha Manage Configurations > Projects.

3. Na página Projects, obtenha o nome do projeto MaxCompute.

Acessar um projeto

Acesse um projeto para o qual você tenha permissões. Após entrar no projeto, execute operações diretamente nos objetos contidos nele.

• Sintaxe do comando

  -- Enter a project.
  USE <project_name>;

• Parâmetros

  project_name: Nome do projeto que você deseja acessar. O sistema retornará um erro caso o projeto não exista ou você não possua permissões para acessá-lo.

• Exemplos

  • Exemplo 1: Acesse um projeto e utilize um objeto nele existente.

    -- The current project is my_project. The project to be accessed is my_project_test. You have permissions to access my_project_test.
    odps@ my_project>USE my_project_test;
    -- After you enter the project, you can perform other operations. For example, you can query the test_src table in the my_project_test project.
    odps@ my_project_test>SELECT * FROM test_src;

    O MaxCompute busca automaticamente a tabela no projeto my_project_test. Se a tabela existir, os dados serão retornados. Caso contrário, o sistema exibirá uma mensagem de erro.

  • Exemplo 2: Para acessar um objeto em outro projeto, especifique o nome do projeto e garanta que possui as permissões necessárias sobre o objeto.

    • O exemplo abaixo ilustra o comportamento quando o recurso de schema está desativado no MaxCompute:

      -- Access the test_src table in the my_project2 project from the my_project_test project.
      odps@ my_project_test>SELECT * FROM my_project2.test_src;

    • Este exemplo aplica-se quando o recurso de schema está ativado no MaxCompute:

      -- Access the test_src table in the my_project2 project from the my_project_test project. The default schema of my_project2 is Default.
      odps@ my_project_test>SELECT * FROM my_project2.default.test_src;

      Nota

      • Para mais informações sobre como conceder permissões em objetos de um projeto de destino, consulte Project management.

      • Para mais detalhes sobre o recurso de schema, consulte Schema operations.

Visualizar propriedades do projeto

Visualize as configurações de propriedades no nível do projeto atual. O MaxCompute também permite consultar propriedades no nível da sessão. Para mais informações, consulte SHOW FLAGS.

• Sintaxe do comando

  SETPROJECT;

• Descrição das propriedades

  Veja a seguir as propriedades comuns de um projeto.

  Nome da propriedade (KEY)	Descrição	Faixa de valores (VALUE)
  odps.sql.allow.fullscan	Define se varreduras completas de tabela são permitidas no projeto. Varreduras completas consomem muitos recursos computacionais. Para melhorar a eficiência do processamento, recomendamos não ativar este recurso.	true: Varreduras completas de tabela são permitidas. false: Varreduras completas de tabela não são permitidas.
  odps.table.lifecycle	Determina se é obrigatório configurar um ciclo de vida para as tabelas do projeto.	optional: A cláusula Lifecycle é opcional na criação da tabela. Sem essa configuração, a tabela nunca expira. mandatory: A cláusula Lifecycle é obrigatória. Configure um ciclo de vida para a tabela. inherit: Se nenhum ciclo de vida for definido durante a criação da tabela, ela herdará o valor de odps.table.lifecycle.value.
  odps.table.lifecycle.value	Ciclo de vida da tabela. Unidade: dias.	De 1 a 37231. O valor padrão é 37231.
  odps.security.ip.whitelist	Lista de permissões de endereços IP autorizados a acessar o projeto pela Internet. Para mais informações, consulte Manage IP address whitelists.	Lista de endereços IP separados por vírgulas (,).
  odps.security.vpc.whitelist	Lista de permissões de endereços IP autorizados a acessar o projeto via VPC. Para mais informações, consulte Manage IP address whitelists.	VPC instance ID1,VPC instance ID2[IP address list].
  READ_TABLE_MAX_ROW	Quantidade máxima de registros de dados que uma instrução SELECT pode retornar.	De 1 a 10000. O valor padrão é 10000.
  odps.sql.type.system.odps2	Ativa ou desativa os novos tipos de dados do MaxCompute V2.0. Para mais informações sobre os tipos de dados V2.0, consulte Data type editions (V2.0).	true: ativado false: desativado
  odps.sql.hive.compatible	Ativa ou desativa o modo de compatibilidade com Hive. Ao ativar esse modo, o MaxCompute passa a aceitar diversas sintaxes específicas do Hive, como inputRecordReader, outputRecordReader e Serde. Para mais informações sobre tipos de dados compatíveis com Hive, consulte Hive-compatible data type edition.	true: ativado false: desativado
  odps.sql.decimal.odps2	Ativa ou desativa o tipo de dados DECIMAL(precision,scale) do MaxCompute V2.0. Para mais informações, consulte Data type editions (V2.0).	true: ativado false: desativado
  odps.sql.metering.value.max	Consumo máximo permitido para uma única instrução SQL. Para mais informações, consulte Consumption control for monitoring and alerting.	Nenhum.
  odps.sql.timezone	Fuso horário do projeto MaxCompute. Para mais informações sobre fusos horários, consulte Time zone configurations.	Nenhum.
  odps.sql.unstructured.oss.commit.mode	Define se o upload multipart deve ser ativado para gravar dados em tabelas externas do OSS. Para mais informações, consulte OSS external tables.	true: ativado false: desativado
  odps.sql.groupby.orderby.position.alias	Define se constantes inteiras nas cláusulas group by e order by devem ser interpretadas como números ordinais das colunas na lista SELECT. Nota Em projetos existentes, ativar esse parâmetro no nível do projeto pode afetar a análise e execução de tarefas já criadas. Antes de modificar esse parâmetro, confirme que as tarefas atuais continuarão funcionando corretamente com a lógica original após a alteração. Caso contrário, defina o parâmetro apenas no nível da sessão.	true: ativado false: desativado
  odps.forbid.fetch.result.by.bearertoken	Define se a aba Result no Logview deve ser impedida de exibir resultados de execução de jobs. Este parâmetro visa proteger a segurança dos dados.	true: Os resultados da execução do job não são exibidos. false: Exibe os resultados da execução do job.
  odps.cupidhistory.inprogress.remain.days	Período de retenção de logs históricos para jobs Spark on MaxCompute em execução. Unidade: dias.	De 1 a 7. O valor padrão é 7.
  odps.cupidhistory.remain.days	Período de retenção de logs históricos para jobs Spark on MaxCompute. Unidade: dias.	De 1 a 3. O valor padrão é 3.
  odps.ext.oss.orc.native	Define se a implementação de análise de arquivos de dados ORC deve ser atualizada quando um job no projeto lê uma tabela externa. A implementação original baseia-se na comunidade Java open source. A nova implementação utiliza C++, oferece suporte a versões mais recentes de arquivos ORC e aumenta significativamente a performance de análise de dados open source.	true: Utiliza a nova implementação nativa em C++ para analisar arquivos de dados ORC ao ler uma tabela externa. false: Utiliza a implementação original em Java da comunidade open source para analisar arquivos de dados ORC ao ler uma tabela externa.
  odps.ext.parquet.native	Define se a implementação de análise de arquivos de dados PARQUET deve ser atualizada quando um job no projeto lê uma tabela externa. A implementação original baseia-se na comunidade Java open source. A nova implementação utiliza C++ e aumenta significativamente a performance de análise de dados open source. Após a atualização, se houver muitos arquivos PARQUET pequenos e muitas colunas de dados, o número de requisições de acesso à fonte de dados poderá aumentar. Durante a criação da tabela, utilize a cláusula with serdeproperties com os parâmetros parquet.file.cache.size e parquet.io.buffer.size para ampliar a quantidade de dados armazenados em cache a cada acesso à fonte de dados.	true: Utiliza a nova implementação nativa em C++ para analisar arquivos de dados PARQUET ao ler uma tabela externa. false: Utiliza a implementação original em Java da comunidade open source para analisar arquivos de dados PARQUET ao ler uma tabela externa.
  odps.security.enabledownloadprivilege	Define se o controle de permissão de Download deve ser ativado para o projeto. Ao ativar esse recurso, é possível controlar as ações de funções ou usuários que utilizam o Tunnel para baixar tabelas e instâncias. Isso aprimora a segurança dos dados e previne violações. Para mais informações, consulte Download permission control.	true: Ativa o controle de permissão de Download. false: Desativa o controle de permissão de Download.
  odps.security.ip.whitelist.services	Lista de permissões de serviços. Este parâmetro evita a necessidade de configurar uma lista de permissões de endereços IP quando usuários acessam projetos MaxCompute por meio de serviços da Alibaba Cloud, como DataHub e SLS.	Formato: service1,service2. O nome do serviço deve estar previamente registrado no MaxCompute. Este parâmetro é frequentemente utilizado para o serviço LogShipper. O valor correspondente ao serviço é AliyunLogSLRService,AliyunLogDefaultService.

Definir propriedades do projeto

Defina as propriedades no nível do projeto. O comando para configurar essas propriedades apresenta uma latência entre 0 e 5 minutos. Após a execução bem-sucedida do comando, aguarde 5 minutos antes de verificar o resultado. O MaxCompute também permite definir propriedades no nível da sessão. Para mais informações, consulte SET.

• Sintaxe do comando

  SETPROJECT <KEY>=<VALUE>;

• Parâmetros

  • KEY: Nome da propriedade.

  • VALUE: Valor da propriedade. Para mais informações sobre as propriedades, consulte View project properties.

• Exemplo

  Permita varreduras completas de tabela no projeto.

  SETPROJECT odps.sql.allow.fullscan=true;

Visualizar os sistemas de conta de um projeto

LIST accountproviders;

Adicionar o sistema de usuários RAM

ADD accountprovider ram;

Remover o sistema de usuários RAM

REMOVE accountprovider ram;