Compartilhar via

Função PATH (DAX)

  • Artigo

Retorna uma cadeia de caracteres de texto delimitada com os identificadores de todos os pais do identificador atual, começando pelo mais antigo até o atual.

Sintaxe

PATH(<ID_columnName>, <parent_columnName>)

Parâmetros

  • ID_columnName
    O nome de uma coluna existente que contém o identificador exclusivo de linhas na tabela. Ele não pode ser uma expressão. O tipo de dados do valor em ID_columnName deve ser texto ou inteiro, e o tipo de dados deve ser igual ao da coluna referenciada em parent_columnName.

  • parent_columnName
    O nome de uma coluna existente contendo o identificador exclusivo do pai da linha atual. Ele não pode ser uma expressão. O tipo de dados do valor no tipo de dados parent_columnName deve ser texto ou inteiro, e o tipo de dados deve ser igual ao do valor em ID_columnName.

Valor de retorno

Uma cadeia de caracteres de texto delimitada que contém os identificadores de todos os pais para o identificador atual.

Comentários

Esta função é usada em tabelas que têm algum tipo de hierarquia interna para retornar os itens relacionados ao valor de linha atual. Por exemplo, em uma tabela Employees que contém os funcionários, os gerentes de funcionários e os gerentes dos gerentes, você pode retornar o caminho que conecta um funcionário ao seu gerente.

O caminho não é restringido a um único nível de relações pai-filho; ele pode retornar linhas relacionadas que estão vários níveis acima da linha inicial especificada.

  • O delimitador usado para separar os ascendentes é a barra vertical,' | '.

  • Os valores em ID_columnName e parent_columnName devem ter o mesmo tipo de dados, texto ou inteiro.

  • Valores em parent_columnName devem estar presentes em ID_columnName. Ou seja, você não pode verificar um pai se não existe valor em nível de filho.

  • Se parent_columnName for BLANK, PATH() retornará o valor ID_columnName. Em outras palavras, se você procurar o gerente de um funcionário mas a coluna parent_columnName não tiver dados, a função PATH retornará apenas a ID do funcionário.

  • Se ID_columnName tiver duplicatas e parent_columnName for igual para essas duplicatas, PATH() retornará o valor parent_columnName comum; porém, se o valor parent_columnName for diferente para essas duplicatas, PATH() retornará um erro. Em outras palavras, se você tiver duas listagens para a mesma ID de funcionário e elas tiverem a mesma ID de gerente, a função PATH retornará a ID desse gerente. Porém, se houver duas IDs de funcionário idênticas com IDs de gerente diferentes, a função PATH retornará um erro.

  • Se ID_columnName for BLANK, PATH() retornará BLANK.

  • Se ID_columnName contiver uma barra vertical' | ', PATH() retornará um erro.

Esta função DAX não tem suporte para uso no modo DirectQuery. Para obter mais informações sobre limitações nos modelos DirectQuery, consulte https://go.microsoft.com/fwlink/?LinkId=219172.

Exemplo

O exemplo a seguir cria uma coluna calculada que lista todos os gerentes para cada funcionário.

=PATH(Employee[EmployeeKey], Employee[ParentEmployeeKey])