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.

Fontes conectadas

As fontes conectadas são uma alternativa de cópia zero à sincronização direta de dados com o recurso de Ingestão de Dados na Nuvem (CDI) da Braze. Uma fonte conectada consulta diretamente seu data warehouse para criar novos segmentos sem copiar nenhum dos dados subjacentes para a Braze.

Depois de adicionar uma fonte conectada ao seu espaço de trabalho da Braze, você pode criar um Segment CDI dentro das extensões de segmento. As extensões de segmento CDI permitem que você escreva SQL que consulta diretamente seu data warehouse (usando os dados disponibilizados por meio da sua fonte conectada CDI). Assim, você cria e mantém um grupo de usuários que podem ser direcionados dentro da Braze.

Para saber mais sobre como criar um Segment com essa fonte, consulte Extensões de segmento CDI.

Aviso

Como as fontes conectadas são executadas diretamente no seu data warehouse, você arcará com todos os custos associados à execução dessas consultas no seu data warehouse. As fontes conectadas não registram pontos de dados, e as extensões de segmento CDI não consomem créditos de Segment SQL.

Integração de fontes conectadas

Etapa 1: Conecte seus recursos

As fontes conectadas da ingestão de dados na nuvem exigem algumas configurações na Braze e na sua instância. Siga estas etapas para configurar a integração−algumas etapas serão feitas no seu data warehouse e outras no dashboard da Braze.

No seu data warehouse

Crie uma função e conceda permissões para consultar e criar tabelas em um esquema.
Configure seu warehouse e dê acesso a essa função.
Crie um usuário para essa função com Workload Identity Federation ou um par de chaves RSA.
Dependendo da sua configuração, talvez seja necessário permitir os IPs da Braze na política de rede do Snowflake.

No dashboard da Braze

Crie uma nova fonte conectada no dashboard da Braze.
Defina os detalhes de sincronização da fonte conectada.
Para um par de chaves RSA, recupere a chave pública. Para Workload Identity Federation, copie a instrução do formulário de credencial.

No seu data warehouse

Para um par de chaves RSA, anexe a chave pública ao usuário do Snowflake para autenticação. Para Workload Identity Federation, execute a instrução em uma planilha do Snowflake. Quando terminar, você poderá usar a fonte conectada para criar uma ou mais extensões de segmento CDI.

Configure os dados de origem e os recursos necessários no seu ambiente Redshift.
Crie uma nova fonte conectada no dashboard da Braze.
Teste a integração.
Use a fonte conectada para criar uma ou mais extensões de segmento CDI.

Configure os dados de origem e os recursos necessários no seu ambiente BigQuery.
Crie uma conta de serviço que a Braze acesse por meio de Workload Identity Federation ou de uma chave de conta de serviço, e permita o acesso aos projetos e conjuntos de dados do BigQuery que contêm os dados que você deseja sincronizar.
Crie uma nova fonte conectada no dashboard da Braze.
Teste a integração.
Use a fonte conectada para criar uma ou mais extensões de segmento CDI.

Configure os dados de origem e os recursos necessários no seu ambiente Databricks.
Crie uma entidade de serviço para autenticação OAuth máquina a máquina (M2M) ou um token de acesso pessoal, e permita o acesso aos catálogos e esquemas do Databricks que contêm os dados que você deseja sincronizar.
Crie uma nova fonte conectada no dashboard da Braze.
Teste a integração.
Use a fonte conectada para criar uma ou mais extensões de segmento CDI.

Importante

Pode haver um tempo de aquecimento de dois a cinco minutos quando a Braze se conecta a instâncias SQL Classic e Pro, o que causa atrasos durante a configuração e o teste da conexão, bem como durante a criação e a atualização da extensão de segmento CDI. Usar uma instância SQL sem servidor minimiza o tempo de aquecimento e melhora a taxa de transferência das consultas, mas pode resultar em custos de integração um pouco mais altos.

Crie uma entidade de serviço e permita o acesso ao espaço de trabalho do Fabric que será usado na sua integração.
No seu espaço de trabalho do Fabric, configure os dados de origem e conceda permissões à sua entidade de serviço
Crie uma nova fonte conectada no dashboard da Braze.
Teste a integração.
Use a fonte conectada para criar uma ou mais extensões de segmento CDI.

Etapa 2: Configure seu data warehouse

