Amazon Redshift용 클라우드 데이터 수집
이 페이지에서는 클라우드 데이터 수집(CDI)을 사용하여 Amazon Redshift의 데이터를 Braze로 동기화하는 데 필요한 모든 내용을 다룹니다. Redshift에서 생성해야 하는 리소스, Braze에서 소스를 연결하고 동기화를 생성하는 방법, 데이터 유형별 소스 테이블, Redshift 관련 문제 해결 방법을 확인할 수 있습니다.
설정 개요
- Redshift 인스턴스에서 Braze와 동기화할 테이블 또는 뷰를 설정합니다.
- Braze에서 지원하는 인증 방법 중 하나를 선택하고, Braze 데이터베이스 사용자에게 테이블에 대한 액세스 권한을 부여합니다.
- 동기화할 Redshift 테이블에 Braze가 액세스할 수 있는지 확인합니다. Braze는 인터넷을 통해 Redshift에 연결합니다.
- Braze 대시보드에서 새 소스와 동기화를 생성합니다.
- 통합을 검증하고 동기화를 시작합니다.

동기화당 처리되는 행 수는 웨어하우스 성능, 네트워크 지연 시간, 그리고 동기화 쿼리와 일치하는 새 데이터의 양에 따라 달라집니다. 최근 실행의 소요 시간과 행 수를 확인하려면 대시보드에서 통합의 동기화 기록을 확인하세요.
1단계: 소스 테이블 설정
이 섹션의 단계에서는 PAYLOAD 열이 있는 테이블을 생성합니다. Data definition 단계에서 데이터를 구성할 계획이라면 기존 테이블이나 뷰를 사용할 수 있습니다. 이 경우 테이블 생성 단계를 건너뛰고, 동기화하려는 테이블 또는 뷰에 대한 읽기 권한을 Braze에 부여하세요. 옵션 비교는 데이터 정의 옵션 선택하기를 참조하세요.
데이터베이스, 스키마, 테이블의 이름은 원하는 대로 지정할 수 있지만, 열 이름은 다음 탭의 정의와 일치해야 합니다. 테이블 대신 뷰 또는 구체화된 뷰를 사용할 수도 있습니다.
선택적으로, 소스 테이블을 보관할 새 데이터베이스와 스키마를 설정합니다.
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

