Todos os produtos
Search
Central de documentação

:Importar dados

Última atualização: Jul 04, 2026

Este tópico descreve como utilizar o cliente MaxCompute e o comando Tunnel Upload para importar dados de um arquivo local para uma tabela existente.

Pré-requisitos

Verifique se os seguintes pré-requisitos foram atendidos:

Etapa 1: Importar dados

Utilize o comando Tunnel Upload para importar dados de um arquivo local para uma tabela do MaxCompute. Para obter mais detalhes sobre as operações do Tunnel, consulte Comandos do Tunnel. O processo de importação é descrito a seguir:

  1. Confirme o caminho do arquivo de dados.

    Existem duas opções para o caminho do arquivo de dados. Caso você salve o arquivo na pasta

    bin

    do cliente MaxCompute, o caminho de upload será

    filename.extension

    . Se o arquivo estiver em outro diretório, como a pasta test na unidade D, o caminho de upload será

    D:\test\filename.extension

    .

    Neste tópico, o arquivo de dados de exemplo banking.txt está salvo na pasta bin do cliente MaxCompute. Os arquivos banking_yescreditcard.csv, banking_uncreditcard.csv e banking_nocreditcard.csv estão salvos na pasta test da unidade D.

  2. No cliente MaxCompute, execute o comando Tunnel Upload para importar os dados.

    Os comandos abaixo servem como exemplos.

    tunnel upload banking.txt bank_data;
    tunnel upload D:\test\banking_yescreditcard.csv bank_data_pt/credit="yes";
    tunnel upload D:\test\banking_uncreditcard.csv bank_data_pt/credit="unknown";
    tunnel upload D:\test\banking_nocreditcard.csv bank_data_pt/credit="no";

    A importação estará concluída quando a mensagem

    OK

    for exibida.

    odps@ doc_test_dev>tunnel upload D:\test\banking_yescreditcard.csv bank_data_pt/credit="yes",
    Upload session: 202105171550120131f60b242a2417
    Start upload:D:\test\banking_yescreditcard.csv
    Using \r\n to split records
    Upload in strict schema mode: true
    Total bytes:351  Split input to 1 blocks
    2021-05-17 15:47:58    scan block: '1'
    2021-05-17 15:47:58    scan block complete, block id: 1
    2021-05-17 15:47:58    upload block: '1'
    2021-05-17 15:47:59    upload block complete, block id: 1
    upload complete, average speed is 351 bytes/s
    OK

Etapa 2: Confirmar o resultado da importação

Após a importação dos dados, verifique se a quantidade de registros na tabela de destino corresponde ao número de registros no arquivo de origem. Essa validação garante que todos os dados foram importados com sucesso.

Neste tópico, o arquivo de exemplo banking.txt contém 41.188 registros. Já os arquivos banking_yescreditcard.csv, banking_uncreditcard.csv e banking_nocreditcard.csv contêm, respectivamente, 3, 8.597 e 32.588 registros. O comando a seguir apresenta um exemplo de consulta.

select count(*) as num1 from bank_data;
select count(*) as num2 from bank_data_pt where credit="yes";
select count(*) as num3 from bank_data_pt where credit="unknown";
select count(*) as num4 from bank_data_pt where credit="no";

Os resultados retornados são apresentados abaixo.

--The number of records in bank_data.
+------------+
| num1       |
+------------+
| 41188      |
+------------+
--The number of records in bank_data_pt where credit is "yes".
+------------+
| num2       |
+------------+
| 3          |
+------------+
--The number of records in bank_data_pt where credit is "unknown".
+------------+
| num3       |
+------------+
| 8597       |
+------------+
--The number of records in bank_data_pt where credit is "no".
+------------+
| num4       |
+------------+
| 32588      |
+------------+

Se os valores retornados pelos comandos acima coincidirem com a quantidade de registros nos arquivos de exemplo, a importação foi bem-sucedida.

Próximos passos

Depois de importar os dados para uma tabela do MaxCompute, execute comandos SQL no cliente MaxCompute para processar as informações e exportar os resultados. Para mais detalhes, consulte Executar comandos SQL e exportar os dados resultantes.