Conjunto de linhas DISCOVER_CALC_DEPENDENCY

Cria relatórios sobre as dependências entre cálculos e sobre os objetos referenciados nesses cálculos. Você pode usar essas informações em um aplicativo cliente para gerar relatórios sobre problemas com fórmulas complexas ou para advertir quando objetos relacionados forem excluídos ou modificados. Você também pode usar o conjunto de linhas para extrair as expressões DAX usadas em medidas ou colunas calculadas.

Aplica-se a: modelos tabulares

Colunas do conjunto de linhas

O conjunto de linhas DISCOVER_CALC_DEPENDENCY contém as colunas a seguir. A tabela também especifica o tipo de dados, indica se a coluna pode ser restrita para limitar as linhas que são retornadas e fornece uma descrição de cada coluna.

Exemplo

Sintaxe básica

A consulta a seguir é uma consulta DMV simples que retorna valores para todas as colunas neste conjunto de linhas, usando o banco de dados padrão na conexão atual. Você pode executar essa consulta em uma janela de consulta MDX e exibir seus resultados no Management Studio. Você também pode seguir as técnicas descritas em Consultando DMVs do PowerPivot no Excel para exibir resultados da consulta DMV no Excel.

SELECT * FROM $System.DISCOVER_CALC_DEPENDENCY

Classificar os resultados

Adicionar um ORDER BY para classificar o conjunto de linhas por tabela ou outra coluna.

SELECT * FROM $System.DISCOVER_CALC_DEPENDENCY ORDER BY [TABLE] ASC

Filtrar usando uma cláusula WHERE

A próxima consulta mostra como adicionar uma restrição usando a cláusula WHERE. As colunas a seguir podem ser usadas como filtros de consulta em uma cláusula WHERE: Database_Name, Object_Type e Query.

SELECT * From $SYSTEM.DISCOVER_CALC_DEPENDENCY WHERE OBJECT_TYPE = 'RELATIONSHIP' OR OBJECT_TYPE = 'ACTIVE_RELATIONSHIP'

Filtrar em medidas e colunas calculadas para exibir expressões DAX subjacentes.

Nessa consulta, você pode selecionar apenas a medida ou coluna calculada e, em seguida, exibir a expressão DAX usada no cálculo. A coluna EXPRESSION contém as expressões DAX. Se você estiver usando DISCOVER_CALC_DEPENDENCY para extrair a expressão DAX usada no modelo, essa consulta será suficiente para essa finalidade. Ela retorna todas as expressões usadas no modelo, em ordem crescente.

SELECT * From $SYSTEM.DISCOVER_CALC_DEPENDENCY WHERE OBJECT_TYPE = 'MEASURE' OR OBJECT_TYPE = 'CALC_COLUMN' ORDER BY [EXPRESSION] ASC

Filtrar usando QUERY

Usando a restrição QUERY, você pode fornecer uma consulta DAX para exibir todos os objetos usados na consulta. Considere uma consulta simples como 'Evaluate Customer'. Conforme foi escrito, essa consulta retorna linhas de dados do cliente, onde a composição da linha é baseada nas colunas na tabela Customer. Se você executar agora DISCOVER_CALC_DEPENDENCY com uma restrição QUERY de ‘Evaluate Customer’, obterá as colunas (ou objetos) usados na consulta. Nesse caso, é uma lista das colunas na tabela Customer.

O próximo conjunto de consultas demonstra sintaxe para a restrição QUERY. Você pode executar essas consultas no Modelo Tabular do AdventureWorks SQL Server 2012 para exibir o conjunto de resultados.

A primeira consulta mostra como especificar uma restrição QUERY para nomes de objetos que incluem espaços. A segunda consulta, emprestada de Executar consultas DAX por meio de OLE DB e ADOMD.NET, é uma consulta mais complexa que inclui objetos de várias tabelas.

Observação
Embora as consultas pareçam usar aspas duplas, de fato somente aspas simples são usadas. Um par de aspas simples envolve ‘Evaluate <Tablename>’, e aspas simples usadas em volta do nome da tabela precisam ser substituídas por aspas duplas. Aspas simples em volta do nome da tabela são necessárias somente para os nomes de tabelas que incluem um espaço.

SELECT * From $SYSTEM.DISCOVER_CALC_DEPENDENCY WHERE QUERY = 'EVALUATE ''Reseller Sales'''

SELECT * from $system.DISCOVER_CALC_DEPENDENCY WHERE QUERY = 'EVALUATE CALCULATETABLE(VALUES(''Product Subcategory''[Product Subcategory Name]), ''Product Category''[Product Category Name] = "Bikes")'

Exemplo XMLA de restrição QUERY

Você pode usar um comando Discover do XMLA para retornar os objetos de consulta em uma tabela. O XMLA retorna resultados como XML bruto. Você pode usar ADOMD.NET para analisar os resultados em um formato mais legível.

<Discover xmlns="urn:schemas-microsoft-com:xml-analysis">
   <RequestType>DISCOVER_CALC_DEPENDENCY</RequestType>
     <Restrictions>
        <RestrictionList>
            <QUERY>Evaluate 'Reseller Sales'</QUERY>
        </RestrictionList>
    </Restrictions>
    <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.

Consulte também

Referência

Conjuntos de linhas de esquema do Analysis Services

Conceitos

Usar DMVs (Exibições de Gerenciamento Dinâmico) para monitorar o Analysis Services