カスタマイズ ファイルの 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 文字列。 |
関連項目
「カスタマイズ ファイル接続セクション」
カスタマイズファイルログ セクション
カスタマイズ ファイルの UserList セクション
DataFactory カスタマイズ
必要なクライアント設定
カスタマイズ ファイルの について
独自のカスタムハンドラーを記述する