構文を指定して、準備済み SQL 照会を実行します。
Execute Prepared SQL 機能ブロックは、データベース・エラーが発生した場合に CwDBSQLException 例外をスローできます。
実行できる SQL ステートメントを以下に示します (必要なデータベース許可がある場合)。
Has More Rows 機能ブロックと Next Row 機能ブロックを使用して検索されたデータにアクセスします。
Execute Prepared SQL 機能ブロックは、準備済み SQL ステートメントとして、指定された照会 ストリングを現行接続に関連付けられているデータベースに送信します。
この照会は、最初の実行時にストリングとしてデータベースに送信されます。データベースは、受信したストリングを実行可能形式 (準備済みステートメントと呼ばれる) にコンパイルし、SQL ステートメントを実行して、準備済みステートメントを機能ブロックに戻します。次にこの機能ブロックは、準備済みステートメントをメモリー内に保管します。複数回実行する必要がある SQL ステートメントには、Execute Prepared SQL を使用してください。
要確認 |
---|
Execute Prepared SQL を使用して照会を実行する前に、Get Database Connection 機能ブロックを使用して CwDBConnection オブジェクトを生成することにより、目的のデータベースへの接続を確立する必要があります。 |
接続で明示的なトランザクション・ブラケットを使用している場合は、Begin Transaction によって明示的に各トランザクションを開始し、Commit または Roll Back のいずれかによって終了する必要があります。
OUT パラメーターを使用してストアード・プロシージャーを実行するには、Execute Stored Procedure 機能ブロックを使用します。詳細については、"executeStoredProcedure() でのストアード・プロシージャーの呼び出し"を参照してください。
この機能ブロックは、CwDBConnection.executePreparedSQL() メソッドを基にしています。詳細については、executePreparedSQL()を参照してください。