Partilhar via


CAMINHO

Aplica-se a:Colunacalculada Tabelacalculada MedidaCálculo visual

Retorna uma cadeia de texto delimitada com os identificadores de todos os pais do identificador atual, começando com o mais antigo e continuando até o 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 para linhas na tabela. Isto 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. Isto não pode ser uma expressão. O tipo de dados do valor em parent_columnName tipo de dados deve ser texto ou inteiro e deve ser o mesmo tipo de dados que o valor em ID_columnName.

Valor devolvido

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

Observações

  • Esta função é usada em tabelas que têm algum tipo de hierarquia interna, para retornar os itens que estão relacionados ao valor da linha atual. Por exemplo, em uma tabela 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 a seu gerente.

  • O caminho não está limitado a um único nível de relações entre pais e filhos; ele pode retornar linhas relacionadas que estão vários níveis acima da linha inicial especificada.

    • O delimitador utilizado 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 pode procurar um pai se não houver valor no nível da criança.
    • Se parent_columnName estiver BLANK, PATH() retornará ID_columnName valor. 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 o ID do funcionário.
    • Se ID_columnName tiver duplicatas e parent_columnName for o mesmo para essas duplicatas, PATH() retornará o valor de parent_columnName comum, no entanto, se parent_columnName valor for diferente para essas duplicatas, PATH() retornará um erro. Em outras palavras, se você tiver duas listagens para o mesmo ID de funcionário e eles tiverem o mesmo ID de gerente, a função PATH retornará o ID desse gerente. No entanto, se houver dois IDs de funcionário idênticos que tenham IDs de gerente diferentes, a função PATH retornará um erro.
    • Se ID_columnName estiver BLANK, PATH() retornará BLANK.
    • Se ID_columnName contiver uma barra vertical '|', PATH() retornará um erro.
  • Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

Exemplo

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

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