PAYLOAD 열을 사용하는 경우, 소스 테이블 또는 뷰에 다음 탭에 나열되지 않은 열(예: 감사 또는 해싱용 열)을 포함할 수 있습니다. Braze는 이 탭에 설명된 열만 읽으며, 그 외의 열은 클라우드 데이터 수집 동기화 중에 사용되지 않습니다.
동기화하려는 데이터 유형에 해당하는 탭을 선택하세요.
사용자 속성, 커스텀 이벤트, 구매 이벤트는 모두 동일한 형태의 소스 테이블을 사용합니다. PAYLOAD의 내용만 다릅니다.
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- 이 행이 테이블에서 업데이트되거나 테이블에 추가된 시간입니다. Braze는UPDATED_AT이 마지막으로 동기화된 값보다 늦은 행을 동기화합니다. 경계 타임스탬프와 정확히 일치하는 행은 같은 타임스탬프를 가진 새 행이 있으면 다시 동기화될 수 있습니다.- 사용자 식별자 열 - 테이블에는 하나 이상의 사용자 식별자 열이 포함될 수 있습니다. 각 행에는 식별자가 하나만 포함되어야 합니다(
external_id,alias_name과alias_label의 조합,braze_id,email또는phone중 하나). 소스 테이블에는 식별자 유형 한 가지, 두 가지, 세 가지, 네 가지 또는 다섯 가지 모두에 대한 열이 있을 수 있습니다.EXTERNAL_ID- 업데이트하려는 사용자를 식별합니다. 이 값은 Braze에서 사용하는external_id값과 일치해야 합니다.ALIAS_NAME및ALIAS_LABEL- 이 두 열은 사용자 별칭 객체를 생성합니다.alias_name은 고유 식별자여야 하며,alias_label은 별칭의 유형을 지정합니다. 사용자는 레이블이 서로 다른 여러 별칭을 가질 수 있지만,alias_label당alias_name은 하나만 가질 수 있습니다.BRAZE_ID- Braze 사용자 식별자입니다. 이 값은 Braze SDK에서 생성되며, Cloud Data Ingestion을 통해 Braze ID로 새 사용자를 생성할 수는 없습니다. 새 사용자를 생성하려면 외부 사용자 ID 또는 사용자 별칭을 지정하세요.EMAIL- 사용자의 이메일 주소입니다. 동일한 이메일 주소를 가진 프로필이 여러 개 있으면 가장 최근에 업데이트된 프로필이 우선적으로 업데이트됩니다. 이메일과 전화번호를 모두 포함하면 이메일이 기본 식별자로 사용됩니다.PHONE- 사용자의 전화번호입니다. 동일한 전화번호를 가진 프로필이 여러 개 있으면 가장 최근에 업데이트된 프로필이 우선적으로 업데이트됩니다.
PAYLOAD- Braze에서 사용자에게 동기화하려는 필드의 JSON 문자열입니다.
속성 동기화의 경우 PAYLOAD는 사용자 속성 객체 형식을 따릅니다. 중첩 커스텀 속성, 객체 배열, 구독 그룹 상태를 포함할 수 있습니다. 페이로드 예시는 테이블 설정을 참조하세요.
커스텀 이벤트는 사용자 속성과 동일한 소스 테이블을 사용합니다. User attributes 탭에 표시된 테이블을 생성한 다음, PAYLOAD를 이벤트 객체로 채웁니다.
이벤트를 동기화하려면 이벤트 이름이 필요합니다. time 필드는 ISO 8601 문자열 또는 yyyy-MM-dd'T'HH:mm:ss:SSSZ 형식으로 지정하세요. time 필드가 없으면 Braze는 UPDATED_AT 열 값을 이벤트 시간으로 사용합니다. app_id 및 properties를 포함한 기타 필드는 선택 사항입니다.
행당 하나의 이벤트를 동기화할 수 있습니다.
{
"app_id" : "your-app-id",
"name" : "rented_movie",
"time" : "2013-07-16T19:20:45+01:00",
"properties": {
"movie": "The Sad Egg",
"director": "Alex Smith"
}
}
구매 이벤트는 사용자 속성과 동일한 소스 테이블을 사용합니다. User attributes 탭에 표시된 테이블을 생성한 다음, PAYLOAD를 구매 객체로 채웁니다.
구매 이벤트를 동기화하려면 product_id, currency, price가 필요합니다. 선택 사항인 time 필드는 ISO 8601 문자열 또는 yyyy-MM-dd'T'HH:mm:ss:SSSZ 형식으로 지정하세요. time 필드가 없으면 Braze는 UPDATED_AT 열 값을 이벤트 시간으로 사용합니다. app_id, quantity, properties를 포함한 기타 필드는 선택 사항입니다.
행당 하나의 구매 이벤트를 동기화할 수 있습니다.
{
"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 }
]
}
}
카탈로그 동기화를 생성하기 전에 Braze에서 대상 카탈로그를 생성하세요. 전체 카탈로그 워크플로는 카탈로그 데이터 동기화 및 삭제를 참조하세요.
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
)
다른 소스 테이블과 함께 이 테이블에 대한 액세스 권한을 Braze 사용자에게 부여합니다.
GRANT SELECT ON TABLE CATALOGS_SYNC TO braze_user;
통합 이름은 Braze에서 생성한 카탈로그 이름과 정확히 일치해야 합니다.
동기화가 실행될 때마다 소스 테이블이 완전히 새로 고쳐지도록 카탈로그 데이터로 뷰를 생성하는 것을 권장합니다. 예를 들어, product_id와 세 개의 추가 속성이 있는 제품 데이터 테이블(product_catalog_1)이 있다면 다음과 같이 동기화할 수 있습니다.
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";
데이터 오브젝트 동기화를 생성하기 전에 Braze에서 데이터 오브젝트 유형과 해당 필드를 생성하세요. 전체 워크플로는 데이터 오브젝트 동기화를 참조하세요.
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
)
| 필드 이름 | 유형 | 모드 |
|---|---|---|
UPDATED_AT |
timestamptz | REQUIRED |
OBJECT_ID |
varchar | REQUIRED |
PAYLOAD |
varchar(max) | REQUIRED |
DELETED |
boolean | NULLABLE |
UPDATED_AT- 이 행이 테이블에서 업데이트되거나 테이블에 추가된 시간입니다. Braze는UPDATED_AT이 마지막으로 동기화된 값보다 이후인 행을 동기화합니다. 정확히 경계 타임스탬프에 해당하는 행은 새 행이 같은 타임스탬프를 공유하는 경우 다시 동기화될 수 있습니다.OBJECT_ID- 데이터 오브젝트 레코드의 식별자입니다. 이 값은 Braze에서 이 데이터 오브젝트 유형에 사용하는object_id값과 일치해야 합니다.PAYLOAD- 동기화할 필드와 값으로 구성된 JSON 문자열입니다. 각 키는 Braze의 데이터 오브젝트 유형에 정의된 필드와 일치해야 합니다.DELETED-true이면 Braze는 레코드를 업데이트하는 대신 삭제합니다. 생성하거나 업데이트하려는 행에는 이 값을 null 또는false로 두세요.
PAYLOAD 내부의 필드 이름은 대소문자를 구분합니다. NAME이라는 키는 name이라는 필드와 일치하지 않습니다. 대소문자가 일치하지 않으면 유효성 검사에서 해당 키를 정의되지 않은 필드로 보고하고, 원래 채우려던 필드는 누락된 것으로 보고합니다. 키 이름은 데이터 설정 > 데이터 오브젝트에 표시되는 필드 이름과 정확히 같게 지정하세요.
Braze는 동기화 중에 데이터 오브젝트 유형을 생성하거나 변경하지 않습니다. 동기화를 생성하기 전에 Braze에서 유형과 모든 필드를 정의하세요. 나중에 필드를 추가하려면 먼저 유형에 필드를 추가한 다음 소스 테이블이나 쿼리를 업데이트하세요.
예를 들어, name 및 team_id 필드가 있는 계정의 PAYLOAD 값은 다음과 같습니다.
{"name": "Acme Corp", "team_id": 42}
이 테이블에 대한 액세스 권한을 Braze 사용자에게 부여합니다.
GRANT SELECT ON TABLE ACCOUNTS_SYNC TO braze_user;
Data definition 단계에서 Data Objects 데이터 유형을 선택한 다음 Data object type을 선택합니다. 데이터 오브젝트 동기화는 Table 및 SQL을 지원합니다.
이 동기화를 사용하면 사용자를 데이터 오브젝트 레코드에 연결할 수 있습니다(예: 사용자를 소속 계정에 연결). 동기화하기 전에 Braze에서 관계를 생성하세요.
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
)
| 필드 이름 | 유형 | 모드 |
|---|---|---|
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 |
각 행에는 OBJECT_ID와 함께 최소 하나의 사용자 식별자(EXTERNAL_ID, ALIAS_NAME과 ALIAS_LABEL의 조합, EMAIL 또는 PHONE)가 필요합니다. 관계 자체에 정의된 필드에는 PAYLOAD를 사용하세요.

