カスタマイズ ファイルの概要

カスタマイズ ファイルの各セクション ヘッダーは、型とパラメーターを含む角かっこ ([]) で構成されます。 リテラル文字列 connect、sql、userlist、logs によって、4 種類のセクションが示されます。 パラメーターには、リテラル文字列、既定値、ユーザー指定の識別子を指定するか、または何も指定しません。

重要

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

そのため、各セクションには次のいずれかのセクション ヘッダーが付いています。

  
[ connect default ] [ connect    
identifier   
] [ sql  default ] [ sql    
identifier   
] [ userlist    
identifier   
] [ logs ]  
  

セクション ヘッダーには、次の部分があります。

パーツ	説明
connect	接続文字列を変更するリテラル文字列。
sql	コマンド文字列を変更するリテラル文字列。
userlist	特定のユーザーのアクセス権を変更するリテラル文字列。
logs	操作エラーを記録するログ ファイルを指定するリテラル文字列。
default	識別子が指定されていないか見つからない場合に使用されるリテラル文字列。
identifier	connect または command 文字列内の文字列と一致する文字列。 - セクション ヘッダーに connect が含まれていて、識別子の文字列が接続文字列に含まれている場合は、このセクションを使用します。 - セクション ヘッダーに sql が含まれていて、識別子の文字列がコマンド文字列に含まれている場合は、このセクションを使用します。 - セクション ヘッダーに userlist が含まれていて、識別子の文字列が connect セクションの識別子と一致する場合は、このセクションを使用します。

DataFactory はハンドラーを呼び出し、クライアント パラメーターを渡します。 ハンドラーは、適切なセクション ヘッダー内の識別子と一致する、クライアント パラメーター内の文字列全体を検索します。 一致が見つかった場合、そのセクションの内容はクライアント パラメーターに適用されます。

次の状況では、特定のセクションが使用されます。

• クライアント接続文字列キーワード "Data Source=value" の value の部分が connect セクションの識別子と一致する場合は、connect セクションが使用されます。

• クライアント コマンド文字列に sql セクションの識別子と一致する文字列が含まれている場合は、sql セクションが使用されます。

• 一致する識別子がない場合は、既定のパラメーターを持つ connect または sql セクションが使用されます。

• userlist セクションの識別子が connect セクションの識別子と一致する場合は、userlist セクションが使用されます。 一致がある場合、userlist セクションの内容は、connect セクションによって制御される接続に適用されます。

• 接続またはコマンド文字列内の文字列が、任意の connect または sql セクション ヘッダーの識別子と一致せず、既定のパラメーターを持つ connect または sql セクション ヘッダーがない場合は、クライアント文字列が変更なしで使用されます。

• DataFactory が機能しているときは、常に logs セクションが使用されます。

参照

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