sql
文字列をSQL文として整形します。
この関数はテンプレートリテラルのタグとして利用できます。
構文
sql(strings) => string
sql(strings, ...replacements) => string
引数
-
strings
:Array<string>
文字列の配列です。
タグ関数として使用した場合は、テンプレートリテラルの文字列部分の配列が与えられます。
-
replacements
:Array<any>
(省略可)任意の文字列変換可能なデータの配列です。
タグ関数として使用した場合は、テンプレートリテラルに挿入された値の配列が与えられます。
この引数は残余引数です。
この引数の指定は任意です。
返値: string
整形済みのSQL文を表す文字列です。
解説
文字列をSQL文として整形します。
この関数はテンプレートリテラルのタグとして利用できます。
この関数は以下のことを行います:
- 不要な空白と改行の消去
- SQL標準の一行コメントおよびCスタイルの複数行コメントの消去
warning
- 引数
replacements
として与えられた値はString()
を使って文字列へ変換されますが、エスケープ処理は行いません。必要に応じて、DBConnector.asIdentifier()
やDBConnector.asString()
、DBConnector.asValue()
などの関数を利用してエスケープしてください。