Configure os dados de origem e os recursos necessários no ambiente do seu data warehouse. A fonte conectada pode fazer referência a uma ou mais tabelas, então confira se o seu usuário da Braze tem permissão para acessar todas as tabelas que você quer na fonte conectada.

Etapa 2.1: Crie uma função e conceda permissões

Crie uma função para a sua fonte conectada usar. Essa função será usada para gerar a lista de tabelas disponíveis nas suas extensões de segmento CDI e para consultar as tabelas de origem para criar novos segmentos. Depois que a fonte conectada for criada, a Braze descobrirá os nomes e as descrições de todas as tabelas disponíveis para o usuário no esquema de origem.

A permissão create table é necessária para que a Braze possa criar uma tabela com os resultados da consulta da sua extensão de segmento CDI antes de atualizar o segmento na Braze. A Braze criará uma tabela temporária por segmento, e a tabela só existirá enquanto a Braze estiver atualizando o segmento.

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 CREATE TABLE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

-- grant access to all current and future tables or views in the schema
GRANT SELECT ON ALL TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON FUTURE TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

-- grant access to specific tables or views in the schema
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;

Etapa 2.2: Configure o warehouse e dê acesso à função da Braze

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

Nota

O warehouse precisa estar com o sinalizador auto-resume ativado. Caso contrário, você precisará conceder à Braze privilégios OPERATE adicionais no warehouse para que a Braze possa ativá-lo quando for a hora de executar a consulta.

Etapa 2.3: Configure o usuário

A Braze se autentica no Snowflake com Workload Identity Federation ou um par de chaves RSA. As credenciais existentes de par de chaves RSA continuam funcionando, e você não precisa migrá-las. Siga um dos métodos.

workload identity federation
key pair

Use as concessões de função e de warehouse da Etapa 2.1 e da Etapa 2.2. Se a sua conta do Snowflake usar uma política de rede, permita os endereços IP da Braze conforme descrito na Etapa 2.4.

Crie o usuário de serviço a partir do formulário de credencial do Snowflake e execute essa instrução em uma planilha do Snowflake. Para saber o que a instrução faz e onde executá-la, consulte Configuração do Snowflake para Workload Identity Federation.

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Você compartilhará as informações de conexão com a Braze e receberá uma chave pública para anexar ao usuário em uma etapa posterior.

Nota

Ao conectar diferentes espaços de trabalho à mesma conta do Snowflake, você deve criar um usuário exclusivo para cada espaço de trabalho da Braze em que estiver criando uma integração. Dentro de um espaço de trabalho, você pode reutilizar o mesmo usuário em várias integrações, mas a criação da integração falhará se um usuário da mesma conta do Snowflake for duplicado entre espaços de trabalho.

Etapa 2.4: Permita os IPs da Braze na sua política de rede do Snowflake (opcional)

Dependendo da configuração da sua conta do Snowflake, talvez seja necessário permitir os seguintes endereços IP na sua política de rede do Snowflake. Para saber mais sobre como fazer isso, consulte a documentação 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 2.1: Crie o usuário e conceda permissões

CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT CREATE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;

Crie um usuário para a sua fonte conectada usar. Esse usuário será usado para gerar a lista de tabelas disponíveis nas suas extensões de segmento CDI e para consultar as tabelas de origem para criar novos segmentos. Depois que a fonte conectada for criada, a Braze descobrirá os nomes e as descrições de todas as tabelas disponíveis para o usuário no esquema de origem. Se você for criar várias integrações CDI, pode ser útil conceder permissões a um esquema ou gerenciar as permissões usando um grupo.

Você pode conceder acesso a todas as tabelas de um esquema ou conceder privilégios apenas a tabelas específicas. As tabelas às quais a função da Braze tiver acesso ficarão disponíveis para consulta na extensão de segmento CDI. Não se esqueça de conceder ao usuário acesso a novas tabelas quando elas forem criadas, ou defina permissões padrão para o usuário.

A permissão create table é necessária para que a Braze possa criar uma tabela com os resultados da consulta da sua extensão de segmento CDI antes de atualizar o segmento na Braze. A Braze criará uma tabela temporária por segmento, que só existirá enquanto a Braze atualiza o segmento.

Etapa 2.2: Permita o acesso aos IPs da Braze

