MaxCompute:Operações 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 do 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 do MaxCompute.

Acessar um projeto

Acesse um projeto com as permissões necessárias. 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 a ser acessado. O sistema retornará um erro se o projeto não existir ou se você não tiver permissões de acesso.

• Exemplos

  • Exemplo 1: Acessar um projeto e consultar um objeto interno.

    -- 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á um erro.

  • Exemplo 2: Para acessar um objeto em outro projeto, tenha as permissões adequadas sobre o objeto e especifique o nome do projeto.

    • 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

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

• Sintaxe do comando

  SETPROJECT;

• Descrição das propriedades

  A seguir estão 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, recomenda-se 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 assumirá o valor de odps.table.lifecycle.value.
  odps.table.lifecycle.value	Ciclo de vida da tabela. Unidade: dias.	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.	Uma 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 que uma instrução SELECT pode retornar.	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 suportar 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 dado 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.	true: ativado false: desativado
  odps.sql.groupby.orderby.position.alias	Define se constantes inteiras nas cláusulas group by e order by devem ser tratadas 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 atuais. Antes de modificar esse parâmetro, certifique-se de que as tarefas existentes continuarão funcionando corretamente com a lógica original após a alteração. Caso contrário, defina o parâmetro no nível de 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.	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.	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 open source Java. A nova implementação usa C++, suporta versões mais recentes de arquivos ORC e melhora o desempenho de análise de dados open source em várias vezes.	true: A nova implementação nativa baseada em C++ é usada para analisar arquivos de dados ORC ao ler uma tabela externa. false: A implementação original baseada em Java da comunidade open source é usada 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 open source Java. A nova implementação usa C++ e melhora o desempenho de análise de dados open source em várias vezes. Após a atualização, se houver muitos arquivos PARQUET pequenos e muitas colunas de dados, o número de solicitações de acesso à fonte de dados pode aumentar. Ao criar uma tabela, utilize a cláusula with serdeproperties com os parâmetros parquet.file.cache.size e parquet.io.buffer.size para aumentar a quantidade de dados armazenados em cache a cada acesso à fonte de dados.	true: A nova implementação nativa baseada em C++ é usada para analisar arquivos de dados PARQUET ao ler uma tabela externa. false: A implementação original baseada em Java da comunidade open source é usada 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. Com esse recurso ativo, é possível controlar as ações de funções ou usuários que utilizam o Tunnel para baixar tabelas e instâncias. Isso aumenta a segurança dos dados e previne vazamentos. Para mais informações, consulte Download permission control.	true: Ativar controle de permissão de Download. false: Desativar 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 IP quando usuários acessam projetos do 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 usado para o serviço LogShipper. O valor para Service é AliyunLogSLRService,AliyunLogDefaultService.

Definir propriedades do projeto

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

• Sintaxe do comando

  SETPROJECT <KEY>=<VALUE>;

• Parâmetros

  • KEY: O nome da propriedade.

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

• Exemplo

  Permitir varreduras completas de tabela no projeto.

  SETPROJECT odps.sql.allow.fullscan=true;

Visualizar os sistemas de contas 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;