Notes and examples for using odpscmd in Cloud Shell - MaxCompute: Central de Documentação do Alibaba Cloud

Pré-requisitos

Se você fizer login no odpscmd no Cloud Shell como usuário RAM, esse usuário precisará ter a permissão AliyunCloudShellFullAccess. Para mais informações, consulte Resource Access Management (RAM).

Limitações

Nota

O Cloud Shell é uma ferramenta de linha de comando baseada na web fornecida pela Alibaba Cloud que permite usar o odpscmd sem instalação manual. Para mais informações, consulte What is Cloud Shell?.

Limitações do Cloud Shell

Limite	Descrição
Máquinas virtuais	Apenas uma máquina virtual executa por vez. Todas as janelas de sessão conectam-se a ela automaticamente.
Janelas de sessão	É possível abrir até cinco janelas de sessão.
Tempo limite de inatividade	Após 30 minutos de inatividade ou quando todas as janelas de sessão se fecham, a sessão é interrompida. A máquina virtual é destruída 15 minutos depois. Reiniciar o Cloud Shell cria uma nova máquina virtual.
Expiração	Cada máquina virtual tem um tempo de vida de 1 hora. Após a expiração, o Cloud Shell a destrói imediatamente. Reiniciar o Cloud Shell cria uma nova máquina virtual.
Armazenamento de arquivos	O Cloud Shell fornece 10 GB de armazenamento temporário na pasta /home/shell. Esse espaço é redefinido quando a máquina virtual é destruída. Para armazenamento persistente, monte um bucket. O bucket carrega automaticamente sempre que o Cloud Shell inicia.
Uso proibido	Tarefas intensivas em computação, intensivas em rede, de longa duração e processos maliciosos são proibidos. Violações podem resultar na interrupção ou desativação da sua sessão sem aviso prévio.

Limitações de região

Atualmente, você pode usar o Cloud Shell para se conectar ao MaxCompute apenas nas seguintes regiões: China (Hangzhou), China (Shanghai), China (Beijing), e China (Shenzhen).

Notas de uso

O service Cloud Shell e seu armazenamento temporário residem na região china (Shanghai) por padrão, independentemente de onde você inicia o odpscmd. Se o seu projeto estiver em uma região diferente, ocorre transferência de dados entre regiões, o que pode representar um risco à segurança dos dados. Use com cautela.

Acessar o ambiente odpscmd

Faça login no console do MaxCompute e selecione uma região no canto superior esquerdo.
No painel de navegação à esquerda, escolha Manage Configurations > Projects.
Na página Projects, clique em Command Line no canto superior direito.

Na caixa de diálogo Choose Project, selecione o projeto que deseja gerenciar e clique em OK.

Nota

Se aparecer um prompt sobre montar um sistema de arquivos NAS, monte-o conforme necessário. Para mais informações, consulte (Optional) Mount a NAS file system.

Após o carregamento do odpscmd no Cloud Shell, a saída será semelhante à seguinte:

inflating: odpscmd_pub/plugins/cupid/lib/jackson-core-2.9.5.jar
inflating: odpscmd_pub/plugins/cupid/lib/odps-console-cupid-public-0.43.1-public.jar
inflating: odpscmd_pub/plugins/cupid/plugin.ini
inflating: odpscmd_pub/plugins/volume2/lib/odps-console-volume2-0.43.1-public.jar
inflating: odpscmd_pub/plugins/volume2/lib/odps-sdk-volumefs-0.43.1-public.jar
inflating: odpscmd_pub/plugins/volume2/lib/hadoop-shaded-protobuf_3_7-1.1.1.jar
inflating: odpscmd_pub/plugins/volume2/lib/hadoop-annotations-3.3.3.jar
inflating: odpscmd_pub/plugins/volume2/lib/hadoop-auth-3.3.3.jar
inflating: odpscmd_pub/plugins/volume2/lib/hadoop-common-3.3.3.jar
/home/shell
Aliyun ODPS Command Line Tool
Version 0.43.1-public
@Copyright 2020 Alibaba Cloud Computing Co., Ltd. All rights reserved.
Connecting to http://service.odps.aliyun.com/api, project: xxx
Endpoint: http://service.odps.aliyun.com/api
Project: xxx
Schema: default
Quota: default in region N/A
Timezone: Asia/Shanghai
Connected!
xxx (default)>

(Opcional) Montar NAS

O Cloud Shell oferece 10 GB de armazenamento temporário que é redefinido quando a máquina virtual é destruída. Para armazenamento persistente, monte um sistema de arquivos NAS, que o Cloud Shell carrega automaticamente sempre que você inicia uma sessão.

Na janela MaxCompute Cloud CMD, clique em no ícone e selecione Mount Storage Space para vincular um sistema de arquivos NAS.

Nota

A montagem de um sistema de arquivos NAS gera taxas de armazenamento do NAS. Desvincule o espaço de armazenamento quando não precisar mais dele. Para mais informações sobre as taxas de armazenamento do NAS, consulte Billing overview.

Usar o odpscmd no Cloud Shell

O odpscmd no Cloud Shell suporta todos os comandos SQL disponíveis no cliente local. Os exemplos a seguir mostram como executar comandos SQL e transferir dados.

Executar comandos SQL

Crie a tabela result_table1:

CREATE TABLE IF NOT EXISTS result_table1 (
 education STRING comment 'Education level',
 num BIGINT comment 'Number of people');

Após criar a tabela, execute o seguinte comando para visualizá-la:

SHOW TABLES;

Transferência de dados

Carregar um arquivo

Clique em no ícone e selecione Upload para transferir um arquivo local. Este tópico usa o arquivo result.txt como exemplo.

Após concluir o upload, pressione Ctrl+c para sair do ambiente Cloud Shell (odpscmd) e, em seguida, execute o comando ll para verificar se o upload foi bem-sucedido e visualizar o caminho do arquivo.

shell@Alicloud:~$ ll
total 24
drwxr-xr-x 3 shell shell 4096 Jul 19 08:21 ./
drwxr-xr-x 1 root  root  4096 Jul 19 08:00 ../
-rw------- 1 shell shell  292 Jul 19 08:22 .bash_history
drwx------ 3 shell shell 4096 Jul 19 08:00 .config/
-rw-r--r-- 1 shell shell  325 Jul 19 08:15 .odpscmd.history
-rw-r--r-- 1 shell shell   30 Jul 19 08:21 result.txt
-rw-r--r-- 1 shell shell    0 Jul 19 08:09 whoami
shell@Alicloud:~$

Após confirmar a presença do arquivo, execute o seguinte comando para retornar ao ambiente odpscmd:

cloudshell-odpscmd -p <project.name>

Carregue o arquivo result.txt no MaxCompute:
```
tunnel upload result.txt result_table1;
```

Baixar um arquivo
1. Baixe a tabela do MaxCompute result_table1 para o Cloud Shell:
```
Tunnel download result_table1 result_table1.txt;
```
2. Clique em no ícone e selecione Download para salvar o arquivo result_table1.txt no seu computador local.