Ingestão de dados na nuvem para Amazon Redshift
Esta página aborda tudo o que você precisa para sincronizar dados do Amazon Redshift com a Braze usando a Ingestão de dados na nuvem (CDI): os recursos a serem criados no Redshift, como conectar a fonte e criar uma sincronização na Braze, a tabela de origem para cada tipo de dado e a solução de problemas específica do Redshift.
Visão geral da configuração
- Em sua instância do Redshift, configure as tabelas ou exibições que deseja sincronizar com a Braze.
- Escolha um dos métodos de autenticação compatíveis com a Braze e conceda ao usuário do banco de dados da Braze acesso às suas tabelas.
- Confira se a Braze tem permissão de acesso às tabelas do Redshift que você deseja sincronizar. A Braze se conecta ao Redshift pela internet.
- Crie uma nova fonte e uma nova sincronização no dashboard da Braze.
- Valide a integração e inicie a sincronização.

O número de linhas processadas por sincronização depende do desempenho do seu data warehouse, da latência da 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.
Etapa 1: Configure sua tabela de origem
As etapas desta seção criam uma tabela com uma coluna PAYLOAD. Se você preferir estruturar seus dados na etapa Definição de dados, pode usar uma tabela ou visualização existente. Nesse caso, pule a criação da tabela e conceda à Braze acesso de leitura às tabelas ou visualizações que deseja sincronizar. Para comparar as opções, consulte Escolha uma opção de definição de dados.
Você pode dar o nome que quiser ao banco de dados, ao esquema e à tabela, mas os nomes das colunas devem corresponder às definições das guias a seguir. Você também pode usar uma visualização ou uma visualização materializada em vez de uma tabela.
Se quiser, configure um novo banco de dados e um novo esquema para armazenar sua tabela de origem:
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

