统信安装TiDB数据库

发表于： 2025年9月15日 2025年10月21日
分类： TiDB

1. 安装 TiUP：

TiUP 是 TiDB 的包管理器和部署工具。

curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh
source ~/.bashrc  # 或 source ~/.zshrc，取决于你使用的 shell

1 2	curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh \| sh source ~/.bashrc # 或 source ~/.zshrc，取决于你使用的 shell

2. 安装 TiUP 的集群组件：

tiup cluster

1	tiup cluster

3. 安装TiDB集群

a. 编写拓扑文件 (/etc/tidb/water/water-tidb.yaml)：

创建一个YAML文件，明确将所有主机地址设为本地(127.0.0.1)，并为每个组件分配独一无二的端口和数据目录，这是避免冲突的关键。

# __global_config__
global:
  user: "tidb"
  ssh_port: 22
  deploy_dir: "/home/TiDB/water-tidb/tidb-deploy"  # 部署目录
  data_dir: "/home/TiDB/water-tidb/tidb-data"      # 数据目录

# __pd_servers__
pd_servers:
  - host: 127.0.0.1
    name: "pd-1"
    client_port: 2379        # PD 客户端端口
    peer_port: 2380          # PD 节点间通信端口

# __tidb_servers__
tidb_servers:
  - host: 127.0.0.1
    port: 4000               # TiDB 服务端口 (MySQL协议)
    status_port: 10080       # TiDB 状态端口

# __tikv_servers__
tikv_servers:
  - host: 127.0.0.1
    port: 20160              # TiKV 服务端口
    status_port: 20180       # TiKV 状态端口

# 以下监控组件是可选的，如果不需要可以删除
# __monitoring_servers__
monitoring_servers:
  - host: 127.0.0.1
    port: 9090               # Prometheus 端口
    deploy_dir: "/home/TiDB/water-tidb/tidb-deploy/prometheus-9090"
    data_dir: "/home/TiDB/water-tidbtidb-data/prometheus-9090"

# __grafana_servers__
grafana_servers:
  - host: 127.0.0.1
    port: 3000               # Grafana 端口
    deploy_dir: "/home/TiDB/water-tidb/tidb-deploy/grafana-3000"

# __global_config__

global:

user: "tidb"

ssh_port: 22

deploy_dir: "/home/TiDB/water-tidb/tidb-deploy" # 部署目录

data_dir: "/home/TiDB/water-tidb/tidb-data" # 数据目录

# __pd_servers__

pd_servers:

- host: 127.0.0.1

name: "pd-1"

client_port: 2379 # PD 客户端端口

peer_port: 2380 # PD 节点间通信端口

# __tidb_servers__

tidb_servers:

- host: 127.0.0.1

port: 4000 # TiDB 服务端口 (MySQL协议)

status_port: 10080 # TiDB 状态端口

# __tikv_servers__

tikv_servers:

- host: 127.0.0.1

port: 20160 # TiKV 服务端口

status_port: 20180 # TiKV 状态端口

# 以下监控组件是可选的，如果不需要可以删除

# __monitoring_servers__

monitoring_servers:

- host: 127.0.0.1

port: 9090 # Prometheus 端口

deploy_dir: "/home/TiDB/water-tidb/tidb-deploy/prometheus-9090"

data_dir: "/home/TiDB/water-tidbtidb-data/prometheus-9090"

# __grafana_servers__

grafana_servers:

- host: 127.0.0.1

port: 3000 # Grafana 端口

deploy_dir: "/home/TiDB/water-tidb/tidb-deploy/grafana-3000"

b. 部署并启动集群：

# water-tidb: 为您集群起的名字
# v7.5.0: TiDB 的版本，您可以指定其他版本如 v6.5.0
# --user root: 使用 root 用户进行部署
-p: 表示需要输入 SSH 密码（如果设置了密钥登录则不需要）
tiup cluster deploy water-tidb v8.5.3 /etc/tidb/water/water-tidb.yaml --user root -p

