DBConnector: executePreparedStatement()

コンパイルされたSQL文を実行します。

この関数は非同期関数です。

note
  • この関数は基底クラスでは実装されていません。派生クラスでは以下に示す仕様を満たすようにこの関数を実装する必要があります。
info

構文

dbConnector.executePreparedStatement(id, ...paramSets) => Promise<number>

引数

  • id: number

    コンパイルされたSQL文の識別子です。

    この値は compile() の結果として得られます。

  • paramSets: Array<Array<any>>

    コンパイルされたSQL文に与える一連のパラメタ配列の配列です。

    配列の個数だけSQL文が実行されます。

note
  • 引数 paramSets に含まれる配列は通常、それぞれ同じ長さでなければなりません。

返値: Promise<Array<any>>

コンパイルされたSQL文の一連の実行結果を表す配列を与える Promise です。

配列の各成分は引数のパラメタ配列それぞれに対する実行結果を表します。

例外

以下の例外は返値の Promise が棄却された際に発生します。

  • DBInternalError
    • この関数が未実装だった場合
  • DBError
    • SQL文の実行に失敗した場合
    • コンパイルされたSQL文に含まれるプレースホルダーの数より多くのパラメタが与えられた場合
warning
  • DBInternalError を try-catch 文の中で catch した場合、何もせず再び throw してください。この例外はアプリケーション実行時に発生するべきではありません。 その他のアプリケーションエラーと区別するため、この関数で発生した例外は必ず instanceof で型を検査してください。

解説

コンパイルされたSQL文を実行します。