準備実行 ODBC

[アーティクル]
09/03/2023

準備された実行は、ステートメントを複数回実行する効率的な方法です。ステートメントは、最初にコンパイルされるか、アクセスプランに準備されます。その後、アクセスプランは後で 1 回以上実行されます。アクセスプランの詳細については、「 SQL ステートメントの処理」を参照してください。

準備実行は、同じパラメーター化された SQL ステートメントを繰り返し実行するために、バーティカルアプリケーションおよびカスタムアプリケーションで一般的に使用されます。たとえば、次のコードは、さまざまな部分の価格を更新するステートメントを準備します。その後、毎回異なるパラメーター値でステートメントを複数回実行します。

SQLREAL       Price;  
SQLUINTEGER   PartID;  
SQLINTEGER    PartIDInd = 0, PriceInd = 0;  
  
// Prepare a statement to update salaries in the Employees table.  
SQLPrepare(hstmt, "UPDATE Parts SET Price = ? WHERE PartID = ?", SQL_NTS);  
  
// Bind Price to the parameter for the Price column and PartID to  
// the parameter for the PartID column.  
SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT, SQL_C_FLOAT, SQL_REAL, 7, 0,  
                  &Price, 0, &PriceInd);  
SQLBindParameter(hstmt, 2, SQL_PARAM_INPUT, SQL_C_ULONG, SQL_INTEGER, 10, 0,  
                  &PartID, 0, &PartIDInd);  
  
// Repeatedly execute the statement.  
while (GetPrice(&PartID, &Price)) {  
   SQLExecute(hstmt);  
}

直接実行されるステートメントが実行のたびにコンパイルされるのに対し、準備実行されるステートメントは 1 回だけコンパイルされるので、準備実行は主に 1 回以上実行されるステートメントの場合は直接実行よりも高速になります。データソースがアクセスプラン識別子をサポートしている場合、ドライバーは SQL ステートメント全体ではなく、ステートメントが実行されるたびにアクセスプラン識別子をデータソースに送信できるため、準備実行によってネットワークトラフィックも削減できます。

アプリケーションは、ステートメントの準備後と実行前に、結果セットのメタデータを取得できます。ただし、準備された実行されていないステートメントのメタデータを返すと、一部のドライバーにはコストがかかるため、可能な場合は相互運用可能なアプリケーションで回避する必要があります。詳細については、「メタデータの結果セット」を参照してください。

準備実行は、1 回しか実行されないステートメントには使用しないでください。このようなステートメントの場合、ODBC 関数呼び出しを追加する必要があるため、直接実行よりも若干遅くなります。

重要

SQLEndTran を明示的に呼び出すか、自動コミットモードで作業することによって、トランザクションをコミットまたはロールバックすると、一部のデータソースは接続上のすべてのステートメントのアクセスプランを削除します。詳細については、SQLGetInfo 関数の説明の SQL_CURSOR_COMMIT_BEHAVIOR オプションと SQL_CURSOR_ROLLBACK_BEHAVIOR オプションを参照してください。

ステートメントを準備して実行するために、アプリケーションは次の手順を実行します。

SQLPrepare を呼び出し、SQL ステートメントを含む文字列を渡します。
任意のパラメーターの値を設定します。パラメーターは、実際には、ステートメントの準備の前または準備後に設定できます。詳細については、このセクションの後にある「ステートメントパラメーター」を参照してください。
SQLExecute を呼び出し、データのフェッチなど、必要な追加処理を実行します。
必要に応じて、ステップ 2 と 3 を繰り返します。
SQLPrepare が呼び出されると、ドライバーは次のようになります。
- ステートメントを解析せずにデータソースの SQL 文法を使用するように SQL ステートメントを変更します。これには、ODBC のエスケープシーケンスで説明されているエスケープシーケンスの置き換えも含まれます。 アプリケーションは、SQLNativeSql を呼び出すことによって、変更された形式の SQL ステートメントを取得できます。 SQL_ATTR_NOSCAN ステートメント属性が設定されている場合、エスケープシーケンスは置き換えされません。
- 準備用のステートメントをデータソースに送信します。
- 後で実行するために返されたアクセスプラン識別子を格納するか (準備が成功した場合)、またはエラー (準備が失敗した場合) を返します。エラーには、SQLSTATE 42000 (構文エラーまたはアクセス違反) などの構文エラーや、SQLSTATE 42S02 (ベーステーブルまたはビューが見つからない) などのセマンティックエラーが含まれます。
  
  Note
  
  一部のドライバーは、この時点ではエラーを返しませんが、代わりにステートメントが実行されたとき、またはカタログ関数が呼び出されたときにエラーを返します。したがって、SQLPrepare は実際に失敗した場合に成功したように見える場合があります。
SQLExecute が呼び出されると、ドライバーは次のようになります。
- 現在のパラメーター値を取得し、必要に応じて変換します。詳細については、このセクションの後にある「ステートメントパラメーター」を参照してください。
- アクセスプラン識別子と変換されたパラメーター値をデータソースに送信します。
- エラーが返されます。これらは通常、SQLSTATE 24000 (無効なカーソル状態) などの実行時エラーです。ただし、一部のドライバーは、この時点で構文エラーとセマンティックエラーを返します。

データソースがステートメントの準備をサポートしていない場合、ドライバーは可能な限りそれをエミュレートする必要があります。たとえば、SQLPrepare が呼び出されたときにドライバーが何も実行せず、SQLExecute が呼び出されたときにステートメントを直接実行する場合があります。

データソースが実行なしで構文チェックをサポートしている場合、ドライバーは、SQLPrepare が呼び出されたときに確認するためのステートメントを送信し、SQLExecute が呼び出されたときには実行するステートメントを送信する可能性があります。

ドライバーは、ステートメントの準備をエミュレートできない場合は、SQLPrepare が呼び出されたときにステートメントを格納し、SQLExecute が呼び出されたときに実行のために送信します。

エミュレートされたステートメントの準備は完璧ではないため、SQLExecute は SQLPrepare によって通常返されるすべてのエラーを返すことができます。

次の方法で共有

準備実行 ODBC

フィードバック

その他のリソース