action Inserção em massa

Use a action Inserção em massa para ler linhas de um arquivo CSV ou de texto e inseri-las em lotes em uma tabela de banco de dados de destino. Com essa ação, você pode carregar grandes conjuntos de dados de maneira eficiente e capturar a contagem total de linhas inseridas.

Use a action Inserção em massa ao realizar operações de inserção de dados em larga escala, como carregar milhares ou milhões de registros de um arquivo em um banco de dados.

Configurações

  • No campo Nome da sessão, insira o nome da sessão que você usou para se conectar ao servidor de banco de dados na action Conectar. Para mais detalhes, consulte Como usar a action Conectar para banco de dados.
  • Insira o caminho do arquivo de origem no campo Arquivo de origem.
    Nota: Você pode especificar apenas os arquivos .csv e .txt.
  • No campo Nome da tabela, insira a tabela do banco de dados de destino na qual você deseja inserir as linhas.
  • Insira o valor de Delimitador para especificar como as colunas do arquivo de origem são separadas.
    Nota: A vírgula é o valor padrão do delimitador. Outros valores compatíveis incluem vírgula, tabulação, nova linha.
  • Especifique o specificDelimiter. Este é um caractere delimitador personalizado quando Delimitador está definido como Outro. Por exemplo, use |.
  • No campo Número da linha inicial, insira a primeira linha de dados a ser lida do arquivo de origem.
    Nota: O valor padrão é 2 e deve ser igual a 2 ou superior a esse valor, pois o arquivo contém uma linha de cabeçalho.
  • No campo Mapeamento de colunas, clique em Adicionar mapeamento para mapear as colunas do arquivo de origem para as colunas da tabela de destino. Garanta que os nomes das colunas e os tipos de dados correspondam.
    • Especifique o Nome da coluna do arquivo que é o cabeçalho da coluna exatamente como aparece no arquivo de origem para uma entrada de mapeamento.
    • Insira o Nome da coluna da tabela que corresponde ao nome da coluna da tabela de destino para uma entrada de mapeamento.
    Nota:
    • O mapeamento de colunas é opcional.
    • Se o mapeamento de colunas não for adicionado, todas as colunas do arquivo de origem serão mapeadas para todas as colunas da tabela de destino.
    • Certifique-se de que a tabela de destino exista no banco de dados com as colunas necessárias. Além disso, verifique se os nomes das colunas diferenciam maiúsculas de minúsculas para o mapeamento um a um dos campos.

    • Essa action é otimizada para cenários de alta taxa de transferência e oferece benefícios consideráveis de desempenho em comparação com a inserção linha a linha.

    • Para volumes menores de dados, operações de inserção padrão (por exemplo, usando a action Loop) são mais apropriadas e simples de configurar.

  • Especifica quantas linhas inserir por lote no campo Tamanho do lote.
    Nota: O Tamanho do lote padrão é 1.000. Ele deve estar entre 200 e 500.000
  • Insira um valor de tempo limite que especifique o tempo máximo de espera para cada lote. O valor padrão é 1.800. Deve ter entre 1 e 3.600 segundos.
    Nota: Se um lote atingir o tempo limite, a action retorna o número total de linhas inseridas com sucesso. Para retomar o processamento, adicione 1 a esse valor e use esse número como o Número da linha inicial para a próxima execução.

Resultado: Ao usar essa action, você pode inserir registros em lote e ela retorna o número total de registros inseridos como um Número.

No geral, essa action executa a inserção em massa sem exigir um Loop e é executada de maneira síncrona, continuando até que todas as linhas sejam inseridas ou ocorra um erro, oferecendo desempenho consideravelmente melhor do que a inserção linha a linha para grandes conjuntos de dados.