Transformação Window

A transformação window permite que você execute resumos e cálculos com base em uma janela contínua de dados relativos à linha atual. Por exemplo, você pode calcular a média contínua para uma coluna especificada para o valor da linha atual e as três linhas precedentes. Esta transformação é particularmente útil para processar tempo ou dados sequenciais.

Você pode aplicar uma ou mais funções à etapa de transformação window.

  • Para mais informações sobre as funções window, consulte Funções Window.
  • Você também pode usar as funções de agregação com essa transformação. Consulte Funções Aggregate.

OBSERVAÇÃO: tenha cuidado ao aplicar essa transformação em um grande número de linhas. Em alguns casos, o aplicativo pode ficar sem memória ao gerar resultados, e eles poderão apresentar falhas.

Uso básico

window value: ROLLINGAVERAGE(myValues,3) order: MyDate group: customerId

Resultado: gera uma nova coluna chamada window, que contém o resultado da função ROLLINGAVERAGE aplicada da linha atual na coluna myValues nas linhas 3 em diante, ordenadas pelo MyDate e agrupadas pelo customerId.

Parâmetros

window value: WINDOW_FUNCTION(arg1,arg2) order: order_col [group: group_col]

ParâmetroObrigatório?Transform BuilderTipo de dadosDescrição
valueSFórmulastringExpressão que avalia a chamada da função window e os parâmetros dela
orderSOrganizadas porstringColuna ou nomes de coluna pelos quais ordenar o conjunto de dados antes que a expressão value seja aplicada
groupNAgrupar porstringNome ou nomes de coluna que contêm os valores pelos quais agrupar para o cálculo

Para mais informações sobre os padrões de sintaxe, consulte Notas de sintaxe da documentação da linguagem.

value

Para a transformação window, o parâmetro value contém as chamadas de função que definem o conjunto de linhas às quais a função é aplicada.

Você pode especificar várias funções window para o valor. Cada referência de função precisa ser separada por uma vírgula. A transformação gera uma nova coluna para cada função window.

Esta transformação usa um conjunto especial de funções. Para mais informações sobre as funções disponíveis, consulte Funções Window.

Observações sobre o uso:

Obrigatório?Tipo de dados
SimString (expressão)

order

Para a transformação window, este parâmetro especifica a coluna na qual ordenar o conjunto de dados antes de aplicar a função especificada. Para chaves de classificação de combinação, você pode adicionar várias colunas separadas por vírgulas.

OBSERVAÇÃO: o parâmetro order aplica-se apenas a etapas de transformação que contenham uma função Window ou à transformação sort. Para etapas com uma transformação compatível com um parâmetro order e uma função que não seja Window, o parâmetro order não produz nenhum efeito.

OBSERVAÇÃO: se você estiver aplicando uma função Window, ela requer uma chave primária para identificar as linhas na saída. Caso contrário, os resultados podem ser ambíguos. Para mais informações sobre como definir uma chave primária, consulte Funções Window.

OBSERVAÇÃO: quando presente, o conjunto de dados é agrupado primeiro pelo valor group antes de ser ordenado pelos valores na coluna order.

OBSERVAÇÃO: a coluna order não precisa ser ordenada antes da transformação window ser executado nela.

Dica: para classificar na ordem inversa, adicione um traço no início do nome da coluna (-MyDate).

Observações sobre o uso:

Obrigatório?Tipo de dados
SimString (nome da coluna)

group

Para a transformação window, este parâmetro especifica a coluna cujos valores são usados para agrupar o conjunto de dados antes de aplicar a função especificada. Para o agrupamento de combinações, você pode especificar vários nomes de colunas separados por vírgulas.

OBSERVAÇÃO: tenha cuidado ao aplicar essa transformação em grupos que contenham um grande número de linhas. Em alguns casos, o aplicativo pode ficar sem memória ao gerar resultados, e eles poderão apresentar falhas.

Observações sobre o uso:

Obrigatório?Tipo de dado
NãoString (nome da coluna)

Exemplos

Consulte as funções individuais de exemplo. Consulte Funções Window.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Google Cloud Dataprep
Precisa de ajuda? Acesse nossa página de suporte.