Ir para o conteúdo

Esta página foi traduzida automaticamente e pode conter imprecisões. Para relatar um erro de tradução, use o componente de feedback na parte inferior do sumário, à direita da página.

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 Cloud Data Ingestion exigem algumas configurações 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 você 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.

Dica

O guia de início rápido do Snowflake fornece código de exemplo e explica as etapas necessárias para criar um pipeline automatizado usando Snowflake Streams e CDI para sincronizar dados com a Braze.

Verifique se o acesso da Braze é permitido nas tabelas do Redshift que você deseja sincronizar. A Braze se conecta ao Redshift pela internet.
Na sua instância do Redshift, configure as tabelas ou views que você 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.

Nota

As linhas processadas por sincronização dependem do desempenho do seu warehouse, da latência de rede e de quantos dados novos 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 que a Braze acessa por meio do Workload Identity Federation ou de uma chave de conta de serviço, e permita acesso aos projetos e datasets do BigQuery que contêm os dados que você deseja sincronizar.
Na sua conta do BigQuery, configure as tabelas ou views que você 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 um service principal para autenticação OAuth machine-to-machine (M2M) ou um token de acesso pessoal, e permita acesso aos catálogos e esquemas do Databricks que contêm os dados que você deseja sincronizar.
Na sua conta do Databricks, configure as tabelas ou views que você 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.

Importante

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, assim como no início das sincronizações agendadas. Usar uma instância SQL serverless minimiza o tempo de aquecimento e melhora o throughput 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 você 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

As etapas nesta seção criam uma tabela com uma coluna PAYLOAD. Se você planeja mapear colunas com Visual ou escrever uma consulta com SQL na etapa de Definição de dados, pode usar uma tabela ou view existente. Pule a etapa de criação de tabela para o seu warehouse e conceda à Braze acesso de leitura nas tabelas ou views que você deseja sincronizar. Para uma comparação das opções, consulte Escolher uma opção de definição de dados.

Nota

Se você usar uma coluna PAYLOAD, sua tabela ou view de origem pode incluir colunas que não estão listadas para o seu 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 Cloud Data Ingestion.

Etapa 1.1: Configurar a tabela

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

UPDATED_AT — A hora em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza linhas em que UPDATED_AT é posterior ao último valor sincronizado. Linhas no exato timestamp 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 de Cloud Data Ingestion. 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 é 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 vários perfis com o mesmo número de telefone, o perfil atualizado mais recentemente é priorizado para 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

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

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

Nota

O warehouse precisa ter o flag de 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

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Após essa etapa, compartilhe as informações de conexão com a Braze para receber uma chave pública para adicionar ao usuário.

Nota

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 em diferentes integrações, mas a criação da integração falhará se um usuário na mesma conta do Snowflake estiver duplicado entre espaços de trabalho.

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 habilitar 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
3.34.212.92
54.116.134.231
3.37.197.225

Etapa 1.1: Configurar a tabela

Opcionalmente, configure um novo banco de dados e esquema para conter sua tabela de origem

CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

Crie uma tabela (ou view) para usar na sua integração CDI

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

UPDATED_AT — A hora em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza linhas em que UPDATED_AT é posterior ao último valor sincronizado. Linhas no exato timestamp 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 de Cloud Data Ingestion. 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 é 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 vários perfis com o mesmo número de telefone, o perfil atualizado mais recentemente é priorizado para 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

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, pode ser interessante conceder permissões a um esquema 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 URL de endpoint 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 nessa porta, mesmo que as regras de entrada estejam configuradas como “allow all”.
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 o post do AWS Knowledge Center.

Permita 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
3.34.212.92
54.116.134.231
3.37.197.225

Etapa 1.1: Configurar a tabela

Opcionalmente, configure um novo projeto ou dataset para conter sua tabela de origem.

CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

Crie uma ou mais tabelas para usar na sua integração CDI com os seguintes campos:

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 quiser, mas os nomes das colunas devem corresponder à definição anterior.

