Recuperando metadados – Trabalhando com conjuntos de linhas de esquema

Quando você precisa de mais metadados do que aquele disponível no modelo de objeto ADOMD.NET, o ADOMD.NET fornece a capacidade de recuperar toda a gama de rowsets de esquema XML for Analysis (XMLA), OLE DB, OLE DB para OLAP e OLE DB para Data Mining.

Metadados do XML for Analysis
Os conjuntos de linhas do esquema XML for Analysis fornecem um método para recuperar informações de baixo nível sobre o servidor. As informações disponíveis incluem as fontes de dados disponíveis no servidor, as palavras-chave reservadas pelo provedor, os literais compatíveis com o provedor e muito mais. Você pode até mesmo usar um conjunto de linhas de esquema XML for Analysis para descobrir todos os conjuntos de linhas de esquema compatíveis com o provedor.

Metadados do OLE DB
Os conjuntos de linhas de esquema OLE DB fornecem um método padrão do setor para recuperar informações de uma variedade de provedores.

Metadados OLAP
As informações de esquema fornecidas para uma fonte de dados analítica incluem bancos de dados ou catálogos disponíveis na fonte de dados analítica, cubos e modelos de mineração em um banco de dados, funções que existem para cubos na fonte de dados e muito mais.

Metadados de mineração de dados
Além dos metadados OLAP, os metadados de mineração de dados podem ser recuperados usando conjuntos de linhas de esquema. Os conjuntos de linhas disponíveis expõem informações sobre os modelos de mineração de dados disponíveis no banco de dados, os algoritmos de mineração disponíveis, os parâmetros exigidos pelo algoritmo, estruturas de mineração e muito mais.

Para cada um desses vários conjuntos de linhas de esquema, você recupera metadados do conjunto de linhas passando um GUID ou nome XMLA com o método GetSchemaDataSet do objeto AdomdConnection.

Recuperando metadados passando GUIDs

A AdomdSchemaGuid classe contém uma lista de campos que representam os conjuntos de linhas de esquema mais comumente compatíveis com provedores e fontes de dados analíticas. Para recuperar metadados gerais e específicos do provedor, ou de uma fonte de dados analítica, utilize os GUIDs contidos no objeto AdomdSchemaGuid com um dos seguintes métodos:

• GetSchemaDataSet

• GetSchemaDataSet

Recuperando metadados passando nomes XMLA

Os métodos a seguir assumem como argumentos o nome do esquema XMLA que identifica quais informações de esquema devem ser retornadas e uma matriz de restrições nessas colunas retornadas:

• GetSchemaDataSet

• GetSchemaDataSet

• GetSchemaDataSet

• GetSchemaDataSet

Cada um desses métodos retorna uma instância de um objeto DataSet que é preenchido com as informações de esquema. O objeto DataSet é do namespace System.Data da Biblioteca de Classes do Microsoft .NET Framework.

Example

No exemplo a seguir, a função GetActions usa uma conexão, o nome do cubo, uma coordenada e um tipo de coordenada, recupera um conjunto de linhas MDSCHEMA_ACTIONS e retorna as ações disponíveis na coordenada selecionada.

//The following function can be called with the following data:
//ae.GetActions(conn, "Adventure Works","[Geography].[City]",6 );

//This would return a DataSet containing the actions available for cells
//in the Adventure Works cube on [Geography].[City].
private System.Data.DataSet GetActions(AdomdConnection Connection, string Cube, string Coordinate, int CoordinateType)
{
    //Create a restriction collection to restrict the schema information to be returned.
    AdomdRestrictionCollection restrictions= new AdomdRestrictionCollection();
    restrictions.Add("CUBE_NAME", Cube);
    restrictions.Add("COORDINATE", Coordinate);
    restrictions.Add("COORDINATE_TYPE", CoordinateType); //6 = Cell coordinate

    //Open and return a schema rowset, given the correct restictions
    return Connection.GetSchemaDataSet("MDSCHEMA_ACTIONS", restrictions);
}