Microsoft BizTalk Adapter for SQL Server 接続 URI には、SQL Server データベースへの接続を確立するためにアダプターが使用するプロパティが含まれています。 このトピックでは、SQL Server 接続 URI に関する情報を提供し、さまざまなプログラミング シナリオで URI を指定する方法を説明する他のトピックへのリンクを提供します。
SQL アダプターの接続 URI
WCF の一般的なエンドポイント アドレス URI は、 scheme://hostinfoparams?query_string、次のように表されます。
scheme はスキーム名です。
hostinfoparams は、ホストへの接続を確立するために必要な情報です。たとえば、サーバー名です。
query_stringは、疑問符 (?) で区切られたパラメーターの省略可能な名前と値のコレクションです。
SQL アダプター接続 URI は、この基本的な形式に準拠しており、次のように実装されます。
mssql://[Server_Name[:Portno]]/[Database_Instance_Name]/[Database_Name]?FailoverPartner=[Partner_Server_Name]&InboundId=[Inbound_ID]
ここで、 mssql は SQL Server 接続 URI のスキームです。
次の表では、接続 URI に含まれるプロパティについて説明します。
| 接続 URI プロパティ | カテゴリ | 説明 |
|---|---|---|
| [SERVER_NAME] | hostinfoparams | SQL Server がインストールされているサーバーの名前。 値を指定しない場合、アダプターはサーバー名を "localhost" と見なし、ローカル サーバー上の SQL Server データベースとの接続を確立します。 |
| [PORTNO] | hostinfoparams | 接続が確立されているポート番号。 値を指定しない場合、アダプターは既定のポートを介して接続します。 |
| [DATABASE_INSTANCE_NAME] | hostinfoparams | 接続する SQL Server インスタンスの名前。 値を指定しない場合、アダプターは既定のデータベース インスタンスに接続します。 |
| [DATABASE_NAME] | hostinfoparams | 接続するデータベースの名前。 値を指定しない場合、アダプターは既定のデータベースに接続します。 |
| [PARTNER_SERVER_NAME] | クエリ文字列 | プライマリ SQL Server データベースが使用できない場合に接続するフェールオーバー SQL Server データベースの名前。 SQL Server に関する高可用性の詳細については、「SQL Server での データベース ミラーリング」を参照してください。 |
| [INBOUND_ID] | query_string | 接続 URI に追加して一意にする識別子。 TypedPolling 受信操作のメタデータを生成する場合は、この接続パラメーターを指定する必要があります。 また、BizTalk アプリケーションでは、同じデータベースをポーリングする複数の受信場所がある場合、受信 ID によって接続 URI が一意になり、アダプター クライアントは異なる受信場所で同じデータベースからポーリング メッセージを受信できるようになります。 詳細については、「 BizTalk Server を使用して SQL から複数の受信ポート間でポーリング メッセージを受信する」を参照してください。 |
注
これらの接続文字列プロパティの詳細については、「 SqlConnection.ConnectionString プロパティ」を参照してください。
SQL Server 資格情報と接続 URI
SQL アダプターは、接続 URI での資格情報の指定をサポートしていません。 SQL アダプターを使用するアプリケーションで資格情報を指定する方法の詳細については、「SQL アプリケーションの セキュリティ保護」を参照してください。
接続 URI での特殊文字の使用
SQL アダプターでは、パラメーター値の特殊文字を含む接続 URI の指定はサポートされていません。 接続パラメーターの値に特殊文字が含まれている場合は、次のいずれかの操作を行ってください。
Add Adapter Service Reference Plug-in または Consume Adapter Service Add-in を使用して Visual Studio で URI を指定する場合は、[ URI プロパティ ] タブで as-is を指定する必要があります。つまり、エスケープ文字は使用しません。 [ URI の構成 ] フィールドで URI を直接指定し、接続パラメーターに特殊文字が含まれている場合は、適切なエスケープ文字を使用して接続パラメーターを指定する必要があります。
たとえば、接続 URI に名前
sql serverのパラメーターがある場合は、sql%20serverとして指定する必要があります。BizTalk Server 管理コンソールで送受信ポートを作成するときに URI を指定していて、接続パラメーターに特殊文字が含まれている場合は、適切なエスケープ文字を使用して接続パラメーターを指定する必要があります。
接続 URI を使用して SQL Server データベースに接続する
SQL アダプターの接続 URI の例を次に示します。
mssql://sql_server/sql_server_instance//
前の例では、"sql_server" は SQL Server がインストールされているコンピューターの名前ですが、"sql_server_instance" は接続先のデータベース インスタンスの名前です。 データベース名が指定されていないため、アダプターは既定のデータベースに接続します。
SQL Server データベースが SQL アダプターと同じコンピューターにインストールされている接続 URI の例を次に示します。 この例では、アダプターはローカル コンピューター上の "sql_server_instance" データベース インスタンスのデータベース "my_database" に接続します。
mssql://localhost/sql_server_instance/my_database/
この例では、アダプターはローカル コンピューターで実行されている既定のインスタンスの既定のデータベースに接続します。
mssql://localhost///
次の場合に SQL Server データベースへの接続を指定する方法について説明します。
BizTalk プロジェクト アドインのConsume Adapter ServiceまたはVisual StudioプラグインのAdd Adapter Service Referenceを使用します。「SQL アダプターを使って Visual Studio で SQL Server に接続する」を参照してください。
BizTalk Server ソリューションで送信ポートまたは受信ポート (場所) を構成する方法については、「 SQL アダプターへの物理ポート バインドを手動で構成する」を参照してください。
プログラミング ソリューションで WCF チャネル モデルを使用する方法については、「 SQL アダプターを使用したチャネルの作成」を参照してください。
プログラミング ソリューションで WCF サービス モデルを使用する方法については、「 SQL アダプターのクライアント バインドの構成」を参照してください。