Share via


Durchsuchen, Suchen und Abrufen von SQL Server-Metadaten

Die Metadaten, die Microsoft BizTalk Adapter für SQL Server Oberflächen aus der SQL Server-Datenbank enthält, beschreiben die Nachrichtenstruktur für die Kommunikation mit der SQL Server-Datenbank mithilfe des Adapters. Der SQL-Adapter unterstützt zwei Schnittstellen zum Abrufen von Metadaten.

  • MetadataExchange wird von Windows Communication Foundation (WCF) bereitgestellt. WCF stellt einen Metadatenaustauschendpunkt für alle WCF-Bindungen bereit, mit dem Clients Metadaten aus der SQL Server-Datenbank abrufen können.

  • IMetadataRetrievalContract wird vom Lob-Adapter-SDK (Microsoft Windows Communication Foundation) (WCF) bereitgestellt, das die Funktionen zum Durchsuchen und Durchsuchen von Metadaten des Adapters unterstützt.

    Der SQL-Adapter zeigt die SQL Server Datenbankartefakten und entsprechenden Vorgängen an, die die Adapterclients aufrufen können. Der Adapter zeigt auch Vorgänge an (z. B. ExecuteNonQuery, ExecuteReader und ExecuteScalar), die zum Ausführen bestimmter Vorgänge für die SQL Server Datenbank verwendet werden können. Diese Vorgänge werden weiter unten in diesem Thema erläutert.

Hinweis

Der SQL-Adapter zeigt Artefakte in allen Schemas in der SQL Server Datenbank an, auf die der aktuell verbundene Benutzer Zugriff hat. Dies bedeutet, dass die Adapterclients neben dem Standardschema (dbo) auch Vorgänge für Artefakte in anderen Schemas in der SQL Server-Datenbank ausführen können, vorausgesetzt, die Benutzeranmeldeinformationen, die zum Herstellen einer Verbindung mithilfe des SQL-Adapters verwendet werden, haben Zugriff auf diese Schemas in der SQL Server-Datenbank. Informationen zu einem Schema in SQL Server Datenbank finden Sie unter https://go.microsoft.com/fwlink/?LinkId=130148.

Sie können die Adapterclients zum Durchsuchen, Suchen und Abrufen von Metadaten verwenden:

  • Erstellen eines BizTalk-Projekts in Visual Studio

  • Verwenden des WCF-Dienstmodells

  • Verwenden des WCF-Kanalmodells

    Wenn Sie ein BizTalk-Projekt verwenden, müssen Sie das BizTalk-Projekt-Add-In zum Verwenden des Adapterdiensts oder den Assistenten zum Hinzufügen von Adaptermetadaten verwenden, um Metadaten für die Vorgänge zu generieren, die Sie für die SQL Server-Datenbank ausführen möchten. Wenn Sie das WCF-Dienstmodell verwenden, müssen Sie das Visual Studio-Plug-In Add Adapter Service Reference verwenden, um die Proxyklassen für die Ausführung von Vorgängen für die SQL Server-Datenbank zu generieren. Weitere Informationen zum Durchsuchen, Suchen und Abrufen von Metadaten mithilfe des Adapterdienst-Add-Ins nutzen, Assistenten zum Hinzufügen von Adaptermetadaten oder Hinzufügen des Adapterdienstverweis-Plug-Ins finden Sie unter Abrufen von Metadaten für SQL Server Vorgänge in Visual Studio mithilfe des SQL-Adapters.

Durchsuchen von Metadaten

Mit dem SQL-Adapter können Adapterclients Datenbanktabellen, Ansichten, gespeicherte Prozeduren und Funktionen durchsuchen, die in der SQL Server-Datenbank verfügbar sind. Im Rahmen des Metadatenstöbervorgangs zeigt der Adapter auch die Vorgänge an, die für die SQL Server-Datenbank ausgeführt werden können, einschließlich einiger benutzerdefinierter Vorgänge, die von den Adaptern unterstützt werden. Diese Vorgänge sind über Das Adapterdienst-Add-In nutzen, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Add Adapter Service Reference Plug-In verfügbar. Der SQL-Adapter zeigt die folgenden Vorgänge an:

Suchen nach Metadaten

Mit dem SQL-Adapter ist es möglich, eine Suchabfrage für die SQL Server Datenbank mithilfe der SQL Server Suchausdrücke auszuführen, die mit dem LIKE-Operator kompatibel sind. Adapterclients können beispielsweise einen Suchausdruck wie "EMP%" verwenden, um Tabellen ab EMP abzurufen. Der Adapter konvertiert dies in die folgende SQL-Abfrage:

SELECT TABLE_NAME FROM ALL_TABLES WHERE TABLE_NAME LIKE 'EMP%'

In der folgenden Tabelle sind die Sonderzeichen aufgeführt, die für die Suche und deren Interpretation durch den SQL-Adapter verwendet werden können.

Sonderzeichen Interpretation
_ (Unterstrich) Entspricht genau einem Zeichen.

"A_" entspricht beispielsweise "AB", "AC", "AD".
% (Prozentsatz) Entspricht null oder mehr Zeichen.

Beispielsweise entspricht "A%" "A", "AB", "ABC".
[ ] - Entweicht die besondere Bedeutung von _ und %.
– Gibt einen Bereich oder einen Satz von Zeichen an, die vorhanden sein sollen.

Beispiel:

- %[%]% entspricht allen Namen, die ein %-Symbol enthalten.
- [a-f] entspricht allen Namen, die Zeichen zwischen und enthalten, einschließlich "a" und "f".
- [abc] entspricht allen Namen mit den Zeichen "a", "b" und "c".
[^] Gibt einen Bereich oder einen Satz von Zeichen an, die nicht vorhanden sein sollen.

Beispiel:

- [^a-f] entspricht allen Namen, die keine Zeichen zwischen und enthalten, einschließlich "a" und "f".
- [^abc] entspricht allen Namen, die keine Zeichen "a", "b" und "c" enthalten.

Wichtig

Der Metadatensuchbereich ist auf die Ebene direkt unter dem Knoten beschränkt, auf dem der Suchvorgang ausgeführt wird. Um beispielsweise nach einer skalaren Funktion zu suchen, müssen Sie unter /Skalar Function/[Schema] suchen. Die Suche mit mehreren Ebenen wird nicht unterstützt.

Abrufen von Metadaten

Beim Abrufen von Metadaten kann der SQL-Adapter Metadaten unter einem Schema extrahieren, einschließlich aller oder einer Teilmenge von Datenbankobjekten mit den jeweiligen Objekt- und Vorgangsparametern. Der Adapter stellt die Entitäten aus der SQL Server-Datenbank als Elementnamen in XML dar. Da Unterstriche die einzigen zulässigen Sonderzeichen sind, die eingeschlossen werden können, werden alle anderen Sonderzeichen in den Elementnamen mit Unterstrichen codiert. Beispielsweise emp$name wird als emp_x0024_namecodiert.

Weitere Informationen

Übersicht über den BizTalk-Adapter für SQL ServerUnderstand BizTalk Adapter for SQL ServerAbrufen von Metadaten für SQL Server Vorgänge in Visual Studio mithilfe des SQL-Adapters