Types et ID de nœud pour l’adaptateur SQL Server

ID des nœuds de métadonnées

L’adaptateur Microsoft BizTalk pour SQL Server surfaces SQL Server artefacts de base de données de manière hiérarchique. Le tableau suivant répertorie les types de nœuds et les ID de nœud pour SQL Server artefacts de base de données exposés par l’adaptateur SQL. L’ID de nœud est le chemin absolu du nœud utilisé dans les méthodes IMetadataRetrievalContractBrowse, Search et GetMetadata .

Nom complet de l’artefact	Type de nœud	ID du nœud	Exemple	Description
--	CATÉGORIE	/	/	Nœud racine du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF. Retourne tous les nœuds de premier niveau ; cela inclut les nœuds des opérations ExecuteNonQuery, ExecuteReader et ExecuteScalar et tous les nœuds de schéma pour les opérations sortantes, et le nœud d’opération d’interrogation pour l’opération entrante.
ExecuteNonQuery	OPÉRATION SORTANTE	GenericOp/ExecuteNonQuery	GenericOp/ExecuteNonQuery	Nœud de l’opération ExecuteNonQuery. Retourne WSDL pour l’opération ExecuteNonQuery.
ExecuteReader	OPÉRATION SORTANTE	GenericOp/ExecuteReader	GenericOp/ExecuteReader	Nœud d’opération ExecuteReader. Retourne WSDL pour l’opération ExecuteReader.
ExecuteScalar	OPÉRATION SORTANTE	GenericOp/ExecuteScalar	GenericOp/ExecuteScalar	Nœud d’opération ExecuteScalar. Retourne WSDL pour l’opération ExecuteScalar.
Interrogation	OPÉRATION ENTRANTE	Interrogation	Interrogation	Nœud de l’opération d’interrogation. Retourne WSDL pour l’opération d’interrogation.
Notification	OPÉRATION ENTRANTE	Notification	Notification	Nœud d’opération de notification. Retourne WSDL pour l’opération de notification.
Procédures	CATÉGORIE	Procédures/	Procédures/	Nœud procédures de schéma. Retourne toutes les procédures pour le schéma spécifié.
[DB_PROCEDURE]	OPÉRATION SORTANTE	Procédure/[DB_SCHEMA]/[Procedure_Name]	Procédure/dbo/ADD_EMP_DETAILS	Nœud de procédure. Retourne le WSDL pour la procédure spécifiée.
Tables	CATÉGORIE	Tables/	Tables/	Nœud tables de schéma. Retourne tous les nœuds de table pour le schéma spécifié.
[DB_TABLE]	CATÉGORIE	-	-	Nœud de table. Retourne tous les nœuds d’opération (Insert, Select, Update, Delete et Set) pour la table spécifiée. L’opération Set est retournée uniquement pour les tables qui contiennent des colonnes avec l’un des types de données suivants : Varchar(Max), Nvarchar(Max) ou Varbinary(Max).
Insérer	OPÉRATION SORTANTE	TableOp/Insert/[DB_SCHEMA]/[DB_TABLE]	TableOp/Insert/dbo/Employee	Nœud d’opération d’insertion de table. Retourne WSDL pour l’opération Insert pour la table spécifiée.
Sélectionnez	OPÉRATION SORTANTE	TableOp/Select/[DB_SCHEMA]/[DB_TABLE]	TableOp/Select/dbo/Employee	Table Sélectionner le nœud de l’opération. Retourne WSDL pour l’opération Select pour la table spécifiée.
Update	OPÉRATION SORTANTE	TableOp/Update/[DB_SCHEMA]/[DB_TABLE]	TableOp/Update/dbo/Employee	Nœud de l’opération de mise à jour de table. Retourne WSDL pour l’opération De mise à jour de la table spécifiée.
Supprimer	OPÉRATION SORTANTE	TableOp/Delete/[DB_SCHEMA]/[DB_TABLE]	TableOp/Delete/dbo/Employee	Nœud d’opération De suppression de table. Retourne WSDL pour l’opération Delete pour la table spécifiée.
Set[COLUMN_NAME]	OPÉRATION SORTANTE	TableOp/WriteText/[DB_SCHEMA]/[DB_TABLE]/[COLUMN_NAME]	TableOp/WriteText/dbo/Employee/Job_Description	Nœud de l’opération Jeu de tables. Retourne WSDL pour l’opération Set pour la colonne spécifiée dans la table. (Uniquement exposé si la table contient des colonnes avec l’un des types de données suivants : (Max), Nvarchar(Max) ou Varbinary(Max)).
Vues	CATÉGORIE	Affichage/	Affichage/	Nœud vues de schéma. Retourne tous les nœuds d’affichage pour le schéma spécifié.
[DB_VIEW]	CATÉGORIE	-	-	Afficher le nœud. Retourne tous les nœuds d’opération (Insert, Select, Update et Delete) pour la vue spécifiée.
Insérer	OPÉRATION SORTANTE	ViewOp/Insert/[DB_SCHEMA]/[DB_VIEW]	ViewOp/Insert/dbo/Employee_View	Afficher le nœud d’opération d’insertion. Retourne WSDL pour l’opération Insert pour la vue spécifiée.
Sélectionnez	OPÉRATION SORTANTE	ViewOp/Select/[DB_SCHEMA]/[DB_VIEW]	ViewOp/Select/dbo/Employee_View	Afficher Le nœud Sélectionner une opération. Retourne WSDL pour l’opération Select pour la vue spécifiée.
Update	OPÉRATION SORTANTE	ViewOp/Update/[DB_SCHEMA]/[DB_VIEW]	ViewOp/Update/dbo/Employee_View	Afficher le nœud de l’opération de mise à jour. Retourne WSDL pour l’opération De mise à jour de la vue spécifiée.
Supprimer	OPÉRATION SORTANTE	ViewOp/Delete/[DB_SCHEMA]/[DB_VIEW]	ViewOp/Delete/dbo/Employee_View	Afficher le nœud d’opération Supprimer. Retourne WSDL pour l’opération Delete pour la vue spécifiée.
Fonctions scalaires	CATÉGORIE	ScalarFunctions/	ScalarFunctions/	Nœud fonctions scalaires de schéma. Retourne toutes les fonctions scalaires pour le schéma spécifié.
[DB_SCLR_FUNCTION]	OPÉRATION SORTANTE	ScalarFunction/[DB_SCHEMA]/[DB_SCLR_FUNCTION]	ScalarFunction/dbo/GET_EMP_ID	Nœud de fonction scalaire. Retourne le WSDL pour la fonction scalaire spécifiée.
Fonctions de table avec valeur	CATÉGORIE	TableFunctions/	TableFunctions/	Nœud fonctions table de schéma. Retourne toutes les fonctions table pour le schéma spécifié.
[DB_TBL_FUNCTION]	OPÉRATION SORTANTE	TableFunction/[DB_SCHEMA]/[DB_TBL_FUNCTION]	TableFunction/dbo/TVF_EMPLOYEE	Nœud de fonction table. Retourne le WSDL pour la fonction table spécifiée.

