Fontes de ingestão de dados na nuvem
Cada fonte de ingestão de dados na nuvem tem sua própria página de configuração, com tudo o que você precisa para essa fonte: os recursos a criar, como conectá-la à Braze, o formato da tabela ou do arquivo de origem para cada tipo de dado e a solução de problemas específica da fonte.
Fontes de data warehouse
Fontes de armazenamento de arquivos
Escolha uma fonte
A ingestão de dados na nuvem se conecta a duas categorias de fonte, e a categoria determina como as sincronizações são disparadas.
| Categoria da fonte | Fontes | Como as sincronizações são executadas |
|---|---|---|
| Data warehouse | Snowflake, Amazon Redshift, Google BigQuery, Databricks, Microsoft Fabric | Em um cronograma definido por você, que pode variar de a cada 5 minutos até uma vez por mês, ou sob demanda pela API. A Braze consulta sua tabela de origem em busca de linhas em que UPDATED_AT seja posterior ao último valor sincronizado. |
| Armazenamento de arquivos | Amazon S3, Google Cloud Storage, Azure Blob Storage | Orientado a eventos. Seu provedor publica uma notificação quando um novo arquivo chega, e a Braze faz a ingestão desse arquivo. Fontes de armazenamento de arquivos não usam UPDATED_AT. |
O que cada página de fonte aborda
Todas as páginas de fonte seguem a mesma estrutura. Assim, você pode configurar qualquer fonte sem precisar ler vários artigos:
- Os recursos a criar no seu data warehouse ou conta de nuvem, incluindo funções, usuários, contas de serviço e acesso à rede.
- Uma seção Configurar autenticação que lista os métodos de autenticação compatíveis com a fonte, com as etapas de configuração de cada método.
- Como criar a fonte e a sincronização no dashboard da Braze.
- Uma guia para cada tipo de dado que você pode sincronizar a partir dessa fonte, abrangendo atributos de usuário, eventos personalizados, eventos de compra, itens de catálogo, disparos de Canvas e exclusões de usuários.
- Otimização de consultas e solução de problemas específicas da fonte.
Métodos de autenticação por fonte
Cada fonte aceita uma ou mais formas de a Braze se autenticar. Selecione uma fonte para acessar a seção Configurar autenticação dela.
| Fonte | Métodos de autenticação |
|---|---|
| Snowflake | Key pair authentication |
| Amazon Redshift | Username and password |
| Google BigQuery | Workload Identity Federation, Service account key |
| Databricks | OAuth M2M (recomendado), Personal access token |
| Microsoft Fabric | Service principal |
| Amazon S3 | IAM role |
| Google Cloud Storage | Workload Identity Federation, Service account key |
| Azure Blob Storage | Service principal |
Tipos de dados por fonte
Nem todos os tipos de dados estão disponíveis para todas as fontes. Use esta tabela para confirmar o que uma fonte aceita antes de começar.
| Tipo de dado | Fontes de data warehouse | Fontes de armazenamento de arquivos |
|---|---|---|
| Atributos de usuário | Compatível | Compatível |
| Eventos personalizados | Compatível | Compatível |
| Eventos de compra | Compatível | Compatível |
| Itens de catálogo | Compatível | Compatível |
| Exclusões de usuários | Compatível | Compatível |
| Disparos de Canvas | Compatível | Compatível |
| Fontes conectadas | Compatível | Não compatível |
Referência compartilhada
Alguns comportamentos da ingestão de dados na nuvem são iguais, independentemente da fonte que você usa:
- Configuração de tabelas explica as colunas obrigatórias e como a formatação de
PAYLOADcorresponde aos formatos de objeto de/users/track. - Práticas recomendadas aborda o agendamento de sincronizações, o comportamento de
UPDATED_ATe como minimizar o consumo de pontos de dados. - Logs de sincronização e observabilidade aborda o monitoramento das execuções de sincronização e a exportação de logs.
- Perguntas frequentes responde a dúvidas comuns sobre comportamento de sincronização, erros e segurança.