跳至内容
用户手册
DistSQL
语法
RDL 语法
规则定义
影子库压测
CREATE SHADOW RULE

CREATE SHADOW RULE

描述

CREATE SHADOW RULE 语法用于创建影子库压测规则。

语法定义

CreateShadowRule ::=
  'CREATE' 'SHADOW' 'RULE' ifNotExists? shadowRuleDefinition (',' shadowRuleDefinition)*

ifNotExists ::=
  'IF' 'NOT' 'EXISTS'

shadowRuleDefinition ::=
  ruleName '(' storageUnitMapping ',' shadowTableRule (',' shadowTableRule)* ')'
    
storageUnitMapping ::=
  'SOURCE' '=' storageUnitName ',' 'SHADOW' '=' storageUnitName

shadowTableRule ::=
  tableName '(' shadowAlgorithm (',' shadowAlgorithm)* ')'
    
shadowAlgorithm ::=
  'TYPE' '(' 'NAME' '=' algorithmType (',' propertiesDefinition)? ')'

ruleName ::=
  identifier

storageUnitName ::=
  identifier

tableName ::=
  identifier

algorithmName ::=
  identifier

algorithmType ::=
  string

propertiesDefinition ::=
  'PROPERTIES' '(' (key '=' value (',' key '=' value)*)? ')'

key ::=
  string

value ::=
  literal

补充说明

  • 重复的 ruleName 无法被创建；
  • storageUnitMapping 指定源数据库和影子库的映射关系，需使用 RDL 管理的 STORAGE UNIT ，请参考 存储单元；
  • shadowAlgorithm 可同时作用于多个 shadowTableRule；
  • algorithmName 会根据 ruleName、tableName 和 algorithmType 自动生成；
  • algorithmType 目前支持 VALUE_MATCH、REGEX_MATCH 和 SQL_HINT；
  • ifNotExists 子句用于避免出现 Duplicate shadow rule 错误。

示例

  • 创建影子库压测规则
CREATE SHADOW RULE shadow_rule(
  SOURCE=demo_ds,
  SHADOW=demo_ds_shadow,
  t_order(TYPE(NAME="SQL_HINT")), 
  t_order_item(TYPE(NAME="VALUE_MATCH", PROPERTIES("operation"="insert","column"="user_id", "value"='1')))
);
  • 使用 ifNotExists 子句创建影子库压测规则
CREATE SHADOW RULE IF NOT EXISTS shadow_rule(
  SOURCE=demo_ds,
  SHADOW=demo_ds_shadow,
  t_order(TYPE(NAME="SQL_HINT")), 
  t_order_item(TYPE(NAME="VALUE_MATCH", PROPERTIES("operation"="insert","column"="user_id", "value"='1')))
);

保留字

CREATE、SHADOW、RULE、SOURCE、SHADOW、TYPE、NAME、PROPERTIES

相关链接

ALTER SHADOW RULE