[DB_SCHEMA] = Collection d’artefacts SQL Server ; par exemple, dbo.

[DB_TABLE] = Nom d’une table SQL Server ; par exemple, Employee.

[DB_VIEW] = Nom d’une vue SQL Server ; par exemple, Employee_View.

[DB_PROCEDURE] = Nom d’une procédure stockée SQL Server ; par exemple, ADD_EMP_DETAILS.

[DB_SCLR_FUNCTION] = Nom d’une fonction scalaire SQL Server ; par exemple, GET_EMP_ID.

[DB_TBL_FUNCTION] = Nom d’une fonction table SQL Server ; par exemple, TVF_EMPLOYEE.

Recherche de métadonnées et ID de nœud

La recherche de métadonnées est une fonctionnalité puissante que le Kit de développement logiciel (SDK) de l’adaptateur LOB WCF présente dans le cadre de son interface MetadataRetrievalContract . L’adaptateur SQL utilise cette fonctionnalité pour prendre en charge la recherche sur les artefacts SQL Server suivants. L’étendue de recherche de métadonnées est limitée au niveau situé immédiatement sous le nœud où l’opération de recherche est effectuée. Par exemple, pour rechercher une fonction scalaire, vous devez effectuer une recherche sous /Scalar Function/[Schema]. La recherche récursive n’est pas prise en charge.