Se você usar uma coluna PAYLOAD, sua tabela ou visualização de origem pode incluir colunas que não aparecem nas guias a seguir (por exemplo, de auditoria ou hashing). A Braze lê apenas as colunas descritas nessas guias. As demais colunas não são usadas durante as sincronizações da ingestão de dados na nuvem.
Selecione a guia do tipo de dados que você deseja sincronizar.
Atributos do usuário, eventos personalizados e eventos de compra usam a mesma estrutura de tabela de origem. Só o conteúdo de PAYLOAD muda.
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)
)
UPDATED_AT- O horário em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. Linhas com o carimbo de data/hora exatamente no limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo carimbo de data/hora.- Colunas de identificador de usuário - Sua tabela pode conter uma ou mais colunas de identificador de usuário. Cada linha deve conter apenas um identificador (
external_id, a combinação dealias_nameealias_label,braze_id,emailouphone). Uma tabela de origem pode ter colunas para um, dois, três, quatro ou todos os cinco tipos de identificador.EXTERNAL_ID- Identifica o usuário que você deseja atualizar. Deve corresponder ao valor deexternal_idusado na Braze.ALIAS_NAMEeALIAS_LABEL- Essas duas colunas criam um objeto de alias de usuário.alias_namedeve ser um identificador exclusivo, ealias_labelespecifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas umalias_nameporalias_label.BRAZE_ID- O identificador de usuário da Braze. Ele é gerado pelo SDK da Braze. Não é possível criar novos usuários usando um Braze ID por meio da ingestão de dados na nuvem. Para criar novos usuários, especifique um ID de usuário externo ou um alias de usuário.EMAIL- O endereço de e-mail do usuário. Se existirem vários perfis com o mesmo endereço de e-mail, o perfil atualizado mais recentemente terá prioridade nas atualizações. Se você incluir tanto o e-mail quanto o telefone, o e-mail será usado como identificador principal.PHONE- O número de telefone do usuário. Se existirem vários perfis com o mesmo número de telefone, o perfil atualizado mais recentemente terá prioridade nas atualizações.
PAYLOAD- É uma string JSON com os campos que você deseja sincronizar com o usuário na Braze.
Para sincronizações de atributos, PAYLOAD segue o formato do objeto de atributos do usuário. Você pode incluir atributos personalizados aninhados, arrays de objetos e status de grupos de inscrições. Para ver exemplos de carga útil, consulte Configuração da tabela.
Eventos personalizados usam a mesma tabela de origem que os atributos do usuário. Crie a tabela mostrada na guia Atributos do usuário e preencha PAYLOAD com um objeto de eventos.
Para sincronizar eventos, é necessário informar o nome do evento. Formate o campo time como uma string ISO 8601 ou no formato yyyy-MM-dd'T'HH:mm:ss:SSSZ. Se o campo time não estiver presente, a Braze usa o valor da coluna UPDATED_AT como horário do evento. Os demais campos, incluindo app_id e properties, são opcionais.
Você pode sincronizar um evento por linha.
{
"app_id" : "your-app-id",
"name" : "rented_movie",
"time" : "2013-07-16T19:20:45+01:00",
"properties": {
"movie": "The Sad Egg",
"director": "Alex Smith"
}
}
Eventos de compra usam a mesma tabela de origem que os atributos do usuário. Crie a tabela mostrada na guia Atributos do usuário e preencha PAYLOAD com um objeto de compras.
Para sincronizar eventos de compra, é necessário informar product_id, currency e price. Formate o campo opcional time como uma string ISO 8601 ou no formato yyyy-MM-dd'T'HH:mm:ss:SSSZ. Se o campo time não estiver presente, a Braze usa o valor da coluna UPDATED_AT como horário do evento. Os demais campos, incluindo app_id, quantity e properties, são opcionais.
Você pode sincronizar um evento de compra por linha.
{
"app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
"product_id" : "Completed Order",
"currency" : "USD",
"price" : 219.98,
"time" : "2013-07-16T19:20:30+01:00",
"properties" : {
"products" : [ { "name": "Monitor", "category": "Gaming", "product_amount": 19.99 },
{ "name": "Gaming Keyboard", "category": "Gaming ", "product_amount": 199.99 }
]
}
}
Antes de criar uma sincronização de catálogo, crie o catálogo de destino na Braze. Para ver o fluxo completo de catálogos, consulte Sincronizar e excluir dados de catálogo.
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CATALOGS_SYNC (
updated_at timestamptz default sysdate not null,
--ID of the catalog item to be created or updated
id varchar not null,
--Catalog fields and values that should be added or updated
payload varchar(max),
--The catalog item associated with this ID should be deleted
deleted boolean
)
Conceda ao usuário da Braze acesso a esta tabela, junto com suas outras tabelas de origem:
GRANT SELECT ON TABLE CATALOGS_SYNC TO braze_user;
O nome da integração deve ser exatamente igual ao nome do catálogo que você criou na Braze.
A Braze recomenda criar uma visualização a partir dos dados do catálogo para que a tabela de origem seja totalmente atualizada a cada sincronização. Por exemplo, se você tem uma tabela de dados de produtos (product_catalog_1) com product_id e mais três atributos, pode sincronizar o seguinte:
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CATALOGS_SYNC AS
SELECT
CURRENT_TIMESTAMP as UPDATED_AT,
Product_id as id,
JSON_SERIALIZE(
OBJECT (
'attribute_1',
attribute_1,
'attribute_2',
attribute_2,
'attribute_3',
attribute_3)
) as PAYLOAD FROM "product_catalog_1";
Antes de criar uma sincronização de objetos de dados, crie o tipo de objeto de dados e seus campos na Braze. Para ver o fluxo completo, consulte Sincronizar objetos de dados.
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNTS_SYNC (
updated_at timestamptz default sysdate not null,
object_id varchar not null,
payload varchar(max) not null,
--the data object record associated with this object_id should be deleted
deleted boolean
)
| Nome do campo | Tipo | Modo |
|---|---|---|
UPDATED_AT |
timestamptz | REQUIRED |
OBJECT_ID |
varchar | REQUIRED |
PAYLOAD |
varchar(max) | REQUIRED |
DELETED |
boolean | NULLABLE |
UPDATED_AT- O horário em que essa linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. Linhas com o carimbo de data/hora exatamente no limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo carimbo de data/hora.OBJECT_ID- O identificador do registro do objeto de dados. Ele deve corresponder ao valor deobject_idusado na Braze para esse tipo de objeto de dados.PAYLOAD- Uma string JSON com os campos e valores a serem sincronizados. Cada chave deve corresponder a um campo definido no tipo de objeto de dados na Braze.DELETED- Quando fortrue, a Braze exclui o registro em vez de atualizá-lo. Deixe esse valor nulo ou comofalsenas linhas que você quer criar ou atualizar.
Os nomes dos campos dentro de PAYLOAD diferenciam maiúsculas de minúsculas. Uma chave chamada NAME não corresponde a um campo chamado name. Se as maiúsculas e minúsculas não corresponderem, a validação informa a chave como um campo indefinido e informa como ausente o campo que ela deveria preencher. Nomeie suas chaves exatamente como os campos aparecem em Configurações de dados > Objetos de dados.
A Braze não cria nem altera tipos de objetos de dados durante uma sincronização. Defina o tipo e todos os seus campos na Braze antes de criar a sincronização. Para adicionar um campo depois, adicione-o primeiro ao tipo e, em seguida, atualize sua tabela de origem ou sua consulta.
Por exemplo, um valor de PAYLOAD para uma conta com os campos name e team_id fica assim:
{"name": "Acme Corp", "team_id": 42}
Conceda ao usuário da Braze acesso a esta tabela:
GRANT SELECT ON TABLE ACCOUNTS_SYNC TO braze_user;
Na etapa Definição de dados, selecione o tipo de dados Objetos de dados e escolha o Tipo de objeto de dados. Sincronizações de objetos de dados aceitam Tabela e SQL.
Use esta sincronização para conectar usuários a registros de objetos de dados, como vincular usuários às contas a que pertencem. Crie o relacionamento na Braze antes de sincronizá-lo.
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNT_USERS_SYNC (
updated_at timestamptz default sysdate not null,
object_id varchar not null,
--at least one of external_id, alias_name and alias_label, email, or phone is required
external_id varchar,
--if using user alias, both alias_name and alias_label are required
alias_name varchar,
alias_label varchar,
email varchar,
phone varchar,
payload varchar(max),
deleted boolean
)
| Nome do campo | Tipo | Modo |
|---|---|---|
UPDATED_AT |
timestamptz | REQUIRED |
OBJECT_ID |
varchar | REQUIRED |
EXTERNAL_ID |
varchar | NULLABLE |
ALIAS_NAME |
varchar | NULLABLE |
ALIAS_LABEL |
varchar | NULLABLE |
EMAIL |
varchar | NULLABLE |
PHONE |
varchar | NULLABLE |
PAYLOAD |
varchar(max) | NULLABLE |
DELETED |
boolean | NULLABLE |
Cada linha precisa de OBJECT_ID e de pelo menos um identificador de usuário: EXTERNAL_ID, a combinação de ALIAS_NAME e ALIAS_LABEL, EMAIL ou PHONE. Use PAYLOAD para quaisquer campos definidos no próprio relacionamento.