# 安装完成之后，初始化集群
tiup cluster start water-tidb --init

# 启动集群 
tiup cluster start water-tidb 

# 停止集群 
tiup cluster stop water-tidb 

# 重启集群 
tiup cluster restart water-tidb 

# 查看集群状态 
# 如果一切正常，您会看到所有组件的状态为 Up。
tiup cluster display water-tidb

# 查看已安装的集群
tiup cluster list

# 查看帮助命令
tiup cluster --help

# water-tidb: 为您集群起的名字

# v7.5.0: TiDB 的版本，您可以指定其他版本如 v6.5.0

# --user root: 使用 root 用户进行部署

-p: 表示需要输入 SSH 密码（如果设置了密钥登录则不需要）

tiup cluster deploy water-tidb v8.5.3 /etc/tidb/water/water-tidb.yaml --user root -p

# 安装完成之后，初始化集群

tiup cluster start water-tidb --init

# 启动集群

tiup cluster start water-tidb

# 停止集群

tiup cluster stop water-tidb

# 重启集群

tiup cluster restart water-tidb

# 查看集群状态

# 如果一切正常，您会看到所有组件的状态为 Up。

tiup cluster display water-tidb

# 查看已安装的集群

tiup cluster list

# 查看帮助命令

tiup cluster --help

c. 连接数据库

# -P 4000: 指定连接端口为 4000（您在拓扑文件中设置的 TiDB 端口）
mysql -h 127.0.0.1 -P 4000 -u root

# 成功连接后，您就可以执行 SQL 命令了，例如：
-- 查看 TiDB 版本
SELECT VERSION();

-- 显示所有数据库
SHOW DATABASES;
-- 创建一个测试数据库
CREATE DATABASE test_tidb;
-- 使用新数据库
USE test_tidb;
-- 创建测试表
CREATE TABLE test_table (id INT, name VARCHAR(20));
-- 插入数据
INSERT INTO test_table VALUES (1, 'Hello'), (2, 'TiDB');
-- 查询数据
SELECT * FROM test_table;

# -P 4000: 指定连接端口为 4000（您在拓扑文件中设置的 TiDB 端口）

mysql -h 127.0.0.1 -P 4000 -u root

# 成功连接后，您就可以执行 SQL 命令了，例如：

-- 查看 TiDB 版本

SELECT VERSION();

-- 显示所有数据库

SHOW DATABASES;

-- 创建一个测试数据库

CREATE DATABASE test_tidb;

-- 使用新数据库

USE test_tidb;

-- 创建测试表

CREATE TABLE test_table (id INT, name VARCHAR(20));

-- 插入数据

INSERT INTO test_table VALUES (1, 'Hello'), (2, 'TiDB');

-- 查询数据

SELECT * FROM test_table;

d. 修改集群root密码

# 进入数据库
# -p 之后是初始的root密码 初始化完成之后 会显示root密码
mysql -h 127.0.0.1 -P 4000 -u root -pf^580C9R4*Shj_z+D3

# 修改root密码
SET PASSWORD FOR 'root'@'%' = '新密码';

# 刷新
FLUSH PRIVILEGES;

# 退出数据库
exit

# 使用新密码重新连接数据库
mysql -h 127.0.0.1 -P 4000 -u root -p密码

# 进入数据库

# -p 之后是初始的root密码初始化完成之后会显示root密码

mysql -h 127.0.0.1 -P 4000 -u root -pf^580C9R4*Shj_z+D3

# 修改root密码

SET PASSWORD FOR 'root'@'%' = '新密码';

# 刷新

FLUSH PRIVILEGES;

# 退出数据库

exit

# 使用新密码重新连接数据库

mysql -h 127.0.0.1 -P 4000 -u root -p密码

e. 访问监控界面（可选）

集群还包含了监控组件：

Grafana: 打开浏览器访问 http://服务器IP:3000（默认用户名/密码：admin/admin）
Prometheus: 访问 http://服务器IP:9090

张存志

176

张 存志

张存志