doris/CREATE-SQL-BLOCK-RULE.md at 74a482ca7ff2180039e62e88fc9c1053e1287c98

Files

Mingyu Chen 74a482ca7f [fix] fix docs build bug (#9293 )

After this PR #9272, the `docs/build_help_zip.sh` will run failed.
This PR fix this issue.
But the help module still has some parse problem, I will fix it in next PR.

This CL mainly changes:
1. fix `docs/build_help_zip.sh` error
2. remove `sql-reference-v2` to `sql-reference`
3. modify build extension github action to run `docs/build_help_zip.sh`

2022-04-28 22:19:04 +08:00

3.2 KiB

Raw Blame History

title, language

title	language
CREATE-SQL-BLOCK-RULE	en

CREATE-SQL-BLOCK-RULE

Name

CREATE SQL BLOCK RULE

Description

This statement creates a SQL blocking rule, which is only used to restrict query statements, not to restrict the execution of explian statements.

Supports configuring SQL blacklists by user:

Refuse to specify SQL by regular matching
Check if a query reaches one of these limits by setting partition_num, tablet_num, cardinality
- partition_num, tablet_num, cardinality can be set together, once a query reaches one of these limits, the query will be intercepted

grammar:

CREATE SQL_BLOCK_RULE rule_name
[PROPERTIES ("key"="value", ...)];

Parameter Description:

sql: matching rule (based on regular matching, special characters need to be translated), optional, the default value is "NULL"
sqlHash: sql hash value, used for exact matching, we will print this value in fe.audit.log, optional, this parameter and sql can only be selected one, the default value is "NULL"
partition_num: the maximum number of partitions a scan node will scan, the default value is 0L
tablet_num: The maximum number of tablets that a scanning node will scan, the default value is 0L
cardinality: the rough scan line number of a scan node, the default value is 0L
global: Whether to take effect globally (all users), the default is false
enable: whether to enable blocking rules, the default is true

Example

Create a block rule named test_rule

mysql> CREATE SQL_BLOCK_RULE test_rule
    -> PROPERTIES(
    -> "sql"="select * from order_analysis;",
    -> "global"="false",
    -> "enable"="true"
    -> );
Query OK, 0 rows affected (0.01 sec)

When we execute the sql we just defined in the rule, an exception error will be returned. The example is as follows:

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

Create test_rule2, limit the maximum number of scanned partitions to 30, and limit the maximum scan base to 10 billion rows. The example is as follows:

mysql> CREATE SQL_BLOCK_RULE test_rule2
    -> PROPERTIES (
    -> "partition_num" = "30",
    -> "cardinality" = "10000000000",
    -> "global" = "false",
    -> "enable" = "true"
    -> );
Query OK, 0 rows affected (0.01 sec)

Keywords

CREATE, SQL_BLCOK_RULE

3.2 KiB Raw Blame History