Skip to content

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 warehouses

As integrações de ingestão de dados na nuvem exigem algumas configurações do lado da Braze e na sua instância de data warehouse. Siga estas etapas para configurar a integração:

  1. Na sua instância do Snowflake, configure as tabelas ou views que você deseja sincronizar com a Braze.
  2. Crie uma nova fonte Snowflake no dashboard da Braze.
  3. Recupere a chave pública fornecida no dashboard da Braze e adicione-a ao usuário do Snowflake para autenticação.
  4. Crie uma sincronização no dashboard da Braze, teste a integração e inicie a sincronização.
  1. Certifique-se de que o acesso da Braze às tabelas do Redshift que você deseja sincronizar esteja permitido. A Braze se conecta ao Redshift pela internet.
  2. Na sua instância do Redshift, configure as tabelas ou views que você deseja sincronizar com a Braze.
  3. Crie uma nova fonte e sincronização no dashboard da Braze.
  4. Teste a integração e inicie a sincronização.
  1. 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 você deseja sincronizar.
  2. Na sua conta do BigQuery, configure as tabelas ou views que você deseja sincronizar com a Braze.
  3. Crie uma nova fonte e sincronização no dashboard da Braze.
  4. Teste a integração e inicie a sincronização.
  1. 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 você deseja sincronizar.
  2. Na sua conta do Databricks, configure as tabelas ou views que você deseja sincronizar com a Braze.
  3. Crie uma nova fonte e sincronização no dashboard da Braze.
  4. Teste a integração e inicie a sincronização.
  1. Crie um service principal e conceda acesso às APIs do Fabric.
  2. Configure um espaço de trabalho compartilhado e conceda ao service principal acesso a ele.
  3. No espaço de trabalho compartilhado do Fabric, configure as tabelas ou views que você deseja sincronizar com a Braze.
  4. Crie uma nova fonte e sincronização no dashboard da Braze.
  5. 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.

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, o schema e a tabela como preferir, mas os nomes das colunas devem corresponder à definição anterior.

  • UPDATED_AT - O horário em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em que UPDATED_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 de alias_name e alias_label, braze_id, email ou phone). 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 você deseja atualizar. Deve corresponder ao valor external_id usado na Braze.
    • ALIAS_NAME e ALIAS_LABEL - Essas duas colunas criam um objeto de alias de usuário. alias_name deve ser um identificador único, e alias_label especifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas um alias_name por alias_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 de usuário externo ou alias de usuário.
    • EMAIL - O endereço de e-mail do usuário. Se existirem vários perfis com o mesmo endereço de e-mail, o perfil atualizado mais recentemente terá prioridade nas atualizações. Se você incluir tanto e-mail quanto telefone, o e-mail será usado como identificador principal.
    • PHONE - O número de telefone do usuário. Se existirem vários perfis com o mesmo número de telefone, o perfil atualizado mais recentemente terá prioridade nas atualizações.
  • PAYLOAD - Uma string JSON dos campos que você deseja sincronizar com o usuário na Braze.

Etapa 1.2: Configurar a 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 à role da Braze

1
2
3
CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

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.

Etapa 1.5: Permitir IPs da Braze na política de rede do Snowflake (opcional)

Dependendo da configuração da sua conta 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 modificação de 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.191
  • 34.206.23.173
  • 50.16.249.9
  • 52.4.160.214
  • 54.87.8.34
  • 54.156.35.251
  • 52.54.89.238
  • 18.205.178.15

Para a instância US-08, estes são os endereços IP relevantes:

  • 52.151.246.51
  • 52.170.163.182
  • 40.76.166.157
  • 40.76.166.170
  • 40.76.166.167
  • 40.76.166.161
  • 40.76.166.156
  • 40.76.166.166
  • 40.76.166.160
  • 40.88.51.74
  • 52.154.67.17
  • 40.76.166.80
  • 40.76.166.84
  • 40.76.166.85
  • 40.76.166.81
  • 40.76.166.71
  • 40.76.166.144
  • 40.76.166.145

