Todos os produtos
Search
Central de documentação

ApsaraDB for ClickHouse:Connect to a ClickHouse cluster by using the CLI

Última atualização: Jul 20, 2026

Use o clickhouse-client para se conectar a um cluster ApsaraDB for ClickHouse.

Pré-requisitos

  • Crie um cluster ApsaraDB for ClickHouse. Para mais informações, consulte Create a cluster.

  • Configure uma conta de banco de dados e uma senha. Para mais informações, consulte Create an account.

  • Instale uma versão compatível do clickhouse-client. Para obter o link de download, consulte clickhouse-client.

  • Se o servidor do clickhouse-client não estiver na mesma VPC do cluster ApsaraDB for ClickHouse, solicite primeiro um endpoint público. Para mais informações, consulte Apply for and release a public endpoint.

  • Adicione o endereço IP do servidor que executa o clickhouse-client à lista de permissões do ApsaraDB for ClickHouse. Para mais informações, consulte Configure a whitelist.

Procedimento

  1. Faça login no servidor onde o clickhouse-client está instalado.

  2. Execute o comando de conexão para acessar o cluster ApsaraDB for ClickHouse. A sintaxe é a seguinte:

    clickhouse-client --host=<host> --port=<port> --user=<user> --password=<password> 

    A tabela a seguir descreve os parâmetros.

    Parâmetro

    Descrição

    host

    Endpoint público ou interno do cluster. Você pode encontrar o endpoint na página Cluster Information.

    Nota

    Se o servidor que executa o clickhouse-client e o cluster ApsaraDB for ClickHouse estiverem na mesma VPC, use o endpoint interno. Caso contrário, use o endpoint público.

    port

    Número da porta TCP, disponível na página Cluster Information.

    user

    Conta do banco de dados.

    password

    Senha da conta do banco de dados.