Diferente das sincronizações de atributos do usuário, BRAZE_ID não é aceito em sincronizações de relacionamentos de usuários. Use um dos identificadores listados acima.
UPDATED_AT- O horário em que essa linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. Linhas com o carimbo de data/hora exatamente no limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo carimbo de data/hora.OBJECT_ID- O identificador do registro do objeto de dados. Ele deve corresponder ao valor deobject_idusado na Braze para esse tipo de objeto de dados.PAYLOAD- Uma string JSON com os campos e valores a serem sincronizados. Cada chave deve corresponder a um campo definido no tipo de objeto de dados na Braze.DELETED- Quando fortrue, a Braze exclui o registro em vez de atualizá-lo. Deixe esse valor nulo ou comofalsenas linhas que você quer criar ou atualizar.
Os nomes dos campos dentro de PAYLOAD diferenciam maiúsculas de minúsculas. Uma chave chamada NAME não corresponde a um campo chamado name. Se as maiúsculas e minúsculas não corresponderem, a validação informa a chave como um campo indefinido e informa como ausente o campo que ela deveria preencher. Nomeie suas chaves exatamente como os campos aparecem em Configurações de dados > Objetos de dados.
A Braze não cria nem altera tipos de objetos de dados durante uma sincronização. Defina o tipo e todos os seus campos na Braze antes de criar a sincronização. Para adicionar um campo depois, adicione-o primeiro ao tipo e, em seguida, atualize sua tabela de origem ou sua consulta.
Na etapa Definição de dados, selecione o tipo de dados Relacionamentos de usuários com objetos de dados e escolha um Nome do relacionamento, como User (Account-User).
Use esta sincronização para conectar registros de objetos de dados entre si, como vincular contas às respectivas contas principais. Crie o relacionamento na Braze antes de sincronizá-lo.
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.ACCOUNT_SUBACCOUNTS_SYNC (
updated_at timestamptz default sysdate not null,
object_id varchar not null,
related_object_id varchar not null,
payload varchar(max),
deleted boolean
)
| Nome do campo | Tipo | Modo |
|---|---|---|
UPDATED_AT |
timestamptz | REQUIRED |
OBJECT_ID |
varchar | REQUIRED |
RELATED_OBJECT_ID |
varchar | REQUIRED |
PAYLOAD |
varchar(max) | NULLABLE |
DELETED |
boolean | NULLABLE |
OBJECT_ID é o registro de onde o relacionamento parte, e RELATED_OBJECT_ID é o registro para o qual ele aponta. Ambos são obrigatórios em todas as linhas. Use PAYLOAD para quaisquer campos definidos no próprio relacionamento.
UPDATED_AT- O horário em que essa linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. Linhas com o carimbo de data/hora exatamente no limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo carimbo de data/hora.OBJECT_ID- O identificador do registro do objeto de dados. Ele deve corresponder ao valor deobject_idusado na Braze para esse tipo de objeto de dados.PAYLOAD- Uma string JSON com os campos e valores a serem sincronizados. Cada chave deve corresponder a um campo definido no tipo de objeto de dados na Braze.DELETED- Quando fortrue, a Braze exclui o registro em vez de atualizá-lo. Deixe esse valor nulo ou comofalsenas linhas que você quer criar ou atualizar.
Os nomes dos campos dentro de PAYLOAD diferenciam maiúsculas de minúsculas. Uma chave chamada NAME não corresponde a um campo chamado name. Se as maiúsculas e minúsculas não corresponderem, a validação informa a chave como um campo indefinido e informa como ausente o campo que ela deveria preencher. Nomeie suas chaves exatamente como os campos aparecem em Configurações de dados > Objetos de dados.
A Braze não cria nem altera tipos de objetos de dados durante uma sincronização. Defina o tipo e todos os seus campos na Braze antes de criar a sincronização. Para adicionar um campo depois, adicione-o primeiro ao tipo e, em seguida, atualize sua tabela de origem ou sua consulta.
Na etapa Definição de dados, selecione o tipo de dados Relacionamentos entre objetos de dados e escolha um Nome do relacionamento, como Subaccount (Account-Account).
Os gatilhos do Canvas viabilizam a personalização sem cópia. Para saber como configurar o Canvas de destino e o que considerar, consulte Personalização sem cópia.
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC (
updated_at timestamptz default sysdate not null,
--at least one of external_id or alias_name and alias_label is required
external_id varchar not null,
--if using user alias, both alias_name and alias_label are required
alias_label varchar,
alias_name varchar,
properties varchar(max)
);
As sincronizações de disparo de Canvas diferem de outras sincronizações de dados de usuários de três maneiras:
- Só há suporte para os identificadores ID externo ou alias de usuário. E-mail e números de telefone não são identificadores compatíveis.
- Só é possível sincronizar usuários que já existem na Braze. Não é possível criar novos usuários.
PROPERTIESsubstitui a colunaPAYLOAD. Essa coluna é uma string JSON com os campos que você quer usar como propriedades de entrada no Canvas para personalização.
Sua tabela de disparos de Canvas precisa das seguintes colunas:
UPDATED_AT- O momento em que essa linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. As linhas com o timestamp exatamente no limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo timestamp.EXTERNAL_IDouALIAS_NAMEeALIAS_LABELcomo coluna de identificador de usuário. Essas colunas identificam os usuários para os quais você quer disparar o envio de mensagens do Canvas.EXTERNAL_ID- Identifica o usuário que vai entrar no Canvas. Esse valor deve corresponder ao valor deexternal_idusado na Braze.ALIAS_NAMEeALIAS_LABEL- Essas colunas criam um objeto de alias de usuário.alias_namedeve ser um identificador único, ealias_labelespecifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas umalias_nameporalias_label.
PROPERTIES- Uma string JSON com os campos que ficarão disponíveis como propriedades de personalização no seu Canvas. Ela deve conter informações específicas do usuário.