Se você tiver um firewall ou outras políticas de rede, deverá conceder à Braze acesso de rede à sua instância do Redshift. Permita o acesso a partir dos seguintes IPs correspondentes à região do seu dashboard da Braze.

Talvez também seja necessário alterar seus grupos de segurança para permitir que a Braze acesse seus dados no Redshift. Permita explicitamente o tráfego de entrada nos IPs da seção a seguir e na porta usada para consultar seu cluster do Redshift (o padrão é 5439). Você deve permitir explicitamente a conectividade TCP do Redshift nessa porta, mesmo que as regras de entrada estejam definidas como “permitir tudo”. Além disso, é importante que o endpoint do cluster do Redshift esteja acessível publicamente para que a Braze possa se conectar ao seu cluster.

Se não quiser que seu cluster do Redshift fique acessível publicamente, você pode configurar uma VPC e uma instância EC2 para usar um túnel SSH e acessar os dados do Redshift. Para saber mais, consulte AWS: Como faço para acessar um cluster privado do Amazon Redshift a partir da minha máquina local?

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.1: Crie credenciais para a Braze

Crie uma conta de serviço no GCP para a Braze usar para se conectar e ler dados das suas tabelas. A conta de serviço deve ter as permissões da seção a seguir:

BigQuery Connection User: Permite que a Braze faça conexões.
BigQuery User: Concede à Braze acesso para executar consultas, ler metadados de conjuntos de dados e listar tabelas.
BigQuery Data Viewer: Concede à Braze acesso para visualizar conjuntos de dados e seu conteúdo.
BigQuery Job User: Concede à Braze acesso para executar jobs.
bigquery.tables.create Concede à Braze acesso para criar tabelas temporárias durante a atualização de segmentos.

Crie uma conta de serviço para a sua fonte conectada usar. Esse usuário será usado para gerar a lista de tabelas disponíveis nas suas extensões de segmento CDI e para consultar as tabelas de origem para criar novos segmentos. Depois que a fonte conectada for criada, a Braze descobrirá os nomes e as descrições de todas as tabelas disponíveis para o usuário no esquema de origem.

Você pode conceder acesso a todas as tabelas de um conjunto de dados ou conceder privilégios apenas a tabelas específicas. As tabelas às quais a função da Braze tiver acesso ficarão disponíveis para consulta na extensão de segmento CDI.

A Braze pode acessar a conta de serviço com Workload Identity Federation ou uma chave de conta de serviço. As credenciais existentes de chave de conta de serviço continuam funcionando, e você não precisa migrá-las. Uma única credencial de Workload Identity Federation pode atender tanto a fontes do BigQuery quanto do Google Cloud Storage.

workload identity federation
service account key

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

Depois de criar a conta de serviço e conceder as permissões, gere uma chave JSON. Para saber mais, consulte Google Cloud: Criar e excluir chaves de conta de serviço. Você fará o upload dela no dashboard da Braze mais tarde.

Etapa 2.2: Permita o acesso aos IPs da Braze

Se você tiver políticas de rede em vigor, deverá conceder à Braze acesso de rede à sua instância do BigQuery. Permita o acesso a partir 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 2.1: Crie credenciais para a Braze

A Braze pode se conectar ao Databricks usando OAuth máquina a máquina (M2M) com uma entidade de serviço ou com um token de acesso pessoal. A Braze recomenda o OAuth M2M. As credenciais existentes de token de acesso pessoal continuam funcionando, e você não precisa migrá-las.

Seja qual for o método escolhido, a Braze usa essas credenciais para gerar a lista de tabelas disponíveis nas suas extensões de segmento CDI e para consultar as tabelas de origem para criar novos segmentos. Depois que a fonte conectada é criada, a Braze descobre os nomes e as descrições de todas as tabelas disponíveis para o usuário no esquema de origem.

Você pode conceder acesso a todas as tabelas de um esquema ou conceder privilégios apenas a tabelas específicas. As tabelas às quais a função da Braze tiver acesso ficam disponíveis para consulta na extensão de segmento CDI.

A permissão CREATE TABLE é necessária para que a Braze possa criar uma tabela com os resultados da consulta da sua extensão de segmento CDI antes de atualizar o segmento na Braze. A Braze cria uma tabela temporária por segmento, que existe apenas enquanto a Braze atualiza o segmento.

oauth m2m
personal access token

