Table.ReplaceValue

Sintaxe

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

Sobre

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

• table: A tabela a pesquisar.
• oldValue: O valor a ser substituído.
• newValue: O valor de substituição.
• replacer: A função de substituição a ser usada. A função pode ser Replacer.ReplaceText substituir o texto original por um novo texto, Replacer.ReplaceValue substituir o valor original por um novo valor ou um substituto personalizado.
• columnsToSearch: Uma lista que contém a coluna ou colunas específicas na tabela para procurar o valor a substituir.

Exemplo 1

Substitua o texto "adeus" por "mundo" na coluna B, correspondendo apenas ao valor inteiro.

Utilização

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

Saída

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

Exemplo 2

Substitua o texto "ur" por "or" na coluna B, correspondendo a qualquer parte do valor.

Utilização

Table.ReplaceValue(
    Table.FromRecords({
        [A = 1, B = "hello"],
        [A = 2, B = "wurld"]
    }),
    "ur",
    "or",
    Replacer.ReplaceText,
    {"B"}
)

Saída

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

Exemplo 3

Anonimizar os nomes dos funcionários dos EUA.

Utilização

Table.ReplaceValue(
    Table.FromRecords({
        [Name = "Cindy", Country = "US"],
        [Name = "Bob", Country = "CA"]
    }),
    each if [Country] = "US" then [Name] else false,
    each Text.Repeat("*", Text.Length([Name])),
    Replacer.ReplaceValue,
    {"Name"}
)

Saída

Table.FromRecords({
    [Name = "*****", Country = "US"],
    [Name = "Bob", Country = "CA"]
})

Exemplo 4

Anonimizar todas as colunas de funcionários dos EUA.

Utilização

Table.ReplaceValue(
    Table.FromRecords({
        [Name = "Cindy", Country = "US"],
        [Name = "Bob", Country = "CA"]
    }),
    each [Country] = "US",
    "?",
    (currentValue, isUS, replacementValue) =>
        if isUS then
            Text.Repeat(replacementValue, Text.Length(currentValue))
        else
            currentValue,
    {"Name", "Country"}
)

Saída

Table.FromRecords({
    [Name = "?????", Country = "??"],
    [Name = "Bob", Country = "CA"]
})

Conteúdos relacionados

Funções de substituição