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.ReplaceValue

Table.ReplaceValue

MTabela

Substitui um valor por um novo valor nas colunas indicadas de uma tabela.

Sintaxe

M
Table.ReplaceValue(table as table, oldValue as any, newValue as any, replacer as function, columnsToSearch as list) as table

Parâmetros

tabletableObrigatório

Tabela a pesquisar.

M
Table.FromRecords({[A = 1, B = "hello"], [A = 2, B = "goodbye"], [A = 3, B = "goodbyes"]})
oldValueanyObrigatório

Valor a ser substituído.

M
"goodbye"
newValueanyObrigatório

Valor de substituição.

M
"world"
replacerfunctionObrigatório

Função substituidora (Replacer.ReplaceText, Replacer.ReplaceValue ou personalizada).

M
Replacer.ReplaceValue
columnsToSearchlistObrigatório

Coluna(s) em que o valor será procurado.

M
{"B"}

Retorna

table

Exemplo

M
Table.ReplaceValue(
    Table.FromRecords({
        [A = 1, B = "hello"],
        [A = 2, B = "goodbye"],
        [A = 3, B = "goodbyes"]
    }),
    "goodbye",
    "world",
    Replacer.ReplaceValue,
    {"B"}
)

Resultado

M
Table.FromRecords({
    [A = 1, B = "hello"],
    [A = 2, B = "world"],
    [A = 3, B = "goodbyes"]
})

Observações

Replacer.ReplaceValue troca só o valor inteiro; Replacer.ReplaceText troca qualquer parte do texto; também é possível usar um substituidor personalizado.

Mais informações

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