Função ARRAYCONCAT

Combina os elementos de uma matriz com outra, listando todos os elementos da primeira matriz antes de listar todos os da segunda matriz.
  • As matrizes são mencionadas pelo nome da coluna ou como literais de matriz.
  • Esta função aplica duas ou mais colunas apenas do tipo "Matriz". Para concatenar valores de string, consulte Transformação Merge.
  • Os valores duplicados não são removidos da matriz gerada.

Uso básico

Exemplo de referência de literal de matriz:

derive type:single value:ARRAYCONCAT([["A","B","C"],["C","D","E"]])

Resultado: gera uma nova coluna com a seguinte matriz:

["A","B","C","C","D","E"]

Exemplo de referência da coluna:

derive type:single value:ARRAYCONCAT([array1,array2]) as:'concat_Arrays'

Resultado: gera uma nova coluna concat_Arrays contendo uma matriz única que lista todos os elementos em array1 e array2 na ordem.

Sintaxe

derive type:single value:ARRAYCONCAT(array_ref1,array_ref2)

ArgumentoObrigatório?Tipo de dadosDescrição
array_ref1Sstring ou matrizNome da primeira coluna ou literal da primeira matriz para aplicar à função
array_ref2Sstring ou matrizNome da segunda coluna ou literal da segunda matriz para aplicar à função

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

array_ref1, array_ref2

Literal ou nome da matriz da coluna com elementos que você quer concatenar. É possível concatenar duas ou mais matrizes.

Observações sobre o uso:

Obrigatório?Tipo de dadosValor de exemplo
SimLiteral da matriz ou referência de colunamyArray1, myArray2

Exemplos

Exemplo de concatenação simples

Este exemplo simples ilustra como as seguintes funções operam em dados aninhados.

Fonte:

A formatação do código foi aplicada para melhorar a legibilidade.

ItemArrayAArrayB
Item1["A","B","C"]["1","2","3"]
Item2["A","B"]["A","B","C"]
Item3["D","E","F"]["4","5","6"]

Transformação:

Você pode aplicar as seguintes transformações na ordem abaixo. Os nomes das colunas precisam ser diferentes do nome da transformação, que é uma palavra reservada.

derive type:single value:ARRAYCONCAT([Letters,Numerals]) as:'concat2'

derive type:single value:ARRAYINTERSECT([Letters,Numerals]) as:'intersection2'

derive type:single value:ARRAYCROSS([Letters,Numerals]) as:'cross2'

derive type:single value:ARRAYUNIQUE([Letters,Numerals]) as:'unique2'

Resultados:

Para fins de exibição, a tabela de resultados foi dividida em três conjuntos separados de colunas.

Grupo de colunas 1:

ItemArrayAArrayBconcat2intersection2
Item1

["A","B","C"]

["1","2","3"]["A","B","C","1","2","3"][ ]
Item2["A","B"]["A","B","C"]["A","B","A","B","C"]["A","B"]
Item3["D","E","F"]["4","5","6"]["D","E","F","4","5","6"][ ]

Grupo de colunas 2:

Itemcross2
Item1[["A","1"],["A","2"],["A","3"],["B","1"],["B","2"],["B","3"],["C","1"],["C","2"],["C","3"]]
Item2[["A","A"],["A","B"],["A","C"],["B","A"],["B","B"],["B","C"]]
Item3[["D","4"],["D","5"],["D","6"],["E","4"],["E","5"],["E","6"], ["F","4"],["F","5"],["F","6"]]

Grupo de colunas 3:

Itemunique2
Item1["A","B","C","1","2","3"]
Item2["A","B","C"]
Item3["D","E","F","4","5","6"]

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.