사용자 속성 동기화와 달리 사용자 관계 동기화에서는 BRAZE_ID가 지원되지 않습니다. 앞서 나열한 식별자 중 하나를 사용하세요.
UPDATED_AT- 이 행이 테이블에서 업데이트되거나 테이블에 추가된 시간입니다. Braze는UPDATED_AT이 마지막으로 동기화된 값보다 이후인 행을 동기화합니다. 정확히 경계 타임스탬프에 해당하는 행은 새 행이 같은 타임스탬프를 공유하는 경우 다시 동기화될 수 있습니다.OBJECT_ID- 데이터 오브젝트 레코드의 식별자입니다. 이 값은 Braze에서 이 데이터 오브젝트 유형에 사용하는object_id값과 일치해야 합니다.PAYLOAD- 동기화할 필드와 값으로 구성된 JSON 문자열입니다. 각 키는 Braze의 데이터 오브젝트 유형에 정의된 필드와 일치해야 합니다.DELETED-true이면 Braze는 레코드를 업데이트하는 대신 삭제합니다. 생성하거나 업데이트하려는 행에는 이 값을 null 또는false로 두세요.
PAYLOAD 내부의 필드 이름은 대소문자를 구분합니다. NAME이라는 키는 name이라는 필드와 일치하지 않습니다. 대소문자가 일치하지 않으면 유효성 검사에서 해당 키를 정의되지 않은 필드로 보고하고, 원래 채우려던 필드는 누락된 것으로 보고합니다. 키 이름은 데이터 설정 > 데이터 오브젝트에 표시되는 필드 이름과 정확히 같게 지정하세요.
Braze는 동기화 중에 데이터 오브젝트 유형을 생성하거나 변경하지 않습니다. 동기화를 생성하기 전에 Braze에서 유형과 모든 필드를 정의하세요. 나중에 필드를 추가하려면 먼저 유형에 필드를 추가한 다음 소스 테이블이나 쿼리를 업데이트하세요.
Data definition 단계에서 Data Object User Relationships 데이터 유형을 선택한 다음 User (Account-User)와 같은 Relationship name을 선택합니다.
이 동기화를 사용하면 데이터 오브젝트 레코드끼리 연결할 수 있습니다(예: 계정을 상위 계정에 연결). 동기화하기 전에 Braze에서 관계를 생성하세요.
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
)
| 필드 이름 | 유형 | 모드 |
|---|---|---|
UPDATED_AT |
timestamptz | REQUIRED |
OBJECT_ID |
varchar | REQUIRED |
RELATED_OBJECT_ID |
varchar | REQUIRED |
PAYLOAD |
varchar(max) | NULLABLE |
DELETED |
boolean | NULLABLE |
OBJECT_ID는 관계가 시작되는 레코드이고, RELATED_OBJECT_ID는 관계가 가리키는 레코드입니다. 두 값 모두 모든 행에 필요합니다. 관계 자체에 정의된 필드에는 PAYLOAD를 사용하세요.
UPDATED_AT- 이 행이 테이블에서 업데이트되거나 테이블에 추가된 시간입니다. Braze는UPDATED_AT이 마지막으로 동기화된 값보다 이후인 행을 동기화합니다. 정확히 경계 타임스탬프에 해당하는 행은 새 행이 같은 타임스탬프를 공유하는 경우 다시 동기화될 수 있습니다.OBJECT_ID- 데이터 오브젝트 레코드의 식별자입니다. 이 값은 Braze에서 이 데이터 오브젝트 유형에 사용하는object_id값과 일치해야 합니다.PAYLOAD- 동기화할 필드와 값으로 구성된 JSON 문자열입니다. 각 키는 Braze의 데이터 오브젝트 유형에 정의된 필드와 일치해야 합니다.DELETED-true이면 Braze는 레코드를 업데이트하는 대신 삭제합니다. 생성하거나 업데이트하려는 행에는 이 값을 null 또는false로 두세요.
PAYLOAD 내부의 필드 이름은 대소문자를 구분합니다. NAME이라는 키는 name이라는 필드와 일치하지 않습니다. 대소문자가 일치하지 않으면 유효성 검사에서 해당 키를 정의되지 않은 필드로 보고하고, 원래 채우려던 필드는 누락된 것으로 보고합니다. 키 이름은 데이터 설정 > 데이터 오브젝트에 표시되는 필드 이름과 정확히 같게 지정하세요.
Braze는 동기화 중에 데이터 오브젝트 유형을 생성하거나 변경하지 않습니다. 동기화를 생성하기 전에 Braze에서 유형과 모든 필드를 정의하세요. 나중에 필드를 추가하려면 먼저 유형에 필드를 추가한 다음 소스 테이블이나 쿼리를 업데이트하세요.
Data definition 단계에서 Data Object Relationships 데이터 유형을 선택한 다음 Subaccount (Account-Account)와 같은 Relationship name을 선택합니다.
Canvas 트리거는 제로 카피 개인화를 지원합니다. 대상 Canvas 설정 및 고려 사항은 제로 카피 개인화를 참조하세요.
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)
);
Canvas 트리거 동기화는 다른 사용자 데이터 동기화와 세 가지 면에서 다릅니다.
- 외부 ID 또는 사용자 별칭 식별자만 지원됩니다. 이메일과 전화번호는 식별자로 지원되지 않습니다.
- 기존 Braze 사용자만 동기화할 수 있습니다. 새 사용자는 생성할 수 없습니다.
PROPERTIES가PAYLOAD열을 대체합니다. 이 열은 개인화를 위해 Canvas 항목 속성으로 사용하려는 필드를 담은 JSON 문자열입니다.
Canvas 트리거 테이블에는 다음 열이 필요합니다.
UPDATED_AT- 이 행이 업데이트되거나 테이블에 추가된 시간입니다. Braze는UPDATED_AT이 마지막으로 동기화된 값보다 이후인 행을 동기화합니다. 경계 타임스탬프와 정확히 일치하는 행은 같은 타임스탬프를 가진 새 행이 있으면 다시 동기화될 수 있습니다.- 사용자 식별자 열로
EXTERNAL_ID또는ALIAS_NAME과ALIAS_LABEL중 하나가 필요합니다. 이 열은 Canvas 메시징을 트리거할 대상 사용자를 식별합니다.EXTERNAL_ID- Canvas에 진입시킬 사용자를 식별합니다. 이 값은 Braze에서 사용하는external_id값과 일치해야 합니다.ALIAS_NAME및ALIAS_LABEL- 이 두 열로 사용자 별칭 객체를 생성합니다.alias_name은 고유 식별자여야 하며,alias_label은 별칭 유형을 지정합니다. 사용자는 레이블이 서로 다른 여러 별칭을 가질 수 있지만,alias_label당alias_name은 하나만 가질 수 있습니다.
PROPERTIES- Canvas에서 개인화 속성으로 사용할 수 있게 할 필드를 담은 JSON 문자열입니다. 사용자별 정보가 포함되어야 합니다.

모든 행이나 사용자에게 속성이 필요한 것은 아닙니다. 다만 속성 값은 유효한 JSON 문자열이어야 합니다. 행에 속성이 없으면 빈 {} 문자열을 입력하세요.
이 테이블에 대한 액세스 권한을 Braze 사용자에게 부여합니다.
GRANT SELECT ON TABLE CANVAS_TRIGGERS_SYNC TO braze_user;
시작하려면 새 동기화를 생성할 때 Canvas Triggers 데이터 유형을 선택하세요.
사용자 삭제를 위한 소스 테이블에는 하나 이상의 사용자 식별자 유형과 UPDATED_AT 타임스탬프가 포함되어야 합니다. 사용자 삭제 데이터에는 페이로드 열이 지원되지 않습니다.
UPDATED_AT- 이 행이 테이블에 업데이트되거나 추가된 시간입니다. Braze는UPDATED_AT이 마지막으로 동기화된 값보다 이후인 행을 동기화합니다. 새 행이 경계 타임스탬프와 정확히 같은 타임스탬프를 공유하는 경우, 해당 경계 타임스탬프의 행이 다시 동기화될 수 있습니다.- 사용자 식별자 열 - 각 행에는 식별자가 하나만 포함되어야 합니다.
external_id,alias_name과alias_label의 조합,braze_id중 하나를 사용하세요. 소스 테이블에는 한 가지, 두 가지 또는 세 가지 식별자 유형 모두에 대한 열이 포함될 수 있습니다.EXTERNAL_ID- 업데이트하려는 사용자를 식별합니다. Braze에서 사용하는external_id값과 일치해야 합니다.ALIAS_NAME및ALIAS_LABEL- 이 두 열은 사용자 별칭 객체를 생성합니다.alias_name은 고유 식별자여야 하며,alias_label은 별칭 유형을 지정합니다. 사용자는 레이블이 서로 다른 여러 별칭을 가질 수 있지만,alias_label당alias_name은 하나만 가질 수 있습니다.BRAZE_ID- Braze 사용자 식별자입니다. 이 식별자는 Braze SDK에서 생성되며, Cloud Data Ingestion을 통해 Braze ID로 신규 사용자를 생성할 수는 없습니다. 신규 사용자를 생성하려면 외부 사용자 ID 또는 사용자 별칭을 지정하세요.

