Note
- This view is available starting with V4.2.3 for V4.2.x.
- This view is available starting with V4.3.4 for V4.3.x.
Purpose
The DBA_OB_FORMAT_OUTLINES view records the details of the current tenant's Format Outline.
Columns
| Column | Type | Nullable? | Description |
|---|---|---|---|
| CREATE_TIME | timestamp(6) | YES | The timestamp when the Format Outline was created. |
| MODIFY_TIME | timestamp(6) | YES | The timestamp when the Format Outline was last modified. |
| TENANT_ID | bigint(20) | NO | The tenant ID. |
| DATABASE_ID | bigint(20) | NO | The database ID. |
| OUTLINE_ID | bigint(20) | NO | The ID of the execution plan outline. |
| DATABASE_NAME | varchar(128) | NO | The name of the database. |
| OUTLINE_NAME | varchar(128) | NO | The name of the execution plan outline. |
| VISIBLE_SIGNATURE | longtext | NO | The deserialized result of the Signature. |
| FORMAT_SQL_TEXT | longtext | YES | The FORMAT SQL TEXT generated in the ON clause when the execution plan outline was created. |
| OUTLINE_TARGET | longtext | NO | The SQL statement specified in the TO clause when the execution plan outline was created. |
| OUTLINE_SQL | longtext | NO | The SQL statement containing the complete execution plan outline information. |
| FORMAT_SQL_ID | varbinary(32) | NO | The MD5 value of the FORMAT SQL TEXT that generated this record. |
| OUTLINE_CONTENT | longtext | NO | The complete execution plan outline information. |
Sample query
Query the information of a Format Outline in the current tenant.
obclient> SELECT * FROM oceanbase.DBA_OB_FORMAT_OUTLINES LIMIT 1\G
The returned result is as follows:
*************************** 1. row ***************************
CREATE_TIME: 2025-12-29 16:14:36.973420
MODIFY_TIME: 2025-12-29 16:14:36.973420
TENANT_ID: 1002
DATABASE_ID: 500001
OUTLINE_ID: 500003
DATABASE_NAME: test
OUTLINE_NAME: my_outline
VISIBLE_SIGNATURE: SELECT * FROM EMPLOYEES WHERE DEPARTMENT_ID > = ?
FORMAT_SQL_TEXT: SELECT * FROM employees WHERE department_id >= 10
OUTLINE_TARGET:
OUTLINE_SQL:
FORMAT_SQL_ID:
OUTLINE_CONTENT: /*+BEGIN_OUTLINE_DATA FULL(@"SEL$1" "test"."employees"@"SEL$1") OPTIMIZER_FEATURES_ENABLE('4.3.5.0') END_OUTLINE_DATA*/
1 row in set