Todos os produtos
Search
Central de documentação

ApsaraDB for ClickHouse:Importar dados

Última atualização: Jun 28, 2026

Este tópico apresenta um exemplo de como usar o clickhouse-client para importar dados para o ApsaraDB for ClickHouse. Neste exemplo, o conjunto de dados On Time é importado para a tabela distribuída ontime_local_distributed no banco de dados clickhouse_demo.

Pré-requisitos

  1. As etapas listadas em Primeiros passos foram concluídas:

    1. Crie um cluster

    2. Crie uma conta de banco de dados

    3. Configure uma lista de permissões

      Nota

      Adicione o endereço IP do servidor onde o clickhouse-client está instalado à lista de permissões do cluster ApsaraDB for ClickHouse.

    4. Conectar-se a um cluster

    5. Crie um banco de dados

    6. Crie uma tabela

  2. O clickhouse-client correspondente à versão do cluster ApsaraDB for ClickHouse está instalado. Para mais informações, consulte clickhouse-client.

Procedimento

  1. Clique em On Time Data para baixe o conjunto de dados On Time.

  2. Descompacte o pacote do conjunto de dados On Time que você baixou.

    unzip ontime-data(1).zip
  3. Conecte-se ao cluster ApsaraDB for ClickHouse e importe os dados para o ApsaraDB for ClickHouse.

    Execute o comando a seguir no diretório onde o clickhouse-client está instalado:

    ./clickhouse-client --host=<host> --port=<port> --user=<user> --password=<password> --query="INSERT INTO <ClickHouse_table> FORMAT CSVWithNames" < ontime-data.csv

    A tabela a seguir descreve os parâmetros.

    Parâmetro

    Descrição

    host

    Endpoint público ou endpoint de virtual private cloud (VPC). Visualize o endpoint público ou da VPC na página Cluster Information.

    Caso o servidor com o clickhouse-client esteja na mesma VPC do cluster ApsaraDB for ClickHouse, utilize o endpoint da VPC. Se o servidor e o cluster estiverem em VPCs diferentes, use o endpoint público.

    port

    Número da porta tcp. Consulte o número da porta tcp na página Cluster Information.

    user

    Conta do banco de dados. Crie uma conta de banco de dados no console do ApsaraDB for ClickHouse.

    password

    Senha da conta do banco de dados.

    ClickHouse_table

    Tabela de destino no ApsaraDB for ClickHouse para a importação dos dados.

    Exemplo de comando:

    ./clickhouse-client --host=cc-bp16qwvp7hy8i****.public.clickhouse.ads.aliyuncs.com --port=3306 --user=test --password=123456Aa --query="INSERT INTO clickhouse_demo.ontime_local_distributed FORMAT CSVWithNames" < ontime-data.csv
  4. Visualize os dados para verificar se a importação foi bem-sucedida.

    SELECT OriginCityName, count(*) AS flights
    FROM ontime_local_distributed
    GROUP BY OriginCityName
    ORDER BY flights DESC
    LIMIT 10; 

    Resultado retornado pela consulta:

       OriginCityName      │ flights  
     ──────────────────────│────────
       Chicago, IL         │  24114    
       Atlanta, GA         │  22001  
     Dallas/Fort Worth, TX │  17340   
       Los Angeles, CA     │  14494  
       Denver, CO          │  14170  
       New York, NY        │  14075   
       Washington, DC      │  11985  
       Houston, TX         │  11483    
       San Francisco, CA   │  11259  
       St. Louis, MO       │  10721