通过MySQL协议连接ClickHouse

云数据库ClickHouse支持通过MySQL客户端访问。本文介绍如何通过MySQL协议连接云数据库ClickHouse集群。

使用限制

仅20.8及以上版本的云数据库ClickHouse社区兼容版集群支持通过MySQL协议连接。

注意事项

使用MySQL协议连接云数据库ClickHouse集群时,会形成性能损失,并产生很多兼容性问题,建议您谨慎选择。

前提条件

  • 已开通MySQL协议。如何开通,请参见开通MySQL协议

  • 已将连接源的IP地址添加到云数据库ClickHouse集群的白名单中。如何添加,请参见设置白名单

  • 如果连接源和云数据库ClickHouse集群不属于同一个VPC,请先为云数据库ClickHouse集群申请外网地址。

操作步骤

  1. 通过外网地址或VPC地址连接云数据库ClickHouse集群,语法如下。

    mysql -h <外网地址或VPC地址> -P <MySQL端口号> -u <数据库账号> -p<数据库账号的密码> --default-auth=mysql_native_password

    示例如下。

    mysql -h cc-bp163l724nkf****.clickhouse.ads.aliyuncs.com -P 9004 -u test -p123456Aa --default-auth=mysql_native_password
    说明

    MySQL端口号固定为9004。

  2. 成功连接云数据库ClickHouse集群后,对数据库进行查询,查询语句如下。

    show databases;

    查询结果如下。

    +--------------------------------+
    | name                           |
    +--------------------------------+
    | _temporary_and_external_tables |
    | default                        |
    | system                         |
    +--------------------------------+