Fontes conectadas

Em seu data warehouse

1. Criar uma função e conceder permissões para consultar e criar tabelas em um esquema.
2. Configure seu depósito e conceda acesso a essa função.
3. Crie um usuário para essa função.
4. Dependendo de sua configuração, talvez seja necessário permitir IPs da Braze em sua política de rede do Snowflake.

No dashboard do Braze

5. Crie uma nova fonte conectada no dashboard do Braze. 6. Configure os detalhes de sincronização para a fonte conectada. 7. Recupere a chave pública fornecida no dashboard do Braze.

Em seu data warehouse

8. Anexe a chave pública do dashboard da Braze ao usuário do Snowflake para autenticação. Quando terminar, você poderá usar a fonte conectada para criar um ou mais segmentos de CDI.

Etapa 2.1: Criar uma função e conceder permissões

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

Você pode optar por conceder acesso a todas as tabelas em um esquema ou conceder privilégios somente a tabelas específicas. Quaisquer tabelas às quais a função da Braze tenha acesso estarão disponíveis para consulta no segmento CDI.

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

1
2
3
4
5
6
7
8
9
10
11
12
13
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: Configurar warehouse e dar acesso à função na Braze

1
2
3
CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

Etapa 2.3: Configurar usuário

1
2
3
CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

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

Etapa 2.4: Permitir IPs do Braze em sua política de rede do Snowflake (opcional)

Dependendo da configuração de sua conta do Snowflake, talvez seja necessário permitir os seguintes endereços IP em sua política de rede do Snowflake. Para saber mais sobre como fazer isso, consulte a documentação relevante do Snowflake sobre a modificação de uma política de rede.

• united states (us)
• european union (eu)

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

Crie uma fonte conectada no dashboard do Braze. Acesse Configurações de dados > Ingestão de dados na nuvem > Fontes conectadas e selecione Criar nova sincronização de dados > Importação do Snowflake.

Insira as informações do data warehouse do Snowflake e do esquema de origem e prossiga para a próxima etapa.

Etapa 3.2: Configurar detalhes de sincronização

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

Configure um tempo máximo de execução para essa fonte. O Braze abortará automaticamente as consultas que excederem o tempo máximo de execução quando estiver criando ou atualizando um segmento. O tempo máximo de execução permitido é de 60 minutos; um tempo de execução menor reduzirá os custos incorridos em sua conta do Snowflake.

Etapa 3.3: Note a chave pública

Na etapa Testar conexão, observe a chave pública RSA. Você precisará dele para concluir a integração no Snowflake.

Adicione a chave pública que notou na última etapa ao seu usuário no Snowflake. Isso permitirá que a Braze se conecte ao Snowflake. Para obter detalhes sobre como fazer isso, consulte a documentação do Snowflake.

Se quiser girar as chaves a qualquer momento, você pode criar uma nova chave pública acessando o Gerenciamento de acesso a dados no Cloud Data Ingestion e selecionando Gerar nova chave para a respectiva conta.

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

Depois de adicionar a chave ao usuário no Snowflake, selecione Testar conexão no Braze e, em seguida, selecione Concluído. Sua fonte conectada agora está criada e pronta para ser usada nos segmentos CDI.

Você pode configurar várias integrações com o Braze, mas cada integração deve ser configurada para conectar um esquema diferente. Ao criar conexões adicionais, você pode reutilizar as credenciais existentes se estiver se conectando à mesma conta do Snowflake.

Se você reutilizar o mesmo usuário e função em todas as integrações, não precisará adicionar a chave pública novamente.