PingKai Logo下载
搜索

ADMIN CREATE LOG REPLICATION

ADMIN CREATE LOG REPLICATION 用于创建一条物理复制链路，将当前集群设置为 standby。执行该语句后，系统会初始化复制链路并将 source 集群的数据同步到当前集群。

该语句必须在将要成为 standby 的集群上执行。

**TLS 说明：**在开启 TLS 的集群间创建物理复制链路需要两个集群证书互信，包括集群证书和 TiDB SQL 证书。

所需权限

  • 执行该语句的当前用户需要 SUPER 权限。
  • SOURCE_USER 对应的账号必须在 source 集群中拥有 SUPER 权限。

语法图

ADMIN CREATE LOG REPLICATION <name>
    SOURCE_HOST = '<source_tidb_host>'
    SOURCE_PORT = <source_tidb_port>
    SOURCE_USER = '<source_tidb_user>'
    SOURCE_PASSWORD = '<source_tidb_password>'
    [PROTECTION_MODE = MAXIMUM_PERFORMANCE | MAXIMUM_PROTECTION | MAXIMUM_AVAILABILITY]
    [DEGRADE_TIMEOUT = '<duration>']
    [DETACHED];

参数说明

参数说明
name复制链路名称，在参与该链路的所有集群中必须唯一
SOURCE_HOSTsource 集群的 TiDB SQL 地址
SOURCE_PORTsource 集群的 TiDB SQL 端口
SOURCE_USERsource 集群中具备相应权限的账号
SOURCE_PASSWORDSOURCE_USER 对应的密码
PROTECTION_MODE保护模式，可选值：MAXIMUM_PERFORMANCE（默认）、MAXIMUM_PROTECTION、MAXIMUM_AVAILABILITY
DEGRADE_TIMEOUT降级超时时长，仅当 PROTECTION_MODE = MAXIMUM_AVAILABILITY 时需指定
DETACHED异步创建模式，语句立即返回 WORKFLOW_ID，不阻塞等待初始化完成

示例

创建一条异步复制链路：

ADMIN CREATE LOG REPLICATION dr_east
    SOURCE_HOST = '192.168.1.100'
    SOURCE_PORT = 4000
    SOURCE_USER = 'repl_user'
    SOURCE_PASSWORD = 'password';

异步创建（立即返回）：

ADMIN CREATE LOG REPLICATION dr_east
    SOURCE_HOST = '192.168.1.100'
    SOURCE_PORT = 4000
    SOURCE_USER = 'repl_user'
    SOURCE_PASSWORD = 'password'
    DETACHED;

创建同步复制链路（最大可用模式）：

ADMIN CREATE LOG REPLICATION dr_east
    SOURCE_HOST = '192.168.1.100'
    SOURCE_PORT = 4000
    SOURCE_USER = 'repl_user'
    SOURCE_PASSWORD = 'password'
    PROTECTION_MODE = MAXIMUM_AVAILABILITY
    DEGRADE_TIMEOUT = '30s';

MySQL 兼容性

ADMIN CREATE LOG REPLICATION 语句是 TiDB 对 MySQL 语法的扩展。

另请参阅