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ê, com frequência de até a cada 5 minutos ou tão rara quanto 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 | Orientadas por eventos. Seu provedor publica uma notificação quando um novo arquivo chega, e a Braze faz a ingestão desse arquivo. As 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ê consegue configurar qualquer fonte sem precisar consultar vários artigos:
- Os recursos a serem criados no seu data warehouse ou na sua conta de nuvem, incluindo funções, usuários, contas de serviço e acesso à rede.
- Uma seção Configurar a autenticação, que lista os métodos de autenticação compatíveis com a fonte e traz 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, incluindo atributos de usuário, eventos personalizados, eventos de compra, gatilhos do Canvas, exclusões de usuários, itens de catálogo, objetos de dados e relacionamentos entre objetos de dados.
- Otimização de consultas e solução de problemas específicas de cada fonte.
Métodos de autenticação por fonte
Cada fonte oferece uma ou mais formas de autenticação para a Braze. Selecione uma fonte para acessar a seção Configurar a autenticação dela.
| Fonte | Métodos de autenticação |
|---|---|
| Snowflake | Key pair authentication |
| Amazon Redshift | IAM role, 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 todo tipo de dado está disponível para todas as fontes. Use esta tabela para confirmar o que cada fonte aceita antes de começar.
| Tipo de dado | Fontes de data warehouse | Fontes de armazenamento de arquivos |
|---|---|---|
| Atributos do 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 |
| Disparadores de Canvas | Compatível | Compatível |
| Objetos de dados | Compatível | Compatível |
| Relacionamentos entre objetos de dados e usuários | Compatível | Compatível |
| Relacionamentos entre objetos de dados | 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 os mesmos, independentemente da fonte que você usa:
- Configuração da tabela explica as colunas obrigatórias e como a formatação de
PAYLOADcorresponde aos formatos de objeto do/users/track. - Melhores práticas aborda o agendamento de sincronizações, o comportamento de
UPDATED_ATe como minimizar o consumo de pontos de dados. - Registros de sincronização e observabilidade aborda o monitoramento das execuções de sincronização e a exportação de registros.
- Perguntas frequentes responde a dúvidas comuns sobre comportamento de sincronização, erros e segurança.