Para a instância US-10, estes são os endereços IP relevantes:

  • 100.25.232.164
  • 35.168.86.179
  • 52.7.44.117
  • 3.92.153.18
  • 35.172.3.129
  • 50.19.162.19

Para as instâncias EU-01 e EU-02, estes são os endereços IP relevantes:

  • 52.58.142.242
  • 52.29.193.121
  • 35.158.29.228
  • 18.157.135.97
  • 3.123.166.46
  • 3.64.27.36
  • 3.65.88.25
  • 3.68.144.188
  • 3.70.107.88

Para a instância AU-01, estes são os endereços IP relevantes:

  • 13.210.1.145
  • 13.211.70.159
  • 13.238.45.54
  • 52.65.73.167
  • 54.153.242.239
  • 54.206.45.213

Para a instância ID-01, estes são os endereços IP relevantes:

  • 108.136.157.246
  • 108.137.30.207
  • 16.78.128.71
  • 16.78.14.134
  • 16.78.162.208
  • 43.218.73.35

Para a instância JP-01, estes são os endereços IP relevantes:

  • 13.159.155.212
  • 54.199.221.241
  • 13.192.23.16
  • 54.250.120.139
  • 18.181.114.232
  • 3.114.38.100

Para a instância KR-01, estes são os endereços IP relevantes:

  • 43.200.215.4
  • 52.79.67.175
  • 52.79.113.60

Etapa 1.1: Configurar a tabela

Opcionalmente, configure um novo banco de dados e schema para armazenar 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, o schema e a tabela como preferir, mas os nomes das colunas devem corresponder à definição anterior.

  • UPDATED_AT - O horário em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em que UPDATED_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 de alias_name e alias_label, braze_id, email ou phone). 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 você deseja atualizar. Deve corresponder ao valor external_id usado na Braze.
    • ALIAS_NAME e ALIAS_LABEL - Essas duas colunas criam um objeto de alias de usuário. alias_name deve ser um identificador único, e alias_label especifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas um alias_name por alias_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 de usuário externo ou alias de usuário.
    • EMAIL - O endereço de e-mail do usuário. Se existirem vários perfis com o mesmo endereço de e-mail, o perfil atualizado mais recentemente terá prioridade nas atualizações. Se você incluir tanto e-mail quanto telefone, o e-mail será usado como identificador principal.
    • PHONE - O número de telefone do usuário. Se existirem vários perfis com o mesmo número de telefone, o perfil atualizado mais recentemente terá prioridade nas atualizações.
  • PAYLOAD - Uma string JSON dos campos que você deseja sincronizar com o usuário na Braze.

Etapa 1.2: Criar 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 necessárias para este usuário. Se estiver criando várias integrações CDI, você pode 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, deve 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 informações 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 Redshift (o padrão é 5439). Você deve permitir explicitamente a conectividade TCP do Redshift nesta porta, mesmo que as regras de entrada estejam configuradas como “permitir tudo”.
  • O endpoint do cluster Redshift deve ser acessível publicamente para que a Braze se conecte ao seu cluster.
    • Se você não quiser que seu cluster Redshift seja acessível publicamente, 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.191
  • 34.206.23.173
  • 50.16.249.9
  • 52.4.160.214
  • 54.87.8.34
  • 54.156.35.251
  • 52.54.89.238
  • 18.205.178.15

Para a instância US-08, estes são os endereços IP relevantes:

  • 52.151.246.51
  • 52.170.163.182
  • 40.76.166.157
  • 40.76.166.170
  • 40.76.166.167
  • 40.76.166.161
  • 40.76.166.156
  • 40.76.166.166
  • 40.76.166.160
  • 40.88.51.74
  • 52.154.67.17
  • 40.76.166.80
  • 40.76.166.84
  • 40.76.166.85
  • 40.76.166.81
  • 40.76.166.71
  • 40.76.166.144
  • 40.76.166.145

