Skip to main content
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 >
O identificador da tabela (:table_name) deve ser o mesmo utilizado no momento da criação via API de Schema.

​
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: Por padrão, o sistema gerará automaticamente um id (UUID v7) nativo para cada linha. Se você já possuir um ID externo e quiser persisti-lo (seja do tipo UUID, TEXT ou INTEGER), basta enviar o campo id no objeto JSON.
  3. Operação de Upsert (Atualização em Conflito): Quando a coluna id é enviada e o valor informado já existe na base de dados, a API realiza automaticamente um Upsert (atualiza as demais colunas com os novos valores enviados), garantindo a idempotência da ingestão.
  4. Estrutura Unificada: Todos os objetos dentro do array do mesmo lote devem possuir as mesmas chaves (colunas).