사용자 삭제용 테이블에는 PAYLOAD 열을 포함하지 마세요. 실수로 사용자가 영구 삭제되는 것을 방지하기 위해, 소스 테이블에 페이로드 열이 있으면 동기화가 실패합니다. 그 외의 열은 포함할 수 있지만 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
);
Create import sync 페이지에서 Data Type을 Delete Users로 설정하면 통합 실행 중에 적절한 작업이 수행됩니다. 자세한 내용은 클라우드 데이터 수집으로 사용자 삭제하기를 참조하세요.

고객 프로필 삭제는 되돌릴 수 없습니다. 삭제 작업은 사용자를 영구적으로 제거하므로 데이터에 불일치가 발생할 수 있습니다. 자세한 내용은 고객 프로필 삭제의 영향을 참조하세요.
2단계: 인증 설정
Braze는 데이터베이스 사용자로 Redshift에 연결합니다. 다음 인증 방법 중 하나를 선택하여 해당 사용자를 설정하세요.
| 방법 | Braze의 인증 방식 | 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
Braze는 고객님의 AWS 계정에 있는 AWS Identity and Access Management(IAM) 역할을 수임하고 임시 데이터베이스 자격 증명을 요청합니다. Braze는 데이터베이스 비밀번호를 저장하지 않습니다. Braze는 Amazon S3 소스에 사용하는 것과 동일한 AWS 계정에서 역할을 수임합니다.
Braze는 워크스페이스용 외부 ID를 생성합니다. 역할은 이 ID를 사용해 역할 수임 요청이 고객님의 Braze 워크스페이스에서 온 것인지 확인합니다.
기존 사용자 이름 및 비밀번호 자격 증명은 계속 작동하므로 마이그레이션할 필요가 없습니다.
사전 요구 사항
AWS 계정에서 IAM 역할과 정책을 생성할 수 있는 권한이 필요합니다. 또한 Redshift 데이터베이스에서 CREATE USER 및 GRANT 문을 실행할 수 있는 권한도 필요합니다.

역할의 신뢰 정책은 Braze 자격 증명 양식에 표시된 외부 ID와 정확히 일치하는 값을 요구해야 합니다. 자격 증명을 테스트하거나 저장할 때 Braze는 다른 외부 ID로 역할 수임을 시도합니다. AWS가 이 시도를 허용하면 연결 테스트가 실패합니다. 이는 역할이 외부 ID를 요구하지 않거나 braze-cdi-*와 같은 패턴을 허용할 때 발생합니다.
Braze 계정 ID 및 외부 ID 복사
- Braze 대시보드에서 데이터 설정 > 클라우드 데이터 수집 > 소스로 이동합니다.
- 데이터 소스 추가를 선택한 다음 Amazon Redshift를 선택합니다.
- 인증 방법으로 IAM 역할을 선택합니다.
- AWS 설정 단계에서 Braze 계정 ID와 외부 ID를 복사합니다. Braze에 값 입력 단계에서 다시 돌아와야 하므로 양식을 열어 둡니다.
IAM 역할 생성
- AWS 콘솔에서 IAM > 역할로 이동한 다음 역할 생성을 선택합니다.
- 신뢰할 수 있는 엔터티 유형으로 AWS 계정을 선택한 다음 다른 AWS 계정을 선택합니다.
- Braze 계정 ID를 붙여넣습니다. 외부 ID 필요를 선택한 다음 외부 ID를 붙여넣습니다.
- 권한 단계는 건너뜁니다. 역할 이름을 입력한 다음 역할 생성을 선택합니다. 권한 정책은 권한 정책 추가 단계에서 추가합니다.
- 역할의 Amazon 리소스 이름(ARN)을 복사합니다. 이 값은 Braze에 값 입력 단계에서 Braze에 입력합니다.
역할의 신뢰 정책은 다음 예시와 같습니다. BRAZE_ACCOUNT_ID와 EXTERNAL_ID를 자격 증명 양식의 값으로 바꿉니다.
{
"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"
}
}
}
]
}
권한 정책 추가
역할에 인라인 권한 정책을 추가합니다. 역할의 권한 탭에서 권한 추가 > 인라인 정책 생성을 선택한 다음, 아래 탭에서 클러스터 유형에 맞는 JSON을 붙여넣습니다.
Redshift Serverless의 경우 정책에서 워크그룹에 대한 redshift-serverless:GetCredentials를 허용해야 합니다. Resource 값에는 워크그룹 이름이 아닌 워크그룹 ID를 사용합니다. ID를 찾으려면 Redshift 콘솔에서 워크그룹을 열고 워크그룹 ARN에서 ID를 복사합니다.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "redshift-serverless:GetCredentials",
"Resource": "arn:aws:redshift-serverless:REGION:AWS_ACCOUNT_ID:workgroup/WORKGROUP_ID"
}
]
}
REGION, AWS_ACCOUNT_ID, WORKGROUP_ID를 워크그룹에 해당하는 값으로 바꿉니다.
프로비저닝된 클러스터의 경우 정책에서 동기화할 데이터베이스에 대한 redshift:GetClusterCredentialsWithIAM을 허용해야 합니다.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "redshift:GetClusterCredentialsWithIAM",
"Resource": "arn:aws:redshift:REGION:AWS_ACCOUNT_ID:dbname:CLUSTER_IDENTIFIER/DATABASE_NAME"
}
]
}
REGION, AWS_ACCOUNT_ID, CLUSTER_IDENTIFIER, DATABASE_NAME을 클러스터에 해당하는 값으로 바꿉니다.
데이터베이스 사용자 생성 및 액세스 권한 부여
Braze는 IAMR:ROLE_NAME이라는 데이터베이스 사용자로 Redshift에 로그인합니다. 여기서 ROLE_NAME은 생성한 IAM 역할의 이름입니다. 이 사용자는 braze_user와 다르므로 다른 데이터베이스 사용자에게 부여한 권한은 이 사용자에게 적용되지 않습니다.
Braze에서 연결을 테스트하기 전에 Redshift 데이터베이스에서 다음 문을 실행해 사용자를 생성합니다. 이 문은 Braze가 처음 연결하기 전에 실행해도 안전합니다.
CREATE USER "IAMR:ROLE_NAME" PASSWORD DISABLE;
그런 다음 이 사용자에게 소스 테이블에 대한 액세스 권한을 부여합니다. 3단계: 사용자에게 권한 부여와 동일한 GRANT 문을 사용하되, braze_user를 "IAMR:ROLE_NAME"으로 바꿉니다. 사용자 이름에 콜론이 포함되어 있으므로 큰따옴표는 그대로 유지합니다.
Redshift를 연결된 소스로도 사용하는 경우, 해당 섹션에 나열된 것과 동일한 권한을 이 사용자에게 부여합니다.
Braze에 값 입력
Braze 자격 증명 양식으로 돌아갑니다. Braze 설정 단계에서 다음 값을 입력합니다.
| Braze 필드 | 입력할 내용 |
|---|---|
| 클러스터 유형 | Serverless(기본값) 또는 Provisioned. |
| 역할 ARN | 생성한 역할의 ARN으로, arn:aws:iam::123456789012:role/ROLE_NAME 형식입니다. |
| 리전 | Redshift 클러스터 또는 워크그룹이 실행되는 AWS 리전(예: us-east-1). Braze 인스턴스의 리전과 다를 수 있습니다. |
| 워크그룹 이름 또는 클러스터 식별자 | Serverless의 경우 워크그룹 이름을, 프로비저닝된 클러스터의 경우 클러스터 식별자를 입력합니다. |
| 호스트 | 클러스터 또는 워크그룹의 엔드포인트. Serverless의 경우 Braze가 역할 ARN, 리전, 워크그룹 이름을 바탕으로 이 필드를 자동으로 채우며, 직접 수정할 수 있습니다. 프로비저닝된 클러스터의 경우 엔드포인트를 입력합니다. |
| 포트 | 클러스터 또는 워크그룹의 포트. 기본값은 5439입니다. 1024부터 65535 사이의 값을 입력합니다. |

