SQL Server のメタデータを参照、検索、取得する
microsoft BizTalk Adapter for SQL ServerがSQL Server データベースから表示するメタデータは、アダプターを使用してSQL Server データベースと通信するためのメッセージ構造を表します。 SQL アダプターでは、メタデータを取得するための 2 つのインターフェイスがサポートされています。
MetadataExchange は、Windows Communication Foundation (WCF) によって提供されます。 WCF は、すべての WCF バインディングに対してメタデータ交換エンドポイントを提供します。これにより、クライアントはSQL Server データベースからメタデータを取得できます。
アダプターのメタデータの参照と検索機能をサポートする Microsoft Windows Communication Foundation (WCF) 基幹業務 (LOB) アダプター SDK によって提供される IMetadataRetrievalContract。
SQL アダプターは、SQL Serverデータベース成果物と、アダプター クライアントが呼び出すことができるそれぞれの操作を表示します。 アダプターでは、SQL Server データベースに対して特定の操作を実行するために使用できる操作 (ExecuteNonQuery、ExecuteReader、ExecuteScalar など) も表示されます。 これらの操作の詳細については、このトピックの後半で説明します。
Note
SQL アダプターは、現在接続されているユーザーがアクセスできるSQL Server データベース内のすべてのスキーマに成果物を表示します。 つまり、既定のスキーマ (dbo) とは別に、アダプター クライアントは、SQL アダプターを使用して接続するために使用されるユーザー資格情報がSQL Server データベース内のスキーマにアクセスできる場合、SQL Server データベース内の他のスキーマの成果物に対する操作を実行することもできます。 SQL Server データベース内のスキーマの詳細については、「」を参照してくださいhttps://go.microsoft.com/fwlink/?LinkId=130148。
アダプター クライアントを使用すると、次の方法でメタデータを参照、検索、および取得できます。
Visual Studio での BizTalk プロジェクトの作成
WCF サービス モデルの使用
WCF チャネル モデルの使用
BizTalk プロジェクトを使用する場合は、アダプター サービス BizTalk プロジェクト アドインまたはアダプター メタデータの追加ウィザードを使用して、SQL Server データベースに対して実行する操作のメタデータを生成する必要があります。 WCF サービス モデルを使用する場合は、アダプター サービス参照 Visual Studio プラグインを使用して、SQL Server データベースに対する操作を実行するためのプロキシ クラスを生成する必要があります。 アダプター サービス アドインの使用、アダプター メタデータの追加ウィザード、またはアダプター サービス参照プラグインの追加を使用したメタデータの参照、検索、および取得の詳細については、「SQL アダプターを使用して Visual Studio でSQL Server操作のメタデータを取得する」を参照してください。
メタデータの参照
SQL アダプターを使用すると、アダプター クライアントは、SQL Server データベースで使用できるデータベース テーブル、ビュー、ストアド プロシージャ、および関数を参照できます。 メタデータ参照操作の一環として、アダプターは、アダプターでサポートされているカスタム操作を含め、SQL Server データベースで実行できる操作も表示します。 これらの操作は、アダプター サービス アドインの使用、アダプター メタデータの追加ウィザード、またはアダプター サービス参照プラグインの追加から使用できます。 SQL アダプターでは、次の操作が表示されます。
テーブル、ビュー、プロシージャ、スカラー関数、およびテーブル値関数に対する操作。 たとえば、SQL アダプターでは、EMPLOYEE テーブルの挿入、更新、選択、および削除の操作が表示される場合があります。
アダプター クライアントがストリーミング形式で大きなデータ値を書き込むテーブルとビューの列名の設定<>操作。 Set 操作は、Varchar(Max)、Nvarchar(Max) または Varbinary(Max) のいずれかのデータ型の列を含むテーブルとビューに対してのみ返されます。 詳細については、「 SQL アダプターを使用した大規模なデータ型を含むテーブルとビューに対する操作」を参照してください。
アダプター クライアントがSQL Serverで任意の SQL ステートメントを実行できるようにする ExecuteNonQuery、ExecuteReader、ExecuteScalar 操作。 これらの操作の詳細については、「 ExecuteNonQuery、ExecuteReader、ExecuteScalar 操作のサポート」を参照してください。
SQL Serverから受信メッセージを受信するためのポーリング操作と通知操作。 ポーリング操作の詳細については、「ポーリングを 使用した受信呼び出しのサポート」を参照してください。通知操作の詳細については、「 SQL アダプターを使用したクエリ通知の受信に関する考慮事項」を参照してください。
メタデータの分類方法の詳細については、「 メタデータ ノード ID」を参照してください。
メタデータの検索
SQL アダプターを使用すると、LIKE 演算子と互換性のあるSQL Server検索式を使用して、SQL Server データベースに対して検索クエリを実行できます。 たとえば、アダプター クライアントは、"EMP%" などの検索式を使用して、EMP で始まるテーブルを取得できます。 アダプターは、これを次の SQL クエリに変換します。
SELECT TABLE_NAME FROM ALL_TABLES WHERE TABLE_NAME LIKE 'EMP%'
次の表に、SQL アダプターによる検索とその解釈に使用できる特殊文字を示します。
| 特殊文字 | 解釈 |
|---|---|
| _ (アンダースコア) | 1 文字に一致します。 たとえば、"A_" は "AB"、"AC"、"AD" と一致します。 |
| % (パーセンテージ) | 0 個以上の文字と一致します。 たとえば、"A%" は "A"、"AB"、"ABC" と一致します。 |
| [ ] | - _ と %. の特別な意味をエスケープします。 - 存在する範囲または文字のセットを指定します。 次に例を示します。 - %[%]% は、 % 記号を含むすべての名前と一致します。 - [a-f] は、'a' と 'f' の間に文字が含まれるすべての名前と一致します。 - [abc] は、文字 'a'、'b'、および 'c' を持つすべての名前と一致します。 |
| [^] | 指定しない範囲または文字のセットを指定します。 次に例を示します。 - [^a-f] は、'a' と 'f' の間に文字がないすべての名前と一致します。 - [^abc] は、文字 'a'、'b'、および 'c' を持たないすべての名前と一致します。 |
重要
メタデータ検索スコープは、検索操作が実行されるノードのすぐ下のレベルに制限されます。 たとえば、スカラー関数を検索するには、/Scalar Function/[Schema] で検索する必要があります。 複数レベルの検索はサポートされていません。
メタデータを取得する
メタデータを取得する場合、SQL アダプターはスキーマの下でメタデータを抽出できます。これには、それぞれのオブジェクトと操作パラメーターを含むデータベース オブジェクトのすべてまたはサブセットが含まれます。 アダプターは、SQL Server データベースのエンティティを XML の要素名として表示します。 アンダースコアは含めることができる唯一の許容される特殊文字であるため、要素名の他のすべての特殊文字はアンダースコアを使用してエンコードされます。 たとえば、 emp$name は として emp_x0024_nameエンコードされます。
参照
BizTalk Adapter for SQL Serverの概要SQL アダプターを使用した Visual Studio でのSQL Server操作のSQL Server用BizTalk アダプターのメタデータの取得