Programando o cliente no ADOMD.NET

Os componentes de cliente do ADOMD.NET residem no namespace Microsoft.AnalysisServices.AdomdClient (em microsoft.analysisservices.adomdclient.dll). Esses componentes de cliente oferece a funcionalidade para aplicativos clientes e de camada intermediária para a consulta fácil de dados e de metadados a partir de uma fonte de dados analítica, como o Microsoft SQL Server Analysis Services.

Compreendendo os objetos de cliente do ADOMD.NET

Antes de começar a usar os componentes de cliente do ADOMD.NET, você precisa conhecer a funcionalidade de cliente, o modelo de objeto e as diferenças de versão.

Para obter mais informações: Funcionalidade de cliente do ADOMD.NET, Conceitos de cliente e modelo de objeto do ADOMD.NET, Diferenças de versão do ADOMD.NET, Migrando do ADO MD para o ADOMD.NET

Usando os objetos de cliente do ADOMD.NET

Durante a consulta a uma fonte de dados analítica, existe um conjunto de tarefas comuns que precisam ser executadas. A tabela a seguir representa as tarefas comuns nas quais você usa os objetos de cliente do ADOMD.NET para executar uma consulta assim.

Tarefa	Descrição
Estabelecendo conexões no ADOMD.NET	No ADOMD.NET, você usa um objeto AdomdConnection para estabelecer conexões com fontes de dados analíticas, como bancos de dados do Analysis Services. Você pode usar o objeto AdomdConnection para executar comandos, para recuperar dados para recuperar metadados da fonte de dados analítica.
Recuperando metadados de uma fonte de dados analítica	Depois que uma conexão foi estabelecida, você poderá usar uma grande variedade de objetos para recuperar informações sobre a fonte de dados subjacente. Essa funcionalidade permite que aplicativos se adaptem à fonte de dados à qual se conectaram.
Executando comandos em uma fonte de dados analítica	O objeto AdomdCommand oferece as interfaces necessárias para a execução de comandos na fonte de dados analítica subjacente.
Recuperando dados de uma fonte de dados analítica	Após a execução de um comando, os dados podem ser recuperados e analisados por meio dos objetos CellSet, AdomdDataReader ou System.XmlReader.
Executando transações no ADOMD.NET	Todas as ações listadas nas linhas anteriores desta tabela podem ocorrer em uma transação confirmada por leitura, na qual bloqueios compartilhados são mantidos enquanto os dados são lidos para impedir leituras sujas. Os dados ainda podem ser alterados antes do término da transação, resultando em leituras não-repetíveis ou em dados fantasma. O objeto AdomdTransaction oferece a funcionalidade de transação no ADOMD.NET.

A interação com a hierarquia de objetos do ADOMD.NET normalmente começa com um ou mais objetos da camada superior, como descrito na tabela a seguir.

Para	Use este objeto
Conectar a uma fonte de dados analítica	AdomdConnection O objeto AdomdConnection representa uma conexão a uma fonte de dados e os metadados de fonte de dados. Por exemplo, você pode se conectar a um arquivo de cubo local (.cub) do Microsoft SQL Server Analysis Services e examinar a propriedade Cubes para obter metadados sobre os cubos presentes na fonte de dados analítica. Esse objeto também representa a implementação da interface IDbConnection, que é exigida por todos os provedores de dados do .NET Framework.
Descobrir os recursos de mineração de dados da fonte de dados	AdomdConnection O objeto AdomdConnection exibe várias coleções de mineração: MiningModelCollection contém uma lista de todos os modelo de mineração da fonte de dados. MiningServiceCollection oferece informações sobre os algoritmos de mineração disponíveis. MiningStructureCollection exibe informações sobre as estruturas de mineração no servidor.
Consulte a fonte de dados	AdomdCommand O objeto AdomdCommand representa a instrução ou consulta que será enviada ao servidor. Após o estabelecimento de uma conexão a uma fonte de dados, use o objeto AdomdCommand para executar instruções na linguagem suportada, como MDX (Multidimensional Expressions) ou DMX (Data Mining Extensions). Você também pode usar um objeto AdomdCommand para retornar resultados na forma de objetos CellSet ou AdomdDataReader.
Recupere dados de uma forma rápida e eficiente	AdomdDataReader AdomdDataReader pode ser criado com uma chamada ao método Execute ou ExecuteReader de um objeto AdomdCommand. Esse objeto implementa a interface IDbDataReader do namespace System.Data da biblioteca de classes do .NET Framework.
Recupere dados analíticos com a maior quantidade de metadados	CellSet CellSet pode ser criado com uma chamada ao método Execute ou ExecuteCellSet de AdomdCommand. Quando AdomdCommand tiver retornado CellSet, você poderá examinar os dados analíticos contidos por CellSet.
Recupere metadados sobre cubos, como as dimensões, medidas, conjuntos nomeados disponíveis e assim por diante	CubeDef CubeDef representa os metadados sobre um cubo. Você referencia CubeDef a partir de AdomdConnection.
Recupere dados usando a interface System.Data.IDbDataAdapter	AdomdDataAdapter AdomdDataAdapter oferece suporte somente leitura para aplicativos cliente do .NET Framework existentes.

Consulte também

Conceitos

Programando o servidor no ADOMD.NET

ADOMD.NET