Programmation du client ADOMD.NET

Les composants clients ADOMD.NET résident dans l'espace de noms Microsoft.AnalysisServices.AdomdClient (dans microsoft.analysisservices.adomdclient.dll). Ces composants clients dotent les applications clientes et intermédiaires de fonctionnalités destinées à faciliter l'interrogation de données et de métadonnées dans une banque de données analytiques, telle que Microsoft SQL Server Analysis Services.

Fonctionnement des objets clients ADOMD.NET

Avant de commencer à utiliser les composants clients ADOMD.NET, vous devez vous familiariser avec les fonctionnalités clientes, le modèle objet et les différences entre les versions.

Pour plus d'informations : Fonctionnalités clientes ADOMD.NET, Concepts et modèle objet client ADOMD.NET, Différences entre les versions d'ADOMD.NET, Migration d'ADO MD vers ADOMD.NET

Utilisation des objets clients ADOMD.NET

Lorsqu'il s'agit d'interroger une source de données analytiques, il convient d'effectuer un ensemble de tâches courantes. Le tableau suivant présente les tâches courantes dans lesquelles les objets clients ADOMD.NET sont utilisés dans le cadre d'une requête de ce type.

Tâche

Description

Établissement de connexions dans ADOMD.NET

Dans ADOMD.NET, il convient d'utiliser un objet AdomdConnection pour établir des connexions avec les sources de données analytiques, telles que les bases de données Analysis Services. Vous pouvez utiliser l'objet AdomdConnection pour exécuter des commandes ou récupérer des données et des métadonnées à partir de la source de données analytiques.

Récupération de métadonnées à partir d'une source de données analytiques

Après avoir établi une connexion, vous pouvez utiliser une large palette d'objets pour récupérer des informations sur la source de données sous-jacente. Ces fonctionnalités permettent aux applications de s'adapter à la source de données à laquelle elles se sont connectées.

Exécution de commandes sur une source de données analytiques

L'objet AdomdCommand fournit les interfaces nécessaires à l'exécution de commandes sur la source de données analytiques sous-jacente.

Récupération de données à partir d'une source de données analytiques

Suite à l'exécution d'une commande, les données peuvent être récupérées et analysées à l'aide des objets CellSet, AdomdDataReader ou System.XmlReader.

Exécution de transactions dans ADOMD.NET

Toutes les actions énumérées dans les lignes précédentes de ce tableau peuvent se produire dans une transaction validée en lecture, où les verrous partagés sont maintenus pendant la lecture des données afin d'éviter des lectures erronées. Les données peuvent toujours être modifiées avant la fin de la transaction, ce qui génère des lectures non renouvelables ou des données fantômes. L'objet AdomdTransaction fournit les fonctionnalités de transaction dans ADOMD.NET.

L'interaction avec la hiérarchie d'objets ADOMD.NET débute généralement avec un ou plusieurs des objets de la couche de niveau supérieur, comme indiqué dans le tableau suivant.

Pour

Utiliser cet objet

Se connecter à une source de données analytiques

AdomdConnection

L'objet AdomdConnection représente à la fois une connexion à une source de données et les métadonnées de la source de données. Par exemple, vous pouvez vous connecter à un fichier de cube local Microsoft SQL Server Analysis Services (.cub), puis examiner la propriété Cubes pour obtenir les métadonnées relatives aux cubes présents dans la source de données analytiques. Cet objet représente également l'implémentation de l'interface IDbConnection, interface requise par tous les fournisseurs de données .NET Framework.

Découvrir les possibilités d'exploration de données propres à la source de données

AdomdConnection

L'objet AdomdConnection expose plusieurs collections d'exploration de données :

Interroger la source de données

AdomdCommand

L'objet AdomdCommand représente l'instruction ou la requête qui sera envoyée au serveur. Après avoir établi une connexion à une source de données, vous devez utiliser un objet AdomdCommand pour exécuter les instructions dans le langage pris en charge, tel que MDX (Multidimensional Expressions) ou DMX (Data Mining Extensions). Vous pouvez également utiliser un objet AdomdCommand pour retourner les résultats sous forme d'objets CellSet ou AdomdDataReader.

Récupérer les données avec rapidité et efficacité

AdomdDataReader

L'objet AdomdDataReader peut être créé en faisant appel à la méthode Execute ou ExecuteReader d'un objet AdomdCommand. Cet objet implémente l'interface IDbDataReader à partir de l'espace de noms System.Data de la bibliothèque de classes du .NET Framework.

Récupérer des données analytiques avec une quantité maximale de métadonnées

CellSet

CellSet peut être créé en faisant appel à la méthode Execute ou ExecuteCellSet de AdomdCommand. Dès lors que AdomdCommand a retourné CellSet, vous pouvez examiner les données analytiques contenues dans CellSet.

Récupérer les métadonnées relatives aux cubes, notamment les dimensions disponibles, les mesures, les jeux nommés, etc.

CubeDef

CubeDef représente les métadonnées relatives à un cube. Vous faites référence à CubeDef à partir de AdomdConnection.

Récupérer des données à l'aide de l'interface System.Data.IDbDataAdapter

AdomdDataAdapter

AdomdDataAdapter fournit une prise en charge en lecture seule pour les applications clientes .NET Framework existantes.