Crie uma entidade de serviço, gere um segredo do cliente e conceda à entidade de serviço a permissão Can use no seu SQL warehouse. Para ver as etapas, consulte Criar credenciais para a Braze.
Conceda à entidade de serviço acesso ao esquema usado para a fonte conectada, incluindo CREATE TABLE. Use o ID do aplicativo da entidade de serviço (o mesmo valor do ID do cliente) como beneficiário da concessão.

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

Substitua APPLICATION_ID pelo ID do aplicativo da sua entidade de serviço.

Guarde o ID do cliente e o segredo em um local seguro até precisar inseri-los no dashboard da Braze durante a etapa de criação da credencial.

No seu espaço de trabalho do Databricks, selecione seu nome de usuário do Databricks na barra superior e depois selecione User Settings no menu suspenso.
Confira se a conta de serviço tem privilégios CREATE TABLE no esquema usado para a fonte conectada.
Na guia Access tokens, selecione Generate new token.
Insira um comentário que ajude a identificar esse token, como “Braze CDI”, e altere o tempo de vida do token para sem tempo de vida, deixando a caixa Lifetime (days) vazia (em branco).
Selecione Generate.
Copie o token exibido e depois selecione Done.

Guarde o token em um local seguro até precisar inseri-lo no dashboard da Braze durante a etapa de criação da credencial.

Etapa 2.2: Permita o acesso aos IPs da Braze

Se você tiver políticas de rede em vigor, deverá conceder à Braze acesso de rede à sua instância do Databricks. Permita o acesso a partir 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 2.1: Conceda acesso aos recursos do Fabric

A Braze se conectará ao seu warehouse do Fabric usando uma entidade de serviço com autenticação do Entra ID. Você criará uma nova entidade de serviço para a Braze usar e concederá acesso aos recursos do Fabric conforme necessário. A Braze precisará 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 para segredos de entidades de serviço. Lembre-se de atualizar as credenciais antes que elas vençam para manter o fluxo de dados para a Braze.

Etapa 2.2: Conceda acesso aos recursos do Fabric

Você concederá acesso para que a Braze se conecte à sua instância do Fabric. No portal de administração do Fabric, acesse 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 a entidade de serviço possa acessar dados a partir de um app externo.

Etapa 2.3: Obtenha a string de conexão do warehouse

Você precisará do endpoint SQL do seu warehouse para que a Braze possa se conectar. Para recuperar o endpoint SQL, acesse o espaço de trabalho no Fabric e, na lista de itens, passe o mouse sobre o nome do warehouse e selecione Copy SQL connection string. Mantenha esse valor disponível para a configuração da credencial na Etapa 3.

Etapa 2.4: Permita os IPs da Braze no firewall (opcional)

Dependendo da configuração da sua conta do Microsoft Fabric, talvez seja necessário permitir os seguintes endereços IP no seu firewall para liberar o tráfego da Braze. Para saber mais sobre como ativar isso, consulte a documentação 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
3.34.212.92
54.116.134.231
3.37.197.225

Etapa 3: Crie uma fonte conectada no dashboard da Braze

Etapa 3.1: Adicione as informações de conexão do Snowflake e a tabela de origem

Crie uma fonte conectada no dashboard da Braze. Acesse Configurações de dados > Ingestão de dados na nuvem > Fontes conectadas, selecione Adicionar fonte de dados e depois selecione Snowflake.

Em Configurar fonte, insira o seguinte:

Nome da credencial e o método de autenticação, Workload Identity Federation ou Par de chaves
Credenciais: Localizador da conta, Nome de usuário e Função
Configuração: Warehouse, Banco de dados e Esquema

Para Workload Identity Federation, selecione Copiar instrução, execute-a em uma planilha do Snowflake e depois selecione Salvar credencial. Para um par de chaves, selecione Salvar credenciais e gerar chave RSA antes de testar a conexão.

Etapa 3.2: Defina os detalhes de sincronização

Escolha um nome para a fonte conectada. Esse nome será usado na lista de fontes disponíveis quando você criar uma nova extensão de segmento CDI.

Defina um tempo de execução máximo para essa fonte. A Braze interromperá automaticamente qualquer consulta que exceda o tempo de execução máximo. O tempo de execução máximo permitido é de 60 minutos; um tempo de execução menor reduz os custos incorridos na sua conta do Snowflake. Essa configuração se aplica às consultas executadas por meio dessa fonte, incluindo sincronizações e extensões de segmento CDI que a utilizam.