UPDATED_AT — A hora em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza linhas em que UPDATED_AT é posterior ao último valor sincronizado. Linhas no exato timestamp 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 de Cloud Data Ingestion. 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 é 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 vários perfis com o mesmo número de telefone, o perfil atualizado mais recentemente é priorizado para atualizações.
PAYLOAD — Uma string JSON dos campos que você deseja sincronizar com o usuário na Braze.

Importante

Particionamento no BigQuery

O CDI suporta partições no 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 filtrar 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 para seus dados específicos.

Todas as consultas CDI filtram por UPDATED_AT, mas esse comportamento pode mudar. Projete o esquema 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 credenciais para a Braze

Crie uma conta de serviço no GCP para a Braze usar na conexão e leitura de 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.

A Braze pode acessar a conta de serviço com qualquer um dos seguintes métodos de autenticação:

Workload Identity Federation: A Braze assume a identidade da conta de serviço com uma identidade de curta duração, assim você não precisa criar ou enviar uma chave.
Chave de conta de serviço: Você envia uma chave JSON da conta de serviço para a Braze.

Credenciais de chave de conta de serviço existentes continuam funcionando, e você não precisa migrá-las. Uma credencial de Workload Identity Federation pode atender tanto fontes do BigQuery quanto do Google Cloud Storage.

workload identity federation
chave de conta de serviço

Configure um pool de identidade de carga de trabalho, um provedor e a conta de serviço, e vincule o principal da Braze à conta de serviço. Para as etapas, consulte Configurando o Google Cloud para Workload Identity Federation. Se você já configurou o Workload Identity Federation para uma fonte do Google Cloud Storage, não precisa repetir o processo. Conceda à conta de serviço existente as permissões listadas nesta etapa.

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. Envie essa chave para o 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, é necessário conceder à Braze acesso de rede à sua instância do BigQuery. Permita 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
3.34.212.92
54.116.134.231
3.37.197.225

Etapa 1.1: Configurar a tabela

Opcionalmente, configure um novo catálogo ou esquema para conter sua tabela de origem.

CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

Crie uma ou mais tabelas para usar na sua integração CDI com os seguintes campos:

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

UPDATED_AT — A hora em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza linhas em que UPDATED_AT é posterior ao último valor sincronizado. Linhas no exato timestamp 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 de Cloud Data Ingestion. 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 é 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 vários perfis com o mesmo número de telefone, o perfil atualizado mais recentemente é priorizado para atualizações.
PAYLOAD — Uma string ou struct dos campos que você deseja sincronizar com o usuário na Braze.

Etapa 1.2: Criar credenciais para a Braze

A Braze pode se conectar ao Databricks com qualquer um dos seguintes métodos de autenticação:

OAuth M2M (recomendado): A Braze se autentica como um service principal do Databricks usando um client ID e client secret. O Databricks recomenda a autenticação OAuth M2M para conexões não assistidas como Cloud Data Ingestion.
Token de acesso pessoal: A Braze se autentica com um token gerado no seu espaço de trabalho do Databricks.

Credenciais de token de acesso pessoal existentes continuam funcionando, e você não precisa migrá-las. No entanto, os tokens de acesso pessoal geralmente expiram em um cronograma definido pelo administrador do seu espaço de trabalho, e as sincronizações param quando o token expira. Para migrar uma fonte existente para OAuth M2M, crie uma credencial OAuth M2M e selecione-a ao editar a fonte.

oauth m2m
token de acesso pessoal

A Braze se conecta ao seu espaço de trabalho do Databricks usando um service principal com autenticação OAuth M2M. Crie um novo service principal para a Braze usar e conceda acesso ao seu SQL warehouse e tabelas de origem. A Braze precisa dos seguintes detalhes para se conectar:

Client ID (também chamado de application ID) do service principal
Client secret para a Braze se autenticar

Criar o service principal