자격 증명을 저장한 후에는 이 연결 세부 정보를 변경할 수 없습니다. 변경하려면 새 자격 증명을 생성해야 합니다. 그런 다음 소스를 새 자격 증명으로 옮길 수 있습니다.
IAM 역할 인증은 SSH 터널 사용 여부와 관계없이 작동합니다. 터널 및 IP 허용 목록 설정은 다른 방법과 마찬가지로 4단계: Braze IP에 대한 액세스 허용을 따릅니다. 자격 증명을 저장한 후에는 이름을 변경할 수 있습니다. 터널을 사용하는 경우 터널 키를 교체할 수도 있습니다.
Braze의 연결 테스트 방식
연결을 테스트할 때와 Braze가 연결할 때마다, Braze는 먼저 어떤 워크스페이스에도 속하지 않는 테스트 외부 ID braze-cdi-000000000000000000000000을 사용해 역할 수임을 시도합니다. 역할은 이 시도를 AccessDenied 오류로 거부해야 합니다. AWS가 이를 허용하면 연결 테스트가 실패합니다. 도움이 필요하면 IAM 역할이 외부 ID를 요구하지 않음을 참조하세요.
AWS CloudTrail에서는 이러한 시도가 세션 이름 Braze-CDI-Redshift의 AssumeRole 호출로 표시됩니다. 거부된 시도는 예상된 동작이며 Braze에 데이터 액세스 권한을 부여하지 않습니다. 이 외부 ID만 거부하는 조건은 추가하지 마세요. 그렇게 하면 역할이 여전히 다른 Braze 워크스페이스를 신뢰하게 됩니다.
Braze 액세스 제거
Braze가 데이터에 액세스하지 못하도록 하려면 역할을 삭제하거나, 역할의 신뢰 정책에서 Braze 계정에 대한 신뢰 문을 제거합니다. IAMR:ROLE_NAME 데이터베이스 사용자를 삭제할 수도 있습니다.
AWS CLI로 설정
또는 AWS 명령줄 인터페이스(CLI)를 사용해 역할을 생성하고 권한 정책을 연결할 수 있습니다. 이 예시는 Serverless 워크그룹을 사용합니다. 프로비저닝된 클러스터의 경우 정책 문서를 권한 정책 추가의 Provisioned 탭에 있는 정책으로 바꿉니다.
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"
}]
}'
다음 입력 안내 값을 바꿉니다.
BRAZE_ACCOUNT_ID및EXTERNAL_ID: 자격 증명 양식의 값REGION,AWS_ACCOUNT_ID,WORKGROUP_ID: 워크그룹에 해당하는 값
create-role 명령은 출력에 역할 ARN을 반환합니다. 자세한 내용은 AWS CLI 명령 참조의 create-role을 참조하세요. ARN을 복사한 다음 데이터베이스 사용자 생성 및 액세스 권한 부여로 계속 진행합니다.
Username and password
Braze는 비밀번호가 설정된 데이터베이스 사용자로 Redshift에 연결합니다. Braze용 사용자를 생성하세요.
CREATE USER braze_user PASSWORD '{password}';
사용자 이름과 비밀번호는 소스를 생성할 때 Braze 대시보드에 입력해야 하므로, 그때까지 안전한 곳에 보관하세요.
3단계: 사용자에게 권한 부여하기
Braze가 연결할 때 사용하는 데이터베이스 사용자에게 소스 테이블에 대한 액세스 권한을 부여합니다. 다음 예시에서는 braze_user를 사용합니다. IAM 역할 인증을 사용하는 경우 braze_user를 "IAMR:ROLE_NAME"(으)로 바꾸세요. 자세한 내용은 데이터베이스 사용자 생성 및 액세스 권한 부여를 참조하세요.
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;
이는 이 사용자에게 필요한 최소 권한입니다. 여러 CDI 통합을 생성하는 경우 스키마에 권한을 부여하거나 그룹을 사용하여 권한을 관리하는 것이 좋습니다.
4단계: Braze IP에 대한 액세스 허용
방화벽이나 기타 네트워크 정책이 있는 경우, Braze가 Redshift 인스턴스에 네트워크로 액세스할 수 있도록 허용해야 합니다. Redshift URL 엔드포인트의 예시는 “example-cluster.ap-northeast-2.redshift.amazonaws.com”입니다.
알아두어야 할 중요한 사항은 다음과 같습니다.
- Braze가 Redshift의 데이터에 액세스할 수 있도록 보안 그룹을 변경해야 할 수도 있습니다.
- 표에 있는 IP와 Redshift 클러스터를 쿼리하는 데 사용하는 포트(기본값은 5439)에서 인바운드 트래픽을 명시적으로 허용해야 합니다. 인바운드 규칙이 “모두 허용”으로 설정되어 있더라도 이 포트에서 Redshift TCP 연결을 명시적으로 허용해야 합니다.
- Braze가 클러스터에 연결하려면 Redshift 클러스터의 엔드포인트에 공개적으로 액세스할 수 있어야 합니다.
- Redshift 클러스터를 공개적으로 액세스할 수 없도록 하려면 VPC와 EC2 인스턴스를 설정하고 SSH 터널을 사용하여 Redshift 데이터에 액세스할 수 있습니다. 자세한 내용은 AWS 지식 센터 게시물을 참조하세요.
Braze 대시보드의 리전에 해당하는 다음 IP로부터의 액세스를 허용하세요.
인스턴스 US-01, US-02, US-03, US-04, US-05, US-06, US-07의 경우, 관련 IP 주소는 다음과 같습니다.
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
인스턴스 US-08의 경우, 관련 IP 주소는 다음과 같습니다.
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
인스턴스 US-10의 경우, 관련 IP 주소는 다음과 같습니다.
100.25.232.16435.168.86.17952.7.44.1173.92.153.1835.172.3.12950.19.162.19
인스턴스 EU-01 및 EU-02의 경우, 관련 IP 주소는 다음과 같습니다.
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
인스턴스 AU-01의 경우, 관련 IP 주소는 다음과 같습니다.
13.210.1.14513.211.70.15913.238.45.5452.65.73.16754.153.242.23954.206.45.213
인스턴스 ID-01의 경우, 관련 IP 주소는 다음과 같습니다.
108.136.157.246108.137.30.20716.78.128.7116.78.14.13416.78.162.20843.218.73.35
인스턴스 JP-01의 경우, 관련 IP 주소는 다음과 같습니다.
13.159.155.21254.199.221.24113.192.23.1654.250.120.13918.181.114.2323.114.38.100
인스턴스 KR-01의 경우, 관련 IP 주소는 다음과 같습니다.
43.200.215.452.79.67.17552.79.113.603.34.212.9254.116.134.2313.37.197.225
5단계: Braze 대시보드에서 새 소스 만들기
Braze 대시보드에서 데이터 설정 > 클라우드 데이터 수집 > 소스로 이동하여 데이터 소스 추가를 선택한 다음 Amazon Redshift를 선택합니다.
5.1단계: Redshift 연결 정보 및 소스 테이블 추가
소스의 이름을 정하고 Redshift 자격 증명과 구성을 입력합니다. 2단계에서 설정한 인증 방법을 선택하고 해당 자격 증명을 입력합니다:
- IAM role: Role ARN, Region, Cluster type, and Workgroup name or Cluster identifier
- Username and password: Username and Password
비공개 네트워크 터널을 사용하는 경우 슬라이더를 토글하고 터널 정보를 입력합니다. 그런 다음 다음 단계로 진행합니다.