Para a instância US-10, estes são os endereços IP relevantes:

  • 100.25.232.164
  • 35.168.86.179
  • 52.7.44.117
  • 3.92.153.18
  • 35.172.3.129
  • 50.19.162.19

Para as instâncias EU-01 e EU-02, estes são os endereços IP relevantes:

  • 52.58.142.242
  • 52.29.193.121
  • 35.158.29.228
  • 18.157.135.97
  • 3.123.166.46
  • 3.64.27.36
  • 3.65.88.25
  • 3.68.144.188
  • 3.70.107.88

Para a instância AU-01, estes são os endereços IP relevantes:

  • 13.210.1.145
  • 13.211.70.159
  • 13.238.45.54
  • 52.65.73.167
  • 54.153.242.239
  • 54.206.45.213

Para a instância ID-01, estes são os endereços IP relevantes:

  • 108.136.157.246
  • 108.137.30.207
  • 16.78.128.71
  • 16.78.14.134
  • 16.78.162.208
  • 43.218.73.35

Para a instância JP-01, estes são os endereços IP relevantes:

  • 13.159.155.212
  • 54.199.221.241
  • 13.192.23.16
  • 54.250.120.139
  • 18.181.114.232
  • 3.114.38.100

Para a instância KR-01, estes são os endereços IP relevantes:

  • 43.200.215.4
  • 52.79.67.175
  • 52.79.113.60

Etapa 1.1: Configurar a tabela

Opcionalmente, configure um novo projeto ou dataset para armazenar 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, o dataset e a tabela como preferir, mas os nomes das colunas devem corresponder à definição anterior.

  • UPDATED_AT - O horário em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em que UPDATED_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 de alias_name e alias_label, braze_id, email ou phone). 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 você deseja atualizar. Deve corresponder ao valor external_id usado na Braze.
    • ALIAS_NAME e ALIAS_LABEL - Essas duas colunas criam um objeto de alias de usuário. alias_name deve ser um identificador único, e alias_label especifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas um alias_name por alias_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 de usuário externo ou alias de usuário.
    • EMAIL - O endereço de e-mail do usuário. Se existirem vários perfis com o mesmo endereço de e-mail, o perfil atualizado mais recentemente terá prioridade nas atualizações. Se você incluir tanto e-mail quanto telefone, o e-mail será usado como identificador principal.
    • PHONE - O número de telefone do usuário. Se existirem vários perfis com o mesmo número de telefone, o perfil atualizado mais recentemente terá prioridade nas atualizações.
  • PAYLOAD - Uma string JSON dos campos que você deseja sincronizar com o usuário na Braze.

Etapa 1.2: Criar uma conta de serviço e conceder permissões

Crie uma conta de serviço no GCP para a Braze usar para se 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 seus conteúdos.
  • BigQuery Job User: Fornece à Braze acesso para executar jobs

Após criar a conta de serviço e conceder as 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 em vigor, deve 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.191
  • 34.206.23.173
  • 50.16.249.9
  • 52.4.160.214
  • 54.87.8.34
  • 54.156.35.251
  • 52.54.89.238
  • 18.205.178.15

Para a instância US-08, estes são os endereços IP relevantes:

  • 52.151.246.51
  • 52.170.163.182
  • 40.76.166.157
  • 40.76.166.170
  • 40.76.166.167
  • 40.76.166.161
  • 40.76.166.156
  • 40.76.166.166
  • 40.76.166.160
  • 40.88.51.74
  • 52.154.67.17
  • 40.76.166.80
  • 40.76.166.84
  • 40.76.166.85
  • 40.76.166.81
  • 40.76.166.71
  • 40.76.166.144
  • 40.76.166.145

Para a instância US-10, estes são os endereços IP relevantes:

  • 100.25.232.164
  • 35.168.86.179
  • 52.7.44.117
  • 3.92.153.18
  • 35.172.3.129
  • 50.19.162.19

