SQL Server接続 URI を作成する
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] | query_string | プライマリ SQL Server データベースが使用できない場合に接続するフェールオーバー SQL Serverデータベースの名前。 SQL Serverに関する高可用性の詳細については、「SQL Serverでのデータベース ミラーリング」を参照してください。 |
| [INBOUND_ID] | query_string | 接続 URI に追加して一意にする識別子。 TypedPolling 受信操作のメタデータを生成する場合は、この接続パラメーターを指定する必要があります。 また、BizTalk アプリケーションでは、同じデータベースをポーリングする複数の受信場所がある場合、受信 ID によって接続 URI が一意になり、アダプター クライアントは異なる受信場所で同じデータベースからポーリング メッセージを受信できるようになります。 詳細については、「BizTalk Serverを使用して SQL から複数の受信ポート間でポーリング メッセージを受信する」を参照してください。 |
Note
これらの接続文字列プロパティの詳細については、「SqlConnection.ConnectionString プロパティ」を参照してください。
SQL Server資格情報と接続 URI
SQL アダプターは、接続 URI での資格情報の指定をサポートしていません。 SQL アダプターを使用するアプリケーションで資格情報を指定する方法の詳細については、「SQL アプリケーションの セキュリティ保護」を参照してください。
接続 URI での特殊文字の使用
SQL アダプターでは、パラメーター値に特殊文字を含む接続 URI の指定はサポートされていません。 接続パラメーターの値に特殊文字が含まれている場合は、次のいずれかの操作を行ってください。
[アダプター サービス参照プラグインの追加] または [アダプター サービス アドインの使用] を使用して Visual Studio で URI を指定する場合は、[ URI のプロパティ ] タブでそのまま指定する必要があります。つまり、エスケープ文字は使用しません。 [ 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 アダプターと同じコンピューターにSQL Server データベースがインストールされている接続 URI の例を次に示します。 この例では、アダプターは、ローカル コンピューター上の "sql_server_instance" データベース インスタンスのデータベース "my_database" に接続します。
mssql://localhost/sql_server_instance/my_database/
この例では、アダプターはローカル コンピューターで実行されている既定のインスタンスの既定のデータベースに接続します。
mssql://localhost///
次の場合に、SQL Server データベースへの接続を指定する方法について説明します。
アダプター サービス BizTalk プロジェクト アドインまたはアダプター サービスの追加リファレンス Visual Studio プラグインを使用します。「SQL アダプターを使用して Visual Studio でSQL Serverに接続する」を参照してください。
BizTalk Server ソリューションで送信ポートまたは受信ポート (場所) を構成する方法については、「SQL アダプターへの物理ポート バインドを手動で構成する」を参照してください。
プログラミング ソリューションで WCF チャネル モデルを使用する方法については、「 SQL アダプターを使用してチャネルを作成する」を参照してください。
プログラミング ソリューションで WCF サービス モデルを使用する方法については、「 SQL アダプターのクライアント バインドの構成」を参照してください。