Amazon Redshift는 데이터베이스 식별자에 추가 문자를 지원하지만, Braze 대시보드의 데이터베이스 이름 필드에는 영문자(A–Z, a–z), 숫자(0–9), 밑줄(_)만 입력할 수 있습니다.
5.2단계: 연결 테스트 및 소스에 연결
다음으로 연결 테스트를 선택합니다. 테스트에 성공하면 나머지 설정을 완료하고 소스에 연결을 클릭합니다. 연결에 실패하면 문제 해결에 도움이 되는 오류 메시지가 표시됩니다.
6단계: Braze 대시보드에서 새 동기화 만들기
데이터 설정 > 클라우드 데이터 수집 > 동기화로 이동한 후 데이터 동기화 만들기를 선택합니다.
동기화 세부 정보 구성 및 데이터 정의
동기화 이름을 입력합니다. 그런 다음 활성 소스와 동기화 데이터 유형을 선택합니다. 이어서 동기화 모드를 선택하고 데이터를 정의합니다. 그런 다음 미리 보기 및 유효성 검사를 선택합니다.
유효성 검사에 성공하면 데이터 미리 보기가 표시됩니다. 계속하려면 다음: 알림을 선택합니다. 유효성 검사에 실패하면 문제 해결에 도움이 되는 오류 메시지가 표시됩니다.

다음 단계로 진행하려면 먼저 동기화의 유효성 검사를 성공적으로 완료해야 합니다. 동기화 만들기 페이지를 닫아야 하는 경우 초안으로 저장을 선택하여 진행 중인 작업을 보관하세요.
알림 기본 설정 추가
동기화 오류 알림을 받을 연락처 이메일을 입력합니다. Braze는 이 연락처 정보를 사용하여 예기치 않은 테이블 액세스 손실과 같은 통합 오류에 대한 알림을 보냅니다.
연락처 이메일로는 테이블 누락, 권한 문제 등 전역 또는 동기화 수준의 오류 알림만 전송됩니다. 행 수준 문제에 대한 알림은 전송되지 않습니다. 전역 오류는 동기화 실행을 막는 연결상의 심각한 문제를 나타냅니다.
이러한 문제에는 다음이 포함될 수 있습니다.
- 연결 문제
- 리소스 부족
- 권한 문제
- 카탈로그 티어의 공간 부족(카탈로그 동기화에만 해당)
스케줄 설정
마지막으로 동기화를 비반복 또는 반복으로 구성합니다.
비반복 동기화는 대시보드에서 지금 동기화를 선택하거나 동기화 트리거 엔드포인트를 호출할 때만 실행됩니다.
반복 동기화는 짧게는 5분마다, 길게는 한 달에 한 번까지 실행할 수 있습니다. 기본적으로 대시보드에서 설정할 수 있는 가장 짧은 간격은 15분이며, 이를 통해 웨어하우스 컴퓨팅 비용과 요청량을 관리할 수 있습니다. 5분 간격으로 동기화하려면 Braze 지원팀 또는 고객 성공 매니저에게 문의하세요. Braze는 반복 동기화를 UTC 기준으로 스케줄링합니다.

