Pular para o conteúdo
officetuning.aiofficetuning.ai
TreinamentosConsultoriaBibliotecaFerramentasConteúdoPortfólio
Entrar
officetuning.aiofficetuning.ai

Treinamento, consultoria e mentoria para decidir, construir e aprender nas quatro frentes da marca.

AI · Data · Productivity · Dev · São Paulo
contato@officetuning.ai
TreinamentosPower BIExcelSQLPowerPointIA + ProdutividadeTodos os treinamentos
PortalConsultoriaBibliotecaPortfólioBackground BuilderDashboard CanvasConteúdo
InstitucionalPolítica de privacidadeInformações legais
© 2026 officetuning.ai · São Paulo
  1. Biblioteca
  2. Power Query (M)
  3. Funções M
  4. Table.NestedJoin

Table.NestedJoin

MTabela

Une as linhas de table1 com as de table2 pela igualdade dos valores das colunas-chave indicadas em key1 e key2. O resultado é inserido na coluna newColumnName, com uma tabela aninhada por linha.

Sintaxe

M
Table.NestedJoin(table1 as table, key1 as any, table2 as any, key2 as any, newColumnName as text, optional joinKind as nullable number, optional keyEqualityComparers as nullable list) as table

Parâmetros

table1tableObrigatório

Tabela da esquerda da junção.

M
Table.FromRecords({[CustomerToCall = 1], [CustomerToCall = 3]})
key1anyObrigatório

Coluna(s)-chave de table1.

M
{"CustomerToCall"}
table2anyObrigatório

Tabela da direita, cujas linhas correspondentes são aninhadas.

M
Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"], ...})
key2anyObrigatório

Coluna(s)-chave de table2.

M
{"CustomerID"}
newColumnNametextObrigatório

Nome da nova coluna que recebe as tabelas aninhadas.

M
"CustomerDetails"
joinKindnullable numberOpcional

Tipo de junção a executar; o padrão é junção externa esquerda.

keyEqualityComparersnullable listOpcional

Comparadores que definem como as colunas-chave são comparadas (uso interno).

Retorna

table

Exemplo

M
Table.NestedJoin(
    Table.FromRecords({
        [CustomerToCall = 1],
        [CustomerToCall = 3]
    }),
    {"CustomerToCall"},
    Table.FromRecords({
        [CustomerID = 1, Name = "Bob", Phone = "123-4567"],
        [CustomerID = 2, Name = "Jim", Phone = "987-6543"],
        [CustomerID = 3, Name = "Paul", Phone = "543-7890"],
        [CustomerID = 4, Name = "Ringo", Phone = "232-1550"]
    }),
    {"CustomerID"},
    "CustomerDetails"
)

Resultado

M
Table.FromRecords({
    [CustomerToCall = 1, CustomerDetails = Table.FromRecords({[CustomerID = 1, Name = "Bob", Phone = "123-4567"]})],
    [CustomerToCall = 3, CustomerDetails = Table.FromRecords({[CustomerID = 3, Name = "Paul", Phone = "543-7890"]})]
})

Observações

Sem joinKind, é feita uma junção externa esquerda. O parâmetro keyEqualityComparers destina-se atualmente apenas a uso interno.

Mais informações

Subgrupo
Table
Referência
https://learn.microsoft.com/pt-br/powerquery-m/table-nestedjoin
Função anteriorTable.MinNPróxima função Table.Partition
Biblioteca