As propriedades não são obrigatórias para todas as linhas ou usuários. No entanto, os valores das propriedades precisam ser uma string JSON válida. Insira uma string vazia {} se não houver propriedades para a linha.
Conceda ao usuário da Braze acesso a esta tabela:
GRANT SELECT ON TABLE CANVAS_TRIGGERS_SYNC TO braze_user;
Para começar, selecione o tipo de dados Gatilhos do Canvas ao criar uma nova sincronização.
As tabelas de origem para exclusões de usuários devem incluir um ou mais tipos de identificador de usuário e um carimbo de data/hora UPDATED_AT. Colunas de carga útil não são compatíveis com dados de exclusão de usuários.
UPDATED_AT- O momento em que esta linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em queUPDATED_ATé posterior ao último valor sincronizado. As linhas que estiverem exatamente no carimbo de data/hora limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo carimbo de data/hora.- Colunas de identificador de usuário - Cada linha deve conter apenas um identificador:
external_id, a combinação dealias_nameealias_label, oubraze_id. Uma tabela de origem pode conter colunas para um, dois ou todos os três tipos de identificador.EXTERNAL_ID- Identifica o usuário que você deseja atualizar. Deve corresponder ao valor deexternal_idusado na Braze.ALIAS_NAMEeALIAS_LABEL- Essas duas colunas criam um objeto de alias de usuário.alias_namedeve ser um identificador exclusivo, ealias_labelespecifica o tipo de alias. Os usuários podem ter vários aliases com rótulos diferentes, mas apenas umalias_nameporalias_label.BRAZE_ID- O identificador de usuário da Braze. Ele é gerado pelo SDK da Braze, e não é possível criar novos usuários usando um ID da Braze por meio da ingestão de dados na nuvem. Para criar novos usuários, especifique um ID de usuário externo ou um alias de usuário.

Não inclua uma coluna PAYLOAD na sua tabela para remoção de usuários. Para evitar a remoção acidental e permanente de usuários, a sincronização falha se uma coluna de carga útil for fornecida na tabela de origem. Quaisquer outras colunas são permitidas, mas são ignoradas pela Braze.
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_DELETES (
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
);
Na página Criar sincronização de importação, defina o Tipo de dados como Excluir usuários para que as ações corretas sejam executadas durante a integração. Para saber mais, consulte Excluir usuários com a ingestão de dados na nuvem.

A exclusão de perfis de usuário não pode ser desfeita. Essa ação remove os usuários permanentemente, o que pode causar discrepâncias nos seus dados. Para mais detalhes, consulte Efeitos da exclusão de perfis de usuário.
Etapa 2: Configure a autenticação
A Braze se conecta ao Redshift como um usuário do banco de dados. Escolha um dos seguintes métodos de autenticação para configurar esse usuário:
| Método | Como a Braze faz a autenticação | O que você insere na Braze |
|---|---|---|
| IAM role | Braze assumes an AWS Identity and Access Management (IAM) role in your account, using an external ID that Braze generates for your workspace, and then requests temporary database credentials. | Role ARN, Region, Cluster type, and Workgroup name or Cluster identifier |
| Username and password | Braze connects as a Redshift database user with a password. | Username and Password |
IAM role
A Braze assume uma função do AWS Identity and Access Management (IAM) na sua conta da AWS e solicita credenciais temporárias do banco de dados. A Braze não armazena nenhuma senha do banco de dados. Ela assume a função a partir da mesma conta da AWS que usa para fontes do Amazon S3.
A Braze gera um ID externo para o seu espaço de trabalho. Sua função usa esse ID para confirmar que a solicitação para assumi-la vem do seu espaço de trabalho da Braze.
Suas credenciais existentes de nome de usuário e senha continuam funcionando, então você não precisa migrá-las.
Pré-requisitos
Você precisa de permissão para criar funções e políticas do IAM na sua conta da AWS. Também precisa de permissão para executar instruções CREATE USER e GRANT no seu banco de dados do Redshift.

