引数

バインド引数

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

型推論

SQLDelightは、カスタムカラム型を含む実行時パラメータの正しい型とNull許容性（nullability）を推論します。

selectByNumber:
SELECT *
FROM hockeyPlayer
WHERE player_number = ?;

val selectNumber10 = playerQueries.selectByNumber(player_number = 10)
println(selectNumber10.executeAsOne())
// "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は、クエリに引数を渡すためにクエリプレースホルダーを使用します。 引数入力の実際のサニタイズは、各プラットフォームやダイアレクト（方言）における、基盤となるドライバーの実装によって行われます。