Parcourir, rechercher et obtenir des métadonnées SQL Server

Les métadonnées que l’adaptateur Microsoft BizTalk pour SQL Server surface à partir de la base de données SQL Server décrivent la structure de message pour la communication avec la base de données SQL Server à l’aide de l’adaptateur. L’adaptateur SQL prend en charge deux interfaces pour récupérer les métadonnées.

• MetadataExchange fourni par Windows Communication Foundation (WCF). WCF fournit un point de terminaison d’échange de métadonnées pour toutes les liaisons WCF, ce qui permet aux clients d’obtenir des métadonnées à partir de la base de données SQL Server.

• IMetadataRetrievalContract fourni par le Kit de développement logiciel (SDK) de l’adaptateur métier (LOB) Microsoft Windows Communication Foundation (WCF), qui prend en charge les fonctionnalités de navigation et de recherche des métadonnées de l’adaptateur.

  L’adaptateur SQL fait apparaître les artefacts de base de données SQL Server et les opérations respectives que les clients de l’adaptateur peuvent appeler. L’adaptateur présente également des opérations (telles que ExecuteNonQuery, ExecuteReader et ExecuteScalar) qui peuvent être utilisées pour effectuer des opérations spécifiques sur la base de données SQL Server. Ces opérations sont traitées plus loin dans cette rubrique.

Notes

L’adaptateur SQL fait apparaître des artefacts dans tous les schémas de la base de données SQL Server à laquelle l’utilisateur actuellement connecté a accès. Cela implique qu’en dehors du schéma par défaut (dbo), les clients d’adaptateur peuvent également effectuer des opérations sur des artefacts dans d’autres schémas de la base de données SQL Server, à condition que les informations d’identification utilisateur utilisées pour se connecter à l’aide de l’adaptateur SQL ont accès à ces schémas dans la base de données SQL Server. Pour plus d’informations sur un schéma dans SQL Server base de données, consultez https://go.microsoft.com/fwlink/?LinkId=130148.

Vous pouvez utiliser les clients d’adaptateur pour parcourir, rechercher et récupérer des métadonnées en procédant comme suit :

• Création d’un projet BizTalk dans Visual Studio

• Utilisation du modèle de service WCF

• Utilisation du modèle de canal WCF

  Lorsque vous utilisez un projet BizTalk, vous devez utiliser le complément de projet BizTalk du service d’adaptateur consommer ou l’Assistant Ajouter des métadonnées d’adaptateur pour générer des métadonnées pour les opérations que vous souhaitez effectuer sur la base de données SQL Server. Lorsque vous utilisez le modèle de service WCF, vous devez utiliser le plug-in Visual Studio Add Adapter Service pour générer les classes proxy pour effectuer des opérations sur la base de données SQL Server. Pour plus d’informations sur la navigation, la recherche et la récupération des métadonnées à l’aide du complément Consommer le service d’adaptateur, de l’Assistant Ajouter des métadonnées d’adaptateur ou d’ajouter un plug-in de référence du service d’adaptateur, consultez Obtenir des métadonnées pour SQL Server opérations dans Visual Studio à l’aide de l’adaptateur SQL.

Métadonnées de navigation

L’adaptateur SQL permet aux clients d’adaptateur de parcourir les tables de base de données, les vues, les procédures stockées et les fonctions disponibles dans la base de données SQL Server. Dans le cadre de l’opération de navigation des métadonnées, l’adaptateur présente également les opérations qui peuvent être effectuées sur la base de données SQL Server, y compris certaines opérations personnalisées prises en charge par les cartes. Ces opérations sont disponibles à partir du complément Consommer le service d’adaptateur, de l’Assistant Ajouter des métadonnées d’adaptateur ou d’ajouter un plug-in de référence du service d’adaptateur. L’adaptateur SQL présente les opérations suivantes :

• Opérations sur les tables, les vues, les procédures, les fonctions scalaires et les fonctions table. Par exemple, l’adaptateur SQL peut entraîner des opérations d’insertion, de mise à jour, de sélection et de suppression pour la table EMPLOYEE.

• L’opération Définir<le nom> de colonne pour les tables et les vues qui permet aux clients d’adaptateur d’écrire des valeurs de données volumineuses en streaming. L’opération Set est retournée uniquement pour les tables et les vues qui contiennent des colonnes avec l’un des types de données suivants : Varchar(Max), Nvarchar(Max) ou Varbinary(Max). Pour plus d’informations, consultez Opérations sur les tables et les vues qui contiennent des types de données volumineux à l’aide de l’adaptateur SQL.

• Les opérations ExecuteNonQuery, ExecuteReader et ExecuteScalar qui permettent aux clients d’adaptateur d’exécuter des instructions SQL arbitraires dans SQL Server. Pour plus d’informations sur ces opérations, consultez Prise en charge des opérations ExecuteNonQuery, ExecuteReader et ExecuteScalar.

• Opérations d’interrogation et de notification pour recevoir les messages entrants de SQL Server. Pour plus d’informations sur l’opération d’interrogation, consultez Prise en charge des appels entrants à l’aide de l’interrogation ; Pour plus d’informations sur l’opération de notification, consultez Considérations relatives à la réception de notifications de requête à l’aide de l’adaptateur SQL.

  Pour plus d’informations sur la façon dont les métadonnées sont catégorisées, consultez ID de nœud de métadonnées.

Recherche dans les métadonnées

Avec l’adaptateur SQL, il est possible d’effectuer une requête de recherche sur la base de données SQL Server à l’aide des expressions de recherche SQL Server compatibles avec l’opérateur LIKE. Par exemple, les clients d’adaptateur peuvent utiliser une expression de recherche telle que « EMP% » pour obtenir des tables commençant par EMP. L’adaptateur le convertit en requête SQL suivante :

SELECT TABLE_NAME FROM ALL_TABLES WHERE TABLE_NAME LIKE 'EMP%'

Le tableau suivant répertorie les caractères spéciaux qui peuvent être utilisés pour la recherche et leur interprétation par l’adaptateur SQL.

Caractère spécial	Interprétation
_ (souligné)	Correspond exactement à un caractère. Par exemple, « A_ » correspond à « AB », « AC », « AD ».
% (pourcentage)	Correspond à zéro, un ou plusieurs caractères. Par exemple, « A% » correspond à « A », « AB », « ABC ».
[ ]	- É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'.

Important

L’étendue de recherche de métadonnées est limitée au niveau situé immédiatement sous le nœud auquel 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 à plusieurs niveaux n’est pas prise en charge.

Récupération de métadonnées

Lors de la récupération de métadonnées, l’adaptateur SQL peut extraire des métadonnées sous un schéma, y compris la totalité ou un sous-ensemble d’objets de base de données avec l’objet et les paramètres d’opération respectifs. L’adaptateur présente les entités de la base de données SQL Server sous forme de noms d’éléments dans XML. Étant donné que les traits de soulignement sont les seuls caractères spéciaux autorisés qui peuvent être inclus, tous les autres caractères spéciaux dans les noms d’éléments sont encodés à l’aide de traits de soulignement. Par exemple, emp$name est encodé en tant que emp_x0024_name.

Voir aussi

Vue d’ensemble de l’adaptateur BizTalk pour SQL ServerComprendre l’adaptateur BizTalk pour SQL Server Obtenir desmétadonnées pour les opérations SQL Server dans Visual Studio à l’aide de l’adaptateur SQL