A política de confiança da sua função deve exigir exatamente o ID externo do formulário de credencial da Braze. Quando você testa ou salva uma credencial, a Braze tenta assumir sua função com um ID externo diferente. Se a AWS permitir essa tentativa, o teste de conexão falha. Isso acontece quando a função não exige um ID externo ou quando aceita um padrão como braze-cdi-*.
Copie o ID da conta Braze e o ID externo
- No dashboard da Braze, acesse Configurações de dados > Ingestão de dados na nuvem > Fontes.
- Selecione Adicionar fonte de dados e depois selecione Amazon Redshift.
- Como método de autenticação, selecione Função do IAM.
- Na etapa Configuração da AWS, copie o ID da conta Braze e o ID externo. Mantenha o formulário aberto, porque você vai voltar a ele em Insira os valores na Braze.
Crie a função do IAM
- No console da AWS, acesse IAM > Roles e depois selecione Create role.
- Selecione AWS account como tipo de entidade confiável e depois selecione Another AWS account.
- Cole o ID da conta Braze. Selecione Require external ID e depois cole o ID externo.
- Pule a etapa de permissões. Insira um nome para a função e depois selecione Create role. Você vai adicionar a política de permissões em Adicione a política de permissões.
- Copie o Amazon Resource Name (ARN) da função. Você vai inseri-lo na Braze em Insira os valores na Braze.
A política de confiança da função fica parecida com o exemplo a seguir. Substitua BRAZE_ACCOUNT_ID e EXTERNAL_ID pelos valores do formulário de credencial.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::BRAZE_ACCOUNT_ID:root"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"sts:ExternalId": "EXTERNAL_ID"
}
}
}
]
}
Adicione a política de permissões
Adicione uma política de permissões em linha à função. Na guia Permissions da função, selecione Add permissions > Create inline policy e depois cole o JSON correspondente ao seu tipo de cluster, conforme as guias a seguir.
Para o Redshift Serverless, a política deve permitir redshift-serverless:GetCredentials no seu grupo de trabalho. No valor de Resource, use o ID do grupo de trabalho, que é diferente do nome do grupo de trabalho. Para encontrar o ID, abra seu grupo de trabalho no console do Redshift e copie o ID a partir do ARN do grupo de trabalho.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "redshift-serverless:GetCredentials",
"Resource": "arn:aws:redshift-serverless:REGION:AWS_ACCOUNT_ID:workgroup/WORKGROUP_ID"
}
]
}
Substitua REGION, AWS_ACCOUNT_ID e WORKGROUP_ID pelos valores do seu grupo de trabalho.
Para um cluster provisionado, a política deve permitir redshift:GetClusterCredentialsWithIAM no banco de dados a partir do qual você sincroniza.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "redshift:GetClusterCredentialsWithIAM",
"Resource": "arn:aws:redshift:REGION:AWS_ACCOUNT_ID:dbname:CLUSTER_IDENTIFIER/DATABASE_NAME"
}
]
}
Substitua REGION, AWS_ACCOUNT_ID, CLUSTER_IDENTIFIER e DATABASE_NAME pelos valores do seu cluster.
Crie o usuário do banco de dados e conceda acesso
A Braze faz login no Redshift como um usuário do banco de dados chamado IAMR:ROLE_NAME, em que ROLE_NAME é o nome da função do IAM que você criou. Esse usuário é diferente de braze_user, então as permissões que você concedeu a outros usuários do banco de dados não se aplicam a ele.
Antes de testar a conexão na Braze, execute a instrução a seguir no seu banco de dados do Redshift para criar o usuário. É seguro executar essa instrução antes de a Braze se conectar pela primeira vez:
CREATE USER "IAMR:ROLE_NAME" PASSWORD DISABLE;
Depois, conceda a esse usuário acesso à sua tabela de origem. Use as mesmas instruções GRANT da Etapa 3: Conceder permissões ao usuário e substitua braze_user por "IAMR:ROLE_NAME". Mantenha as aspas duplas, porque o nome do usuário contém dois-pontos.
Se você também usa o Redshift como fonte conectada, conceda a esse usuário as mesmas permissões listadas nessa seção.
Insira os valores na Braze
Volte ao formulário de credencial da Braze. Na etapa Configuração da Braze, insira os seguintes valores:
| Campo da Braze | O que inserir |
|---|---|
| Tipo de cluster | Serverless (padrão) ou Provisioned. |
| ARN da função | O ARN da função que você criou, no formato arn:aws:iam::123456789012:role/ROLE_NAME. |
| Região | A região da AWS em que seu cluster ou grupo de trabalho do Redshift é executado, como us-east-1. Ela pode ser diferente da região da sua instância da Braze. |
| Nome do grupo de trabalho ou Identificador do cluster | Para o Serverless, o nome do seu grupo de trabalho. Para um cluster provisionado, o identificador do seu cluster. |
| Host | O endpoint do seu cluster ou grupo de trabalho. Para o Serverless, a Braze preenche esse campo a partir do ARN da função, da Região e do Nome do grupo de trabalho, e você pode editá-lo. Para um cluster provisionado, insira o endpoint. |
| Porta | A porta do seu cluster ou grupo de trabalho. O padrão é 5439. Insira um valor de 1024 a 65535. |

