Integrações de armazenamento de data warehouse
Esta página aborda como usar a Ingestão de Dados na Nuvem (CDI) da Braze para sincronizar dados relevantes com sua integração do Snowflake, Redshift, BigQuery e Databricks.
Configurando integrações com data warehouse
As integrações de ingestão de dados na nuvem exigem alguma configuração do lado da Braze e na instância do seu data warehouse. Siga estas etapas para configurar a integração:
- Na sua instância do Snowflake, configure as tabelas ou views que deseja sincronizar com a Braze.
- Crie uma nova fonte Snowflake no dashboard da Braze.
- Obtenha a chave pública fornecida no dashboard da Braze e adicione-a ao usuário do Snowflake para autenticação.
- Crie uma sincronização no dashboard da Braze, teste a integração e inicie a sincronização.

O guia de início rápido do Snowflake fornece código de exemplo e orienta as etapas necessárias para criar um pipeline automatizado usando Snowflake Streams e CDI para sincronizar dados com a Braze.
- Certifique-se de que o acesso da Braze é permitido nas tabelas do Redshift que deseja sincronizar. A Braze se conecta ao Redshift pela internet.
- Na sua instância do Redshift, configure as tabelas ou views que deseja sincronizar com a Braze.
- Crie uma nova fonte e sincronização no dashboard da Braze.
- Teste a integração e inicie a sincronização.

As linhas processadas por sincronização dependem do desempenho do seu data warehouse, latência de rede e quantidade de dados novos que correspondem à consulta de sincronização. Use o Histórico de sincronização da integração no dashboard para ver a duração e a contagem de linhas das execuções recentes.
- Crie uma conta de serviço e permita o acesso ao(s) projeto(s) e dataset(s) do BigQuery que contêm os dados que deseja sincronizar.
- Na sua conta do BigQuery, configure as tabelas ou views que deseja sincronizar com a Braze.
- Crie uma nova fonte e sincronização no dashboard da Braze.
- Teste a integração e inicie a sincronização.
- Crie uma conta de serviço e permita o acesso ao(s) projeto(s) e dataset(s) do Databricks que contêm os dados que deseja sincronizar.
- Na sua conta do Databricks, configure as tabelas ou views que deseja sincronizar com a Braze.
- Crie uma nova fonte e sincronização no dashboard da Braze.
- Teste a integração e inicie a sincronização.

Pode haver de dois a cinco minutos de tempo de aquecimento quando a Braze se conecta a instâncias SQL Classic e Pro, o que pode causar atrasos durante a configuração e teste da conexão, bem como no início de sincronizações agendadas. Usar uma instância SQL serverless minimiza o tempo de aquecimento e melhora a taxa de consultas, mas pode resultar em custos de integração ligeiramente mais altos.
- Crie um service principal e conceda acesso às APIs do Fabric.
- Configure um espaço de trabalho compartilhado e conceda ao service principal acesso a ele.
- No espaço de trabalho compartilhado do Fabric, configure as tabelas ou views que deseja sincronizar com a Braze.
- Crie uma nova fonte e sincronização no dashboard da Braze.
- Teste a integração e inicie a sincronização.
Etapa 1: Configurar tabelas ou views
Antes de começar, revise Configuração de tabelas para ingestão de dados na nuvem para entender os requisitos da tabela de origem em comparação com os requisitos de formatação do PAYLOAD.

Sua tabela ou view de origem pode incluir colunas que não estão listadas para o seu data warehouse nas guias da seção a seguir (por exemplo, auditoria ou hashing). A Braze lê apenas as colunas descritas nessas guias; outras colunas não são usadas durante as sincronizações de ingestão de dados na nuvem.
Etapa 1.1: Configurar a tabela
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
--at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required
EXTERNAL_ID VARCHAR(16777216),
--if using user alias, both alias_name and alias_label are required
ALIAS_LABEL VARCHAR(16777216),
ALIAS_NAME VARCHAR(16777216),
--braze_id can only be used to update existing users created through the Braze SDK
BRAZE_ID VARCHAR(16777216),
--If you include both email and phone, email is used as the primary identifier
EMAIL VARCHAR(16777216),
PHONE VARCHAR(16777216),
PAYLOAD VARCHAR(16777216) NOT NULL
);
Você pode nomear o banco de dados, schema e tabela como quiser, mas os nomes das colunas devem corresponder à definição anterior.
UPDATED_AT- O momento em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. Linhas no exato timestamp de limite podem ser ressincronizadas se novas linhas compartilharem o mesmo timestamp.- Colunas de identificação do usuário - Sua tabela pode conter uma ou mais colunas de identificação do usuário. Cada linha deve conter apenas um identificador (
external_id, a combinação dealias_nameealias_label,braze_id,emailouphone). Uma tabela de origem pode ter colunas para um, dois, três, quatro ou todos os cinco tipos de identificadores.EXTERNAL_ID- Identifica o usuário que deseja atualizar. Deve corresponder ao valorexternal_idusado na Braze.ALIAS_NAMEeALIAS_LABEL- Essas duas colunas criam um objeto de alias de usuário.alias_namedeve ser um identificador único, ealias_labelespecifica o tipo de alias. Os usuários podem ter múltiplos aliases com rótulos diferentes, mas apenas umalias_nameporalias_label.BRAZE_ID- O identificador de usuário da Braze. É gerado pelo SDK da Braze, e novos usuários não podem ser criados usando um Braze ID por meio da ingestão de dados na nuvem. Para criar novos usuários, especifique um ID externo de usuário ou alias de usuário.EMAIL- O endereço de e-mail do usuário. Se existirem múltiplos perfis com o mesmo endereço de e-mail, o perfil atualizado mais recentemente é priorizado para atualizações. Se você incluir tanto e-mail quanto telefone, o e-mail é usado como identificador principal.PHONE- O número de telefone do usuário. Se existirem múltiplos perfis com o mesmo número de telefone, o perfil atualizado mais recentemente é priorizado para atualizações.
PAYLOAD- Esta é uma string JSON dos campos que deseja sincronizar com o usuário na Braze.
Etapa 1.2: Configurar o role e as permissões do banco de dados
1
2
3
4
5
CREATE ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;
Atualize os nomes conforme necessário, mas as permissões devem corresponder ao exemplo anterior.
Etapa 1.3: Configurar o warehouse e conceder acesso ao role da Braze
1
2
3
CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;
GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

