バージョン: 26.x

CREATE SQL_BLOCK_RULE

説明

このステートメントはSQLブロックルールを作成するために使用されます。

SQL_BLOCK_RULEは、大量のデータのスキャンを避けるなど、特定の操作をユーザーが実行することを制限するために使用できます。

構文

CREATE SQL_BLOCK_RULE <rule_name>
PROPERTIES (
          -- property
          <property>
          -- Additional properties
          [ , ... ]
          ) 

必須パラメータ

1. <rule_name>

ルールの名前。

2. <property>

ルールのプロパティは3つのカテゴリに分けることができます：SQL実行、スキャン制限、スイッチ。

SQL実行とスキャン制限のカテゴリは相互排他的であり、SQL blockルールはそのうちの1つのみを制限できることを意味します。

SQL実行カテゴリ

2つのタイプがあり、それぞれ正規表現マッチングと完全マッチングを表します。そのうちの1つのみを選択できます。

sql: マッチングルール（正規表現マッチングに基づき、特殊文字はエスケープする必要があります。例えば、select *はselect \\*と記述する必要があります）。ユーザーがSQL文を実行する際、システムはここで設定されたSQLを正規表現としてユーザーが送信したSQLとマッチングします。マッチした場合、そのSQLの実行がブロックされます。

sqlHash: SQLのMD5ハッシュ値。これは主にslow logと組み合わせて使用されます。ユーザーはハッシュ値を自分で計算する必要はありません。例えば、slow logで特定のSQLの実行が遅いことが示されている場合、fe.audit.logからSqlHashをコピーしてSQL_BLOCK_RULEを作成し、このSQLの実行を制限できます。

スキャン制限カテゴリ ユーザーがクエリを開始すると、クエリオプティマイザは各Tableでスキャンする必要があるパーティション数、tablet数、データ行数を計算します。以下のプロパティを使用してこれら3つの数値を制限できます。すべてを一度に制限することも、一部のみを制限することもできます。

partition_num: Tableがスキャンするパーティションの最大数。

tablet_num: Tableがスキャンするtabletの最大数。

cardinality: Tableがスキャンするデータの行数。

スイッチカテゴリ

global: ルールがすべてのユーザーに対して有効かどうか。デフォルトはfalse。trueに設定しない場合、set propertyコマンドを通じてルールを特定のユーザーに適用する必要があります。

enable: ブロッキングルールが有効かどうか。デフォルトはtrue。

アクセス制御要件

このSQLコマンドを実行するユーザーは、少なくとも以下の権限を持っている必要があります：

権限	オブジェクト	備考
ADMIN_PRIV	Global

例

すべてのユーザーがselect * from order_analysisを実行することを禁止するルールを作成

CREATE SQL_BLOCK_RULE test_rule 
PROPERTIES(
"sql"="select \\* from order_analysis",
"global"="true",
"enable"="true"
);

ルール内で定義されたSQLを実行すると、以下に示すように例外エラーが返されます：

mysql> select * from order_analysis;
ERROR 1064 (HY000): errCode = 2, detailMessage = sql match regex sql block rule: order_analysis_rule

同一Tableの30個を超えるパーティションのスキャンを防止し、クエリのデータ量を100億行以下に制限するルールを作成する

CREATE SQL_BLOCK_RULE test_rule2 
PROPERTIES
(
    "partition_num" = "30",
    "cardinality" = "10000000000",
    "global" = "true",
    "enable" = "true"
);

SQLマッチングは正規表現に基づいています。より多くのSQLパターンをマッチさせたい場合は、対応する正規表現を記述する必要があります。例えば、SQL内のスペースを無視し、"order"で始まるTableへのクエリを防ぐ場合は、以下のようになります：
```
CREATE SQL_BLOCK_RULE test_rule3
PROPERTIES(
  "sql"="\\s*select\\s*\\*\\s*from order_\\w*\\s*",
  "global"="true",
  "enable"="true"
);
```

特定のユーザーにのみ適用されるルールを作成する

CREATE SQL_BLOCK_RULE test_rule4
PROPERTIES(
    "sql"="select \\* from order_analysis",
    "global"="false",
    "enable"="true"
);

ルールをユーザー jack に適用する

SET PROPERTY FOR 'jack' 'sql_block_rules' = 'test_rule4';

その他

一般的な正規表現は以下の通りです：

TextCopy

. : Matches any single character except the newline character `\n`.

* : Matches the preceding element zero or more times. For example, a* matches zero or more 'a's.

+ : Matches the preceding element one or more times. For example, a+ matches one or more 'a's.

? : Matches the preceding element zero or one time. For example, a? matches zero or one 'a'.

[] : Defines a character set. For example, [aeiou] matches any vowel.

[^] : When used in a character set, ^ indicates negation, matching characters not in the set. For example, [^0-9] matches any non-digit character.

() : Groups expressions, allowing quantifiers to be applied to them. For example, (ab)+ matches consecutive 'ab's.

| : Indicates logical OR. For example, a|b matches 'a' or 'b'.

^ : Matches the beginning of a string. For example, ^abc matches strings starting with 'abc'.

$ : Matches the end of a string. For example, xyz$ matches strings ending with 'xyz'.

\ : Escapes special characters, making them ordinary characters. For example, \\. matches the period character '.'.

\s : Matches any whitespace character, including spaces, tabs, newlines, etc.

\d : Matches any digit character, equivalent to [0-9].

\w : Matches any word character, including letters, digits, and underscores, equivalent to [a-zA-Z0-9_].

説明​

構文​

必須パラメータ​

アクセス制御要件​

例​

その他​

説明

構文

必須パラメータ

アクセス制御要件

例

その他