Não é possível alterar esses detalhes de conexão depois de salvar a credencial. Para alterar qualquer um deles, crie uma nova credencial. Depois, você pode mover sua fonte para a nova credencial.
A autenticação por função do IAM funciona com ou sem um túnel SSH. Para configurar o túnel e a lista de IPs permitidos, siga a Etapa 4: Permitir acesso aos IPs da Braze, da mesma forma que para os outros métodos. Depois de salvar a credencial, você pode renomeá-la. Se usar um túnel, também pode fazer a rotação da chave do túnel.
Como a Braze testa a conexão
Quando você testa a conexão, e toda vez que a Braze se conecta, ela primeiro tenta assumir sua função usando um ID externo de teste que não pertence a nenhum espaço de trabalho: braze-cdi-000000000000000000000000. Sua função deve negar essa tentativa com um erro AccessDenied. Se a AWS permitir, o teste de conexão falha. Para obter ajuda, consulte Sua função do IAM não exige o ID externo.
O AWS CloudTrail mostra essas tentativas como chamadas AssumeRole com o nome de sessão Braze-CDI-Redshift. A tentativa negada é esperada e não dá à Braze acesso aos seus dados. Não adicione uma condição que rejeite apenas esse ID externo, porque sua função continuaria confiando em outros espaços de trabalho da Braze.
Remova o acesso da Braze
Para impedir que a Braze acesse seus dados, exclua a função ou remova a declaração de confiança da conta Braze da política de confiança da função. Você também pode excluir o usuário do banco de dados IAMR:ROLE_NAME.
Configure com a AWS CLI
Como alternativa, use a AWS Command Line Interface (CLI) para criar a função e anexar a política de permissões. Este exemplo usa um grupo de trabalho Serverless. Para um cluster provisionado, substitua o documento da política pela política da guia Provisioned em Adicione a política de permissões.
aws iam create-role --role-name braze-cdi \
--assume-role-policy-document '{
"Version": "2012-10-17",
"Statement": [{
"Effect": "Allow",
"Principal": {"AWS": "arn:aws:iam::BRAZE_ACCOUNT_ID:root"},
"Action": "sts:AssumeRole",
"Condition": {"StringEquals": {"sts:ExternalId": "EXTERNAL_ID"}}
}]
}'
aws iam put-role-policy --role-name braze-cdi \
--policy-name braze-cdi-redshift \
--policy-document '{
"Version": "2012-10-17",
"Statement": [{
"Effect": "Allow",
"Action": "redshift-serverless:GetCredentials",
"Resource": "arn:aws:redshift-serverless:REGION:AWS_ACCOUNT_ID:workgroup/WORKGROUP_ID"
}]
}'
Substitua os seguintes placeholders:
BRAZE_ACCOUNT_IDeEXTERNAL_ID: os valores do formulário de credencialREGION,AWS_ACCOUNT_IDeWORKGROUP_ID: os valores do seu grupo de trabalho
O comando create-role retorna o ARN da função na saída. Para mais detalhes, consulte create-role na referência de comandos da AWS CLI. Copie o ARN e depois continue em Crie o usuário do banco de dados e conceda acesso.
Username and password
A Braze se conecta ao Redshift como um usuário de banco de dados com senha. Crie um usuário para a Braze:
CREATE USER braze_user PASSWORD '{password}';
Guarde o nome de usuário e a senha em um local seguro até precisar inseri-los no dashboard da Braze ao criar a fonte.
Etapa 3: Conceder permissões ao usuário
Conceda ao usuário do banco de dados com o qual a Braze se conecta acesso à sua tabela de origem. O exemplo a seguir usa braze_user. Se você usa autenticação por função do IAM, substitua braze_user por "IAMR:ROLE_NAME". Para saber mais, consulte Criar o usuário do banco de dados e conceder acesso.
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 esse usuário. Se você for criar várias integrações de CDI, pode ser interessante conceder permissões a um schema ou gerenciar as permissões usando um grupo.
Etapa 4: Permita o acesso aos IPs da Braze
Se você tiver um firewall ou outras políticas de rede, precisa liberar o acesso de rede da Braze à sua instância do Redshift. Um exemplo de endpoint de URL do Redshift é “example-cluster.ap-northeast-2.redshift.amazonaws.com”.
Alguns pontos importantes:
- Talvez você também precise 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 tabela e na porta usada para consultar seu cluster do Redshift (o padrão é 5439). Permita explicitamente a conectividade TCP do Redshift nessa porta, mesmo que as regras de entrada estejam definidas como “permitir tudo”.
- O endpoint do cluster do Redshift precisa estar acessível publicamente para que a Braze consiga se conectar ao seu cluster.
- Se você não quiser que seu cluster do Redshift fique acessível publicamente, 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 a publicação do AWS Knowledge Center.
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.19134.206.23.17350.16.249.952.4.160.21454.87.8.3454.156.35.25152.54.89.23818.205.178.15
Para a instância US-08, estes são os endereços IP relevantes:
52.151.246.5152.170.163.18240.76.166.15740.76.166.17040.76.166.16740.76.166.16140.76.166.15640.76.166.16640.76.166.16040.88.51.7452.154.67.1740.76.166.8040.76.166.8440.76.166.8540.76.166.8140.76.166.7140.76.166.14440.76.166.145
Para a instância US-10, estes são os endereços IP relevantes:
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
Para as instâncias EU-01 e EU-02, estes são os endereços IP relevantes:
52.58.142.24252.29.193.12135.158.29.22818.157.135.973.123.166.463.64.27.363.65.88.253.68.144.1883.70.107.88
Para a instância AU-01, estes são os endereços IP relevantes:
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
Para a instância ID-01, estes são os endereços IP relevantes:
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
Para a instância JP-01, estes são os endereços IP relevantes:
13.159.155.21254.199.221.24113.192.23.1654.250.120.13918.181.114.2323.114.38.100
Para a instância KR-01, estes são os endereços IP relevantes:
43.200.215.452.79.67.17552.79.113.603.34.212.9254.116.134.2313.37.197.225
Etapa 5: Criar uma nova fonte no dashboard da Braze
No dashboard da Braze, acesse Configurações de dados > Ingestão de dados na nuvem > Fontes, selecione Adicionar fonte de dados e, em seguida, selecione Amazon Redshift.
Etapa 5.1: Adicionar as informações de conexão do Redshift e a tabela de origem
Escolha um nome para sua fonte e insira suas credenciais e configurações do Redshift. Selecione o método de autenticação que você configurou na Etapa 2 e informe as credenciais correspondentes:
- IAM role: Role ARN, Region, Cluster type, and Workgroup name or Cluster identifier
- Username and password: Username and Password
Se estiver usando um túnel de rede privada, ative o controle deslizante e insira as informações do túnel. Depois, siga para a próxima etapa.

No dashboard da Braze, o campo Nome do banco de dados aceita apenas letras (A–Z, a–z), números (0–9) e sublinhados (_), mesmo que o Amazon Redshift ofereça suporte a caracteres adicionais em identificadores de banco de dados.
Etapa 5.2: Testar a conexão e conectar à fonte
Em seguida, selecione Testar conexão. Se o teste for bem-sucedido, conclua as configurações restantes e clique em Conectar à fonte. Se a conexão falhar, uma mensagem de erro será exibida para ajudar a resolver o problema.
Etapa 6: Criar uma nova sincronização no dashboard da Braze
Acesse Configurações de dados > Ingestão de dados na nuvem > Sincronizações e selecione Criar sincronização de dados.
Configure os detalhes da sincronização e defina 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 um modo de sincronização e defina seus dados. Por fim, selecione Prévia e validação.
Depois que a validação for bem-sucedida, aparece uma prévia dos dados. Selecione Próximo: Notificações para continuar. Se a validação falhar, aparece uma mensagem de erro para ajudar a solucionar o problema.

É necessário validar uma sincronização com sucesso antes de avançar para as próximas etapas. Se precisar fechar a página de criação da sincronização, selecione Salvar como rascunho para manter o trabalho em andamento.
Adicionar preferências de notificação
Insira um ou mais e-mails de contato para receber notificações de erros de sincronização. A Braze usa essas informações de contato para enviar notificações sobre erros de integração, como a perda inesperada de acesso a uma tabela.
Os e-mails de contato recebem apenas notificações de erros globais ou no nível da sincronização, como tabelas ausentes, problemas de permissões e outros. Eles não recebem notificações de problemas no nível da linha. Os 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)
Definir o cronograma
Por fim, configure a sincronização como não recorrente ou recorrente.
As sincronizações não recorrentes são executadas somente quando você seleciona Sincronizar agora no dashboard ou chama o endpoint Disparar uma sincronização.
As sincronizações recorrentes podem ser executadas com frequência de até uma vez a cada 5 minutos ou com intervalo de até uma vez por mês. Por padrão, o intervalo mais curto que você pode definir no dashboard é de 15 minutos. Isso ajuda a gerenciar os custos de computação e o volume de solicitações do seu data warehouse. Para sincronizar a cada 5 minutos, entre em contato com o suporte da Braze ou com seu gerente de sucesso do cliente. A Braze agenda as sincronizações recorrentes em UTC.

