本文导读

展开导读

文档首页/ 云数据库 TaurusDB/ API参考/ API（推荐）/ HTAP-轻量版/ 数据同步表配置校验

数据同步表配置校验

更新时间：2024-09-11 GMT+08:00

在线调试

CLI示例

查看PDF

功能介绍

数据同步表配置校验。

调用接口前，您需要了解API认证鉴权。
调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

URI

POST /v3/{project_id}/instances/{instance_id}/clickhouse/replication/table-check

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	租户在某一Region下的project ID。获取方法请参见获取项目ID。
instance_id	是	String	ClickHouse实例ID，严格匹配UUID规则。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。
X-Language	否	String	请求语言类型。默认en-us。取值范围： en-us zh-cn

表3 请求Body参数
参数	是否必选	参数类型	描述
source_instance_id	是	String	源实例ID。
source_node_id	否	String	源节点ID。GaussDB(for MySQL)只读节点ID。如为空，则取GaussDB(for MySQL)主节点ID。
source_database_name	是	String	源数据库名。
db_configs	是	Array of ChDatabaseConfigsInfo objects	库配置列表。
tables_configs	是	Array of ChDatabaseTablesConfigsInfo objects	表配置信息。
table_repl_config	是	ChDatabaseTableReplConfigInfo object	表同步配置信息。

表4 ChDatabaseConfigsInfo
参数	是否必选	参数类型	描述
param_name	是	String	库同步配置参数名。可通过查询数据同步的库参数配置查询。
value	是	String	库同步配置参数值。

表5 ChDatabaseTablesConfigsInfo
参数	是否必选	参数类型	描述
table_name	是	String	数据库表名。
table_config	是	String	表配置值。允许输入的列操作有：PARTITION BY, COLUMNS, ORDER BY, SAMPLE BY, PRIMARY KEY, TTL

表6 ChDatabaseTableReplConfigInfo
参数	是否必选	参数类型	描述
repl_type	是	String	表同步类型。取值范围： white_list：白名单，此时表范围不能为空。 black_list：黑名单，此时表范围为空则选择所有表。
tables	是	Array of strings	白名单或黑名单的表范围。

响应参数

状态码： 200

表7 响应Body参数
参数	参数类型	描述
source_database_name	String	源数据库名。
table_config_check_results	Array of ChDatabaseTableConfigCheckResult objects	表配置检查结果。

表8 ChDatabaseTableConfigCheckResult
参数	参数类型	描述
table_name	String	数据库表名。
table_config	String	表配置项。允许输入的列操作有：PARTITION BY, COLUMNS, ORDER BY, SAMPLE BY, PRIMARY KEY, TTL
check_result	String	校验结果。

状态码： 400

表9 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。

状态码： 500

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。

请求示例

数据同步表配置校验。

POST https://{localhost}/v3/23a50154cf494ec9ad6883979a12db0a/instances/54e42160670e48e789af7075e1efea1fin16/clickhouse/replication/table-check

{
  "source_database_name" : "blackwhite_0017_22525694",
  "db_configs" : [ {
    "param_name" : "default_isolation_level",
    "value" : "QUERY_SNAPSHOT"
  }, {
    "param_name" : "enable_snapshots",
    "value" : "true"
  }, {
    "param_name" : "enable_chunk_level",
    "value" : "true"
  }, {
    "param_name" : "max_sync_threads",
    "value" : "1"
  }, {
    "param_name" : "treat_numeric_string_as_integer",
    "value" : "false"
  }, {
    "param_name" : "min_binlog_expire_logs_seconds",
    "value" : "86400"
  }, {
    "param_name" : "max_rows_in_buffer",
    "value" : "2000000"
  }, {
    "param_name" : "max_rows_in_buffers",
    "value" : "6000000"
  }, {
    "param_name" : "max_bytes_in_buffer",
    "value" : "200000000"
  }, {
    "param_name" : "max_bytes_in_buffers",
    "value" : "600000000"
  }, {
    "param_name" : "max_flush_data_time",
    "value" : "5000"
  } ],
  "tables_configs" : [ {
    "table_name" : "sbtest100",
    "table_config" : "ORDER BY id"
  } ],
  "table_repl_config" : {
    "repl_type" : "white_list",
    "tables" : [ ]
  },
  "source_instance_id" : "77aa4096cb824a61b93dab5ca00ecc8fin07",
  "source_node_id" : "57bfeacf6e8d4eb685ea907372374b35no07"
}

响应示例

状态码： 200

Success.

{
  "source_database_name" : "blackwhite_0017_22525694",
  "table_config_check_results" : [ {
    "table_name" : "sbtest100",
    "table_config" : "ORDER BY id",
    "check_result" : "Check Override Table Failed"
  } ]
}

状态码

状态码	描述
200	Success.
400	Client error.
500	Server error.

错误码

请参见错误码。

父主题： HTAP-轻量版

上一篇：数据同步库配置校验

下一篇：查询数据库列表

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消