Nota

Se as consultas atingirem o tempo limite com frequência e você tiver definido um tempo de execução máximo de 60 minutos, considere otimizar o tempo de execução das consultas ou dedicar um warehouse maior ao usuário da Braze.

Etapa 3.3: Anote a chave pública (par de chaves)

Na etapa Testar conexão, anote a chave pública RSA. Você vai precisar dela para concluir a integração no Snowflake.

Etapa 3.1: Adicione as informações de conexão do Redshift e a tabela de origem

Em Configurar fonte, insira o seguinte:

Credenciais: URL do host do Redshift, Nome de usuário, Senha e Porta
Configuração: Banco de dados e Esquema

Se necessário, ative Conectar com túnel SSH e insira Host do túnel, Porta do túnel e Nome de usuário do túnel.

Etapa 3.2: Defina os detalhes de sincronização

Escolha um nome para a fonte conectada. Esse nome será usado na lista de fontes disponíveis quando você criar uma nova extensão de segmento CDI.

Defina um tempo de execução máximo para essa fonte. A Braze interromperá automaticamente qualquer consulta que exceda o tempo de execução máximo. O tempo de execução máximo permitido é de 60 minutos; um tempo de execução menor reduz os custos incorridos na sua conta do Redshift. Essa configuração se aplica às consultas executadas por meio dessa fonte, incluindo sincronizações e extensões de segmento CDI que a utilizam.

Nota

Etapa 3.3: Anote a chave pública (opcional)

Se as suas credenciais estiverem com Conectar com túnel SSH selecionado, anote a chave pública RSA na etapa Testar conexão. Você vai precisar dela para concluir a integração no Redshift.

Etapa 3.1: Adicione as informações de conexão do BigQuery e a tabela de origem

Em Configurar fonte, insira o seguinte:

Credenciais: Nome da credencial e método de autenticação, além de Número do projeto, ID do pool de identidades de carga de trabalho, ID do provedor e E-mail da conta de serviço (Workload Identity Federation) ou a Chave JSON que você enviou (chave de conta de serviço)
Configuração: Projeto e Conjunto de dados

Etapa 3.2: Defina os detalhes de sincronização

Escolha um nome para a fonte conectada. Esse nome será usado na lista de fontes disponíveis quando você criar uma nova extensão de segmento CDI.

Defina um tempo de execução máximo para essa fonte. A Braze interromperá automaticamente qualquer consulta que exceda o tempo de execução máximo. O tempo de execução máximo permitido é de 60 minutos; um tempo de execução menor reduz os custos incorridos na sua conta do BigQuery. Essa configuração se aplica às consultas executadas por meio dessa fonte, incluindo sincronizações e extensões de segmento CDI que a utilizam.

Nota

Etapa 3.3: Teste a conexão

Selecione Testar conexão para verificar se a lista de tabelas visíveis para o usuário é a esperada e depois selecione Concluído. Sua fonte conectada agora está criada e pronta para uso em extensões de segmento CDI.

Etapa 3.1: Adicione as informações de conexão do Databricks e a tabela de origem

Em Configurar fonte, insira o seguinte:

Credenciais: Nome da credencial, Método de autenticação, Nome do host e Caminho HTTP, além de ID do cliente e Segredo do cliente (OAuth M2M) ou Token de acesso (token de acesso pessoal)
Configuração: Catálogo e Esquema

Etapa 3.2: Defina os detalhes de sincronização

Escolha um nome para a fonte conectada. Esse nome será usado na lista de fontes disponíveis quando você criar uma nova extensão de segmento CDI.

Defina um tempo de execução máximo para essa fonte. A Braze interromperá automaticamente qualquer consulta que exceda o tempo de execução máximo. O tempo de execução máximo permitido é de 60 minutos; um tempo de execução menor reduz os custos incorridos na sua conta do Databricks. Essa configuração se aplica às consultas executadas por meio dessa fonte, incluindo sincronizações e extensões de segmento CDI que a utilizam.

Nota

Etapa 3.3: Teste a conexão

Etapa 3.1: Adicione as informações de conexão do Microsoft Fabric e a tabela de origem

Em Configurar fonte, insira o seguinte:

Credenciais: Nome das credenciais, ID do locatário, ID da entidade, Segredo do cliente e String de conexão
Configuração: Banco de dados e Esquema

