Visão geral da CSDLBI (Linguagem de Definição de Esquema Conceitual)

Aplica-se a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

O Analysis Services dá suporte à apresentação da definição de modelos multidimensionais e modelos tabulares nos níveis de compatibilidade 1103 e inferiores em um formato XML chamado Linguagem de Definição de Esquema Conceitual com anotações de Business Intelligence (CSDLBI). Este artigo fornece uma visão geral do CSDLBI e como ele é usado com modelos de dados do Analysis Services.

Compreendendo a função da CSDL

A CSDL (Linguagem de Definição de Esquema Conceitual) é uma linguagem em XML que descreve entidades, relações e funções. A CSDL é definida como parte da Estrutura de Dados de Entidade. As anotações de BI são uma extensão projetada para dar suporte à modelagem de dados usando o Analysis Services.

Embora a CSDL seja compatível com a Estrutura de Dados de Entidade, não é necessário compreender o modelo de relação entre entidades nem ter ferramentas especiais para criar um modelo de tabela ou um relatório baseado em um modelo. Você cria modelos usando ferramentas de cliente como o Visual Studio com extensões de projetos do Analysis Services, também conhecidas como SSDT (SQL Server Data Tools) ou uma API como AMO e implanta o modelo em um servidor.

O esquema CSDLBI é gerado pelo servidor do Analysis Services em resposta a uma solicitação de uma definição de modelo de um cliente. O aplicativo cliente envia uma consulta XML ao servidor do Analysis Services que hospeda os dados modelo. Em resposta, o servidor envia uma mensagem XML que contém uma definição das entidades no modelo, usando as anotações da CSDLBI. O cliente de relatórios usa as informações para apresentar os campos, as agregações e as medidas disponíveis no modelo. As anotações da CSDL também fornecem informações sobre como agrupar, classificar e formatar os dados.

Trabalhando com a CSDL

O conjunto de anotações da CSDLBI que representa qualquer modelo de tabela específico é um documento XML que contém uma coleção de entidades, simples e complexas. As entidades definem tabelas (ou dimensões), colunas (atributos), associações (relações) e fórmulas incluídas em colunas calculadas, medidas ou KPIs.

Você não pode modificar estes objetos diretamente, mas deve usar as ferramentas de cliente e APIs (interfaces de programação de aplicativo) fornecidas para trabalhar com modelos de tabela.

Você pode obter a CSDL para um modelo enviando uma solicitação DISCOVER ao servidor que hospeda o modelo. A solicitação deve ser qualificada especificando o servidor e o modelo e, opcionalmente, uma exibição ou perspectiva. A mensagem retornada é uma cadeia de caracteres XML. Certos elementos dependem da linguagem e retornam valores diferentes de acordo com a linguagem da conexão atual. Para obter mais informações, consulte conjunto de linhas DISCOVER_CSDL_METADATA.

Referência de CSDLBI

A especificação da CSDL original (da Estrutura de Dados de Entidade) oferece a maioria das entidades e propriedades necessárias para oferecer suporte à modelagem. As anotações de BI dão suporte a requisitos especiais de modelos tabulares, propriedades de relatório necessárias para clientes e metadados adicionais necessários para modelos multidimensionais.

A partir de 2012, a versão 1.0 e as versões subsequentes da especificação CSDLBI são descritas em Especificações Abertas. A Especificação Aberta é atualizada periodicamente para coincidir com as alterações na funcionalidade. Antes de publicar o CSDLBI na Especificação Aberta, as versões 1.0 e 1.1 do CSDLBI foram documentadas como uma referência no MSDN\TechNet. Essa versão inicial da referência CSDLBI fornece definições mais detalhadas de estruturas E semânticaS CSDLBI do que as fornecidas na especificação aberta. No entanto, a especificação aberta deve ser usada.

Open Specification versões 1.0 e superior

[MS-CSDLBI]: Formato de arquivo de definição de esquema conceitual com anotações do Business Intelligence

Referência do CSDLBI 1.0, 1.1 (arquivado)

Referência de CSDLBI 1.0, 1.1

Confira também

Para obter informações detalhadas sobre elementos individuais nas anotações CSDLBI, consulte Referência técnica para anotações de BI para CSDL.
Para obter informações sobre a especificação CSDL principal, consulte a especificação CSDL no MSDN.