Connect using odpscmd (cloud shell) - MaxCompute: Central de Documentação do Alibaba Cloud

Pré-requisitos

Se você fizer login no odpscmd no Cloud Shell como um usuário RAM, esse usuário deve 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 do 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	O sistema executa somente uma máquina virtual por vez. Todas as janelas de sessão se conectam a ela automaticamente.
Janelas de sessão	É possível abrir até cinco janelas de sessão.
Tempo limite de inatividade	O Cloud Shell interrompe a sessão após 30 minutos de inatividade ou ao fechar todas as janelas de sessão. O sistema destrói a máquina virtual 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 destrói a máquina 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. O sistema redefine esse espaço ao destruir a máquina virtual. Para armazenamento persistente, monte um bucket. O Cloud Shell carrega o bucket automaticamente a cada inicialização.
Uso proibido	São proibidas tarefas com uso intensivo de computação ou rede, tarefas de longa duração e processos maliciosos. Violações podem resultar na interrupção ou desativação da sua sessão sem aviso prévio.

Limitações de região

Atualmente, é possível 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ê o inicie. Se o seu projeto estiver em uma região diferente, ocorre transferência de dados entre regiões, podendo representar um risco à segurança dos dados. Use com cautela.

Acesse o ambiente do odpscmd

Faça login no MaxCompute console 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 gerencie e clique em OK.

Nota

Se aparecer uma mensagem para 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 odpscmd carregar no Cloud Shell, a saída é 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 fornece 10 GB de armazenamento temporário. O sistema redefine esse espaço ao destruir a máquina virtual. Para armazenamento persistente, monte um sistema de arquivos NAS. O Cloud Shell carrega esse sistema automaticamente a cada início de sessão.

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

Nota

Montar 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');

Depois de criar a tabela, execute o comando a seguir para visualize a tabela:

SHOW TABLES;

Transferência de dados

Upload de arquivo
1. Clique em ícone e selecione Upload para transferir um arquivo local. Este tópico utiliza o arquivo result.txt como exemplo.
  
  Após a conclusão do upload, pressione Ctrl+c para sair do ambiente do 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 comando a seguir para retornar ao ambiente do odpscmd:
```
cloudshell-odpscmd -p <project.name>
```
2. Faça o upload do arquivo result.txt para o MaxCompute:
```
tunnel upload result.txt result_table1;
```
Download de arquivo
1. baixe a tabela result_table1 do MaxCompute para o Cloud Shell:
```
Tunnel download result_table1 result_table1.txt;
```
2. Clique em ícone e selecione Download e salve o arquivo result_table1.txt no seu computador local.