パラメータ

バインド引数

.sqファイルは、バインド引数を含め、PostgreSQLとまったく同じ構文を使用します。 ステートメントにバインド引数が含まれている場合、関連するメソッドは対応する引数を必要とします。

型推論

SQLDelightは、カスタムカラム型を含むランタイムパラメータの正しい型とnull許容性を推論します。

selectByNumber:
SELECT *
FROM hockeyPlayer
WHERE player_number = ?;

val selectNumber10 = playerQueries.selectByNumber(player_number = 10)
println(selectNumber10.executeAsOne())
// Prints "Corey Perry"

名前付き引数

名前付きパラメータまたはインデックス付きパラメータを使用できます。

firstOrLastName:
SELECT *
FROM hockeyPlayer
WHERE full_name LIKE ('% ' || :name)
OR full_name LIKE (:name || ' %');

playerQueries.firstOrLastName(name = "Ryan")

可変引数

値のセットも引数として渡すことができます。

selectByNames:
SELECT *
FROM hockeyPlayer
WHERE full_name IN ?;

playerQueries.selectByNames(listOf("Alec", "Jake", "Matt"))

挿入

INSERT VALUES の引数は、テーブルのデータクラスにバインドできます。

insertPlayer:
INSERT INTO hockeyPlayer
VALUES ?;

val rickardRakell = HockeyPlayer(
  full_name = "Rickard Rakell",
  number = 67
)
playerQueries.insertPlayer(rickardRakell)

入力サニタイズ

SQLDelightは、クエリプレースホルダーを使用して引数をクエリに渡します。 引数入力の実際のサニタイズは、各プラットフォームおよび方言における基盤となるドライバ実装によって行われます。