통합을 초안 상태에서 활성 상태로 전환하려면 먼저 유효성 검사를 성공적으로 완료해야 합니다. 만들기 페이지를 닫아도 통합은 저장되며, 세부 정보 페이지를 다시 방문하여 변경하고 유효성을 검사할 수 있습니다.
동기화 실행
동기화를 활성화하면 설정 중에 구성한 스케줄에 따라 실행됩니다. 스케줄 외에 동기화를 실행하거나 최신 데이터를 가져오려면 지금 동기화를 선택하세요. 이 실행은 이후 정기적으로 예약된 동기화에 영향을 주지 않습니다. 데이터가 업데이트될 때 자동으로 동기화를 시작하려면 파이프라인에서 동기화 트리거 엔드포인트를 호출하세요.
추가 통합 또는 사용자 설정하기(선택 사항)
Braze와 여러 통합을 설정할 수 있습니다. 동일한 Redshift 계정에 연결하는 경우 추가 동기화를 생성할 때 기존 자격 증명을 재사용할 수 있습니다.
여러 통합에서 동일한 사용자를 재사용하는 경우, 해당 사용자를 모든 활성 동기화에서 제거하기 전까지는 Braze 대시보드에서 삭제할 수 없습니다.
Redshift를 연결된 소스로 사용하기
연결된 소스는 데이터를 Braze로 동기화하는 대신 사용할 수 있는 제로 카피 방식입니다. Braze는 기본 데이터를 복사하지 않고 Redshift 인스턴스에 직접 쿼리하여 CDI Segment를 구축합니다. 개념, 제한 사항, 비용 관련 내용은 연결된 소스를 참조하세요.
1단계: 사용자 생성 및 권한 부여
2단계: 인증 설정의 방법 중 하나를 선택하여 Braze에 적용합니다. 그런 다음, Braze 데이터베이스 사용자에게 다음 권한을 부여합니다. 예시에서는 braze_user를 사용합니다. IAM 역할 인증을 사용하는 경우 braze_user를 "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;
연결된 소스에서 사용할 사용자를 생성합니다. 이 사용자는 CDI 세그먼트 확장에서 사용할 수 있는 테이블 목록을 생성하고, 소스 테이블을 쿼리하여 새 Segment를 생성하는 데 사용됩니다. 연결된 소스가 생성되면 Braze는 소스 스키마에서 해당 사용자가 사용할 수 있는 모든 테이블의 이름과 설명을 검색합니다. 여러 CDI 통합을 생성하는 경우 스키마에 권한을 부여하거나 그룹을 사용하여 권한을 관리하는 것이 좋습니다.
스키마의 모든 테이블에 대한 액세스 권한을 부여하거나 특정 테이블에만 권한을 부여할 수 있습니다. Braze 역할이 액세스할 수 있는 테이블은 모두 CDI 세그먼트 확장에서 쿼리할 수 있습니다. 새 테이블이 생성되면 해당 테이블에 대한 액세스 권한을 사용자에게 부여하거나, 사용자에 대한 기본 권한을 설정하세요.
create table 권한은 Braze가 Braze에서 Segment를 업데이트하기 전에 CDI 세그먼트 확장 쿼리 결과로 테이블을 생성할 수 있도록 하기 위해 필요합니다. Braze는 Segment마다 임시 테이블을 생성하며, 이 테이블은 Braze가 Segment를 업데이트하는 동안에만 유지됩니다.
네트워크 액세스 설정은 4단계와 동일합니다.
2단계: Braze에서 연결된 소스 생성
데이터 설정 > 클라우드 데이터 수집 > 연결된 소스로 이동하여 데이터 소스 추가를 선택한 다음 Amazon Redshift를 선택합니다.
소스 설정에서 다음을 입력합니다.
- 자격 증명: Redshift 호스트 URL, 포트, 그리고 인증 방법에 해당하는 필드. IAM role의 경우 다음을 입력합니다: Role ARN, Region, Cluster type, and Workgroup name or Cluster identifier. Username and password의 경우 다음을 입력합니다: Username and Password.
- 구성: 데이터베이스 및 스키마
필요한 경우 SSH 터널로 연결을 활성화하고 터널 호스트, 터널 포트, 터널 사용자 이름을 입력합니다.
연결된 소스의 이름을 정합니다. 이 이름은 새 CDI 세그먼트 확장을 생성할 때 사용 가능한 소스 목록에 표시됩니다.
이 소스의 최대 실행 시간을 구성합니다. Braze는 최대 실행 시간을 초과하는 쿼리를 자동으로 중단합니다. 허용되는 최대 실행 시간은 60분이며, 실행 시간을 낮게 설정하면 Redshift 계정에서 발생하는 비용을 줄일 수 있습니다. 이 설정은 이 소스를 통해 실행되는 쿼리에 적용되며, 이 소스를 사용하는 동기화와 CDI 세그먼트 확장도 포함됩니다.
3단계: Redshift 구성 마무리
자격 증명에서 SSH 터널로 연결을 선택한 경우 연결 테스트 단계에서 RSA 공개 키를 기록해 두고 SSH 터널 사용자에게 추가합니다.
사용자에게 키를 추가한 후 Braze에서 연결 테스트를 선택한 다음 완료를 선택합니다. 이제 연결된 소스가 생성되어 CDI 세그먼트 확장에서 사용할 수 있습니다.
Braze에서 여러 개의 연결된 소스를 설정할 수 있지만, 각 소스는 서로 다른 스키마에 연결되도록 구성해야 합니다. 추가 소스를 생성할 때 동일한 Redshift 계정에 연결하는 경우 기존 자격 증명을 재사용할 수 있습니다.
기존 열에서 페이로드 형식 지정하기
내부적으로 각 속성을 개별 열에 저장하려는 경우, Braze와의 동기화를 채우려면 해당 열을 JSON 문자열로 변환해야 합니다. Redshift에서 다음 쿼리를 사용하여 소스 열을 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";
최적화에 관한 더 많은 지침은 클라우드 데이터 수집 모범 사례를 참조하세요.
문제 해결
연결 테스트가 느리게 실행됨
연결 테스트는 데이터 웨어하우스에서 실행되므로 웨어하우스 용량을 늘리면 속도가 빨라질 수 있습니다. 서버리스 SQL 인스턴스를 사용하면 워밍업 시간이 최소화되고 쿼리 처리량이 향상되지만, 통합 비용이 다소 높아질 수 있습니다.
Permission denied for relation {table_name} 오류
이 오류가 발생하면 다음을 수행하세요.
- 해당 사용자에게 스키마에 대한
usage권한을 부여합니다. - 해당 사용자에게 테이블에 대한
select권한을 부여합니다.
IAM 역할이 외부 ID를 요구하지 않음
IAM 역할 인증을 사용하는 경우 연결 테스트가 다음 오류와 함께 실패할 수 있습니다.
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.
이 오류는 Braze가 연결을 테스트하는 방식에 설명된 테스트용 외부 ID를 AWS가 허용했다는 의미입니다. 이 문제를 해결하려면 역할의 신뢰 정책을 업데이트하세요.
- AWS 콘솔에서 역할을 열고 Trust relationships 탭을 선택합니다.
- Braze 계정이 역할을 수임하도록 허용하는 모든 문(statement)에
sts:ExternalId에 대한StringEquals조건을 추가하고, 자격 증명 양식에 표시된 외부 ID를 정확히 그대로 사용합니다.braze-cdi-*와 같은 패턴 조건은 모두 제거합니다. - Braze에서 연결을 다시 테스트합니다.
Braze가 역할의 외부 ID 요구 여부를 확인할 수 없음
IAM 역할 인증을 사용하는 경우 연결 테스트가 다음 오류와 함께 실패할 수 있습니다.
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.
이 오류는 Braze가 확인을 완료하지 못했다는 뜻일 뿐, 역할의 권한 범위가 너무 넓다는 의미는 아닙니다. 연결을 다시 테스트하세요. 오류가 계속되면 Braze 지원팀에 문의하세요.
IAM 역할을 수임할 수 없음
IAM 역할 인증을 사용하는데 연결 테스트가 “Unable to assume IAM role”로 시작하는 오류와 함께 실패하면 다음 사항을 확인하세요.
- 역할의 신뢰 정책에 자격 증명 양식의 Braze 계정 ID가 신뢰할 수 있는 주체(principal)로 등록되어 있는지
- 역할의 신뢰 정책이 자격 증명 양식의 외부 ID와 정확히 일치하는 값을 요구하는지
- Braze에 입력한 Role ARN이 생성한 역할의 ARN과 일치하는지
- Braze 인스턴스가 자카르타(ID-01)처럼 기본적으로 활성화되지 않은 AWS 리전에 있는 경우, AWS 계정에서 해당 리전이 활성화되어 있는지
AWS는 이러한 원인 모두에 대해 동일한 AccessDenied 오류를 반환하므로 각 항목을 하나씩 확인하세요.
Redshift 데이터베이스 자격 증명을 가져올 수 없음
IAM 역할 인증을 사용하는데 연결 테스트가 “Unable to get Redshift database credentials as IAM role”로 시작하는 오류와 함께 실패하면 다음 사항을 확인하세요.
- 역할의 권한 정책이 Serverless의 경우
redshift-serverless:GetCredentials를, 프로비저닝된 클러스터의 경우redshift:GetClusterCredentialsWithIAM을 허용하는지 - Serverless의 경우 정책의
Resource값에 작업 그룹 이름이 아닌 작업 그룹 ID를 사용하는지(두 값은 서로 다릅니다) - 프로비저닝된 클러스터의 경우 정책의
Resource값이 클러스터와 데이터베이스에 대한dbnameARN(arn:aws:redshift:REGION:AWS_ACCOUNT_ID:dbname:CLUSTER_IDENTIFIER/DATABASE_NAME형식)인지 - Braze에 입력한 Region, Workgroup name 또는 Cluster identifier가 클러스터 또는 작업 그룹과 일치하는지
연결 테스트 성공 후 권한 거부
연결 테스트는 성공했지만 동기화 또는 유효성 검사에서 권한 거부 오류가 반환된다면, braze_user와 같은 다른 사용자에게 액세스 권한을 부여했을 가능성이 높습니다. IAM 역할 인증을 사용하면 Braze는 "IAMR:ROLE_NAME"(으)로 로그인합니다. 해당 사용자에게 스키마 및 테이블 권한을 부여하세요. 자세한 내용은 데이터베이스 사용자 생성 및 액세스 권한 부여를 참조하세요.
연결 생성 오류
이 오류가 발생하면 Redshift 엔드포인트와 포트가 올바른지 확인하세요.
SSH 터널 생성 오류
이 오류가 발생하면 다음을 확인하세요.
- Braze 대시보드의 공개 키가 SSH 터널링에 사용되는 EC2 호스트에 있는지 확인합니다.
- 사용자 이름이 올바른지 확인합니다.
- SSH 터널이 올바른지 확인합니다.
잘못된 스냅샷 식별자
연결 테스트 또는 동기화 설정 중에 Braze가 Invalid snapshot identifier 오류를 반환하면, 소스 객체를 쿼리할 때 사용되는 스냅샷 참조를 Redshift가 확인할 수 없다는 의미입니다.
Redshift에서 스냅샷은 클러스터의 특정 시점 백업입니다. 각 스냅샷에는 Redshift가 해당 백업 상태를 참조하는 데 사용하는 고유 식별자가 있습니다. 자세한 내용은 Amazon Redshift 스냅샷 및 백업을 참조하세요.
이 오류는 스냅샷 복사, 복원 또는 복제 관련 작업 중과 같이 Braze가 소스 객체를 검증하는 동안 메타데이터가 변경될 때 발생할 수 있습니다. 자세한 내용은 다른 AWS 리전으로 스냅샷 복사 및 스냅샷에서 클러스터 복원을 참조하세요.
문제를 해결하려면 다음을 수행하세요.
- 클러스터 엔드포인트, 데이터베이스, 스키마, 객체 이름 등 Braze의 소스 설정을 확인합니다.
- Redshift에서 동일한 쿼리를 직접 실행하여 테이블 또는 뷰를 안정적으로 읽을 수 있는지 확인합니다.
- 진행 중인 스냅샷, 복원, 크기 조정 또는 복제 작업이 완료된 후 다시 시도합니다.
- 문제가 계속되면 자주 변경되는 기본 테이블 대신 구체화된 뷰를 쿼리합니다.
구체화된 뷰는 미리 계산된 쿼리 결과를 저장하며 스케줄에 따라 새로 고칠 수 있으므로 CDI 동기화의 읽기 작업을 더 안정적으로 만들 수 있습니다. 자세한 내용은 Amazon Redshift의 구체화된 뷰를 참조하세요.
예시:
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;
구체화된 뷰를 생성한 후에는 Braze CDI 동기화에서 기본 테이블 대신 구체화된 뷰 이름을 소스 객체로 사용하세요.
SQL 검사를 실행할 위치
CDI 통합에서 사용하는 것과 동일한 테이블 또는 뷰를 대상으로 Redshift SQL 편집기에서 직접 검증 검사를 실행하세요. Query Editor v2를 사용하세요. 자세한 내용은 Amazon Redshift Query Editor v2 사용을 참조하세요.
관련 페이지
- 필수 열과 페이로드 형식은 테이블 설정을 참조하세요.
- 동기화 일정 설정과 데이터 포인트 효율성은 모범 사례를 참조하세요.
- 동기화 실행 모니터링은 동기화 로그 및 관측 가능성을 참조하세요.
- 모든 소스에 공통된 질문은 FAQ를 참조하세요.