O warehouse precisa ter o flag auto-resume ativado. Caso contrário, conceda à Braze privilégios adicionais de OPERATE no warehouse para que a Braze possa ativá-lo quando a consulta for executada.
Etapa 1.4: Configurar o usuário
1
2
3
CREATE USER BRAZE_INGESTION_USER;
GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;
Após esta etapa, compartilhe as informações de conexão com a Braze para receber uma chave pública para adicionar ao usuário.

Ao conectar diferentes espaços de trabalho à mesma conta do Snowflake, você deve criar um usuário único para cada espaço de trabalho da Braze em que está criando uma integração. Dentro de um espaço de trabalho, você pode reutilizar o mesmo usuário entre integrações, mas a criação da integração falhará se um usuário na mesma conta do Snowflake estiver duplicado em espaços de trabalho diferentes.
Etapa 1.5: Permitir IPs da Braze na política de rede do Snowflake (opcional)
Dependendo da configuração da sua conta do Snowflake, pode ser necessário permitir os seguintes endereços IP na sua política de rede do Snowflake. Para saber mais sobre como ativar isso, consulte a documentação relevante do Snowflake sobre modificar uma política de rede.
Para as instâncias US-01, US-02, US-03, US-04, US-05, US-06, US-07, estes são os endereços IP relevantes:
23.21.118.19134.206.23.17350.16.249.952.4.160.21454.87.8.3454.156.35.25152.54.89.23818.205.178.15
Para a instância US-08, estes são os endereços IP relevantes:
52.151.246.5152.170.163.18240.76.166.15740.76.166.17040.76.166.16740.76.166.16140.76.166.15640.76.166.16640.76.166.16040.88.51.7452.154.67.1740.76.166.8040.76.166.8440.76.166.8540.76.166.8140.76.166.7140.76.166.14440.76.166.145
Para a instância US-10, estes são os endereços IP relevantes:
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
Para as instâncias EU-01 e EU-02, estes são os endereços IP relevantes:
52.58.142.24252.29.193.12135.158.29.22818.157.135.973.123.166.463.64.27.363.65.88.253.68.144.1883.70.107.88
Para a instância AU-01, estes são os endereços IP relevantes:
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
Para a instância ID-01, estes são os endereços IP relevantes:
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
Para a instância JP-01, estes são os endereços IP relevantes:
13.159.155.21254.199.221.24113.192.23.1654.250.120.13918.181.114.2323.114.38.100
Para a instância KR-01, estes são os endereços IP relevantes:
43.200.215.452.79.67.17552.79.113.603.34.212.9254.116.134.2313.37.197.225
Etapa 1.1: Configurar a tabela
Opcionalmente, configure um novo banco de dados e schema para conter sua tabela de origem
1
2
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
Crie uma tabela (ou view) para usar na sua integração CDI
1
2
3
4
5
6
7
8
9
10
11
12
13
14
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
updated_at timestamptz default sysdate,
--at least one of external_id, alias_name and alias_label, or braze_id is required
external_id varchar,
--if using user alias, both alias_name and alias_label are required
alias_label varchar,
alias_name varchar,
--braze_id can only be used to update existing users created through the Braze SDK
braze_id varchar,
--If you include both email and phone, email is used as the primary identifier
email varchar,
phone varchar,
payload varchar(max)
)
Você pode nomear o banco de dados, schema e tabela como quiser, mas os nomes das colunas devem corresponder à definição anterior.
UPDATED_AT- O momento em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. Linhas no exato timestamp de limite podem ser ressincronizadas se novas linhas compartilharem o mesmo timestamp.- Colunas de identificação do usuário - Sua tabela pode conter uma ou mais colunas de identificação do usuário. Cada linha deve conter apenas um identificador (
external_id, a combinação dealias_nameealias_label,braze_id,emailouphone). Uma tabela de origem pode ter colunas para um, dois, três, quatro ou todos os cinco tipos de identificadores.EXTERNAL_ID- Identifica o usuário que deseja atualizar. Deve corresponder ao valorexternal_idusado na Braze.ALIAS_NAMEeALIAS_LABEL- Essas duas colunas criam um objeto de alias de usuário.alias_namedeve ser um identificador único, ealias_labelespecifica o tipo de alias. Os usuários podem ter múltiplos aliases com rótulos diferentes, mas apenas umalias_nameporalias_label.BRAZE_ID- O identificador de usuário da Braze. É gerado pelo SDK da Braze, e novos usuários não podem ser criados usando um Braze ID por meio da ingestão de dados na nuvem. Para criar novos usuários, especifique um ID externo de usuário ou alias de usuário.EMAIL- O endereço de e-mail do usuário. Se existirem múltiplos perfis com o mesmo endereço de e-mail, o perfil atualizado mais recentemente é priorizado para atualizações. Se você incluir tanto e-mail quanto telefone, o e-mail é usado como identificador principal.PHONE- O número de telefone do usuário. Se existirem múltiplos perfis com o mesmo número de telefone, o perfil atualizado mais recentemente é priorizado para atualizações.
PAYLOAD- Esta é uma string JSON dos campos que deseja sincronizar com o usuário na Braze.
Etapa 1.2: Criar o usuário e conceder permissões
1
2
3
CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;
Essas são as permissões mínimas exigidas para esse usuário. Se estiver criando múltiplas integrações CDI, pode ser útil conceder permissões a um schema ou gerenciar permissões usando um grupo.
Etapa 1.3: Permitir acesso aos IPs da Braze
Se você tiver um firewall ou outras políticas de rede, é necessário conceder à Braze acesso de rede à sua instância do Redshift. Um exemplo de endpoint de URL do Redshift é “example-cluster.ap-northeast-2.redshift.amazonaws.com”.
Algumas coisas importantes:
- Pode ser necessário alterar seus grupos de segurança para permitir que a Braze acesse seus dados no Redshift.
- Certifique-se de permitir explicitamente o tráfego de entrada nos IPs da tabela e na porta usada para consultar seu cluster do Redshift (o padrão é 5439). Você deve permitir explicitamente a conectividade TCP do Redshift nesta porta, mesmo que as regras de entrada estejam definidas como “permitir tudo”.
- O endpoint do cluster do Redshift deve ser acessível publicamente para que a Braze se conecte ao seu cluster.
- Se não quiser que seu cluster do Redshift seja acessível publicamente, você pode configurar uma VPC e uma instância EC2 para usar um túnel SSH para acessar os dados do Redshift. Para saber mais, consulte a publicação do AWS Knowledge Center.
Permita o acesso dos seguintes IPs correspondentes à região do seu dashboard da Braze.
Para as instâncias US-01, US-02, US-03, US-04, US-05, US-06, US-07, estes são os endereços IP relevantes:
23.21.118.19134.206.23.17350.16.249.952.4.160.21454.87.8.3454.156.35.25152.54.89.23818.205.178.15
Para a instância US-08, estes são os endereços IP relevantes:
52.151.246.5152.170.163.18240.76.166.15740.76.166.17040.76.166.16740.76.166.16140.76.166.15640.76.166.16640.76.166.16040.88.51.7452.154.67.1740.76.166.8040.76.166.8440.76.166.8540.76.166.8140.76.166.7140.76.166.14440.76.166.145
Para a instância US-10, estes são os endereços IP relevantes:
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
Para as instâncias EU-01 e EU-02, estes são os endereços IP relevantes:
52.58.142.24252.29.193.12135.158.29.22818.157.135.973.123.166.463.64.27.363.65.88.253.68.144.1883.70.107.88
Para a instância AU-01, estes são os endereços IP relevantes:
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
Para a instância ID-01, estes são os endereços IP relevantes:
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
Para a instância JP-01, estes são os endereços IP relevantes:
13.159.155.21254.199.221.24113.192.23.1654.250.120.13918.181.114.2323.114.38.100
Para a instância KR-01, estes são os endereços IP relevantes:
43.200.215.452.79.67.17552.79.113.603.34.212.9254.116.134.2313.37.197.225
Etapa 1.1: Configurar a tabela
Opcionalmente, configure um novo projeto ou dataset para conter sua tabela de origem.
1
CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;
Crie uma ou mais tabelas para usar na sua integração CDI com os seguintes campos:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC`
(
updated_at TIMESTAMP DEFAULT current_timestamp,
--At least one of external_id, alias_name and alias_label, or braze_id is required
external_id STRING,
--If using user alias, both alias_name and alias_label are required
alias_name STRING,
alias_label STRING,
--braze_id can only be used to update existing users created through the Braze SDK
braze_id STRING,
--If you include both email and phone, email is used as the primary identifier
email STRING,
phone STRING,
payload JSON
);
| Nome do campo | Tipo | Modo |
|---|---|---|
UPDATED_AT |
TIMESTAMP | REQUIRED |
PAYLOAD |
JSON | REQUIRED |
EXTERNAL_ID |
STRING | NULLABLE |
ALIAS_NAME |
STRING | NULLABLE |
ALIAS_LABEL |
STRING | NULLABLE |
BRAZE_ID |
STRING | NULLABLE |
EMAIL |
STRING | NULLABLE |
PHONE |
STRING | NULLABLE |
Você pode nomear o projeto, dataset e tabela como quiser, mas os nomes das colunas devem corresponder à definição anterior.
UPDATED_AT- O momento em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. Linhas no exato timestamp de limite podem ser ressincronizadas se novas linhas compartilharem o mesmo timestamp.- Colunas de identificação do usuário - Sua tabela pode conter uma ou mais colunas de identificação do usuário. Cada linha deve conter apenas um identificador (
external_id, a combinação dealias_nameealias_label,braze_id,emailouphone). Uma tabela de origem pode ter colunas para um, dois, três, quatro ou todos os cinco tipos de identificadores.EXTERNAL_ID- Identifica o usuário que deseja atualizar. Deve corresponder ao valorexternal_idusado na Braze.ALIAS_NAMEeALIAS_LABEL- Essas duas colunas criam um objeto de alias de usuário.alias_namedeve ser um identificador único, ealias_labelespecifica o tipo de alias. Os usuários podem ter múltiplos aliases com rótulos diferentes, mas apenas umalias_nameporalias_label.BRAZE_ID- O identificador de usuário da Braze. É gerado pelo SDK da Braze, e novos usuários não podem ser criados usando um Braze ID por meio da ingestão de dados na nuvem. Para criar novos usuários, especifique um ID externo de usuário ou alias de usuário.EMAIL- O endereço de e-mail do usuário. Se existirem múltiplos perfis com o mesmo endereço de e-mail, o perfil atualizado mais recentemente é priorizado para atualizações. Se você incluir tanto e-mail quanto telefone, o e-mail é usado como identificador principal.PHONE- O número de telefone do usuário. Se existirem múltiplos perfis com o mesmo número de telefone, o perfil atualizado mais recentemente é priorizado para atualizações.
PAYLOAD- Esta é uma string JSON dos campos que deseja sincronizar com o usuário na Braze.

Particionamento do BigQuery
O CDI suporta partições para o BigQuery. Se você particionar por uma função de UPDATED_AT (por exemplo, na granularidade de um dia, semana ou hora, dependendo do tamanho do seu dataset), o BigQuery pode reduzir os dados que precisa varrer. Isso melhora o desempenho e a eficiência para tabelas muito grandes.
Não particione por outros campos. Teste diferentes configurações para encontrar a melhor opção para seus dados específicos.
Todas as consultas CDI filtram por UPDATED_AT, mas esse comportamento pode mudar. Projete o schema da sua tabela para não exigir que as consultas incluam essa cláusula.
Para saber mais, consulte a documentação de particionamento do BigQuery.
Etapa 1.2: Criar uma conta de serviço e conceder permissões
Crie uma conta de serviço no GCP para que a Braze use para conectar e ler dados da(s) sua(s) tabela(s). A conta de serviço deve ter as seguintes permissões:
- BigQuery Connection User: Permite que a Braze faça conexões
- BigQuery User: Fornece à Braze acesso para executar consultas, ler metadados de datasets e listar tabelas.
- BigQuery Data Viewer: Fornece à Braze acesso para visualizar datasets e seu conteúdo.
- BigQuery Job User: Fornece à Braze acesso para executar jobs
Após criar a conta de serviço e conceder permissões, gere uma chave JSON. Para saber mais, consulte Criar e excluir chaves de conta de serviço. Faça o upload dessa chave no dashboard da Braze em uma etapa posterior.
Etapa 1.3: Permitir acesso aos IPs da Braze
Se você tiver políticas de rede ativas, é necessário conceder à Braze acesso de rede à sua instância do BigQuery. Permita o acesso dos seguintes IPs correspondentes à região do seu dashboard da Braze.
Para as instâncias US-01, US-02, US-03, US-04, US-05, US-06, US-07, estes são os endereços IP relevantes:
23.21.118.19134.206.23.17350.16.249.952.4.160.21454.87.8.3454.156.35.25152.54.89.23818.205.178.15
Para a instância US-08, estes são os endereços IP relevantes:
52.151.246.5152.170.163.18240.76.166.15740.76.166.17040.76.166.16740.76.166.16140.76.166.15640.76.166.16640.76.166.16040.88.51.7452.154.67.1740.76.166.8040.76.166.8440.76.166.8540.76.166.8140.76.166.7140.76.166.14440.76.166.145
Para a instância US-10, estes são os endereços IP relevantes:
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
Para as instâncias EU-01 e EU-02, estes são os endereços IP relevantes:
52.58.142.24252.29.193.12135.158.29.22818.157.135.973.123.166.463.64.27.363.65.88.253.68.144.1883.70.107.88
Para a instância AU-01, estes são os endereços IP relevantes:
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
Para a instância ID-01, estes são os endereços IP relevantes:
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
Para a instância JP-01, estes são os endereços IP relevantes:
13.159.155.21254.199.221.24113.192.23.1654.250.120.13918.181.114.2323.114.38.100
Para a instância KR-01, estes são os endereços IP relevantes:
43.200.215.452.79.67.17552.79.113.603.34.212.9254.116.134.2313.37.197.225
Etapa 1.1: Configurar a tabela
Opcionalmente, configure um novo catálogo ou schema para conter sua tabela de origem.
1
CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;
Crie uma ou mais tabelas para usar na sua integração CDI com os seguintes campos:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC`
(
updated_at TIMESTAMP DEFAULT current_timestamp(),
--At least one of external_id, alias_name and alias_label, or braze_id is required
external_id STRING,
--If using user alias, both alias_name and alias_label are required
alias_name STRING,
alias_label STRING,
--braze_id can only be used to update existing users created through the Braze SDK
braze_id STRING,
--If you include both email and phone, email is used as the primary identifier
email STRING,
phone STRING,
payload STRING, STRUCT, or MAP
);
| Nome do campo | Tipo | Modo |
|---|---|---|
UPDATED_AT |
TIMESTAMP | REQUIRED |
PAYLOAD |
STRING, STRUCT, or MAP | REQUIRED |
EXTERNAL_ID |
STRING | NULLABLE |
ALIAS_NAME |
STRING | NULLABLE |
ALIAS_LABEL |
STRING | NULLABLE |
BRAZE_ID |
STRING | NULLABLE |
EMAIL |
STRING | NULLABLE |
PHONE |
STRING | NULLABLE |
Você pode nomear o schema e a tabela como quiser, mas os nomes das colunas devem corresponder à definição anterior.
UPDATED_AT- O momento em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. Linhas no exato timestamp de limite podem ser ressincronizadas se novas linhas compartilharem o mesmo timestamp.- Colunas de identificação do usuário - Sua tabela pode conter uma ou mais colunas de identificação do usuário. Cada linha deve conter apenas um identificador (
external_id, a combinação dealias_nameealias_label,braze_id,emailouphone). Uma tabela de origem pode ter colunas para um, dois, três, quatro ou todos os cinco tipos de identificadores.EXTERNAL_ID- Identifica o usuário que deseja atualizar. Deve corresponder ao valorexternal_idusado na Braze.ALIAS_NAMEeALIAS_LABEL- Essas duas colunas criam um objeto de alias de usuário.alias_namedeve ser um identificador único, ealias_labelespecifica o tipo de alias. Os usuários podem ter múltiplos aliases com rótulos diferentes, mas apenas umalias_nameporalias_label.BRAZE_ID- O identificador de usuário da Braze. É gerado pelo SDK da Braze, e novos usuários não podem ser criados usando um Braze ID por meio da ingestão de dados na nuvem. Para criar novos usuários, especifique um ID externo de usuário ou alias de usuário.EMAIL- O endereço de e-mail do usuário. Se existirem múltiplos perfis com o mesmo endereço de e-mail, o perfil atualizado mais recentemente é priorizado para atualizações. Se você incluir tanto e-mail quanto telefone, o e-mail é usado como identificador principal.PHONE- O número de telefone do usuário. Se existirem múltiplos perfis com o mesmo número de telefone, o perfil atualizado mais recentemente é priorizado para atualizações.
PAYLOAD- Esta é uma string ou struct dos campos que deseja sincronizar com o usuário na Braze.
Etapa 1.2: Criar um token de acesso
Para que a Braze acesse o Databricks, é necessário criar um token de acesso pessoal.
- No seu espaço de trabalho do Databricks, selecione seu nome de usuário do Databricks na barra superior e, em seguida, selecione User Settings no menu suspenso.
- Na guia Access tokens, selecione Generate new token.
- Insira um comentário que ajude a identificar este token, como “Braze CDI”, e altere o tempo de vida do token para sem prazo de validade, deixando o campo Lifetime (days) vazio (em branco).
- Selecione Generate.
- Copie o token exibido e, em seguida, selecione Done.
Mantenha o token em um local seguro até que precise inseri-lo no dashboard da Braze durante a etapa de criação de credenciais.
Etapa 1.3: Permitir acesso aos IPs da Braze
Se você tiver políticas de rede ativas, é necessário conceder à Braze acesso de rede à sua instância do Databricks. Permita o acesso dos seguintes IPs correspondentes à região do seu dashboard da Braze.
Para as instâncias US-01, US-02, US-03, US-04, US-05, US-06, US-07, estes são os endereços IP relevantes:
23.21.118.19134.206.23.17350.16.249.952.4.160.21454.87.8.3454.156.35.25152.54.89.23818.205.178.15
Para a instância US-08, estes são os endereços IP relevantes:
52.151.246.5152.170.163.18240.76.166.15740.76.166.17040.76.166.16740.76.166.16140.76.166.15640.76.166.16640.76.166.16040.88.51.7452.154.67.1740.76.166.8040.76.166.8440.76.166.8540.76.166.8140.76.166.7140.76.166.14440.76.166.145
Para a instância US-10, estes são os endereços IP relevantes:
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
Para as instâncias EU-01 e EU-02, estes são os endereços IP relevantes:
52.58.142.24252.29.193.12135.158.29.22818.157.135.973.123.166.463.64.27.363.65.88.253.68.144.1883.70.107.88
Para a instância AU-01, estes são os endereços IP relevantes:
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
Para a instância ID-01, estes são os endereços IP relevantes:
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
Para a instância JP-01, estes são os endereços IP relevantes:
13.159.155.21254.199.221.24113.192.23.1654.250.120.13918.181.114.2323.114.38.100
Para a instância KR-01, estes são os endereços IP relevantes:
43.200.215.452.79.67.17552.79.113.603.34.212.9254.116.134.2313.37.197.225
Etapa 1.1: Configurar o service principal e conceder acesso
A Braze se conecta ao seu Fabric warehouse usando um service principal com autenticação Entra ID. Crie um novo service principal para a Braze usar e conceda acesso aos recursos do Fabric conforme necessário. A Braze precisa dos seguintes detalhes para se conectar:
- ID do locatário (também chamado de diretório) da sua conta Azure
- ID da entidade de segurança (também chamado de ID do aplicativo) para a entidade de serviço
- Segredo do cliente para a Braze autenticar
- No portal do Azure, navegue até o centro de administração do Microsoft Entra e, em seguida, App Registrations.
- Selecione + New registration em Identity > Applications > App registrations
- Insira um nome e selecione
Accounts in this organizational directory onlycomo o tipo de conta compatível. Em seguida, selecione Register. - Selecione o app (service principal) que você acabou de criar e navegue até Certificates & secrets > + New client secret
- Insira uma descrição para o segredo e defina um período de vencimento para o segredo. Em seguida, selecione Add.
- Anote o segredo do cliente criado para usar na configuração da Braze.

