Ler em inglês

Compartilhar via


PATH

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

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

Sintaxe

PATH(<ID_columnName>, <parent_columnName>)  

Parâmetros

Termo Definição
ID_columnName O nome de uma coluna existente que contém o identificador exclusivo das linhas na tabela. Não pode ser uma expressão. O tipo de dados do valor em ID_columnName deve ser texto ou inteiro e também deve ser o mesmo tipo de dados que a coluna referenciada em parent_columnName.
parent_columnName O nome de uma coluna existente que contém o identificador exclusivo do pai da linha atual. Não pode ser uma expressão. O tipo de dados do valor em parent_columnName deve ser texto ou inteiro e deve ser o mesmo tipo de dados que o valor em parent_columnName.

Retornar valor

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

Comentários

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

  • O caminho não fica restrito 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.
    • Os valores em parent_columnName devem estar presentes em ID_columnName. Ou seja, você não poderá pesquisar um pai se não houver nenhum valor no nível filho.
    • Se parent_columnName estiver em branco, PATH() retornará o valor de ID_columnName. Ou seja, 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 comum parent_columnName. No entanto, 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. No entanto, se houver duas IDs de funcionário idênticas que tenham IDs de gerentes diferentes, a função PATH retornará um erro.
    • Se ID_columnName estiver em branco, PATH() retornará BLANK.
    • Se ID_columnName contiver uma barra vertical “|”, PATH() retornará um erro.
  • Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

Exemplo

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

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