No seu espaço de trabalho do Databricks, selecione seu nome de usuário na barra superior e, em seguida, selecione Settings.
Acesse Identity and access e, em seguida, selecione Manage ao lado de Service principals.
Selecione Add service principal > Add new.
Insira um nome que ajude a identificar o service principal, como “Braze CDI”, e selecione Add.
Selecione o service principal que você criou. Na guia Configurations, verifique se Databricks SQL access está selecionado.

Gerar um client secret

Na página do service principal, selecione a guia Secrets e, em seguida, selecione Generate secret.
Insira um tempo de vida para o secret, em dias. O Databricks permite um tempo de vida máximo de 730 dias.
Selecione Generate.
Copie os valores de Secret e Client ID e, em seguida, selecione Done.

Guarde o client ID e o secret em um lugar seguro até precisar inseri-los no dashboard da Braze durante a etapa de criação de credenciais. O Databricks exibe o secret apenas uma vez.

Nota

O Databricks não permite tempo de vida ilimitado em secrets de service principal. Lembre-se de substituir o secret antes que ele expire para manter o fluxo de dados para a Braze. Para as etapas, consulte Atualizar o client secret.

Conceder acesso ao SQL warehouse

A Braze precisa de permissão para executar consultas no seu SQL warehouse, mas não precisa de acesso de administrador do espaço de trabalho.

Na barra lateral, selecione SQL Warehouses e, em seguida, selecione o warehouse que deseja que a Braze use.
Selecione Permissions.
Pesquise e selecione o service principal que você criou.
No dropdown de permissões, selecione Can use e, em seguida, selecione Add.

Conceder acesso às tabelas de origem

Conceda ao service principal acesso de leitura ao catálogo, esquema e tabelas que você configurou na Etapa 1.1. Use o application ID do service principal (o mesmo valor que o client ID) como destinatário.

GRANT USE CATALOG ON CATALOG `BRAZE-CLOUD-PRODUCTION` TO `APPLICATION_ID`;
GRANT USE SCHEMA ON SCHEMA `BRAZE-CLOUD-PRODUCTION`.INGESTION TO `APPLICATION_ID`;
GRANT SELECT ON TABLE `BRAZE-CLOUD-PRODUCTION`.INGESTION.USERS_ATTRIBUTES_SYNC TO `APPLICATION_ID`;

Substitua APPLICATION_ID pelo application ID do seu service principal. Atualize os outros nomes conforme necessário, mas as permissões devem corresponder ao exemplo anterior.

Atualizar o client secret

A Braze armazena um client secret por credencial. Quando você o atualiza, toda fonte e sincronização que usa a credencial muda para o novo secret. Para substituir o secret:

No Databricks, gere um novo secret para o service principal seguindo as etapas em Gerar um client secret. Mantenha o secret antigo até a etapa 6.
No dashboard da Braze, acesse Data Settings > Cloud Data Ingestion > Credentials e, em seguida, selecione sua credencial OAuth M2M. A seção Used by lista todas as fontes e sincronizações que usam esta credencial.
Pause as sincronizações que usam esta credencial, ou planeje a atualização para um horário em que nenhuma delas esteja programada para execução. Isso evita que uma sincronização inicie enquanto você atualiza a credencial.
Selecione Edit credential, insira o novo client secret e, em seguida, selecione Save. A alteração se aplica a todas as fontes e sincronizações que usam esta credencial.
Retome as sincronizações que você pausou.
Após a Braze salvar o novo secret, exclua o secret antigo no Databricks.

Para a Braze acessar o Databricks, um token de acesso pessoal precisa ser criado.

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 dropdown.
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 limite, deixando a caixa Lifetime (days) vazia (em branco).
Selecione Generate.
Copie o token exibido e, em seguida, selecione Done.

Guarde o token em um lugar seguro até precisar 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, é necessário conceder à Braze acesso de rede à sua instância do Databricks. Permita 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
3.34.212.92
54.116.134.231
3.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 only como 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.

Nota

O Azure não permite vencimento ilimitado 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

Todos os recursos do Fabric que você deseja conectar à Braze devem ser colocados em um espaço de trabalho compartilhado. Se você só tem usado 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, em seguida, selecione Apply.