O Azure não permite expiração ilimitada em secrets de service principal. Lembre-se de atualizar as credenciais antes que expirem para manter o fluxo de dados para a Braze.
Etapa 1.2: Conceder acesso aos recursos do Fabric
Forneça acesso para a Braze se conectar à sua instância do Fabric. No portal de administração do Fabric, navegue até Settings > Governance and insights > Admin portal > Tenant settings.
- Em Developer settings, ative Service principals can use Fabric APIs para que a Braze possa se conectar usando o Microsoft Entra ID.
- Em OneLake settings, ative Users can access data stored in OneLake with apps external to Fabric para que o service principal possa acessar dados de um app externo.
Etapa 1.3: Configurar um espaço de trabalho compartilhado e conceder acesso
Quaisquer recursos do Fabric que deseje conectar à Braze devem ser colocados em um espaço de trabalho compartilhado. Se você só usou o My Workspace padrão, crie um novo espaço de trabalho compartilhado:
- No menu de navegação, selecione Workspaces e, em seguida, selecione + New workspace.
- Insira um Name para o espaço de trabalho e selecione Apply.
Após ter um espaço de trabalho compartilhado, conceda ao service principal acesso:
- Selecione o espaço de trabalho e, em seguida, selecione Manage Access.
- Selecione + Add people or groups.
- Pesquise e selecione o nome do service principal que você criou na etapa 1.1. Se ele não aparecer, confirme que você ativou a configuração Service principals can use Fabric APIs na etapa 1.2.
- No menu suspenso de role, selecione Contributor.
O service principal agora pode acessar os recursos do Fabric warehouse neste espaço de trabalho por meio de seus endpoints SQL, incluindo o warehouse a ser usado para a Braze.
Etapa 1.4: Configurar a tabela
A Braze suporta tanto tabelas quanto views em Fabric Warehouses. Se precisar criar um novo warehouse, crie-o no espaço de trabalho compartilhado da etapa 1.3. Acesse Create > Data Warehouse > Warehouse no console do Fabric.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
UPDATED_AT DATETIME2(6) NOT NULL,
PAYLOAD VARCHAR NOT NULL,
--at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required
EXTERNAL_ID VARCHAR,
--if using user alias, both alias_name and alias_label are required
ALIAS_NAME VARCHAR,
ALIAS_LABEL VARCHAR,
--braze_id can only be used to update existing users created through the Braze SDK
BRAZE_ID VARCHAR,
--If you include both email and phone, email is used as the primary identifier
EMAIL VARCHAR,
PHONE VARCHAR
)
GO
Você pode nomear o warehouse, schema e tabela ou view como quiser, mas os nomes das colunas devem corresponder à definição anterior.
UPDATED_AT- O momento em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. Linhas no exato timestamp de limite podem ser ressincronizadas se novas linhas compartilharem o mesmo timestamp.- Colunas de identificação do usuário - Sua tabela pode conter uma ou mais colunas de identificação do usuário. Cada linha deve conter apenas um identificador (
external_id, a combinação dealias_nameealias_label,braze_id,emailouphone). Uma tabela de origem pode ter colunas para um, dois, três, quatro ou todos os cinco tipos de identificadores.EXTERNAL_ID- Identifica o usuário que deseja atualizar. Deve corresponder ao valorexternal_idusado na Braze.ALIAS_NAMEeALIAS_LABEL- Essas duas colunas criam um objeto de alias de usuário.alias_namedeve ser um identificador único, ealias_labelespecifica o tipo de alias. Os usuários podem ter múltiplos aliases com rótulos diferentes, mas apenas umalias_nameporalias_label.BRAZE_ID- O identificador de usuário da Braze. É gerado pelo SDK da Braze, e novos usuários não podem ser criados usando um Braze ID por meio da ingestão de dados na nuvem. Para criar novos usuários, especifique um ID externo de usuário ou alias de usuário.EMAIL- O endereço de e-mail do usuário. Se existirem múltiplos perfis com o mesmo endereço de e-mail, o perfil atualizado mais recentemente é priorizado para atualizações. Se você incluir tanto e-mail quanto telefone, o e-mail é usado como identificador principal.PHONE- O número de telefone do usuário. Se existirem múltiplos perfis com o mesmo número de telefone, o perfil atualizado mais recentemente é priorizado para atualizações.
PAYLOAD- Esta é uma string JSON dos campos que deseja sincronizar com o usuário na Braze.
Etapa 1.5: Obter a string de conexão do warehouse
Para obter o endpoint SQL do seu warehouse, acesse o workspace no Fabric, passe o mouse sobre o nome do warehouse na lista de itens e selecione Copy SQL connection string.