Se Conectar com túnel SSH estiver disponível no seu espaço de trabalho e for necessário para a sua configuração, insira também Host do túnel, Porta do túnel e Nome de usuário do túnel.

Etapa 3.2: Defina os detalhes de sincronização

Escolha um nome para a fonte conectada. Esse nome será usado na lista de fontes disponíveis quando você criar uma nova extensão de segmento CDI.

Defina um tempo de execução máximo para essa fonte. A Braze interromperá automaticamente qualquer consulta que exceda o tempo de execução máximo. O tempo de execução máximo permitido é de 60 minutos; um tempo de execução menor reduz os custos incorridos na sua conta do Microsoft Fabric. Essa configuração se aplica às consultas executadas por meio dessa fonte, incluindo sincronizações e extensões de segmento CDI que a utilizam.

Nota

Se as consultas atingirem o tempo limite com frequência e você tiver definido um tempo de execução máximo de 60 minutos, considere otimizar o tempo de execução das consultas ou aumentar a capacidade do Fabric.

Etapa 3.3: Teste a conexão

Etapa 4: Finalize a configuração do data warehouse

workload identity federation
key pair

Você executou a instrução do formulário de credencial em uma etapa anterior. Selecione Testar conexão na Braze e depois selecione Concluído. Sua fonte conectada agora está criada e pronta para uso em extensões de segmento CDI.

Adicione a chave pública que você anotou na etapa anterior ao seu usuário no Snowflake. Isso permite que a Braze se conecte ao Snowflake. Para mais detalhes, consulte Autenticação por par de chaves do Snowflake.

ALTER USER BRAZE_INGESTION_USER SET rsa_public_key='{INSERT_YOUR_KEY}';

Para fazer a rotação da chave posteriormente, acesse Configurações de dados > Ingestão de dados na nuvem > Credenciais, abra a credencial em Credenciais de acesso a dados do Snowflake e selecione Rotacionar credencial. Para ver o modal de detalhes, consulte Revisar uma credencial do Snowflake.

Depois de adicionar a chave ao usuário no Snowflake, selecione Testar conexão na Braze e depois selecione Concluído. Sua fonte conectada agora está criada e pronta para uso em extensões de segmento CDI.

Se estiver se conectando com um túnel SSH, adicione a chave pública que você anotou na etapa anterior ao usuário do túnel SSH.

Depois de adicionar a chave ao usuário, selecione Testar conexão na Braze e depois selecione Concluído. Sua fonte conectada agora está criada e pronta para uso em extensões de segmento CDI.

Isso não se aplica ao BigQuery.

Isso não se aplica ao Databricks.

Isso não se aplica ao Microsoft Fabric.

Nota

Você precisa testar uma fonte com sucesso antes que ela possa passar do estado “rascunho” para o estado “ativo”. Se precisar fechar a página de criação, sua integração será salva, e você poderá voltar à página de detalhes para fazer alterações e testar.

Configuração de 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 se conectar a um esquema diferente. Ao criar conexões adicionais, você pode reutilizar as credenciais existentes se estiver se conectando à mesma conta Snowflake.

Se você reutilizar o mesmo usuário e a mesma função de par de chaves em várias integrações, não precisa adicionar a chave pública novamente. Uma credencial de Workload Identity Federation não tem chave pública para adicionar.

Você pode configurar várias fontes com a Braze, mas cada fonte deve ser configurada para se conectar a um esquema diferente. Ao criar fontes adicionais, você pode reutilizar as credenciais existentes se estiver se conectando à mesma conta Redshift.

Você pode configurar várias fontes com a Braze, mas cada fonte deve ser configurada para se conectar a um conjunto de dados diferente. Ao criar fontes adicionais, você pode reutilizar as credenciais existentes se estiver se conectando à mesma conta BigQuery.

Usando a fonte conectada

Depois que a fonte for criada, você poderá usá-la para criar uma ou mais extensões de segmento CDI. Para saber mais sobre como criar um segmento com essa fonte, consulte a documentação de extensões de segmento CDI.

Nota

Se as consultas estiverem expirando com frequência e você tiver definido um tempo máximo de execução de 60 minutos, tente otimizar o tempo de execução da consulta ou dedicar mais recursos de computação (como um warehouse maior) ao usuário da Braze.

New Stuff!