Para as instâncias EU-01 e EU-02, estes são os endereços IP relevantes:

  • 52.58.142.242
  • 52.29.193.121
  • 35.158.29.228
  • 18.157.135.97
  • 3.123.166.46
  • 3.64.27.36
  • 3.65.88.25
  • 3.68.144.188
  • 3.70.107.88

Para a instância AU-01, estes são os endereços IP relevantes:

  • 13.210.1.145
  • 13.211.70.159
  • 13.238.45.54
  • 52.65.73.167
  • 54.153.242.239
  • 54.206.45.213

Para a instância ID-01, estes são os endereços IP relevantes:

  • 108.136.157.246
  • 108.137.30.207
  • 16.78.128.71
  • 16.78.14.134
  • 16.78.162.208
  • 43.218.73.35

Para a instância JP-01, estes são os endereços IP relevantes:

  • 13.159.155.212
  • 54.199.221.241
  • 13.192.23.16
  • 54.250.120.139
  • 18.181.114.232
  • 3.114.38.100

Para a instância KR-01, estes são os endereços IP relevantes:

  • 43.200.215.4
  • 52.79.67.175
  • 52.79.113.60

Etapa 1.1: Configurar a tabela

Opcionalmente, configure um novo catálogo ou schema para armazenar 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 preferir, mas os nomes das colunas devem corresponder à definição anterior.

  • UPDATED_AT - O horário em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em que UPDATED_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 de alias_name e alias_label, braze_id, email ou phone). 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 você deseja atualizar. Deve corresponder ao valor external_id usado na Braze.
    • ALIAS_NAME e ALIAS_LABEL - Essas duas colunas criam um objeto de alias de usuário. alias_name deve ser um identificador único, e alias_label especifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas um alias_name por alias_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 de usuário externo ou alias de usuário.
    • EMAIL - O endereço de e-mail do usuário. Se existirem vários perfis com o mesmo endereço de e-mail, o perfil atualizado mais recentemente terá prioridade nas atualizações. Se você incluir tanto e-mail quanto telefone, o e-mail será usado como identificador principal.
    • PHONE - O número de telefone do usuário. Se existirem vários perfis com o mesmo número de telefone, o perfil atualizado mais recentemente terá prioridade nas atualizações.
  • PAYLOAD - Uma string ou struct dos campos que você 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.

  1. 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.
  2. Na guia Access tokens, selecione Generate new token.
  3. Insira um comentário que ajude a identificar este token, como “Braze CDI”, e altere o tempo de vida do token para sem limite, deixando a caixa Lifetime (days) vazia (em branco).
  4. Selecione Generate.
  5. Copie o token exibido e selecione Done.

Guarde 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 em vigor, deve 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.191
  • 34.206.23.173
  • 50.16.249.9
  • 52.4.160.214
  • 54.87.8.34
  • 54.156.35.251
  • 52.54.89.238
  • 18.205.178.15

Para a instância US-08, estes são os endereços IP relevantes:

  • 52.151.246.51
  • 52.170.163.182
  • 40.76.166.157
  • 40.76.166.170
  • 40.76.166.167
  • 40.76.166.161
  • 40.76.166.156
  • 40.76.166.166
  • 40.76.166.160
  • 40.88.51.74
  • 52.154.67.17
  • 40.76.166.80
  • 40.76.166.84
  • 40.76.166.85
  • 40.76.166.81
  • 40.76.166.71
  • 40.76.166.144
  • 40.76.166.145

Para a instância US-10, estes são os endereços IP relevantes:

  • 100.25.232.164
  • 35.168.86.179
  • 52.7.44.117
  • 3.92.153.18
  • 35.172.3.129
  • 50.19.162.19

Para as instâncias EU-01 e EU-02, estes são os endereços IP relevantes:

  • 52.58.142.242
  • 52.29.193.121
  • 35.158.29.228
  • 18.157.135.97
  • 3.123.166.46
  • 3.64.27.36
  • 3.65.88.25
  • 3.68.144.188
  • 3.70.107.88