Etapa 1.6: Permitir IPs da Braze no firewall (opcional)
Dependendo da configuração da sua conta do Microsoft Fabric, pode ser necessário permitir os seguintes endereços IP no seu firewall para liberar o tráfego da Braze. Para saber mais sobre como ativar isso, consulte a documentação relevante sobre Acesso Condicional do Entra.
Para as instâncias US-01, US-02, US-03, US-04, US-05, US-06, US-07, estes são os endereços IP relevantes:
23.21.118.19134.206.23.17350.16.249.952.4.160.21454.87.8.3454.156.35.25152.54.89.23818.205.178.15
Para a instância US-08, estes são os endereços IP relevantes:
52.151.246.5152.170.163.18240.76.166.15740.76.166.17040.76.166.16740.76.166.16140.76.166.15640.76.166.16640.76.166.16040.88.51.7452.154.67.1740.76.166.8040.76.166.8440.76.166.8540.76.166.8140.76.166.7140.76.166.14440.76.166.145
Para a instância US-10, estes são os endereços IP relevantes:
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
Para as instâncias EU-01 e EU-02, estes são os endereços IP relevantes:
52.58.142.24252.29.193.12135.158.29.22818.157.135.973.123.166.463.64.27.363.65.88.253.68.144.1883.70.107.88
Para a instância AU-01, estes são os endereços IP relevantes:
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
Para a instância ID-01, estes são os endereços IP relevantes:
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
Para a instância JP-01, estes são os endereços IP relevantes:
13.159.155.21254.199.221.24113.192.23.1654.250.120.13918.181.114.2323.114.38.100
Para a instância KR-01, estes são os endereços IP relevantes:
43.200.215.452.79.67.17552.79.113.603.34.212.9254.116.134.2313.37.197.225
Etapa 2: Criar uma nova fonte no dashboard da Braze
No dashboard da Braze, acesse Data Settings > Cloud Data Ingestion > Sources, selecione Add data source e, em seguida, selecione Snowflake.
Etapa 2.1: Adicionar informações de conexão do Snowflake
Escolha um nome para sua fonte e insira suas credenciais e configuração do Snowflake, depois prossiga para a próxima etapa.
Antes de continuar, confirme o valor que você inseriu em Snowflake Account Locator.
Para o campo Snowflake Account Locator, insira o identificador da sua conta do Snowflake. Insira apenas o valor do identificador da conta, como myorganization-myaccount. Não inclua https://, .snowflakecomputing.com, nem nenhum caminho.
Para encontrar o identificador da sua conta do Snowflake:
- No Snowsight, selecione o menu da sua conta.
- Selecione View account details.
- Copie o valor do Account identifier.
- Se copiar de uma URL do Snowflake, use apenas o valor antes de
.snowflakecomputing.com.
Etapa 2.2: Adicionar uma chave pública ao usuário da Braze
Após inserir suas credenciais e configuração, clique em Save credentials e gere uma chave RSA e volte ao Snowflake para concluir a configuração. Adicione a chave pública exibida no dashboard ao usuário que você criou para a Braze se conectar ao Snowflake.
Para saber mais sobre como fazer isso, consulte a documentação do Snowflake. Se quiser fazer a rotação das chaves em qualquer momento, a Braze pode gerar um novo par de chaves e fornecer a nova chave pública.
1
ALTER USER BRAZE_INGESTION_USER SET RSA_PUBLIC_KEY='MIIBIjANBgkqhkiG9w0BA...';
No dashboard da Braze, acesse Data Settings > Cloud Data Ingestion > Sources, selecione Add data source e, em seguida, selecione Amazon Redshift.
Etapa 2.1: Adicionar informações de conexão do Redshift e tabela de origem
Escolha um nome para sua fonte e insira suas credenciais e configuração do Redshift. Se estiver usando um túnel de rede privada, ative o botão e insira as informações do túnel. Em seguida, prossiga para a próxima etapa.

