文档

通过MySQL命令行连接并使用消息引擎

更新时间:

Lindorm消息引擎支持通过MySQL协议接入,您可以通过MySQL命令行工具连接Lindorm消息引擎,并通过Lindorm SQL完成基本的DDL操作。本文提供详细的操作步骤,带您快速上手Lindorm消息引擎。

前提条件

注意事项

  • 8.0及之前版本的MySQL命令行工具会在建立加密连接时使用TLSv1.1作为默认TLS协议,Lindorm支持的TLS协议版本为TLSv1.2。由于TLS协议版本不一致,可能会导致连接Lindorm实例失败,因此需要在启动MySQL命令行工具的命令行参数中添加--ssl-mode=DISABLED强制建立非加密通信。

    重要

    非加密通信在公网环境下请谨慎使用。

  • 8.0及之前版本的MySQL命令行工具默认使用mysql_native_password鉴权协议。由于Lindorm中MySQL协议对消息引擎版本的要求,可能会出现鉴权失败的情况。同时,8.0及以前版本的MySQL命令行工具也不支持caching_sha2_password鉴权协议,因此只能通过明文方式传递密码:在启动MySQL命令行工具的命令行参数中添加--enable_cleartext_plugin参数。

    重要

    公网环境下请谨慎使用该方式。

操作步骤

工具安装

  • Linux系统

    请根据已有的管理工具,执行相应的安装命令。

    • APT包管理工具

      sudo apt-get install mysql-client
    • Yum包管理工具

      sudo yum install mysql
  • Mac系统

    使用Homebrew包管理工具,执行以下命令安装。

    brew install mysql-client
  • Windows系统

    安装方式请参见安装MySQL命令行工具

连接并使用宽表引擎

  1. 执行以下语句连接消息引擎。

    mysql -h<mysql url> -P33060 -u<用户名> -p<密码> -Ddefault

    参数说明

    参数

    说明

    示例值

    获取方法

    mysql url

    消息引擎的MySQL兼容地址

    ld-uf6k8yqb741t3****-proxy-sql-lindorm-public.lindorm.rds.aliyuncs.com

    请联系Lindorm技术支持(钉钉号:s0s3eg3)获取。

    用户名

    连接消息引擎的用户名和密码

    test

    密码

    test

  2. 使用消息引擎。

    1. 创建名为test的流表,并设置partition数量为10。

      CREATE STREAM test WITH (PARTITIONS='10') ;
    2. 查看所有流表,确认表test是否创建成功。

      SHOW TABLES;

      返回结果:

      +------------------------------+------------+--------------+
      | TABLE_NAME                   | TABLE_TYPE | TABLE_SCHEMA |
      +------------------------------+------------+--------------+
      | testStream                   | Stream     | default      |
      +------------------------------+------------+--------------+

  • 本页导读