Para a instância AU-01, estes são os endereços IP relevantes:

  • 13.210.1.145
  • 13.211.70.159
  • 13.238.45.54
  • 52.65.73.167
  • 54.153.242.239
  • 54.206.45.213

Para a instância ID-01, estes são os endereços IP relevantes:

  • 108.136.157.246
  • 108.137.30.207
  • 16.78.128.71
  • 16.78.14.134
  • 16.78.162.208
  • 43.218.73.35

Para a instância JP-01, estes são os endereços IP relevantes:

  • 13.159.155.212
  • 54.199.221.241
  • 13.192.23.16
  • 54.250.120.139
  • 18.181.114.232
  • 3.114.38.100

Para a instância KR-01, estes são os endereços IP relevantes:

  • 43.200.215.4
  • 52.79.67.175
  • 52.79.113.60

Etapa 1.1: Configurar o service principal e conceder acesso

A Braze se conecta ao seu warehouse do Fabric 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
  1. No portal do Azure, navegue até o centro de administração do Microsoft Entra e, em seguida, App Registrations.
  2. Selecione + New registration em Identity > Applications > App registrations
  3. Insira um nome e selecione Accounts in this organizational directory only como o tipo de conta compatível. Em seguida, selecione Register.
  4. Selecione o app (service principal) que você acabou de criar e navegue até Certificates & secrets > + New client secret
  5. Insira uma descrição para o segredo e defina um período de vencimento para o segredo. Em seguida, selecione Add.
  6. Anote o segredo do cliente criado para usar na configuração da 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

Todos os recursos do Fabric que você deseja conectar à Braze devem ser colocados em um espaço de trabalho compartilhado. Se você estiver usando apenas o My Workspace padrão, crie um novo espaço de trabalho compartilhado:

  1. No menu de navegação, selecione Workspaces e, em seguida, selecione + New workspace.
  2. 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:

  1. Selecione o espaço de trabalho e, em seguida, selecione Manage Access.
  2. Selecione + Add people or groups.
  3. 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.
  4. No menu suspenso de role, selecione Contributor.

O service principal agora pode acessar os recursos do warehouse do Fabric neste espaço de trabalho por meio de seus endpoints SQL, incluindo o warehouse a ser usado pela Braze.

Etapa 1.4: Configurar a tabela

A Braze suporta tanto tabelas quanto views em Fabric Warehouses. Se você precisar criar um novo warehouse, crie-o dentro do 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, o schema e a tabela ou view como preferir, mas os nomes das colunas devem corresponder à definição anterior.

  • UPDATED_AT - O horário em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em que UPDATED_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 de alias_name e alias_label, braze_id, email ou phone). 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 você deseja atualizar. Deve corresponder ao valor external_id usado na Braze.
    • ALIAS_NAME e ALIAS_LABEL - Essas duas colunas criam um objeto de alias de usuário. alias_name deve ser um identificador único, e alias_label especifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas um alias_name por alias_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 de usuário externo ou alias de usuário.
    • EMAIL - O endereço de e-mail do usuário. Se existirem vários perfis com o mesmo endereço de e-mail, o perfil atualizado mais recentemente terá prioridade nas atualizações. Se você incluir tanto e-mail quanto telefone, o e-mail será usado como identificador principal.
    • PHONE - O número de telefone do usuário. Se existirem vários perfis com o mesmo número de telefone, o perfil atualizado mais recentemente terá prioridade nas atualizações.
  • PAYLOAD - Uma string JSON dos campos que você deseja sincronizar com o usuário na Braze.

Etapa 1.5: Obter a string de conexão do warehouse

Para recuperar 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.

A página "Fabric Console" no Microsoft Azure, onde os usuários devem recuperar a string de conexão SQL.

Etapa 1.6: Permitir IPs da Braze no firewall (opcional)

Dependendo da configuração da sua conta Microsoft Fabric, pode ser necessário permitir os seguintes endereços IP no seu firewall para permitir 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.191
  • 34.206.23.173
  • 50.16.249.9
  • 52.4.160.214
  • 54.87.8.34
  • 54.156.35.251
  • 52.54.89.238
  • 18.205.178.15