No dashboard da Braze, o campo Database name aceita apenas letras (A–Z, a–z), números (0–9) e sublinhados (_), mesmo que o Amazon Redshift suporte caracteres adicionais em identificadores de banco de dados.
Etapa 2.2: Testar a conexão e conectar à fonte
Em seguida, selecione Test connection. Quando for bem-sucedido, finalize as configurações restantes e clique em Connect to Source. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar na solução do problema.
Solução de problemas: identificador de snapshot inválido
Se a Braze retornar um erro Invalid snapshot identifier durante Test connection ou a configuração de sincronização, o Redshift não consegue resolver a referência de snapshot usada quando o objeto de origem é consultado.
No Redshift, um snapshot é um backup point-in-time de um cluster. Cada snapshot tem um identificador único usado pelo Redshift para referenciar aquele estado de backup. Para saber mais, consulte Snapshots e backups do Amazon Redshift.
Esse erro pode ocorrer quando metadados mudam enquanto a Braze valida o objeto de origem, como durante operações de cópia, restauração ou replicação de snapshots. Para saber mais, consulte copiar snapshots para outra região AWS e restaurar um cluster a partir de um snapshot.
Para solucionar:
- Verifique as configurações da fonte na Braze, incluindo endpoint do cluster, banco de dados, schema e nome do objeto.
- Execute a mesma consulta diretamente no Redshift para confirmar que a tabela ou view é legível e estável.
- Tente novamente após a conclusão de atividades de snapshot, restauração, redimensionamento ou replicação.
- Se o problema persistir, consulte uma materialized view em vez de uma tabela base que muda frequentemente.
Uma materialized view armazena resultados de consultas pré-computados que podem ser atualizados em um cronograma, o que pode tornar as leituras mais estáveis para sincronizações CDI. Para saber mais, consulte materialized views no Amazon Redshift.
Exemplo:
1
2
3
4
5
CREATE MATERIALIZED VIEW ingestion.users_attributes_mv AS
SELECT updated_at, external_id, alias_label, alias_name, braze_id, email, phone, payload
FROM ingestion.users_attributes_sync;
REFRESH MATERIALIZED VIEW ingestion.users_attributes_mv;
Após criar a materialized view, use o nome da materialized view como o objeto de origem na sua sincronização CDI da Braze em vez da tabela base.
No dashboard da Braze, acesse Data Settings > Cloud Data Ingestion > Sources, selecione Add data source e, em seguida, selecione Google BigQuery.
Etapa 2.1: Adicionar informações de conexão do BigQuery e tabela de origem
Escolha um nome para sua fonte. Em seguida, faça o upload da chave JSON e forneça um nome para a conta de serviço. Depois, insira os campos de configuração restantes.
Etapa 2.2: Testar a conexão e conectar à fonte
Em seguida, selecione Test connection. Quando for bem-sucedido, finalize as configurações restantes e clique em Connect to Source. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar na solução do problema.
No dashboard da Braze, acesse Data Settings > Cloud Data Ingestion > Sources, selecione Add data source e, em seguida, selecione Databricks.
Etapa 2.1: Adicionar informações de conexão do Databricks e tabela de origem
Escolha um nome para sua fonte e insira suas credenciais e configuração do Databricks. Em seguida, prossiga para a próxima etapa.
Etapa 2.2: Testar a conexão e conectar à fonte
Em seguida, selecione Test connection. Quando for bem-sucedido, finalize as configurações restantes e clique em Connect to Source. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar na solução do problema.

