Partilhar via


Função de ER SPLITLIST

A função SPLITLIST divide a lista especificada em sublistas (ou lotes), cada uma das quais contém o número especificado de registos. Em seguida, devolve o resultado como um novo valor Lista de registos que consiste nos lotes.

Sintaxe 1

SPLITLIST (list, number)

Sintaxe 2

SPLITLIST (list, number, on-demand reading flag)

Argumentos

list: Lista de registos

O caminho válido de uma origem de dados do tipo de dados Lista de registos.

number: Número inteiro

O número máximo de registos por lote.

on-demand reading flag: Booleano

Um valor Booleano que especifica se os elementos das sublistas devem ser gerados a pedido.

Valores de retorno

Lista de registos

A lista de registos resultante.

Notas de utilização

A lista de lotes devolvidos contém os seguintes elementos:

  • Valor: Lista

    A lista de registos que pertencem ao lote atual.

  • BatchNumber: Número inteiro

    O número do lote atual na lista devolvida.

Quando o sinalizador de leitura a pedido está definido para Verdadeiro, as sublistas são geradas mediante pedido, o que permite uma redução do consumo de memória, mas pode causar degradação do desempenho se os elementos não forem utilizados sequencialmente.

Exemplo

Na ilustração seguinte, uma origem de dados Linhas é criada como uma lista de registos com três registos. Esta lista é dividida em lotes, cada um dos quais contém até dois registos.

Data source that is divided into batches

A ilustração seguinte mostra o esquema de formato estruturado. Neste esquema de formato, são criados enlaces para a origem de dados Linhas para gerar o resultado no formato XML. Este resultado apresenta nós individuais para cada lote e os respetivos registos.

Format layout that has bindings to a data source

A ilustração seguinte mostra o resultado quando o formato estruturado é executado.

Result of running the format

Recursos adicionais

Funções de lista