カスタマイズ ファイルの SQL セクション

sql セクションには、クライアント コマンド文字列を置き換える新しい SQL 文字列を含めることができます。 セクションに SQL 文字列がない場合、セクションは無視されます。

重要

Windows 8 および Windows Server 2012 から、RDS サーバー コンポーネントが Windows オペレーティング システムに含まれなくなりました (詳細については、Windows 8 および Windows Server 2012 の互換性クックブックを参照してください)。 RDS クライアント コンポーネントは、今後のバージョンの Windows で削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 RDS を使用するアプリケーションを、WCF Data Service に移行する必要があります。

新しい SQL 文字列は "パラメーター化" できます。 つまり、sql セクション SQL 文字列 ('?' 文字で示される) のパラメーターは、クライアント コマンド文字列 (括弧内のコンマ区切りリストで示される) の "識別子" の対応引数で置換できます。 識別子と引数リストは、関数呼び出しのように動作します。

たとえば、クライアント コマンド文字列が "CustomerByID(4)" であれば、SQL セクション ヘッダーは [SQL CustomerByID] であり、新しい SQL セクション文字列は "SELECT * FROM Customers WHERE CustomerID = ?". です。ハンドラーによって "SELECT * FROM Customers WHERE CustomerID = 4" が生成され、その文字列を使用してデータ ソースにクエリを実行します。

新しい SQL ステートメントが null 文字列 ("") の場合、セクションは無視されます。

新しい SQL ステートメント文字列が無効な場合、ステートメントの実行は失敗します。 クライアント パラメーターは実質的に無視されます。 次を指定することですべてのクライアント SQL コマンドを "オフにし"、これを意図的に行うことができます。

[SQL default]   
SQL = " "  

構文

置換 SQL 文字列エントリは次の形式です。

SQL=
sqlString

部分	説明
SQL	これが SQL セクション エントリであることを示すリテラル文字列。
sqlString	クライアント文字列を置き換える SQL 文字列。

参照

カスタマイズ ファイルの Connect セクション
カスタマイズ ファイルの Logs セクション
カスタマイズ ファイルの UserList セクション
DataFactory のカスタマイズ
必要なクライアントの設定
カスタマイズ ファイルの概要
独自のカスタム ハンドラーの記述