Todos os produtos
Search
Central de documentação

MaxCompute:MULTIMAP_FROM_ENTRIES

Última atualização: Jun 26, 2026

Retorna um Map composto pelas chaves do array de structs e por arrays que contêm todos os valores correspondentes.

Formato do comando

	multimap_from_entries(array<struct<K, V>>)

Descrição dos parâmetros

array<struct<K, V>>: Array de structs formado por pares chave/valor.

Valor retornado

A função retorna um Map construído a partir das chaves do array de structs e de arrays que agrupam todos os valores associados, no formato map<K, array<V>>.

  • No Map resultante, cada chave pode associar-se a múltiplos valores, armazenados em um único array.

  • Se o array for Null, o retorno será Null.

  • O sistema lançará uma exceção se o número de campos na struct (StructField) for diferente de 2 ou se a chave contiver valor Null.

Exemplos

SELECT multimap_from_entries(array(struct(1, 'a'), 
                                     struct(2, 'b'), 
                                     struct(1, 'c')));

Resultado:

{1 : ['a', 'c'],  2: ['b']}

Funções relacionadas

A função MULTIMAP_FROM_ENTRIES pertence à categoria de funções de tipos complexos. Para obter mais informações sobre funções de processamento de dados de tipos complexos (como ARRAY, MAP, STRUCT e JSON), consulte Funções de tipos complexos.