Você deve testar a fonte com sucesso antes que ela possa ser criada. Se fechar a página de criação, sua fonte não será salva.
No dashboard da Braze, acesse Data Settings > Cloud Data Ingestion > Sources, selecione Add data source e, em seguida, selecione Microsoft Fabric.
Etapa 2.1: Configurar uma sincronização de ingestão de dados na nuvem
Escolha um nome para sua fonte e insira suas credenciais e configuração do Microsoft Fabric.
- Credentials Name é um rótulo para essas credenciais na Braze; você pode definir um valor útil aqui
- Consulte as etapas na seção 1 para saber como obter o Tenant ID, Principal ID, Client Secret e Connection String
Etapa 2.2: Testar a conexão e conectar à fonte
Em seguida, selecione Test connection. Quando for bem-sucedido, finalize as configurações restantes e clique em Connect to Source. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar na solução do problema.

Você deve testar a fonte com sucesso antes que ela possa ser criada. Se fechar a página de criação, sua fonte não será salva.
Etapa 3: Criar uma nova sincronização no dashboard da Braze
Acesse Data Settings > Cloud Data Ingestion > Syncs e selecione Create data sync.
Etapa 3.1: Configurar os detalhes da sincronização e testar a conexão
Escolha um nome para sua sincronização. Em seguida, selecione qualquer fonte ativa e insira sua tabela de origem para a sincronização. Selecione um tipo de dados e clique em Test Connection.
Quando for bem-sucedido, uma prévia dos dados aparecerá. Selecione Next: Notifications para continuar. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar na solução do problema.

