> ## Documentation Index
> Fetch the complete documentation index at: https://docs.analytics.synapside.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ingestão de Dados

O Motor CDP do S.Analytics oferece uma API de alto desempenho para o recebimento de dados, focada na ingestão em massa (Batch Insert). Isso garante que você possa sincronizar grandes volumes de registros de forma rápida e segura.

[Documentação da API >](https://docs.analytics.synapside.com/api-reference/dados/ingest%C3%A3o-em-lote-batch-insert)

<Note>
  O identificador da tabela (`:table_name`) deve ser o mesmo utilizado no momento da criação via API de Schema.
</Note>

## Como funciona

A ingestão ocorre dentro de uma **transação única (rollback total)**. Isso significa que, ao enviar um lote de registros, ou todos são salvos com sucesso, ou nenhum é persistido. Se apenas um dos itens do seu lote contiver um erro (ex: tipo de dado incompatível), a transação inteira será cancelada.

### Regras de Negócio

1. **Limite de Lote:** Você pode enviar até **250 registros** por chamada.
2. **Coluna de ID:** O sistema gerará automaticamente um `id` (**UUID v7**) nativo para cada linha. Se você já possuir um ID externo e quiser persisti-lo, basta enviar o campo `id` no objeto JSON.
3. **Estrutura Unificada:** Todos os objetos dentro do array do mesmo lote devem possuir as mesmas chaves (colunas).