É necessário validar uma integração com sucesso antes que ela possa passar do estado de rascunho para o estado ativo. Se você 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 validar.
Executar a sincronização
Depois de ativada, sua sincronização é executada no cronograma configurado durante a configuração. Se quiser executar a sincronização fora do cronograma ou buscar os dados mais recentes, selecione Sincronizar agora. Essa execução não afeta as próximas sincronizações agendadas. Para iniciar uma sincronização automaticamente quando seus dados forem atualizados, chame o endpoint Disparar uma sincronização a partir do seu pipeline.
Configure 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 as credenciais existentes se estiver se conectando à mesma conta do Redshift.
Se você reutilizar o mesmo usuário em várias integrações, não poderá excluí-lo no dashboard da Braze até que ele seja removido de todas as sincronizações ativas.
Usar o Redshift como fonte conectada
Uma fonte conectada é uma alternativa de cópia zero à sincronização de dados com a Braze. A Braze consulta sua instância do Redshift diretamente para criar Segments do CDI, sem copiar os dados subjacentes. Para saber mais sobre conceitos, limitações e implicações de custo, consulte Fontes conectadas.
Etapa 1: Criar o usuário e conceder permissões
Escolha um dos métodos em Etapa 2: Configurar a autenticação para a Braze. Em seguida, conceda as seguintes permissões ao usuário do banco de dados da Braze. O exemplo usa braze_user. Se você usa a autenticação por função do IAM, substitua braze_user por "IAMR:ROLE_NAME".
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 sua fonte conectada. Esse usuário é usado para gerar a lista de tabelas disponíveis nas suas extensões de segmento CDI e para consultar as tabelas de origem ao criar novos Segments. 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. Se você for criar várias integrações de CDI, talvez seja melhor 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. Todas as tabelas às quais a função da Braze tem acesso ficam disponíveis para consulta na extensão de segmento CDI. Lembre-se 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 Segment na Braze. A Braze cria uma tabela temporária por Segment, que só existe enquanto a Braze atualiza o Segment.
A configuração do acesso à rede é a mesma da Etapa 4.
Etapa 2: Criar a fonte conectada na Braze
Acesse Configurações de dados > Ingestão de dados na nuvem > Fontes conectadas, selecione Adicionar fonte de dados e, em seguida, selecione Amazon Redshift.
Em Configurar fonte, insira o seguinte:
- Credenciais: URL do host do Redshift, Porta e os campos do seu método de autenticação. Para IAM role, insira Role ARN, Region, Cluster type, and Workgroup name or Cluster identifier. Para Username and password, insira Username and Password.
- 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.
Escolha um nome para a fonte conectada. Esse nome aparece na lista de fontes disponíveis quando você cria uma nova extensão de segmento CDI.
Configure um tempo máximo de execução para essa fonte. A Braze interrompe automaticamente qualquer consulta que ultrapasse esse limite. O tempo máximo de execução permitido é de 60 minutos. Um tempo menor reduz os custos na sua conta do Redshift. Essa configuração se aplica às consultas executadas por essa fonte, incluindo sincronizações e extensões de segmento CDI que a utilizam.
Etapa 3: Finalizar a configuração do Redshift
Se suas credenciais estiverem com Conectar com túnel SSH selecionado, anote a chave pública RSA na etapa Testar conexão e adicione-a ao usuário do túnel SSH.
Depois de adicionar a chave ao usuário, selecione Testar conexão na Braze e, em seguida, selecione Concluído. Sua fonte conectada está criada e pronta para uso nas extensões de segmento CDI.
Você pode configurar várias fontes conectadas com a Braze, mas cada uma deve se conectar a um esquema diferente. Ao criar fontes adicionais, você pode reutilizar credenciais existentes se a conexão for com a mesma conta do Redshift.
Formatar uma carga útil a partir de colunas existentes
Se você preferir armazenar cada atributo em sua própria coluna internamente, precisará converter essas colunas em uma string JSON para preencher a sincronização com a Braze. Use esta consulta no Redshift para formatar as colunas de origem em campos de CDI.
CREATE TABLE "EXAMPLE_USER_DATA"
(attribute_1 string,
attribute_2 string,
attribute_3 number,
my_user_id string);
SELECT
CURRENT_TIMESTAMP as UPDATED_AT,
my_user_id as EXTERNAL_ID,
JSON_SERIALIZE(
OBJECT (
'attribute_1',
attribute_1,
'attribute_2',
attribute_2,
'yet_another_attribute',
attribute_3)
) as PAYLOAD FROM "EXAMPLE_USER_DATA";
Para saber mais sobre otimização, confira as práticas recomendadas de ingestão de dados na nuvem.
Solução de problemas
O teste de conexão está lento
O teste de conexão é executado no seu data warehouse, então aumentar a capacidade do warehouse pode melhorar a velocidade. Usar uma instância SQL serverless 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.
Permissão negada para a relação {table_name}
Se você receber esse erro:
- Conceda a permissão
usageno esquema para esse usuário. - Conceda a permissão
selectna tabela para esse usuário.
Sua função do IAM não exige o ID externo
Se você usa a autenticação por função do IAM, o teste de conexão pode falhar com o seguinte erro:
The IAM role on this credential does not require its external ID. Braze assumed the role with an external ID that belongs to no Braze workspace and AWS allowed it, so another Braze customer who learns the role ARN could read this data. In the role’s trust policy, add a StringEquals condition on sts:ExternalId with the external ID shown in the credential form to every statement that allows Braze’s AWS principal to assume the role. A pattern that also matches other Braze workspaces, such as braze-cdi-*, does not require it. Then test the connection again.
Esse erro significa que a AWS permitiu o ID externo de teste descrito em Como a Braze testa a conexão. Para corrigir isso, atualize a política de confiança da sua função:
- No console da AWS, abra a função e selecione a guia Trust relationships.
- Em cada declaração que permite que a conta da Braze assuma a função, adicione uma condição
StringEqualsemsts:ExternalIdusando exatamente o ID externo do formulário de credencial. Remova qualquer condição com padrão, comobraze-cdi-*. - Na Braze, teste a conexão novamente.
A Braze não conseguiu confirmar que sua função exige o ID externo
Se você usa a autenticação por função do IAM, o teste de conexão pode falhar com o seguinte erro:
Braze could not confirm that the IAM role on this credential requires its external ID. The check needs AWS to explicitly refuse an attempt to assume the role with a different external ID, and this attempt failed for another reason instead. Please try again; if it keeps happening, contact support.
A Braze não conseguiu concluir a verificação, então esse erro não significa que sua função seja permissiva demais. Teste a conexão novamente. Se o erro continuar, entre em contato com o suporte da Braze.
Não foi possível assumir a função do IAM
Se você usa a autenticação por função do IAM e o teste de conexão falha com um erro que começa com “Unable to assume IAM role”, verifique o seguinte:
- A política de confiança da função lista o ID da conta da Braze do formulário de credencial como principal confiável.
- A política de confiança da função exige exatamente o ID externo do formulário de credencial.
- O Role ARN que você inseriu na Braze corresponde ao ARN da função que você criou.
- Se sua instância da Braze estiver em uma região da AWS que não vem ativada por padrão, como Jacarta (ID-01), sua conta da AWS precisa estar com essa região ativada.
A AWS retorna o mesmo erro AccessDenied para todas essas causas, então verifique cada uma delas.
Não foi possível obter as credenciais do banco de dados do Redshift
Se você usa a autenticação por função do IAM e o teste de conexão falha com um erro que começa com “Unable to get Redshift database credentials as IAM role”, verifique o seguinte:
- A política de permissões da função permite
redshift-serverless:GetCredentialspara Serverless, ouredshift:GetClusterCredentialsWithIAMpara um cluster provisionado. - Para Serverless, o valor
Resourceda política usa o ID do grupo de trabalho, que é diferente do nome do grupo de trabalho. - Para um cluster provisionado, o valor
Resourceda política é o ARNdbnamedo seu cluster e banco de dados, no formatoarn:aws:redshift:REGION:AWS_ACCOUNT_ID:dbname:CLUSTER_IDENTIFIER/DATABASE_NAME. - A Region, o Workgroup name ou o Cluster identifier que você inseriu na Braze corresponde ao seu cluster ou grupo de trabalho.
Permissão negada após um teste de conexão bem-sucedido
Se o teste de conexão for bem-sucedido, mas uma sincronização ou validação retornar um erro de permissão negada, provavelmente você concedeu acesso a outro usuário, como braze_user. Com a autenticação por função do IAM, a Braze faz login como "IAMR:ROLE_NAME". Conceda as permissões de esquema e tabela a esse usuário. Para mais detalhes, consulte Criar o usuário do banco de dados e conceder acesso.
Erro ao criar conexão
Se você receber esse erro, verifique se o endpoint e a porta do Redshift estão corretos.
Erro ao criar túnel SSH
Se você receber esse erro:
- Verifique se a chave pública do seu dashboard da Braze está no host EC2 usado para o tunelamento SSH.
- Verifique se o seu nome de usuário está correto.
- Verifique se o túnel SSH está correto.
Identificador de snapshot inválido
Se a Braze retornar um erro Invalid snapshot identifier durante o Teste de conexão ou a configuração da sincronização, isso significa que o Redshift não consegue resolver a referência de snapshot usada quando o seu objeto de origem é consultado.
No Redshift, um snapshot é um backup de um cluster em um determinado momento. Cada snapshot tem um identificador único que o Redshift usa para referenciar esse estado de backup. Para saber mais, consulte Snapshots e backups do Amazon Redshift.
Esse erro pode ocorrer quando os metadados mudam enquanto a Braze valida o objeto de origem, por exemplo, durante operações de cópia, recuperação ou replicação de snapshots. Para saber mais, consulte como copiar snapshots para outra região da AWS e como recuperar um cluster a partir de um snapshot.
Para solucionar o problema:
- Verifique as configurações de origem na Braze, incluindo o endpoint do cluster, o banco de dados, o esquema e o nome do objeto.
- Execute a mesma consulta diretamente no Redshift para confirmar que a tabela ou view pode ser lida e está estável.
- Tente novamente depois que qualquer atividade de snapshot, recuperação, redimensionamento ou replicação em andamento terminar.
- Se o problema persistir, consulte uma view materializada em vez de uma tabela base que muda com frequência.
Uma view materializada armazena resultados de consulta pré-calculados que você pode atualizar de acordo com um cronograma. Isso pode deixar as leituras mais estáveis para as sincronizações de 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;
Depois de criar a view materializada, use o nome dela como objeto de origem na sua sincronização de CDI da Braze, em vez da tabela base.
Onde executar verificações SQL
Execute as verificações de validação diretamente no editor SQL do Redshift, na mesma tabela ou view usada pela sua integração de CDI. Use o Query Editor v2. Para saber mais, consulte Como usar o Amazon Redshift Query Editor v2.
Páginas relacionadas
- Configuração da tabela para colunas obrigatórias e formatação da carga útil
- Melhores práticas para agendamento de sincronizações e eficiência no uso de pontos de dados
- Logs de sincronização e observabilidade para monitorar as execuções de sincronização
- Perguntas frequentes para dúvidas comuns sobre todas as fontes