CREATE OUTLINE

説明

このステートメントは、アウトラインを作成するために使用します。アウトラインの作成方法は2通りあります。1つは SQL_TEXT（ユーザーが実行したパラメータ付きの元のステートメント）を使用する方法で、もう1つは SQL_ID を使用して作成する方法です。

構文

sql_text_stmt:
    CREATE [OR REPLACE] OUTLINE outline_name ON stmt [TO target_stmt];

sql_id_stmt:
    CREATE [OR REPLACE] OUTLINE outline_name ON 'sql_id' USING HINT hint;

パラメータの説明

例

1. テストテーブル employees を作成します。

   obclient> CREATE TABLE employees (
      emp_id INT,
      dept_id INT,
      salary INT,
      emp_name VARCHAR(50));
   

2. テーブル employees にデータを挿入します。

   obclient> INSERT INTO employees VALUES
      (1001, 10, 10000, 'John'),
      (1002, 10, 12000, 'Mike'),
      (1003, 20, 15000, 'Sarah');
   

3. テーブル employees の dept_id 列にインデックス idx_dept_id を作成します。

   obclient> CREATE INDEX idx_dept_id ON employees(dept_id);
   

4. SQL_TEXT を使用して outline1 を作成します。

   obclient> CREATE OUTLINE outline1
       ON SELECT/*+ index(employees idx_dept_id)*/ * FROM employees WHERE dept_id = 10;
   

5. SQL_ID を使用して outline2 を作成します。

   1. まず、アウトラインをバインドするSQLの SQL_ID を確認します。

      obclient> SELECT sql_id, trace_id, client_ip, user_name, query_sql
         FROM sys.V$OB_SQL_AUDIT
         WHERE query_sql LIKE '%employees%';
      

   2. 調べた SQL_ID を使用してアウトラインを作成します。

      obclient> CREATE OUTLINE outline2
          ON '549D27D6DD54688A9B25FD82D5650B96'
          USING HINT /*+ index(employees idx_dept_id)*/;
      

注意事項

SQL_ID が同じ場合、SQL_TEXT 方式で作成されたアウトラインは SQL_ID 方式で作成されたアウトラインを上書きします。SQL_TEXT 方式で作成されたものの方が優先順位が高いです。

また、OceanBaseデータベースは SQL_ID によって異なるSQLを区別しますが、SQL_ID は SQL_TEXT から MD5 アルゴリズムでハッシュ値を取ったものです。同じSQLテキストでも、改行やタブ文字が1つ増えただけで、MD5 で得られる SQL_ID は異なります。実際の本番システムでは、SQL_ID を用いたアウトラインのバインドを推奨します。

関連ドキュメント

プランのバインド