Fontes conectadas
As fontes conectadas são uma alternativa de cópia zero à sincronização direta de dados com o recurso de Ingestão de Dados na Nuvem (CDI) da Braze. Uma fonte conectada consulta diretamente seu data warehouse para criar novos segmentos sem copiar nenhum dos dados subjacentes para a Braze.
Depois de adicionar uma fonte conectada ao seu espaço de trabalho da Braze, você pode criar um Segment CDI dentro das extensões de segmento. As extensões de segmento CDI permitem que você escreva SQL que consulta diretamente seu data warehouse (usando os dados disponibilizados por meio da sua fonte conectada CDI). Assim, você cria e mantém um grupo de usuários que podem ser direcionados dentro da Braze.
Para saber mais sobre como criar um Segment com essa fonte, consulte Extensões de segmento CDI.
Como as fontes conectadas são executadas diretamente no seu data warehouse, você arcará com todos os custos associados à execução dessas consultas no seu data warehouse. As fontes conectadas não registram pontos de dados, e as extensões de segmento CDI não consomem créditos de segmentos SQL.
Fontes compatíveis
As fontes conectadas estão disponíveis apenas para fontes de data warehouse. As fontes de armazenamento de arquivos não são compatíveis com fontes conectadas.
| Fonte | Instruções de configuração |
|---|---|
| Snowflake | Usar o Snowflake como fonte conectada |
| Amazon Redshift | Usar o Redshift como fonte conectada |
| Google BigQuery | Usar o BigQuery como fonte conectada |
| Databricks | Usar o Databricks como fonte conectada |
| Microsoft Fabric | Usar o Microsoft Fabric como fonte conectada |
Configurar uma fonte conectada
A configuração de uma fonte conectada segue as mesmas quatro etapas para todos os data warehouses. As credenciais, as permissões e o SQL variam conforme a fonte, então consulte a página da sua fonte para ver os comandos exatos.
- Configure seu data warehouse. Crie as credenciais que a Braze usará para autenticação e conceda a elas acesso às tabelas que você deseja consultar. A fonte conectada pode referenciar uma ou mais tabelas. Portanto, confira se o seu usuário da Braze tem permissão para acessar todas as tabelas que você quer incluir na fonte conectada.
- Crie a fonte conectada na Braze. Acesse Configurações de dados > Ingestão de dados na nuvem > Fontes conectadas, selecione Adicionar fonte de dados e escolha sua fonte. Insira as credenciais e a configuração dessa fonte.
- Configure os detalhes da fonte. Escolha um nome e um tempo máximo de execução.
- Finalize a configuração do data warehouse e teste. No Snowflake, e no Redshift quando você usa um túnel SSH, adicione a chave pública gerada pela Braze ao seu usuário do data warehouse. Depois, selecione Testar conexão e Concluído.
Você precisa testar uma fonte com sucesso antes que ela passe do estado “rascunho” para “ativo”. Se precisar fechar a página de criação, sua integração ficará salva, e você poderá voltar à página de detalhes para fazer alterações e testar.
Permissões a conceder
Seja qual for a fonte que você usa, as credenciais da Braze precisam de dois tipos de acesso:
- Acesso de leitura às tabelas ou visualizações que você quer disponibilizar nas extensões de segmento de CDI. Você pode conceder acesso a todas as tabelas de um esquema ou conjunto de dados, ou conceder privilégios apenas a tabelas específicas. Todas as tabelas às quais a Braze tiver acesso ficam disponíveis para consulta na extensão de segmento de CDI.
- Acesso para criar tabelas no esquema, para que a Braze possa gravar os resultados da consulta da sua extensão de segmento de CDI em uma tabela antes de atualizar o Segment na Braze. A Braze cria uma tabela temporária por Segment, e essa tabela só existe enquanto a Braze está atualizando o Segment.
Depois que a fonte conectada é criada, a Braze identifica os nomes e as descrições de todas as tabelas disponíveis para as credenciais no esquema da fonte.
Tempo máximo de execução
Configure um tempo máximo de execução para cada fonte conectada. A Braze interrompe automaticamente qualquer consulta que ultrapasse esse limite. O tempo máximo permitido é de 60 minutos, e um tempo menor reduz os custos na conta do seu data warehouse. Essa configuração se aplica às consultas executadas por meio dessa fonte, incluindo sincronizações e extensões de segmento de CDI que a utilizam.
Se as consultas estiverem expirando com frequência e você já tiver definido um tempo máximo de execução de 60 minutos, tente otimizar o tempo de execução da consulta ou dedicar mais recursos de computação (como um data warehouse maior) ao usuário da Braze.
Configurar fontes adicionais (opcional)
Você pode configurar várias fontes conectadas com a Braze, mas cada fonte deve ser configurada para conectar um esquema ou conjunto de dados diferente. Ao criar fontes adicionais, você pode reutilizar credenciais existentes se estiver se conectando à mesma conta do data warehouse.
No Snowflake, se você reutilizar o mesmo usuário e a mesma função em várias integrações, não precisará adicionar a chave pública novamente.
Usando a fonte conectada
Depois de criar a fonte, você pode usá-la para criar uma ou mais extensões de segmento CDI. Para saber mais sobre como criar um segmento com essa fonte, consulte a documentação de extensões de segmento CDI.