HINTの使用規範

本記事では、OceanBaseデータベースにおけるHINTの使用規範について説明します。

HINTはできるだけ控えめに使用し、関連するテーブルの統計情報を収集し、HINTなしでステートメントを評価した後にオプティマイザーの実行計画が得られた場合にのみ慎重に検討してください。データベースの条件を変更したり、今後のバージョンでクエリのパフォーマンスを向上させたりすることで、コード内のHINTがパフォーマンスに大きな影響を与える可能性があります。

HINTの紹介

• コストベースのオプティマイザーであり、OracleのHINTと類似しています。

• サーバー側がSQL文内のHINTを認識できない場合、エラーを報告せずに直接無視します。

• HINTはデータベースオプティマイザーが計画を生成するロジックにのみ影響を及ぼし、SQL文自体の意味には影響しません。

• HINTは一種の仕組みであり、HINTを使用することでオプティマイザーに特定の計画の生成を指示できます。通常、オプティマイザーはユーザーのクエリに対して最適な実行計画を選択しますので、ユーザーがHINTで指定する必要はありません。しかし、場合によってはオプティマイザーが生成する実行計画がユーザーの要件を満たさないことがあります。そのような場合、ユーザーはHINTを使用して特定の実行計画の生成を明示的に指示する必要があります。

HINT構文

{CREATE|DELETE|INSERT|SELECT|UPDATE|REPLACE} /*+ [HINT_text][hin_text]... */

• 一つのステートメントブロックには、HINTを含むコメントは一つしか存在できません。また、そのコメントはSELECT、UPDATE、INSERT、MERGE、またはDELETEキーワードの後に続けて記述する必要があります。

• 構文的に見ると、HINTは特殊なSQLコメントですが、コメントの左側のマーカー（'/*'記号）の後に'+'が追加されている点が異なります。コメントである以上、サーバー側がSQL文内のHINTを認識できない場合、オプティマイザーはユーザーのHINTを無視し、デフォルトの計画生成ロジックを使用することを選択します。また、HINTはオプティマイザーが計画を生成するロジックにのみ影響を及ぼし、SQL文の意味には影響しません。

• HINTを定義する際に注意が必要ないくつかのルール：

  • プラス記号 '+' は、データベースにコメントをHINTリストとして解釈させます。プラス記号はコメントの左側のマーカーの直後に続けて記述する必要があり、スペースは許容されません。

  • プラス記号 '+' とHINTテキストの間のスペースはオプションです。コメントに複数のHINTが含まれる場合、HINT同士は少なくとも1つのスペースまたはカンマで区切る必要があります。

  • スペルミスや構文エラーが含まれる場合は無視されます。ただし、データベースは同一コメント内で他に正しく指定されたHINTを考慮します。

  • DELETE、INSERT、MERGE、SELECT、またはUPDATEキーワードの後に続かないHINTは無効です。

• OceanBaseとOracleでは、HINTの概念が一致しない点以外にも、以下の違いがあります：

  • Oracleのleading HINTでは、存在しないテーブルが出現した場合、HINTが有効かどうかが推定され、動作が不安定になります。場合によっては有効で、場合によってはすべて無効になることがあります。

HINTの使用例

• パラメータなしの場合、例えば/*+ KAKA */。

• パラメータ付きの場合、例えば/*+ HAHA(param) */。

• 複数のHINTは同一のコメント内に記述でき、カンマまたは少なくとも1つのスペースで区切ります。例：/*+ KAKA, HAHA(param)*/。

• SELECT文のHINTは、SELECTキーワードの直後、他の語の前に記述する必要があります。例：SELECT /*+ KAKA */。

• UPDATE、DELETE文のHINTは、UPDATE、DELETEキーワードの直後に記述する必要があります。例：UPDATE /*+ KAKA */、DELETE /*+ KAKA */。

よく使われるHINTの種類

その他のHINTに関する詳細は、SQLチューニングガイドを参照してください。