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 ハッシュを適用して生成されます。

• V4.4.2バージョンでは、V4.4.2 BP3バージョンからFormat OutlineはテキストプロトコルとPSプロトコル(Prepared Statement Protocol)の両方のシナリオをサポートしています。

構文

/* 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)*/;
  

関連ドキュメント

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