Artefact	ID du nœud	Type de nœud retourné	Description
/ (c’est-à-dire nœud racine)	/	CATÉGORIE	Retourne tous les nœuds de schéma qui correspondent à l’expression de recherche.
[DB_PROCEDURE]	/Procedure/[DB_SCHEMA]	OPÉRATION SORTANTE	Retourne tous les nœuds de procédure dans le schéma spécifié qui correspondent à l’expression de recherche.
[DB_TABLE]	/Table/[DB_SCHEMA]	CATÉGORIE	Retourne tous les nœuds de table dans le schéma spécifié qui correspondent à l’expression de recherche.
[DB_VIEW]	/View/[DB_SCHEMA]	CATÉGORIE	Retourne tous les nœuds d’affichage dans le schéma spécifié qui correspondent à l’expression de recherche.
[DB_SCLR_FUNCTION]	/ScalarFunction/[DB_SCHEMA]	OPÉRATION SORTANTE	Retourne tous les nœuds de fonction scalaire dans le schéma spécifié qui correspondent à l’expression de recherche.
[DB_TBL_FUNCTION]	/TableFunction/[DB_SCHEMA]	OPÉRATION SORTANTE	Retourne tous les nœuds de fonction table dans le schéma spécifié qui correspondent à l’expression de recherche.

[DB_SCHEMA] = Collection d’artefacts SQL Server ; par exemple, dbo.

[DB_TABLE] = Nom d’une table SQL Server ; par exemple, Employee.

[DB_VIEW] = Nom d’une vue SQL Server ; par exemple, Employee_View.

[DB_PROCEDURE] = nom d’une procédure SQL Server ; par exemple, ADD_EMP_DETAILS.

[DB_SCLR_FUNCTION] = Nom d’une fonction scalaire SQL Server ; par exemple, GET_EMP_ID.

[DB_TBL_FUNCTION] = Nom d’une fonction table SQL Server ; par exemple, TVF_EMPLOYEE.

Vous pouvez spécifier des expressions de recherche compatibles avec n’importe quelle expression valide pouvant être utilisée pour l’opérateur LIKE SQL Server. Par exemple, pour effectuer une recherche sur les tables contenues dans un schéma, l’adaptateur SQL exécute le code SQL suivant : SELECT TABLE_NAME FROM ALL_TABLES WHERE TABLE_NAME LIKE ‘[SEARCH_STR]’.

Le tableau suivant répertorie les caractères spéciaux pris en charge par l’adaptateur SQL dans les expressions de recherche.

Caractère spécial	Interprétation
% (pourcentage)	Correspond à zéro, un ou plusieurs caractères. Par exemple, « A% » correspond à « A », « AB », « ABC », etc.
_ (souligné)	Correspond exactement à 1 caractère. Par exemple, « A_ » correspond à « AB », « AC », « AD », etc.
[ ]	- Échappe la signification spéciale de _ et %. - Spécifie une plage ou un ensemble de caractères à présenter. Par exemple : - %[%]% correspond à tous les noms qui incluent un symbole % . - [a-f] correspond à tous les noms qui ont des caractères entre et y compris « a » et « f ». - [abc] correspond à tous les noms qui ont les caractères « a », « b » et « c ».
[^]	Spécifie une plage ou un ensemble de caractères à ne pas présenter. Par exemple : - [^a-f] correspond à tous les noms qui n’ont pas de caractères entre et y compris « a » et « f ». - [^abc] correspond à tous les noms qui n’ont pas les caractères « a », « b » et « c ».

Récupération des métadonnées et ID de nœud

Le tableau suivant récapitule les caractéristiques de métadonnées retournées par l’adaptateur SQL.

Artefact	Caractéristiques des métadonnées
Table ou vue	Nom de la table. Noms des champs de table. Les types de données de champ de table sont mappés à des types WSDL simples ou complexes. La longueur du champ de table est mappée à la facette maxLength. La contrainte de clé primaire de champ de table est mappée à la facette minOccurs = 1. La contrainte NULL de champ de table est mappée à la facette isNillable = true. Opérations de table INSERT SELECT UPDATE Suppression SET<Nom de la colonne>
Procédure ou fonction	- Le nom de la procédure ou de la fonction est mappé au nom de l’opération. - Noms de paramètres de procédure ou de fonction. - Les types de données de paramètres de procédure ou de fonction sont mappés aux types WSDL. - La direction des paramètres de procédure ou de fonction est mappée à la direction du paramètre WSDL. - La longueur du type de données du paramètre de procédure ou du paramètre de fonction est mappée à la facette maxLength. - L’ordre des paramètres de la procédure ou de la fonction est mappé à la séquence d’éléments. - Le type de données de retour de fonction est mappé au type WSDL. - La longueur du type de données de retour de fonction est mappée à la facette maxLength.

Pour plus d’informations sur le format des métadonnées exposées par l’adaptateur SQL pour des artefacts et des opérations spécifiques sur la base de données SQL Server, consultez Messages et schémas de message pour l’adaptateur BizTalk pour SQL Server.