CREATE FORMAT OUTLINE

説明

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

使用上の制限と注意事項

• アウトラインを作成するには、対応するユーザーの下で実行する必要があります。

• FORMAT_SQL_ID が同じ場合、FORMAT_SQL_TEXT 方法で作成されたアウトラインは、FORMAT_SQL_ID 方法で作成されたアウトラインを上書きします。FORMAT_SQL_TEXT 方法の方が優先順位が高いです。また、OceanBaseデータベースは FORMAT_SQL_ID で異なるSQLを区別しており、FORMAT_SQL_ID は FORMAT_SQL_TEXT に対して MD5 ハッシュを適用して得られます。実際の本番システムでは、FORMAT_SQL_ID を使用したアウトラインのバインドを推奨します。

  説明

  • FORMAT_SQL_TEXT のマッチングルールは、パラメータの変更、大文字と小文字の違い、およびスペースや改行などの構文的でない記号の違いを無視します。`in` 式については、これらの処理を施した後のテキスト内容のみを比較するために正規化されます。
  • FORMAT_SQL_ID は、FORMAT_SQL_TEXT をフォーマットした後（余分なスペースと改行を削除し、すべての文字を大文字または小文字に統一変換）、そのフォーマット済み結果に MD5 ハッシュを適用して生成されます。

構文

/* FORMAT_SQL_TEXT を使用してアウトラインを作成 */
CREATE [OR REPLACE] FORMAT OUTLINE outline_name ON format_stmt [ TO format_target_stmt ]

/* FORMAT_SQL_ID を使用してアウトラインを作成 */
CREATE [OR REPLACE] FORMAT OUTLINE outline_name ON format_sql_id USING HINT hint;

パラメータの説明

例

• FORMAT_SQL_TEXT を使用してアウトラインを作成します。

  CREATE FORMAT OUTLINE my_outline ON SELECT * FROM employees WHERE department_id = ?;
  

• FORMAT_SQL_ID を使用してアウトラインを作成します。

  CREATE FORMAT OUTLINE my_sql_id_outline ON 'ED570339F2C856BA96008A29EDF04C74' USING HINT /*+ index(t1 idx_c2)*/;
  
  

関連ドキュメント

アウトラインの使用例については、プランのバインディングを参照してください。