Compartilhar via


Conjunto de linhas DISCOVER_CSDL_METADATA

Retorna informações sobre um modelo de dados tabular, inclusive a definição do modelo no CSDL (linguagem de definição de esquema conceitual). CSDL é um esquema XML usado pela Estrutura de Dados de Entidade que é utilizada para comunicação entre um servidor Analysis Services e o cliente Power View. Para obter mais informações sobre modelos de dados de tabela, consulte Introdução às extensões CSDL para modelos de tabela.

O contexto de segurança do comando afeta o conjunto de linhas que é retornado. São requeridas permissões de leitura instância do Analysis Services para obter a definição CSDL do servidor.

O identificador de idioma do cliente que emite a solicitação de conjunto de linhas é incluído na cadeia de conexão para o comando e afeta o idioma exibido em várias propriedades que são retornadas como parte do conjunto de linhas. Para obter informações sobre propriedades e descrição que podem ser afetados pelo identificador de idioma, consulte a seção Comentários.

Aplica-se a: modelos tabulares

Colunas do conjunto de linhas

O conjunto de linhas DISCOVER_CSDL_METADATA contém as colunas a seguir.

Nome da coluna

Indicador de tipo

Restrição

Descrição

CATALOG_NAME

DBTYPE_WSTR

Sim

Especifica o nome do banco de dados para o qual a descrição CSDL é solicitada. Se ele for omitido, o banco de dados atual será usado.

O conjunto de linhas DISCOVER_CSDL_METADATA deve ser restrito usando esta coluna.

PERSPECTIVE_NAME

DBTYPE_WSTR

Sim

Especifica o nome de uma perspectiva que foi definida no modelo especificado por CATALOG_NAME.

É possível opcionalmente restringir o conjunto de linhas DISCOVER_CSDL_METADATA usando esta coluna.

Essa restrição é necessária para consultas CSDL em bancos de dados multidimensionais que contém mais de um cubo ou perspectiva. Essa funcionalidade foi apresentada no SQL Server 2012 SP1.

METADATA

DBTYPE_WSTR

Uma cadeia de caracteres que contém a definição de XML de uma fonte de dados e suas propriedades, de acordo com o esquema de CSDL.

Comentários

DISCOVER_CSDL_METADATA tem os seguintes requisitos:

  • A solicitação DISCOVER falhará se um banco de dados não for especificado usando a restrição CATALOG_NAME.

  • Se uma perspectiva for fornecida como uma restrição, o mesmo conjunto de linhas de CSDL será retornado para o modelo. Porém, todos os objetos que estão no modelo, mas não estão incluídos na perspectiva especificada, são marcados como Hidden = True.

  • Para tabelas e colunas, a solicitação DISCOVER gera sempre um valor da dimensão de cubo. Se a propriedade de dimensão de cubo não for definida, a solicitação retornará o valor da dimensão.

  • A solicitação DISCOVER não pode retornar qualquer medida nem colunas calculadas contendo um erro semântico.

  • A solicitação DISCOVER não retornará informações para objetos sem valores de propriedade. A solicitação DISCOVER também não retornará valores para atributos que usam o valor padrão.

A cadeia de caracteres XML que é retornada no conjunto de linhas pode incluir as propriedades ou valores a seguir, específicos do idioma. Por exemplo, se você emitir a solicitação de conjunto de linhas de um cliente que tem o LCID de 0403 (espanhol catalão), a propriedade retornará os valores a seguir como apropriados para espanhol catalão. Se traduções não estiverem disponíveis no servidor, a cadeia de caracteres para o idioma padrão do servidor será retornada.

  • Legenda

  • Qualificador

  • SortDirection

  • IsRightToLeft

Exemplo

A consulta XMLA a seguir retorna a representação CSDL do banco de dados, Modelo, na conexão atual.

<Discover xmlns="urn:schemas-microsoft-com:xml-analysis">
<RequestType>DISCOVER_CSDL_METADATA</RequestType>
    <Restrictions>
<RestrictionList>
<CATALOG_NAME>Model</CATALOG_NAME>
</RestrictionList>
</Restrictions>
    <Properties>
<PropertyList>
                 <FORMAT>Tabular</FORMAT>
   </PropertyList>
</Properties>
</Discover>

Usando ADOMD.NET para retornar o conjunto de linhas

Ao usar ADOMD.NET e o conjunto de linhas de esquema para recuperar metadados, você pode usar o GUID ou a cadeia de caracteres para referenciar um objeto de conjunto de linhas de esquema no método GetSchemaDataSet. Para obter mais informações, consulte Trabalhando com conjuntos de linhas do esquema no ADOMD.NET.

A tabela a seguir fornece os valores de GUID e de cadeia de caracteres que identificam este conjunto de linhas.

Argumento

Valor

GUID

87B86062-21C3-460F-B4F8-5BE98394F13B

ADOMDNAME

Csdl

Consulte também

Referência

Conjuntos de linhas de esquema do Analysis Services

Conceitos

Introdução às extensões CSDL para modelos de tabela