CREATE FORMAT OUTLINE

説明

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

制限事項と注意点

• アウトラインを作成するには、対応するユーザー権限が必要です。

• 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 のマッチングルールは、パラメータ内容、大文字と小文字、スペースや改行などの構文上のない記号の違いを無視し、これらの処理後のテキスト内容のみを比較します。
  • 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(tbl1 idx_col2)*/;
  

関連ドキュメント

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