Você deve testar a sincronização com sucesso antes de prosseguir para as próximas etapas. Se precisar fechar a página de criação da sincronização, clique em Save as draft para salvar seu progresso.
Etapa 3.2: Adicionar preferências de notificação
Insira o(s) e-mail(s) de contato para notificações de erros de sincronização. A Braze usa essas informações de contato para enviar notificações sobre erros de integração, como perda inesperada de acesso à tabela.
Os e-mails de contato recebem notificações apenas de erros globais ou no nível da sincronização, como tabelas ausentes, permissões e outros. Eles não recebem problemas no nível de linha. Erros globais indicam problemas críticos na conexão que impedem a execução das sincronizações.
Esses problemas podem incluir:
- Problemas de conectividade
- Falta de recursos
- Problemas de permissões
- (Apenas para sincronizações de catálogos) O nível do catálogo está sem espaço
Etapa 3.3: Agendamento
Por último, configure sua sincronização como não recorrente ou recorrente.
Sincronizações não recorrentes podem ser acionadas manualmente ou via API.
Sincronizações recorrentes podem ter uma frequência de 15 em 15 minutos até uma vez por mês. A Braze agenda a sincronização recorrente no fuso horário UTC.
Etapa 3.1: Configurar os detalhes da sincronização e testar a conexão
Escolha um nome para sua sincronização. Em seguida, selecione qualquer fonte ativa e insira sua tabela de origem para a sincronização. Selecione um tipo de dados e clique em Test Connection.
Quando for bem-sucedido, uma prévia dos dados aparecerá. Selecione Next: Notifications para continuar. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar na solução do problema.

Você deve testar a sincronização com sucesso antes de prosseguir para as próximas etapas. Se precisar fechar a página de criação da sincronização, clique em Save as draft para salvar seu progresso.
Etapa 3.2: Adicionar preferências de notificação
Insira o(s) e-mail(s) de contato para notificações de erros de sincronização. A Braze usa essas informações de contato para enviar notificações sobre erros de integração, como perda inesperada de acesso à tabela.
Os e-mails de contato recebem notificações apenas de erros globais ou no nível da sincronização, como tabelas ausentes, permissões e outros. Eles não recebem problemas no nível de linha. Erros globais indicam problemas críticos na conexão que impedem a execução das sincronizações.
Esses problemas podem incluir:
- Problemas de conectividade
- Falta de recursos
- Problemas de permissões
(Apenas para sincronizações de catálogos) O nível do catálogo está sem espaço
Etapa 3.3: Agendamento
Por último, configure sua sincronização como não recorrente ou recorrente.
Sincronizações não recorrentes podem ser acionadas manualmente ou via API.
Sincronizações recorrentes podem ter uma frequência de 15 em 15 minutos até uma vez por mês. A Braze agenda a sincronização recorrente no fuso horário UTC.
Etapa 3.1: Configurar os detalhes da sincronização e testar a conexão
Escolha um nome para sua sincronização. Em seguida, selecione qualquer fonte ativa e insira sua tabela de origem para a sincronização. Selecione um tipo de dados e clique em Test Connection.
Quando for bem-sucedido, uma prévia dos dados aparecerá. Selecione Next: Notifications para continuar. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar na solução do problema.

Você deve testar a sincronização com sucesso antes de prosseguir para as próximas etapas. Se precisar fechar a página de criação da sincronização, clique em Save as draft para salvar seu progresso.
Etapa 3.2: Adicionar preferências de notificação
Insira o(s) e-mail(s) de contato para notificações de erros de sincronização. A Braze usa essas informações de contato para enviar notificações sobre erros de integração, como perda inesperada de acesso à tabela.
Os e-mails de contato recebem notificações apenas de erros globais ou no nível da sincronização, como tabelas ausentes, permissões e outros. Eles não recebem problemas no nível de linha. Erros globais indicam problemas críticos na conexão que impedem a execução das sincronizações. Esses problemas podem incluir:
- Problemas de conectividade
- Falta de recursos
- Problemas de permissões
(Apenas para sincronizações de catálogos) O nível do catálogo está sem espaço
Etapa 3.3: Agendamento
Por último, configure sua sincronização como não recorrente ou recorrente.
Sincronizações não recorrentes podem ser acionadas manualmente ou via API.
Sincronizações recorrentes podem ter uma frequência de 15 em 15 minutos até uma vez por mês. A Braze agenda a sincronização recorrente no fuso horário UTC.
Etapa 3.1: Configurar os detalhes da sincronização e testar a conexão
Escolha um nome para sua sincronização. Em seguida, selecione qualquer fonte ativa e insira sua tabela de origem para a sincronização. Selecione um tipo de dados e clique em Test Connection.
Quando for bem-sucedido, uma prévia dos dados aparecerá. Selecione Next: Notifications para continuar. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar na solução do problema.

