SQL语句 - CREATE OUTLINE - 《OceanBase v3.1.1 官方教程》

描述

该语句用来创建 Outline。可以通过两种方式创建，一种是通过 SQL_TEXT（用户执行的带参数的原始语句），另一种是通过 SQL_ID 创建。

说明

创建 OUTLINE 需要进入对应的 DataBase 下执行。

CREATE [OR REPLACE] OUTLINE outline_name ON stmt [ TO target_stmt ]

CREATE OUTLINE outline_name ON sql_id USING HINT hint;

参数	描述
outline_name	指定要创建的 Outline 名称。
OR REPLACE	指定`OR REPLACE`后，如果要创建的 Outline 已存在，则会替换原有的 Outline。
stmt	一般为一个带有 Hint 和原始参数的 DML 语句。
TO target_stmt	如果不指定`TO target_stmt`，则表示如果数据库接受的 SQL 参数化后与`stmt`去掉 Hint 参数化文本相同，则将该 SQL 绑定`stmt`中 Hint 生成执行计划；如果期望对含有 Hint 的语句进行固定计划，则需要`TO target_stmt`来指明原始的 SQL。注意在使用`target_stmt`时，严格要求`stmt`与 `target_stmt`在去掉 Hint 后完全匹配。
sql_id	如果`sql_id`对应的 SQL 语句已经有 Hint，则创建 Outline 指定的 Hint 会覆盖原始语句中所有 Hint。
hint	格式为`/+ xxx /` 。

CREATE OUTLINE otl_idx_c2 
       ON SELECT/*+ index(t1 idx_c2)*/ * FROM t1 WHERE c2 = 1;

CREATE OUTLINE otl_idx_c2 
ON "ED570339F2C856BA96008A29EDF04C74" 
USING HINT /*+ index(t1 idx_c2)*/ ;

当 SQL_ID 相同时，使用 SQL_TEXT 方式创建的 Outline 会覆盖 SQL_ID 方式创建的 Outline，SQL_TEXT 方式创建的优先级更高。

此外，OceanBase 数据库通过 SQL_ID 区分不同的 SQL，而 SQL_ID 是通过 SQL_TEXT 取 MD5 加密得到的，相同的 SQL 文本即使多一个换行或制表符，MD5 得到的 SQL_ID 都会不同。在实际生产系统中，推荐通过 SQL_ID 进行 OUTLINE 绑定。