Lindorm消息引擎支持通过MySQL协议接入,您可以通过MySQL命令行工具连接Lindorm消息引擎,并通过Lindorm SQL完成基本的DDL操作。本文提供详细的操作步骤,带您快速上手Lindorm消息引擎。
前提条件
消息引擎为3.8.0及以上版本。如何升级请参见升级小版本。
已将客户端IP地址添加至Lindorm白名单。具体操作,请参见设置白名单。
已阅读MySQL协议开发说明。具体内容,请参见MySQL协议开发说明。
注意事项
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命令行工具。
连接并使用宽表引擎
执行以下语句连接消息引擎。
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
使用消息引擎。
创建名为test的流表,并设置partition数量为10。
CREATE STREAM test WITH (PARTITIONS='10') ;
查看所有流表,确认表test是否创建成功。
SHOW TABLES;
返回结果:
+------------------------------+------------+--------------+ | TABLE_NAME | TABLE_TYPE | TABLE_SCHEMA | +------------------------------+------------+--------------+ | testStream | Stream | default | +------------------------------+------------+--------------+
- 本页导读