Você deve testar a sincronização com sucesso antes de prosseguir para as próximas etapas. Se precisar fechar a página de criação da sincronização, clique em Save as draft para salvar seu progresso.
Etapa 3.2: Adicionar preferências de notificação
Insira o(s) e-mail(s) de contato para notificações de erros de sincronização. A Braze usa essas informações de contato para enviar notificações sobre erros de integração, como perda inesperada de acesso à tabela.
Os e-mails de contato recebem notificações apenas de erros globais ou no nível da sincronização, como tabelas ausentes, permissões e outros. Eles não recebem problemas no nível de linha. Erros globais indicam problemas críticos na conexão que impedem a execução das sincronizações.
Esses problemas podem incluir:
- Problemas de conectividade
- Falta de recursos
- Problemas de permissões
(Apenas para sincronizações de catálogos) O nível do catálogo está sem espaço
Etapa 3.3: Agendamento
Por último, configure sua sincronização como não recorrente ou recorrente.
Sincronizações não recorrentes podem ser acionadas manualmente ou via API.
Sincronizações recorrentes podem ter uma frequência de 15 em 15 minutos até uma vez por mês. A Braze agenda a sincronização recorrente no fuso horário UTC.
Etapa 3.1: Configurar os detalhes da sincronização e testar a conexão
Escolha um nome para sua sincronização. Em seguida, selecione qualquer fonte ativa e insira sua tabela de origem para a sincronização. Selecione um tipo de dados e clique em Test Connection.
Quando for bem-sucedido, uma prévia dos dados aparecerá. Selecione Next: Notifications para continuar. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar na solução do problema.

Você deve testar a sincronização com sucesso antes de prosseguir para as próximas etapas. Se precisar fechar a página de criação da sincronização, clique em Save as draft para salvar seu progresso.
Etapa 3.2: Adicionar preferências de notificação
Insira o(s) e-mail(s) de contato para notificações de erros de sincronização. A Braze usa essas informações de contato para enviar notificações sobre erros de integração, como perda inesperada de acesso à tabela.
Os e-mails de contato recebem notificações apenas de erros globais ou no nível da sincronização, como tabelas ausentes, permissões e outros. Eles não recebem problemas no nível de linha. Erros globais indicam problemas críticos na conexão que impedem a execução das sincronizações.
Esses problemas podem incluir:
- Problemas de conectividade
- Falta de recursos
- Problemas de permissões
(Apenas para sincronizações de catálogos) O nível do catálogo está sem espaço
Etapa 3.3: Agendamento
Por último, configure sua sincronização como não recorrente ou recorrente.
Sincronizações não recorrentes podem ser acionadas manualmente ou via API.
Sincronizações recorrentes podem ter uma frequência de 15 em 15 minutos até uma vez por mês. A Braze agenda a sincronização recorrente no fuso horário UTC.

Você deve testar uma integração com sucesso antes que ela possa passar do estado Rascunho para Ativo. Se fechar a página de criação, sua integração será salva, e você poderá revisitar a página de detalhes para fazer alterações e testar.
Configurar integrações ou usuários adicionais (opcional)
Você pode configurar várias integrações com a Braze, mas cada integração deve ser configurada para sincronizar uma tabela diferente. Ao criar sincronizações adicionais, você pode reutilizar credenciais existentes se estiver conectando à mesma conta do Snowflake.
Se você reutilizar o mesmo usuário e a mesma função entre integrações, não será necessário adicionar a chave pública novamente.
Você pode configurar várias integrações com a Braze, mas cada integração deve ser configurada para sincronizar uma tabela diferente. Ao criar sincronizações adicionais, você pode reutilizar credenciais existentes se estiver conectando à mesma conta do Snowflake ou do Redshift.
Se você reutilizar o mesmo usuário entre integrações, não será possível excluir o usuário no dashboard da Braze até que ele seja removido de todas as sincronizações ativas.
Você pode configurar várias integrações com a Braze, mas cada integração deve ser configurada para sincronizar uma tabela diferente. Ao criar sincronizações adicionais, você pode reutilizar credenciais existentes se estiver conectando à mesma conta do BigQuery.
Se você reutilizar o mesmo usuário entre integrações, não será possível excluir o usuário no dashboard da Braze até que ele seja removido de todas as sincronizações ativas.
Você pode configurar várias integrações com a Braze, mas cada integração deve ser configurada para sincronizar uma tabela diferente. Ao criar sincronizações adicionais, você pode reutilizar credenciais existentes se estiver conectando à mesma conta do Databricks.
Se você reutilizar o mesmo usuário entre integrações, não será possível excluir o usuário no dashboard da Braze até que ele seja removido de todas as sincronizações ativas.
Você pode configurar várias integrações com a Braze, mas cada integração deve ser configurada para sincronizar uma tabela diferente. Ao criar sincronizações adicionais, você pode reutilizar credenciais existentes se estiver conectando à mesma conta do Fabric.
Se você reutilizar o mesmo usuário entre integrações, não será possível excluir o usuário no dashboard da Braze até que ele seja removido de todas as sincronizações ativas.
Executando a sincronização
Quando ativada, sua sincronização é executada no cronograma configurado durante a configuração. Se você quiser executar a sincronização fora do cronograma normal de testes ou buscar os dados mais recentes, selecione Sync Now. Essa execução não afeta as sincronizações futuras programadas regularmente.
Quando ativada, sua sincronização é executada no cronograma configurado durante a configuração. Se você quiser executar a sincronização fora do cronograma normal de testes ou buscar os dados mais recentes, selecione Sync Now. Essa execução não afeta as sincronizações futuras programadas regularmente.
Quando ativada, sua sincronização é executada no cronograma configurado durante a configuração. Se você quiser executar a sincronização fora do cronograma normal de testes ou buscar os dados mais recentes, selecione Sync Now. Essa execução não afeta as sincronizações futuras programadas regularmente.
Quando ativada, sua sincronização é executada no cronograma configurado durante a configuração. Se você quiser executar a sincronização fora do cronograma normal de testes ou buscar os dados mais recentes, selecione Sync Now. Essa execução não afeta as sincronizações futuras programadas regularmente.
Quando ativada, sua sincronização é executada no cronograma configurado durante a configuração. Se você quiser executar a sincronização fora do cronograma normal de testes ou buscar os dados mais recentes, selecione Sync Now. Essa execução não afeta as sincronizações futuras programadas regularmente.