Para a instância US-08, estes são os endereços IP relevantes:

  • 52.151.246.51
  • 52.170.163.182
  • 40.76.166.157
  • 40.76.166.170
  • 40.76.166.167
  • 40.76.166.161
  • 40.76.166.156
  • 40.76.166.166
  • 40.76.166.160
  • 40.88.51.74
  • 52.154.67.17
  • 40.76.166.80
  • 40.76.166.84
  • 40.76.166.85
  • 40.76.166.81
  • 40.76.166.71
  • 40.76.166.144
  • 40.76.166.145

Para a instância US-10, estes são os endereços IP relevantes:

  • 100.25.232.164
  • 35.168.86.179
  • 52.7.44.117
  • 3.92.153.18
  • 35.172.3.129
  • 50.19.162.19

Para as instâncias EU-01 e EU-02, estes são os endereços IP relevantes:

  • 52.58.142.242
  • 52.29.193.121
  • 35.158.29.228
  • 18.157.135.97
  • 3.123.166.46
  • 3.64.27.36
  • 3.65.88.25
  • 3.68.144.188
  • 3.70.107.88

Para a instância AU-01, estes são os endereços IP relevantes:

  • 13.210.1.145
  • 13.211.70.159
  • 13.238.45.54
  • 52.65.73.167
  • 54.153.242.239
  • 54.206.45.213

Para a instância ID-01, estes são os endereços IP relevantes:

  • 108.136.157.246
  • 108.137.30.207
  • 16.78.128.71
  • 16.78.14.134
  • 16.78.162.208
  • 43.218.73.35

Para a instância JP-01, estes são os endereços IP relevantes:

  • 13.159.155.212
  • 54.199.221.241
  • 13.192.23.16
  • 54.250.120.139
  • 18.181.114.232
  • 3.114.38.100

Para a instância KR-01, estes são os endereços IP relevantes:

  • 43.200.215.4
  • 52.79.67.175
  • 52.79.113.60

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. Em seguida, prossiga para a próxima etapa.

Antes de continuar, confirme o valor que você insere em Snowflake Account Locator.

Para o campo Snowflake Account Locator, insira seu identificador de conta do Snowflake. Insira apenas o valor do identificador de conta, como myorganization-myaccount. Não inclua https://, .snowflakecomputing.com ou qualquer caminho.

Para encontrar seu identificador de conta do Snowflake:

  1. No Snowsight, selecione o menu da sua conta.
  2. Selecione View account details.
  3. Copie o valor do Account identifier.
  4. Se você 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. Em seguida, 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 mais informações sobre como fazer isso, consulte a documentação do Snowflake. Se você quiser rotacionar as chaves em algum 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 controle deslizante e insira as informações do túnel. Em seguida, prossiga para a próxima etapa.

Etapa 2.2: Testar conexão e conectar à fonte

Em seguida, selecione Test connection. Após o sucesso, finalize as configurações restantes e clique em Connect to Source. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar a solucionar o problema.

Solução de problemas: identificador de snapshot inválido

Se a Braze retornar um erro Invalid snapshot identifier durante o Test connection ou a configuração de sincronização, o Redshift não consegue resolver a referência de snapshot usada quando seu 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 esse estado de backup. Para saber mais, consulte Snapshots e backups do Amazon Redshift.

Esse erro pode ocorrer quando os 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 da AWS e restaurar um cluster a partir de um snapshot.

Para solucionar:

  1. Verifique as configurações da fonte na Braze, incluindo endpoint do cluster, banco de dados, schema e nome do objeto.
  2. Execute a mesma consulta diretamente no Redshift para confirmar que a tabela ou view é legível e estável.
  3. Tente novamente após a conclusão de atividades de snapshot, restauração, redimensionamento ou replicação.
  4. Se o problema persistir, consulte uma materialized view em vez de uma tabela base que muda frequentemente.

