TiDB连接管理
TiDB的连接特性
TiDB Server主要负责接收用户的会话请求,接收SQL并负责SQL语句的解析、编译,生成SQL的执行计划。TiDB Server并不存储数据,所以TiDB的连接是无状态的,用户连接的TiDB Server节点出现问题后,用户会话将会丢失,但其他节点的会话不受影响,丢失会话的用户需要重新连接到其他TiDB Server节点,重新执行SQL。
TiDB完全兼容MySQL 5.7协议,支持MySQL 5.7规范支持的常用SQL语句,但是不支持以下语句:
- 存储过程
- 自定义函数
- 触发器
- 外键
- CTAS语法(create table … as select … from …)
连接TiDB
MySQL命令行客户端
TiDB完全兼容MySQL 5.7,所以TiDB可以使用MySQL客户端进行连接。
首先,在服务器上安装MySQL客户端,命令为:
sudo apt-get install mysql-client
安装过程:
wux_labs@wux-labs-vm:~$ sudo apt-get install mysql-client
Reading package lists... Done
Building dependency tree
Reading state information... Done
The following additional packages will be installed:
mysql-client-8.0 mysql-client-core-8.0 mysql-common
The following NEW packages will be installed:
mysql-client mysql-client-8.0 mysql-client-core-8.0 mysql-common
0 upgraded, 4 newly installed, 0 to remove and 6 not upgraded.
Need to get 5196 kB of archives.
After this operation, 75.6 MB of additional disk space will be used.
Do you want to continue? [Y/n] y
Get:1 http://azure.archive.ubuntu.com/ubuntu focal-updates/main amd64 mysql-client-core-8.0 amd64 8.0.32-0ubuntu0.20.04.2 [5157 kB]
Get:2 http://azure.archive.ubuntu.com/ubuntu focal/main amd64 mysql-common all 5.8+1.0.5ubuntu2 [7496 B]
Get:3 http://azure.archive.ubuntu.com/ubuntu focal-updates/main amd64 mysql-client-8.0 amd64 8.0.32-0ubuntu0.20.04.2 [22.0 kB]
Get:4 http://azure.archive.ubuntu.com/ubuntu focal-updates/main amd64 mysql-client all 8.0.32-0ubuntu0.20.04.2 [9364 B]
Fetched 5196 kB in 1s (10.1 MB/s)
Selecting previously unselected package mysql-client-core-8.0.
(Reading database ... 84042 files and directories currently installed.)
Preparing to unpack .../mysql-client-core-8.0_8.0.32-0ubuntu0.20.04.2_amd64.deb ...
Unpacking mysql-client-core-8.0 (8.0.32-0ubuntu0.20.04.2) ...
Selecting previously unselected package mysql-common.
Preparing to unpack .../mysql-common_5.8+1.0.5ubuntu2_all.deb ...
Unpacking mysql-common (5.8+1.0.5ubuntu2) ...
Selecting previously unselected package mysql-client-8.0.
Preparing to unpack .../mysql-client-8.0_8.0.32-0ubuntu0.20.04.2_amd64.deb ...
Unpacking mysql-client-8.0 (8.0.32-0ubuntu0.20.04.2) ...
Selecting previously unselected package mysql-client.
Preparing to unpack .../mysql-client_8.0.32-0ubuntu0.20.04.2_all.deb ...
Unpacking mysql-client (8.0.32-0ubuntu0.20.04.2) ...
Setting up mysql-common (5.8+1.0.5ubuntu2) ...
update-alternatives: using /etc/mysql/my.cnf.fallback to provide /etc/mysql/my.cnf (my.cnf) in auto mode
Setting up mysql-client-core-8.0 (8.0.32-0ubuntu0.20.04.2) ...
Setting up mysql-client-8.0 (8.0.32-0ubuntu0.20.04.2) ...
Setting up mysql-client (8.0.32-0ubuntu0.20.04.2) ...
Processing triggers for man-db (2.9.1-1) ...
wux_labs@wux-labs-vm:~$
安装完成后,确保mysql命令可以使用。
MySQL命令行客户端连接数据库的语法为:
mysql -h ${host} -P ${port} -u ${username} -p ${password}
对于TiDB:
- ${host}是TiDB Server的主机地址
- ${port}是TiDB Server的服务端口,默认配置是 4000
给定具体参数值,连接TiDB Server:
mysql -hwux-labs-vm -P4000 -uroot -p'@2XKr^+9&nNZ3U07q6'
连接过程:
wux_labs@wux-labs-vm:~$ mysql -hwux-labs-vm -P4000 -uroot -p'@2XKr^+9&nNZ3U07q6'
mysql: [Warning] Using a password on the command line interface can be insecure.
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 459
Server version: 5.7.25-TiDB-v6.1.0 TiDB Server (Apache License 2.0) Community Edition, MySQL 5.7 compatible
Copyright (c) 2000, 2023, Oracle and/or its affiliates.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
mysql>
这样就连接上了TiDB集群了。接下来可以执行一些命令。
- 查看当前已有的库
show databases;
当前默认创建了一个数据库test。
- 切换数据库
use test;
- 查看表
show tables test;
当前没有表,所以是空的。
- 创建表
create table dept(
id int,
name varchar(100)
);
- 插入数据
insert into dept values(1, 'Labs');
- 查询数据
select * from dept;
- 修改用户密码
set password = password('tidb');
- 查询已有用户
select user,host,authentication_string from mysql.user;
图形界面客户端连接
除了使用MySQL命令行工具连接TiDB,还可以使用图形界面客户端工具。
本文使用DataGrip作为图形界面客户端做演示,其他还有很多图形界面客户端也是支持的。
通过添加数据源菜单,选择MySQL数据源。
在数据源配置界面输入TiDB的连接信息,注意端口是4000。
点击Test Connection连接测试连接,确保连接成功。
连接成功后,可以执行相关的命令、语句。
- 查看当前已有的数据库
show databases;
- 切换数据库
use test;
执行完成后,当前数据库将会切换成test。
- 查询数据
select * from dept;
执行完成后,将以表格形式显示查询结果。
其他连接方式
TiDB支持的连接器和API:
- MySQL Connector/Net
- MySQL Connector/ODBC
- MySQL Connector/Python
- MySQL C API
- MySQL PHP API
- MySQL Python API
- MySQL GO API
写在后面
TiDB完全兼容MySQL 5.7协议,因此支持的客户端连接工具比较多,选择一个自己喜欢的客户端用起来吧。