Depois de 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 se você ativou a configuração Service principals can use Fabric APIs na Etapa 1.2.
No dropdown 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 pela 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 dentro do espaço de trabalho compartilhado da Etapa 1.3. Acesse Create > Data Warehouse > Warehouse no console do Fabric.

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

UPDATED_AT — A hora em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza linhas em que UPDATED_AT é posterior ao último valor sincronizado. Linhas no exato timestamp 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 de Cloud Data Ingestion. 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 é 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 vários perfis com o mesmo número de telefone, o perfil atualizado mais recentemente é priorizado para 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 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.

A página "Fabric Console" no Microsoft Azure, onde os usuários devem obter a 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 permitir tráfego da Braze. Para saber mais sobre como habilitar isso, consulte a documentação relevante sobre Entra Conditional Access.

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
3.34.212.92
54.116.134.231
3.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ções do Snowflake, depois 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 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 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ções, clique em Save credentials, 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 informações adicionais sobre como fazer isso, consulte a documentação do Snowflake. Se quiser rotacionar as chaves em qualquer momento, a Braze pode gerar um novo par de chaves e fornecer a nova chave pública.

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ções do Redshift. Se estiver usando um túnel de rede privada, ative o controle deslizante e insira as informações do túnel. Depois, prossiga para a próxima etapa.

Nota

No dashboard da Braze, o campo Database name aceita apenas letras (A–Z, a–z), números (0–9) e underscores (_), 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. Após o sucesso, finalize as configurações restantes e clique em Connect to Source. Se a conexão falhar, uma mensagem de erro aparece 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 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:

Verifique as configurações da fonte na Braze, incluindo endpoint do cluster, banco de dados, esquema 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 ativas de snapshot, restauração, redimensionamento ou replicação.
Se o problema persistir, consulte uma view materializada em vez de uma tabela base que muda frequentemente.

Uma view materializada 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 views materializadas no Amazon Redshift.

Exemplo:

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 view materializada, use o nome da view materializada 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

Insira um nome para sua fonte e, em seguida, insira suas credenciais e configurações do BigQuery:

Em Credential name, insira um rótulo que ajude a identificar essas credenciais na Braze.
Para o método de autenticação, selecione Workload Identity Federation ou Service Account Key para corresponder às credenciais que você criou na Etapa 1.2.
Para Workload Identity Federation, copie o Braze principal ARN para sua configuração do Google Cloud e, em seguida, insira o Project number, Workload identity pool ID, Provider ID e Service account email. Para uma chave de conta de serviço, envie a chave JSON.

Em seguida, insira os campos de configuração restantes.

Etapa 2.2: Testar a conexão e conectar à fonte

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

Insira um nome para sua fonte e, em seguida, insira suas credenciais e configurações do Databricks:

Em Credential name, insira um rótulo que ajude a identificar essas credenciais na Braze.
Em Authentication method, selecione OAuth M2M ou Personal Access Token para corresponder às credenciais que você criou na Etapa 1.2.
Para OAuth M2M, insira o Client ID e o Client secret do seu service principal. Para um token de acesso pessoal, insira o Access token.

Em seguida, prossiga para a próxima etapa.

Etapa 2.2: Testar a conexão e conectar à fonte

Nota

Você deve testar uma fonte com sucesso antes de criá-la. Se fechar a página de criação, sua fonte não é 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 Cloud Data Ingestion

Escolha um nome para sua fonte e insira suas credenciais e configurações 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

Nota

Você deve testar uma fonte com sucesso antes de criá-la. Se fechar a página de criação, sua fonte não é 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 definir seus dados

Insira um nome para sua sincronização. Em seguida, selecione uma fonte ativa e um tipo de dados de sincronização. Depois, selecione Visual ou Table e insira sua tabela de origem, ou selecione SQL para escrever uma consulta SQL personalizada. Por fim, selecione Preview and validate.

Após a validação ser bem-sucedida, uma prévia dos dados aparece. Selecione Next: Notifications para continuar. Se a validação falhar, uma mensagem de erro aparece para ajudar a solucionar o problema.