Uma materialized view armazena resultados de consulta pré-computados que você pode atualizar 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 conexão e conectar à fonte

Em seguida, selecione Test connection. Após o sucesso, finalize as configurações restantes e clique em Connect to Source. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar a solucionar o 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 conexão e conectar à fonte

Em seguida, selecione Test connection. Após o sucesso, finalize as configurações restantes e clique em Connect to Source. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar a solucionar o problema.

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 detalhes sobre como recuperar Tenant ID, Principal ID, Client Secret e Connection String

Etapa 2.2: Testar conexão e conectar à fonte

Em seguida, selecione Test connection. Após o sucesso, finalize as configurações restantes e clique em Connect to Source. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar a solucionar o problema.

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 detalhes da sincronização e testar 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.

Após o sucesso, uma prévia dos dados aparecerá. Selecione Next: Notifications para continuar. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar a solucionar o problema.

Etapa 3.2: Adicionar preferências de notificação

Insira 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 apenas notificações 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 com a 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 fim, 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 minutos até uma vez por mês. A Braze agenda a sincronização recorrente no fuso horário UTC.

Etapa 3.1: Configurar detalhes da sincronização e testar 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.

Após o sucesso, uma prévia dos dados aparecerá. Selecione Next: Notifications para continuar. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar a solucionar o problema.

Etapa 3.2: Adicionar preferências de notificação

Insira 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 apenas notificações 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 com a 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 fim, 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 minutos até uma vez por mês. A Braze agenda a sincronização recorrente no fuso horário UTC.

Etapa 3.1: Configurar detalhes da sincronização e testar 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.

Após o sucesso, uma prévia dos dados aparecerá. Selecione Next: Notifications para continuar. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar a solucionar o problema.

Etapa 3.2: Adicionar preferências de notificação

Insira 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 apenas notificações 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 com a 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 fim, 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 minutos até uma vez por mês. A Braze agenda a sincronização recorrente no fuso horário UTC.

Etapa 3.1: Configurar detalhes da sincronização e testar 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.

Após o sucesso, uma prévia dos dados aparecerá. Selecione Next: Notifications para continuar. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar a solucionar o problema.

Etapa 3.2: Adicionar preferências de notificação

Insira 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 apenas notificações 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 com a 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 fim, 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 minutos até uma vez por mês. A Braze agenda a sincronização recorrente no fuso horário UTC.

Etapa 3.1: Configurar detalhes da sincronização e testar 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.

Após o sucesso, uma prévia dos dados aparecerá. Selecione Next: Notifications para continuar. Se a conexão falhar, uma mensagem de erro aparecerá para ajudar a solucionar o problema.

Etapa 3.2: Adicionar preferências de notificação

Insira 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 apenas notificações 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 com a 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 fim, 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 minutos até uma vez por mês. A Braze agenda a sincronização recorrente no fuso horário UTC.

Configure 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 se conectando à mesma conta do Snowflake.

Se você reutilizar o mesmo usuário e a mesma função em diferentes 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 se conectando à mesma conta do Snowflake ou do Redshift.

Se você reutilizar o mesmo usuário em diferentes integrações, não será possível excluí-lo 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 se conectando à mesma conta do BigQuery.

Se você reutilizar o mesmo usuário em diferentes integrações, não será possível excluí-lo 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 se conectando à mesma conta do Databricks.

Se você reutilizar o mesmo usuário em diferentes integrações, não será possível excluí-lo 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 se conectando à mesma conta do Fabric.

Se você reutilizar o mesmo usuário em diferentes integrações, não será possível excluí-lo no dashboard da Braze até que ele seja removido de todas as sincronizações ativas.

Executando a sincronização

Quando ativada, a 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 agendadas regularmente.

Quando ativada, a 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 agendadas regularmente.

Quando ativada, a 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 agendadas regularmente.

Quando ativada, a 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 agendadas regularmente.

Quando ativada, a 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 agendadas regularmente.

New Stuff!