カスタマイズ ファイルについて
カスタマイズ ファイルの各セクション ヘッダーは、型とパラメーターを含む角かっこ ([]) で構成されます。 4 つのセクション タイプは、リテラル文字列 接続、sql、ユーザーリスト、または ログによって示されます。 パラメーターはリテラル文字列、既定値、ユーザー指定の識別子、または何もありません。
大事な
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 ]
セクション ヘッダーには、次の部分があります。
部分 | 説明 |
---|---|
接続 | 接続文字列を変更するリテラル文字列。 |
の sql | コマンド文字列を変更するリテラル文字列。 |
ユーザーリストを する | 特定のユーザーのアクセス権を変更するリテラル文字列。 |
が をログする | 操作エラーを記録するログ ファイルを指定するリテラル文字列。 |
既定 | 識別子が指定されていない場合または見つかった場合に使用されるリテラル文字列。 |
識別子 |
connect または コマンド内の 文字列と一致する文字列。 - セクション ヘッダーに接続 含まれており、接続文字列に識別子文字列が含まれている場合は、このセクションを使用します。 - セクション ヘッダーに sql 含まれており、コマンド文字列に識別子文字列がある場合は、このセクションを使用します。 - セクション ヘッダーにユーザー リスト 含まれており、識別子文字列がセクション識別子 接続 と一致する場合は、このセクションを使用します。 |
DataFactory はハンドラーを呼び出し、クライアント パラメーターを渡します。 ハンドラーは、適切なセクション ヘッダー内の識別子と一致するクライアント パラメーター内の文字列全体を検索します。 一致するものが見つかった場合、そのセクションの内容がクライアント パラメーターに適用されます。
特定のセクションは、次の状況で使用されます。
connect セクションは、クライアント接続文字列のキーワード "Data Source=値" と 接続 セクション識別子が一致する場合に使用されます。
sql セクションは、クライアント コマンド文字列に、sql セクション識別子と一致する文字列が含まれている場合に使用されます。
一致する識別子がない場合は、接続 または sql セクションの既定のパラメーターが使用されます。
ユーザー リスト セクションは、ユーザーリスト セクション識別子が、接続 セクション識別子と一致する場合に使用されます。 一致する場合は、ユーザーリスト セクションの内容が、接続 セクションによって管理される接続に適用されます。
接続またはコマンド文字列内の文字列が、接続 または sql セクション ヘッダー 識別子と一致せず、既定のパラメーターを持つ 接続 または sql セクション ヘッダー がない場合、クライアント文字列は変更なしで使用されます。
DataFactory が動作している場合は常に、ログ セクションが使用されます。
関連項目
カスタマイズ ファイル接続セクション
カスタマイズファイルログ セクション
カスタマイズ ファイルの SQL セクション
カスタマイズ ファイルの UserList セクション
DataFactory カスタマイズ
必要なクライアント設定
独自にカスタマイズされたハンドラーを書く