Todos los productos
Search
Centro de documentos

ApsaraDB for ClickHouse:Conexión a un clúster de ClickHouse mediante la CLI

Última actualización: Sep 05, 2026

Puede usar clickhouse-client para conectarse a un clúster de ApsaraDB for ClickHouse.

Requisitos previos

  • Ha creado un clúster de ApsaraDB for ClickHouse. Para obtener más información, consulte Create a cluster.

  • Ha creado una cuenta de base de datos y una contraseña. Para obtener más información, consulte Create an account.

  • Ha instalado una versión compatible de clickhouse-client. Para obtener el enlace de descarga, consulte clickhouse-client.

  • Si el servidor de clickhouse-client no se encuentra en la misma VPC que el clúster de ApsaraDB for ClickHouse, solicite primero un endpoint público. Para obtener más información, consulte Apply for and release a public endpoint.

  • Ha agregado la dirección IP del servidor donde se ejecuta clickhouse-client a la lista de permitidos de ApsaraDB for ClickHouse. Para obtener más información, consulte Configure a whitelist.

Procedimiento

  1. Inicie sesión en el servidor donde está instalado clickhouse-client.

  2. Ejecute el comando de conexión al clúster de ApsaraDB for ClickHouse. La sintaxis es a continuación:

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

    La siguiente tabla describe los parámetros.

    Parámetro

    Descripción

    host

    Endpoint público o interno del clúster. Puede consultar el endpoint en la página Cluster Information.

    Nota

    Si el servidor donde se ejecuta clickhouse-client y el clúster de ApsaraDB for ClickHouse están en la misma VPC, use el endpoint interno; de lo contrario, use el endpoint público.

    port

    Número de puerto TCP, disponible en la página Cluster Information.

    user

    Cuenta de la base de datos.

    password

    Contraseña de la cuenta de la base de datos.