Nota

Você deve validar uma sincronização com sucesso antes de prosseguir para as próximas etapas. Se precisar sair da página de criação de sincronização, selecione Save as draft para manter seu trabalho em progresso.

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

Insira e-mail(s) de contato para notificações de erro 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 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
O nível do catálogo está sem espaço (somente sincronizações de catálogo)

Etapa 3.3: Agendamento

Por fim, configure sua sincronização como não recorrente ou recorrente.

Sincronizações não recorrentes são executadas apenas quando você seleciona Sync Now no dashboard ou chama o endpoint Disparar uma sincronização.

Sincronizações recorrentes podem ser executadas a cada 5 minutos ou tão raramente quanto uma vez por mês. Por padrão, o menor intervalo que você pode configurar no dashboard é de 15 minutos, o que ajuda a gerenciar os custos de computação do seu warehouse e o volume de requisições. Para sincronizar a cada 5 minutos, entre em contato com o suporte da Braze ou seu gerente de sucesso do cliente. A Braze agenda sincronizações recorrentes em UTC.

Etapa 3.1: Configurar os detalhes da sincronização e definir seus dados

Nota

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

Esses problemas podem incluir:

Problemas de conectividade
Falta de recursos
Problemas de permissões
O nível do catálogo está sem espaço (somente sincronizações de catálogo)

Etapa 3.3: Agendamento

Por fim, configure sua sincronização como não recorrente ou recorrente.

Sincronizações não recorrentes são executadas apenas quando você seleciona Sync Now no dashboard ou chama o endpoint Disparar uma sincronização.

Etapa 3.1: Configurar os detalhes da sincronização e definir seus dados

Nota

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

Problemas de conectividade
Falta de recursos
Problemas de permissões
O nível do catálogo está sem espaço (somente sincronizações de catálogo)

Etapa 3.3: Agendamento

Por fim, configure sua sincronização como não recorrente ou recorrente.

Sincronizações não recorrentes são executadas apenas quando você seleciona Sync Now no dashboard ou chama o endpoint Disparar uma sincronização.

Etapa 3.1: Configurar os detalhes da sincronização e definir seus dados

Nota

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

Esses problemas podem incluir:

Problemas de conectividade
Falta de recursos
Problemas de permissões
O nível do catálogo está sem espaço (somente sincronizações de catálogo)

Etapa 3.3: Agendamento

Por fim, configure sua sincronização como não recorrente ou recorrente.

Sincronizações não recorrentes são executadas apenas quando você seleciona Sync Now no dashboard ou chama o endpoint Disparar uma sincronização.

Etapa 3.1: Configurar os detalhes da sincronização e definir seus dados

Nota

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

Esses problemas podem incluir:

Problemas de conectividade
Falta de recursos
Problemas de permissões
O nível do catálogo está sem espaço (somente sincronizações de catálogo)

Etapa 3.3: Agendamento

Por fim, configure sua sincronização como não recorrente ou recorrente.

Sincronizações não recorrentes são executadas apenas quando você seleciona Sync Now no dashboard ou chama o endpoint Disparar uma sincronização.

Nota

Você deve validar uma integração com sucesso antes que ela possa mudar 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 validar.

Configurar integrações ou usuários adicionais (opcional)

Você pode configurar várias integrações com a Braze. Ao criar sincronizações adicionais, é possível 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 é necessário adicionar a chave pública novamente.

Você pode configurar várias integrações com a Braze. Ao criar sincronizações adicionais, é possível reutilizar credenciais existentes se estiver se conectando à mesma conta 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. Ao criar sincronizações adicionais, é possível 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. Ao criar sincronizações adicionais, é possível 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. Ao criar sincronizações adicionais, é possível 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 ou buscar os dados mais recentes, selecione Sync Now. Essa execução não afeta as sincronizações futuras programadas regularmente. Para iniciar uma sincronização automaticamente quando seus dados forem atualizados, chame o endpoint Trigger a sync a partir do seu pipeline.

New Stuff!