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. Function.ScalarVector

Function.ScalarVector

MValores de Função

Retorna uma função escalar do tipo scalarFunctionType que invoca vectorFunction com uma única linha de argumentos e retorna sua única saída. Quando a função escalar é aplicada repetidamente a cada linha de uma tabela de entradas, como em Table.AddColumn, vectorFunction é aplicada uma única vez para todas as entradas.

Sintaxe

M
Function.ScalarVector(scalarFunctionType as type, vectorFunction as function) as function

Parâmetros

scalarFunctionTypetypeObrigatório

Tipo da função escalar retornada.

M
type function (left as number, right as number) as number
vectorFunctionfunctionObrigatório

Função que processa em lote uma tabela de argumentos e retorna uma lista de resultados.

M
Compute.ScoreVector

Retorna

function

Exemplo

M
let
    Compute.ScoreScalar = (left, right) => left * right,
    // When Function.ScalarVector batching kicks in, we'll receive all
    // of the inputs for the entire table here at once.
    Compute.ScoreVector = (input) => let
        chunks = Table.Split(input, 100),
        scoreChunk = (chunk) => Table.TransformRows(chunk, each Compute.ScoreScalar([left], [right]))
      in
        List.Combine(List.Transform(chunks, scoreChunk)),
    Compute.Score = Function.ScalarVector(
        type function (left as number, right as number) as number,
        Compute.ScoreVector
    ),
    Final = Table.AddColumn(
        Table.FromRecords({
            [a = 1, b = 2],
            [a = 3, b = 4]
        }),
        "Result",
        each Compute.Score([a], [b])
    )
in
    Final

Resultado

M
Table.FromRecords({
    [a = 1, b = 2, Result = 2],
    [a = 3, b = 4, Result = 12]
})

Observações

vectorFunction recebe uma tabela cujas colunas correspondem, em nome e posição, aos parâmetros de scalarFunctionType, e deve retornar uma lista do mesmo tamanho da tabela de entrada. A tabela de entrada é transmitida em fluxo: vectorFunction deve processar um bloco por vez e não pode enumerar a entrada mais de uma vez.

Mais informações

Subgrupo
Function
Referência
https://learn.microsoft.com/pt-br/powerquery-m/function-scalarvector
Função anteriorFunction.IsDataSourcePróxima função Geography.FromWellKnownText
Biblioteca