콘텐츠로 건너뛰기

이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.

데이터 웨어하우스 스토리지 통합

이 페이지에서는 Braze 클라우드 데이터 수집(CDI)을 사용하여 관련 데이터를 Snowflake, Redshift, BigQuery 및 Databricks 통합과 동기화하는 방법을 설명합니다.

데이터 웨어하우스 통합 설정

클라우드 데이터 수집 통합을 사용하려면 Braze와 데이터 웨어하우스 인스턴스 양쪽에서 몇 가지 설정을 해야 합니다. 다음 단계에 따라 통합을 설정하세요.

Snowflake 인스턴스에서 Braze에 동기화할 테이블 또는 뷰를 설정합니다.
역할과 웨어하우스를 생성하고, Braze가 Workload Identity Federation 또는 RSA 키 페어로 인증할 사용자를 생성합니다.
Braze 대시보드에서 새 Snowflake 소스를 생성합니다. 키 페어를 사용하는 경우 Braze가 제공하는 공개 키를 Snowflake 사용자에 추가합니다. Workload Identity Federation을 사용하는 경우 자격 증명 양식에 표시되는 문을 Snowflake 워크시트에서 실행합니다.
Braze 대시보드에서 동기화를 생성하고, 통합을 테스트한 다음 동기화를 시작합니다.

팁

Snowflake 빠른 시작 가이드에서는 샘플 코드를 제공하고, Snowflake Streams와 CDI를 사용해 데이터를 Braze에 동기화하는 자동화된 파이프라인을 만드는 데 필요한 단계를 안내합니다.

동기화하려는 Redshift 테이블에 Braze의 액세스가 허용되어 있는지 확인합니다. Braze는 인터넷을 통해 Redshift에 연결합니다.
Redshift 인스턴스에서 Braze에 동기화할 테이블 또는 뷰를 설정합니다.
Braze 대시보드에서 새 소스와 동기화를 생성합니다.
통합을 테스트하고 동기화를 시작합니다.

참고

동기화당 처리되는 행 수는 웨어하우스 성능, 네트워크 지연 시간, 동기화 쿼리와 일치하는 새 데이터의 양에 따라 달라집니다. 대시보드의 통합 동기화 기록에서 최근 실행의 소요 시간과 행 수를 확인할 수 있습니다.

Braze가 Workload Identity Federation 또는 서비스 계정 키를 통해 액세스하는 서비스 계정을 생성하고, 동기화하려는 데이터가 포함된 BigQuery 프로젝트와 데이터 세트에 대한 액세스를 허용합니다.
BigQuery 계정에서 Braze에 동기화할 테이블 또는 뷰를 설정합니다.
Braze 대시보드에서 새 소스와 동기화를 생성합니다.
통합을 테스트하고 동기화를 시작합니다.

OAuth 머신 간(M2M) 인증용 서비스 주체 또는 개인 액세스 토큰을 생성하고, 동기화하려는 데이터가 포함된 Databricks 카탈로그와 스키마에 대한 액세스를 허용합니다.
Databricks 계정에서 Braze에 동기화할 테이블 또는 뷰를 설정합니다.
Braze 대시보드에서 새 소스와 동기화를 생성합니다.
통합을 테스트하고 동기화를 시작합니다.

중요

Braze가 Classic 및 Pro SQL 인스턴스에 연결할 때 2~5분 정도의 워밍업 시간이 걸릴 수 있으며, 이로 인해 연결 설정 및 테스트 중은 물론 예약된 동기화가 시작될 때도 지연이 발생할 수 있습니다. 서버리스 SQL 인스턴스를 사용하면 워밍업 시간이 최소화되고 쿼리 처리량이 향상되지만, 통합 비용이 다소 높아질 수 있습니다.

서비스 주체를 생성하고 Fabric API에 대한 액세스 권한을 부여합니다.
공유 작업 공간을 설정하고 서비스 주체에 해당 작업 공간에 대한 액세스 권한을 부여합니다.
공유 Fabric 작업 공간에서 Braze에 동기화할 테이블 또는 뷰를 설정합니다.
Braze 대시보드에서 새 소스와 동기화를 생성합니다.
통합을 테스트하고 동기화를 시작합니다.

1단계: 테이블 또는 뷰 설정

이 섹션의 단계에서는 PAYLOAD 열이 있는 테이블을 생성합니다. 데이터 정의 단계에서 Visual로 열을 매핑하거나 SQL로 쿼리를 작성할 계획이라면 기존 테이블이나 뷰를 대신 사용할 수 있습니다. 이 경우 사용 중인 웨어하우스의 테이블 생성 단계를 건너뛰고, 동기화하려는 테이블 또는 뷰에 대한 읽기 권한을 Braze에 부여하세요. 옵션 비교는 데이터 정의 옵션 선택을 참조하세요.

참고

PAYLOAD 열을 사용하는 경우, 소스 테이블 또는 뷰에 다음 섹션의 탭에서 해당 웨어하우스용으로 나열되지 않은 열(예: 감사 또는 해싱용 열)이 포함되어도 괜찮습니다. Braze는 해당 탭에 설명된 열만 읽으며, 다른 열은 클라우드 데이터 수집 동기화 중에 사용되지 않습니다.

1.1단계: 테이블 설정

CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required
     EXTERNAL_ID VARCHAR(16777216),
     --if using user alias, both alias_name and alias_label are required
     ALIAS_LABEL VARCHAR(16777216),
     ALIAS_NAME VARCHAR(16777216),
     --braze_id can only be used to update existing users created through the Braze SDK
     BRAZE_ID VARCHAR(16777216),
     --If you include both email and phone, email is used as the primary identifier
     EMAIL VARCHAR(16777216),
     PHONE VARCHAR(16777216),
     PAYLOAD VARCHAR(16777216) NOT NULL
);

데이터베이스, 스키마, 테이블 이름은 원하는 대로 지정할 수 있지만, 열 이름은 위의 정의와 일치해야 합니다.

UPDATED_AT - 이 행이 테이블에서 업데이트되거나 테이블에 추가된 시간입니다. Braze는 UPDATED_AT이 마지막으로 동기화된 값보다 이후인 행을 동기화합니다. 새 행이 경계 타임스탬프와 정확히 같은 타임스탬프를 가지는 경우, 해당 타임스탬프의 행이 다시 동기화될 수 있습니다.
사용자 식별자 열 - 테이블에는 하나 이상의 사용자 식별자 열이 포함될 수 있습니다. 각 행에는 식별자가 하나만 포함되어야 합니다(external_id, alias_name과 alias_label의 조합, braze_id, email 또는 phone 중 하나). 소스 테이블에는 1개, 2개, 3개, 4개 또는 5개 식별자 유형 모두에 대한 열이 있을 수 있습니다.
- EXTERNAL_ID - 업데이트하려는 사용자를 식별합니다. Braze에서 사용하는 external_id 값과 일치해야 합니다.
- ALIAS_NAME 및 ALIAS_LABEL - 이 두 열은 사용자 별칭 객체를 생성합니다. alias_name은 고유 식별자여야 하며, alias_label은 별칭 유형을 지정합니다. 사용자는 레이블이 다른 여러 별칭을 가질 수 있지만, alias_label당 alias_name은 하나만 가질 수 있습니다.
- BRAZE_ID - Braze 사용자 식별자입니다. Braze SDK에서 생성되며, 클라우드 데이터 수집을 통해 Braze ID로 신규 사용자를 생성할 수는 없습니다. 신규 사용자를 생성하려면 외부 사용자 ID 또는 사용자 별칭을 지정하세요.
- EMAIL - 사용자의 이메일 주소입니다. 동일한 이메일 주소를 가진 프로필이 여러 개 있는 경우, 가장 최근에 업데이트된 프로필이 우선적으로 업데이트됩니다. 이메일과 전화번호를 모두 포함하면 이메일이 기본 식별자로 사용됩니다.
- PHONE - 사용자의 전화번호입니다. 동일한 전화번호를 가진 프로필이 여러 개 있는 경우, 가장 최근에 업데이트된 프로필이 우선적으로 업데이트됩니다.
PAYLOAD - Braze에서 사용자에게 동기화하려는 필드의 JSON 문자열입니다.

1.2단계: 역할 및 데이터베이스 권한 설정

CREATE ROLE BRAZE_INGESTION_ROLE;

GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;

필요에 따라 이름을 변경할 수 있지만, 권한은 위의 예시와 일치해야 합니다.

1.3단계: 웨어하우스 설정 및 Braze 역할에 액세스 권한 부여

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

참고

웨어하우스에는 auto-resume 플래그가 켜져 있어야 합니다. 그렇지 않은 경우, 쿼리 실행 시 Braze가 웨어하우스를 켤 수 있도록 웨어하우스에 대한 추가 OPERATE 권한을 Braze에 부여하세요.

1.4단계: 사용자 설정

Braze는 다음 방법 중 하나로 Snowflake에 인증합니다.

Workload Identity Federation: Braze는 Snowflake용 Braze AWS 아이덴티티에 바인딩된 TYPE = SERVICE 사용자로 연결합니다. 이 사용자에게는 비밀번호와 RSA 키가 없습니다.
키 페어: Braze는 RSA 키 페어로 연결합니다. Braze가 생성한 공개 키를 Snowflake 사용자에 추가합니다.

기존 RSA 키 페어 자격 증명은 계속 작동하므로 마이그레이션할 필요가 없습니다. 한 가지 방법을 따르세요.

workload identity federation
key pair

1.2단계 및 1.3단계에서 역할, 웨어하우스, 데이터베이스 권한을 생성합니다. Snowflake 계정에서 네트워크 정책을 사용하는 경우, 1.5단계에 설명된 대로 Braze IP 주소를 허용하세요.

Snowflake 자격 증명 양식에서 서비스 사용자를 생성하고, 해당 문을 Snowflake 워크시트에서 실행합니다. 이 문의 역할과 실행 위치는 Workload Identity Federation을 위한 Snowflake 구성을 참조하세요.

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

이 단계가 끝나면 Braze와 연결 정보를 공유하고 사용자에 공개 키를 추가합니다.

참고

서로 다른 워크스페이스를 동일한 Snowflake 계정에 연결하는 경우, 통합을 생성하는 각 Braze 워크스페이스마다 고유한 사용자를 생성해야 합니다. 하나의 워크스페이스 안에서는 여러 통합에 동일한 사용자를 재사용할 수 있지만, 동일한 Snowflake 계정의 사용자가 여러 워크스페이스에서 중복되면 통합 생성이 실패합니다.

1.5단계: Snowflake 네트워크 정책에서 Braze IP 허용(선택 사항)

Snowflake 계정 구성에 따라 Snowflake 네트워크 정책에서 다음 IP 주소를 허용해야 할 수 있습니다. 이 설정을 활성화하는 방법에 대한 자세한 내용은 네트워크 정책 수정에 관한 Snowflake 설명서를 참조하세요.

인스턴스 US-01, US-02, US-03, US-04, US-05, US-06, US-07의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 US-08의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 US-10의 경우, 관련 IP 주소는 다음과 같습니다.

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

인스턴스 EU-01 및 EU-02의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 AU-01의 경우, 관련 IP 주소는 다음과 같습니다.

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

인스턴스 ID-01의 경우, 관련 IP 주소는 다음과 같습니다.

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

인스턴스 JP-01의 경우, 관련 IP 주소는 다음과 같습니다.

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

인스턴스 KR-01의 경우, 관련 IP 주소는 다음과 같습니다.

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

1.1단계: 테이블 설정

선택적으로 소스 테이블을 보관할 새 데이터베이스와 스키마를 설정합니다.

CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;

CDI 통합에 사용할 테이블(또는 뷰)을 생성합니다.

CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC (
   updated_at timestamptz default sysdate,
   --at least one of external_id, alias_name and alias_label, or braze_id is required
   external_id varchar,
   --if using user alias, both alias_name and alias_label are required
   alias_label varchar,
   alias_name varchar,
   --braze_id can only be used to update existing users created through the Braze SDK
   braze_id varchar,
   --If you include both email and phone, email is used as the primary identifier
   email varchar,
   phone varchar,
   payload varchar(max)
)

데이터베이스, 스키마, 테이블 이름은 원하는 대로 지정할 수 있지만, 열 이름은 위의 정의와 일치해야 합니다.

UPDATED_AT - 이 행이 테이블에서 업데이트되거나 테이블에 추가된 시간입니다. Braze는 UPDATED_AT이 마지막으로 동기화된 값보다 이후인 행을 동기화합니다. 새 행이 경계 타임스탬프와 정확히 같은 타임스탬프를 가지는 경우, 해당 타임스탬프의 행이 다시 동기화될 수 있습니다.
사용자 식별자 열 - 테이블에는 하나 이상의 사용자 식별자 열이 포함될 수 있습니다. 각 행에는 식별자가 하나만 포함되어야 합니다(external_id, alias_name과 alias_label의 조합, braze_id, email 또는 phone 중 하나). 소스 테이블에는 1개, 2개, 3개, 4개 또는 5개 식별자 유형 모두에 대한 열이 있을 수 있습니다.
- EXTERNAL_ID - 업데이트하려는 사용자를 식별합니다. Braze에서 사용하는 external_id 값과 일치해야 합니다.
- ALIAS_NAME 및 ALIAS_LABEL - 이 두 열은 사용자 별칭 객체를 생성합니다. alias_name은 고유 식별자여야 하며, alias_label은 별칭 유형을 지정합니다. 사용자는 레이블이 다른 여러 별칭을 가질 수 있지만, alias_label당 alias_name은 하나만 가질 수 있습니다.
- BRAZE_ID - Braze 사용자 식별자입니다. Braze SDK에서 생성되며, 클라우드 데이터 수집을 통해 Braze ID로 신규 사용자를 생성할 수는 없습니다. 신규 사용자를 생성하려면 외부 사용자 ID 또는 사용자 별칭을 지정하세요.
- EMAIL - 사용자의 이메일 주소입니다. 동일한 이메일 주소를 가진 프로필이 여러 개 있는 경우, 가장 최근에 업데이트된 프로필이 우선적으로 업데이트됩니다. 이메일과 전화번호를 모두 포함하면 이메일이 기본 식별자로 사용됩니다.
- PHONE - 사용자의 전화번호입니다. 동일한 전화번호를 가진 프로필이 여러 개 있는 경우, 가장 최근에 업데이트된 프로필이 우선적으로 업데이트됩니다.
PAYLOAD - Braze에서 사용자에게 동기화하려는 필드의 JSON 문자열입니다.

1.2단계: 사용자 생성 및 권한 부여

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

이 권한은 이 사용자에게 필요한 최소 권한입니다. CDI 통합을 여러 개 생성하는 경우, 스키마에 권한을 부여하거나 그룹을 사용해 권한을 관리하는 것이 좋습니다.

1.3단계: 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.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

인스턴스 US-08의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 US-10의 경우, 관련 IP 주소는 다음과 같습니다.

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

인스턴스 EU-01 및 EU-02의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 AU-01의 경우, 관련 IP 주소는 다음과 같습니다.

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

인스턴스 ID-01의 경우, 관련 IP 주소는 다음과 같습니다.

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

인스턴스 JP-01의 경우, 관련 IP 주소는 다음과 같습니다.

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

인스턴스 KR-01의 경우, 관련 IP 주소는 다음과 같습니다.

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

1.1단계: 테이블 설정

선택적으로 소스 테이블을 보관할 새 프로젝트 또는 데이터 세트를 설정합니다.

CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

다음 필드를 사용해 CDI 통합에 사용할 테이블을 하나 이상 생성합니다.

CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp,
  --At least one of external_id, alias_name and alias_label, or braze_id is required
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  --braze_id can only be used to update existing users created through the Braze SDK
  braze_id STRING,
  --If you include both email and phone, email is used as the primary identifier
  email STRING,
  phone STRING,
  payload JSON
);

필드 이름	유형	모드
`UPDATED_AT`	TIMESTAMP	REQUIRED
`PAYLOAD`	JSON	REQUIRED
`EXTERNAL_ID`	STRING	NULLABLE
`ALIAS_NAME`	STRING	NULLABLE
`ALIAS_LABEL`	STRING	NULLABLE
`BRAZE_ID`	STRING	NULLABLE
`EMAIL`	STRING	NULLABLE
`PHONE`	STRING	NULLABLE

프로젝트, 데이터 세트, 테이블 이름은 원하는 대로 지정할 수 있지만, 열 이름은 위의 정의와 일치해야 합니다.

UPDATED_AT - 이 행이 테이블에서 업데이트되거나 테이블에 추가된 시간입니다. Braze는 UPDATED_AT이 마지막으로 동기화된 값보다 이후인 행을 동기화합니다. 새 행이 경계 타임스탬프와 정확히 같은 타임스탬프를 가지는 경우, 해당 타임스탬프의 행이 다시 동기화될 수 있습니다.
사용자 식별자 열 - 테이블에는 하나 이상의 사용자 식별자 열이 포함될 수 있습니다. 각 행에는 식별자가 하나만 포함되어야 합니다(external_id, alias_name과 alias_label의 조합, braze_id, email 또는 phone 중 하나). 소스 테이블에는 1개, 2개, 3개, 4개 또는 5개 식별자 유형 모두에 대한 열이 있을 수 있습니다.
- EXTERNAL_ID - 업데이트하려는 사용자를 식별합니다. Braze에서 사용하는 external_id 값과 일치해야 합니다.
- ALIAS_NAME 및 ALIAS_LABEL - 이 두 열은 사용자 별칭 객체를 생성합니다. alias_name은 고유 식별자여야 하며, alias_label은 별칭 유형을 지정합니다. 사용자는 레이블이 다른 여러 별칭을 가질 수 있지만, alias_label당 alias_name은 하나만 가질 수 있습니다.
- BRAZE_ID - Braze 사용자 식별자입니다. Braze SDK에서 생성되며, 클라우드 데이터 수집을 통해 Braze ID로 신규 사용자를 생성할 수는 없습니다. 신규 사용자를 생성하려면 외부 사용자 ID 또는 사용자 별칭을 지정하세요.
- EMAIL - 사용자의 이메일 주소입니다. 동일한 이메일 주소를 가진 프로필이 여러 개 있는 경우, 가장 최근에 업데이트된 프로필이 우선적으로 업데이트됩니다. 이메일과 전화번호를 모두 포함하면 이메일이 기본 식별자로 사용됩니다.
- PHONE - 사용자의 전화번호입니다. 동일한 전화번호를 가진 프로필이 여러 개 있는 경우, 가장 최근에 업데이트된 프로필이 우선적으로 업데이트됩니다.
PAYLOAD - Braze에서 사용자에게 동기화하려는 필드의 JSON 문자열입니다.

중요

BigQuery 파티셔닝

CDI는 BigQuery의 파티션을 지원합니다. UPDATED_AT의 함수(예: 데이터 세트 크기에 따라 일, 주 또는 시간 단위)로 파티셔닝하면 BigQuery가 스캔해야 하는 데이터를 줄일 수 있습니다. 이렇게 하면 매우 큰 테이블의 성능과 효율성이 향상됩니다.

다른 필드로는 파티셔닝하지 마세요. 다양한 구성을 테스트해 데이터에 가장 적합한 설정을 찾으세요.

모든 CDI 쿼리는 UPDATED_AT으로 필터링하지만, 이 동작은 변경될 수 있습니다. 쿼리에 이 절이 반드시 포함되지 않아도 되도록 테이블 스키마를 설계하세요.

자세한 내용은 BigQuery 파티셔닝 설명서를 참조하세요.

1.2단계: Braze용 자격 증명 생성

Braze가 테이블에 연결하고 데이터를 읽는 데 사용할 서비스 계정을 GCP에서 생성합니다. 서비스 계정에는 다음 권한이 있어야 합니다.

BigQuery Connection User: Braze가 연결할 수 있도록 허용합니다.
BigQuery User: Braze에 쿼리 실행, 데이터 세트 메타데이터 읽기, 테이블 목록 조회 권한을 제공합니다.
BigQuery Data Viewer: Braze에 데이터 세트와 그 콘텐츠를 볼 수 있는 권한을 제공합니다.
BigQuery Job User: Braze에 작업 실행 권한을 제공합니다.

Braze는 다음 인증 방법 중 하나로 서비스 계정에 액세스할 수 있습니다.

Workload Identity Federation: Braze가 단기 아이덴티티로 서비스 계정을 가장하므로 키를 생성하거나 업로드할 필요가 없습니다.
서비스 계정 키: 서비스 계정의 JSON 키를 Braze에 업로드합니다.

기존 서비스 계정 키 자격 증명은 계속 작동하므로 마이그레이션할 필요가 없습니다. 하나의 Workload Identity Federation 자격 증명으로 BigQuery 소스와 Google Cloud Storage 소스를 모두 사용할 수 있습니다.

workload identity federation
service account key

워크로드 아이덴티티 풀, 공급자, 서비스 계정을 설정하고, Braze 주체를 서비스 계정에 바인딩합니다. 단계는 Workload Identity Federation을 위한 Google Cloud 구성을 참조하세요. Google Cloud Storage 소스용으로 이미 Workload Identity Federation을 설정했다면 반복할 필요가 없습니다. 기존 서비스 계정에 이 단계에 나열된 권한을 부여하세요.

서비스 계정을 생성하고 권한을 부여한 후 JSON 키를 생성합니다. 자세한 내용은 서비스 계정 키 생성 및 삭제를 참조하세요. 이후 단계에서 이 키를 Braze 대시보드에 업로드합니다.

1.3단계: Braze IP에 대한 액세스 허용

네트워크 정책을 사용 중인 경우, Braze에 BigQuery 인스턴스에 대한 네트워크 액세스 권한을 부여해야 합니다. Braze 대시보드 리전에 해당하는 다음 IP로부터의 액세스를 허용하세요.

인스턴스 US-01, US-02, US-03, US-04, US-05, US-06, US-07의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 US-08의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 US-10의 경우, 관련 IP 주소는 다음과 같습니다.

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

인스턴스 EU-01 및 EU-02의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 AU-01의 경우, 관련 IP 주소는 다음과 같습니다.

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

인스턴스 ID-01의 경우, 관련 IP 주소는 다음과 같습니다.

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

인스턴스 JP-01의 경우, 관련 IP 주소는 다음과 같습니다.

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

인스턴스 KR-01의 경우, 관련 IP 주소는 다음과 같습니다.

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

1.1단계: 테이블 설정

선택적으로 소스 테이블을 보관할 새 카탈로그 또는 스키마를 설정합니다.

CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

다음 필드를 사용해 CDI 통합에 사용할 테이블을 하나 이상 생성합니다.

CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp(),
  --At least one of external_id, alias_name and alias_label, or braze_id is required
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  --braze_id can only be used to update existing users created through the Braze SDK
  braze_id STRING,
  --If you include both email and phone, email is used as the primary identifier
  email STRING,
  phone STRING,
  payload STRING, STRUCT, or MAP
);

필드 이름	유형	모드
`UPDATED_AT`	TIMESTAMP	REQUIRED
`PAYLOAD`	STRING, STRUCT 또는 MAP	REQUIRED
`EXTERNAL_ID`	STRING	NULLABLE
`ALIAS_NAME`	STRING	NULLABLE
`ALIAS_LABEL`	STRING	NULLABLE
`BRAZE_ID`	STRING	NULLABLE
`EMAIL`	STRING	NULLABLE
`PHONE`	STRING	NULLABLE

스키마와 테이블 이름은 원하는 대로 지정할 수 있지만, 열 이름은 위의 정의와 일치해야 합니다.

UPDATED_AT - 이 행이 테이블에서 업데이트되거나 테이블에 추가된 시간입니다. Braze는 UPDATED_AT이 마지막으로 동기화된 값보다 이후인 행을 동기화합니다. 새 행이 경계 타임스탬프와 정확히 같은 타임스탬프를 가지는 경우, 해당 타임스탬프의 행이 다시 동기화될 수 있습니다.
사용자 식별자 열 - 테이블에는 하나 이상의 사용자 식별자 열이 포함될 수 있습니다. 각 행에는 식별자가 하나만 포함되어야 합니다(external_id, alias_name과 alias_label의 조합, braze_id, email 또는 phone 중 하나). 소스 테이블에는 1개, 2개, 3개, 4개 또는 5개 식별자 유형 모두에 대한 열이 있을 수 있습니다.
- EXTERNAL_ID - 업데이트하려는 사용자를 식별합니다. Braze에서 사용하는 external_id 값과 일치해야 합니다.
- ALIAS_NAME 및 ALIAS_LABEL - 이 두 열은 사용자 별칭 객체를 생성합니다. alias_name은 고유 식별자여야 하며, alias_label은 별칭 유형을 지정합니다. 사용자는 레이블이 다른 여러 별칭을 가질 수 있지만, alias_label당 alias_name은 하나만 가질 수 있습니다.
- BRAZE_ID - Braze 사용자 식별자입니다. Braze SDK에서 생성되며, 클라우드 데이터 수집을 통해 Braze ID로 신규 사용자를 생성할 수는 없습니다. 신규 사용자를 생성하려면 외부 사용자 ID 또는 사용자 별칭을 지정하세요.
- EMAIL - 사용자의 이메일 주소입니다. 동일한 이메일 주소를 가진 프로필이 여러 개 있는 경우, 가장 최근에 업데이트된 프로필이 우선적으로 업데이트됩니다. 이메일과 전화번호를 모두 포함하면 이메일이 기본 식별자로 사용됩니다.
- PHONE - 사용자의 전화번호입니다. 동일한 전화번호를 가진 프로필이 여러 개 있는 경우, 가장 최근에 업데이트된 프로필이 우선적으로 업데이트됩니다.
PAYLOAD - Braze에서 사용자에게 동기화하려는 필드의 문자열 또는 구조체입니다.

1.2단계: Braze용 자격 증명 생성

Braze는 다음 인증 방법 중 하나로 Databricks에 연결할 수 있습니다.

OAuth M2M(권장): Braze가 클라이언트 ID와 클라이언트 시크릿을 사용해 Databricks 서비스 주체로 인증합니다. Databricks는 클라우드 데이터 수집과 같은 무인 연결에 OAuth M2M 인증을 권장합니다.
개인 액세스 토큰: Braze가 Databricks 작업 공간에서 생성된 토큰으로 인증합니다.

기존 개인 액세스 토큰 자격 증명은 계속 작동하므로 마이그레이션할 필요가 없습니다. 하지만 개인 액세스 토큰은 작업 공간 관리자가 설정한 일정에 따라 만료되는 경우가 많으며, 토큰이 만료되면 동기화가 중지됩니다. 기존 소스를 OAuth M2M으로 전환하려면 OAuth M2M 자격 증명을 생성한 후 소스를 편집할 때 해당 자격 증명을 선택하세요.

oauth m2m
personal access token

Braze는 OAuth M2M 인증을 사용하는 서비스 주체로 Databricks 작업 공간에 연결합니다. Braze가 사용할 새 서비스 주체를 생성하고, SQL 웨어하우스와 소스 테이블에 대한 액세스 권한을 부여하세요. Braze가 연결하려면 다음 정보가 필요합니다.

서비스 주체의 클라이언트 ID(애플리케이션 ID라고도 함)
Braze 인증에 사용할 클라이언트 시크릿

서비스 주체 생성

Databricks 작업 공간의 상단 표시줄에서 사용자 이름을 선택한 다음 Settings를 선택합니다.
Identity and access로 이동한 다음 Service principals 옆의 Manage를 선택합니다.
Add service principal > Add new를 선택합니다.
서비스 주체를 식별하는 데 도움이 되는 이름(예: “Braze CDI”)을 입력한 다음 Add를 선택합니다.
생성한 서비스 주체를 선택합니다. Configurations 탭에서 Databricks SQL access가 선택되어 있는지 확인합니다.

클라이언트 시크릿 생성

서비스 주체 페이지에서 Secrets 탭을 선택한 다음 Generate secret을 선택합니다.
시크릿의 유효 기간을 일 단위로 입력합니다. Databricks에서 허용하는 최대 유효 기간은 730일입니다.
Generate를 선택합니다.
Secret 및 Client ID 값을 복사한 다음 Done을 선택합니다.

자격 증명 생성 단계에서 Braze 대시보드에 입력할 때까지 클라이언트 ID와 시크릿을 안전한 곳에 보관하세요. Databricks는 시크릿을 한 번만 표시합니다.

참고

Databricks는 서비스 주체 시크릿에 무제한 유효 기간을 허용하지 않습니다. Braze로의 데이터 흐름을 유지하려면 시크릿이 만료되기 전에 교체하세요. 단계는 클라이언트 시크릿 업데이트를 참조하세요.

SQL 웨어하우스에 대한 액세스 권한 부여

Braze에는 SQL 웨어하우스에서 쿼리를 실행할 권한이 필요하지만, 작업 공간 관리자 액세스 권한은 필요하지 않습니다.

사이드바에서 SQL Warehouses를 선택한 다음 Braze가 사용할 웨어하우스를 선택합니다.
Permissions를 선택합니다.
생성한 서비스 주체를 검색하여 선택합니다.
권한 드롭다운에서 Can use를 선택한 다음 Add를 선택합니다.

소스 테이블에 대한 액세스 권한 부여

1.1단계에서 설정한 카탈로그, 스키마, 테이블에 대한 읽기 권한을 서비스 주체에 부여합니다. 권한 수여 대상으로 서비스 주체의 애플리케이션 ID(클라이언트 ID와 동일한 값)를 사용합니다.

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

APPLICATION_ID를 서비스 주체의 애플리케이션 ID로 바꾸세요. 다른 이름은 필요에 따라 변경할 수 있지만, 권한은 위의 예시와 일치해야 합니다.

클라이언트 시크릿 업데이트

Braze는 자격 증명당 하나의 클라이언트 시크릿을 저장합니다. 시크릿을 업데이트하면 해당 자격 증명을 사용하는 모든 소스와 동기화가 새 시크릿으로 전환됩니다. 시크릿을 교체하려면 다음을 수행합니다.

Databricks에서 클라이언트 시크릿 생성의 단계에 따라 서비스 주체의 새 시크릿을 생성합니다. 6단계까지는 이전 시크릿을 유지하세요.
Braze 대시보드에서 데이터 설정 > 클라우드 데이터 수집 > 자격 증명으로 이동한 다음 OAuth M2M 자격 증명을 선택합니다. 사용처 섹션에는 이 자격 증명을 사용하는 모든 소스와 동기화가 나열됩니다.
이 자격 증명을 사용하는 동기화를 일시 중지하거나, 예약된 동기화가 없는 시간에 업데이트를 계획합니다. 이렇게 하면 자격 증명을 업데이트하는 동안 동기화가 시작되는 것을 방지할 수 있습니다.
자격 증명 편집을 선택하고 새 클라이언트 시크릿을 입력한 다음 저장을 선택합니다. 변경 사항은 이 자격 증명을 사용하는 모든 소스와 동기화에 적용됩니다.
일시 중지한 동기화를 재개합니다.
Braze에 새 시크릿이 저장되면 Databricks에서 이전 시크릿을 삭제합니다.

Braze가 Databricks에 액세스하려면 개인 액세스 토큰을 생성해야 합니다.

Databricks 작업 공간의 상단 표시줄에서 Databricks 사용자 이름을 선택한 다음 드롭다운에서 User Settings를 선택합니다.
Access tokens 탭에서 Generate new token을 선택합니다.
이 토큰을 식별하는 데 도움이 되는 설명(예: “Braze CDI”)을 입력하고, Lifetime (days) 상자를 비워 두어 토큰의 유효 기간을 무제한으로 변경합니다.
Generate를 선택합니다.
표시된 토큰을 복사한 다음 Done을 선택합니다.

자격 증명 생성 단계에서 Braze 대시보드에 입력할 때까지 토큰을 안전한 곳에 보관하세요.

1.3단계: Braze IP에 대한 액세스 허용

네트워크 정책을 사용 중인 경우, Braze에 Databricks 인스턴스에 대한 네트워크 액세스 권한을 부여해야 합니다. Braze 대시보드 리전에 해당하는 다음 IP로부터의 액세스를 허용하세요.

인스턴스 US-01, US-02, US-03, US-04, US-05, US-06, US-07의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 US-08의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 US-10의 경우, 관련 IP 주소는 다음과 같습니다.

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

인스턴스 EU-01 및 EU-02의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 AU-01의 경우, 관련 IP 주소는 다음과 같습니다.

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

인스턴스 ID-01의 경우, 관련 IP 주소는 다음과 같습니다.

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

인스턴스 JP-01의 경우, 관련 IP 주소는 다음과 같습니다.

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

인스턴스 KR-01의 경우, 관련 IP 주소는 다음과 같습니다.

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

1.1단계: 서비스 주체 설정 및 액세스 권한 부여

Braze는 Entra ID 인증을 사용하는 서비스 주체로 Fabric 웨어하우스에 연결합니다. Braze가 사용할 새 서비스 주체를 생성하고, 필요에 따라 Fabric 리소스에 대한 액세스 권한을 부여하세요. Braze가 연결하려면 다음 정보가 필요합니다.

Azure 계정의 테넌트 ID(디렉터리라고도 함)
서비스 주체의 주체 ID(애플리케이션 ID라고도 함)
Braze가 인증하기 위한 클라이언트 시크릿

Azure 포털에서 Microsoft Entra 관리 센터로 이동한 다음 App Registrations를 선택합니다.
Identity > Applications > App registrations에서 + New registration을 선택합니다.
이름을 입력하고 지원되는 계정 유형으로 Accounts in this organizational directory only를 선택합니다. 그런 다음 Register를 선택합니다.
방금 생성한 애플리케이션(서비스 주체)을 선택한 다음 Certificates & secrets > + New client secret로 이동합니다.
비밀에 대한 설명을 입력하고 만료 기간을 설정합니다. 그런 다음 Add를 선택합니다.
Braze 설정에 사용할 클라이언트 비밀을 기록해 둡니다.

참고

Azure는 서비스 주체 시크릿에 무제한 만료 기간을 허용하지 않습니다. Braze로의 데이터 흐름을 유지하려면 자격 증명이 만료되기 전에 갱신하세요.

1.2단계: Fabric 리소스에 대한 액세스 권한 부여

Braze가 Fabric 인스턴스에 연결할 수 있도록 액세스 권한을 제공합니다. Fabric 관리 포털에서 Settings > Governance and insights > Admin portal > Tenant settings로 이동합니다.

Developer settings에서 Service principals can use Fabric APIs를 활성화하여 Braze가 Microsoft Entra ID를 사용해 연결할 수 있도록 합니다.
OneLake settings에서 Users can access data stored in OneLake with apps external to Fabric을 활성화하여 서비스 주체가 외부 앱에서 데이터에 액세스할 수 있도록 합니다.

1.3단계: 공유 작업 공간 설정 및 액세스 권한 부여

Braze에 연결하려는 모든 Fabric 리소스는 공유 작업 공간에 있어야 합니다. 기본 My Workspace만 사용해 왔다면 새 공유 작업 공간을 생성하세요.

탐색 메뉴에서 Workspaces를 선택한 다음 + New workspace를 선택합니다.
작업 공간의 Name을 입력한 다음 Apply를 선택합니다.

공유 작업 공간이 준비되면 서비스 주체에 액세스 권한을 부여합니다.

작업 공간을 선택한 다음 Manage Access를 선택합니다.
+ Add people or groups를 선택합니다.
1.1단계에서 생성한 서비스 주체의 이름을 검색하여 선택합니다. 표시되지 않으면 1.2단계에서 Service principals can use Fabric APIs 설정을 활성화했는지 확인하세요.
역할 드롭다운에서 Contributor를 선택합니다.

이제 서비스 주체는 Braze에 사용할 웨어하우스를 포함해 이 작업 공간의 Fabric 웨어하우스 리소스에 SQL 엔드포인트를 통해 액세스할 수 있습니다.

1.4단계: 테이블 설정

Braze는 Fabric 웨어하우스의 테이블과 뷰를 모두 지원합니다. 새 웨어하우스를 생성해야 하는 경우, 1.3단계의 공유 작업 공간 안에 생성하세요. Fabric 콘솔에서 Create > Data Warehouse > Warehouse로 이동합니다.

CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PAYLOAD VARCHAR NOT NULL,
  --at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR,
  --braze_id can only be used to update existing users created through the Braze SDK
  BRAZE_ID VARCHAR,
  --If you include both email and phone, email is used as the primary identifier
  EMAIL VARCHAR,
  PHONE VARCHAR
)
GO

웨어하우스, 스키마, 테이블 또는 뷰 이름은 원하는 대로 지정할 수 있지만, 열 이름은 위의 정의와 일치해야 합니다.

UPDATED_AT - 이 행이 테이블에서 업데이트되거나 테이블에 추가된 시간입니다. Braze는 UPDATED_AT이 마지막으로 동기화된 값보다 이후인 행을 동기화합니다. 새 행이 경계 타임스탬프와 정확히 같은 타임스탬프를 가지는 경우, 해당 타임스탬프의 행이 다시 동기화될 수 있습니다.
사용자 식별자 열 - 테이블에는 하나 이상의 사용자 식별자 열이 포함될 수 있습니다. 각 행에는 식별자가 하나만 포함되어야 합니다(external_id, alias_name과 alias_label의 조합, braze_id, email 또는 phone 중 하나). 소스 테이블에는 1개, 2개, 3개, 4개 또는 5개 식별자 유형 모두에 대한 열이 있을 수 있습니다.
- EXTERNAL_ID - 업데이트하려는 사용자를 식별합니다. Braze에서 사용하는 external_id 값과 일치해야 합니다.
- ALIAS_NAME 및 ALIAS_LABEL - 이 두 열은 사용자 별칭 객체를 생성합니다. alias_name은 고유 식별자여야 하며, alias_label은 별칭 유형을 지정합니다. 사용자는 레이블이 다른 여러 별칭을 가질 수 있지만, alias_label당 alias_name은 하나만 가질 수 있습니다.
- BRAZE_ID - Braze 사용자 식별자입니다. Braze SDK에서 생성되며, 클라우드 데이터 수집을 통해 Braze ID로 신규 사용자를 생성할 수는 없습니다. 신규 사용자를 생성하려면 외부 사용자 ID 또는 사용자 별칭을 지정하세요.
- EMAIL - 사용자의 이메일 주소입니다. 동일한 이메일 주소를 가진 프로필이 여러 개 있는 경우, 가장 최근에 업데이트된 프로필이 우선적으로 업데이트됩니다. 이메일과 전화번호를 모두 포함하면 이메일이 기본 식별자로 사용됩니다.
- PHONE - 사용자의 전화번호입니다. 동일한 전화번호를 가진 프로필이 여러 개 있는 경우, 가장 최근에 업데이트된 프로필이 우선적으로 업데이트됩니다.
PAYLOAD - Braze에서 사용자에게 동기화하려는 필드의 JSON 문자열입니다.

1.5단계: 웨어하우스 연결 문자열 가져오기

웨어하우스의 SQL 엔드포인트를 가져오려면 Fabric에서 workspace로 이동하여 항목 목록의 웨어하우스 이름 위에 마우스를 올린 다음 Copy SQL connection string을 선택합니다.

Microsoft Azure의 "Fabric Console" 페이지에서 SQL 연결 문자열을 가져오는 화면

1.6단계: 방화벽에서 Braze IP 허용(선택 사항)

Microsoft Fabric 계정 구성에 따라 Braze의 트래픽을 허용하도록 방화벽에서 다음 IP 주소를 허용해야 할 수 있습니다. 이 설정을 활성화하는 방법에 대한 자세한 내용은 Entra 조건부 액세스에 관한 관련 설명서를 참조하세요.

인스턴스 US-01, US-02, US-03, US-04, US-05, US-06, US-07의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 US-08의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 US-10의 경우, 관련 IP 주소는 다음과 같습니다.

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

인스턴스 EU-01 및 EU-02의 경우, 관련 IP 주소는 다음과 같습니다.

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

인스턴스 AU-01의 경우, 관련 IP 주소는 다음과 같습니다.

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

인스턴스 ID-01의 경우, 관련 IP 주소는 다음과 같습니다.

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

인스턴스 JP-01의 경우, 관련 IP 주소는 다음과 같습니다.

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

인스턴스 KR-01의 경우, 관련 IP 주소는 다음과 같습니다.

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

2단계: Braze 대시보드에서 새 소스 생성

Braze 대시보드에서 데이터 설정 > 클라우드 데이터 수집 > 소스로 이동하여 데이터 소스 추가를 선택한 다음 Snowflake를 선택합니다.

2.1단계: Snowflake 연결 정보 추가

소스 이름을 정합니다. 자격 증명 이름을 입력한 다음, 1.4단계에서 생성한 사용자에 맞게 Workload Identity Federation 또는 Key pair를 선택합니다.

계속하기 전에 Snowflake 계정 로케이터에 입력하는 값을 확인하세요.

Snowflake 계정 로케이터 필드에는 Snowflake 계정 식별자를 입력합니다. myorganization-myaccount와 같이 계정 식별자 값만 입력하세요. https://, .snowflakecomputing.com 또는 경로는 포함하지 마세요.

Snowflake 계정 식별자를 찾으려면 다음을 수행합니다.

Snowsight에서 계정 메뉴를 선택합니다.
View account details를 선택합니다.
Account identifier 값을 복사합니다.
Snowflake URL에서 복사하는 경우, .snowflakecomputing.com 앞의 값만 사용하세요.

자격 증명 양식에서 다음 단계를 순서대로 완료합니다.

계정 로케이터, 사용자 이름, 역할을 입력합니다.
사용자 생성 또는 사용자 변경을 선택한 다음, 문 복사가 표시되면 선택합니다.
해당 문을 Snowflake 워크시트에서 실행합니다. 이 문의 역할은 Workload Identity Federation을 위한 Snowflake 구성을 참조하세요.
Braze로 돌아와 자격 증명 저장을 선택합니다.
웨어하우스, 데이터베이스, 스키마를 입력하고 연결 테스트를 선택한 다음 소스에 연결을 선택합니다.

계정 로케이터, 사용자 이름, 역할을 입력한 다음 자격 증명 저장 및 RSA 키 생성을 선택합니다. Snowflake에서 대시보드에 표시된 공개 키를 Braze용으로 생성한 사용자에 추가합니다.

이 작업 방법에 대한 자세한 내용은 Snowflake 설명서를 참조하세요. 언제든지 키를 교체하려는 경우, Braze가 새 키 페어를 생성하고 새 공개 키를 제공할 수 있습니다.

ALTER USER BRAZE_INGESTION_USER SET RSA_PUBLIC_KEY='MIIBIjANBgkqhkiG9w0BA...';

나중에 키를 교체하려면 데이터 설정 > 클라우드 데이터 수집 > 자격 증명으로 이동하여 Snowflake 데이터 액세스 자격 증명에서 자격 증명을 열고 자격 증명 교체를 선택합니다. 상세 정보 모달에 대해서는 Snowflake 자격 증명 검토를 참조하세요.

Snowflake에 키를 추가한 후 연결 테스트를 선택한 다음 소스에 연결을 선택합니다.

Braze 대시보드에서 데이터 설정 > 클라우드 데이터 수집 > 소스로 이동하여 데이터 소스 추가를 선택한 다음 Amazon Redshift를 선택합니다.

2.1단계: Redshift 연결 정보 및 소스 테이블 추가

소스 이름을 정하고 Redshift 자격 증명과 구성을 입력합니다. 프라이빗 네트워크 터널을 사용하는 경우 슬라이더를 토글하고 터널 정보를 입력합니다. 그런 다음 다음 단계로 진행합니다.

참고

Amazon Redshift는 데이터베이스 식별자에 추가 문자를 지원하지만, Braze 대시보드의 데이터베이스 이름 필드에는 문자(A–Z, a–z), 숫자(0–9), 밑줄(_)만 입력할 수 있습니다.

2.2단계: 연결 테스트 및 소스에 연결

다음으로 연결 테스트를 선택합니다. 테스트가 성공하면 나머지 설정을 마무리하고 소스에 연결을 선택합니다. 연결에 실패하면 문제 해결에 도움이 되는 오류 메시지가 표시됩니다.

문제 해결: 잘못된 스냅샷 식별자

연결 테스트 또는 동기화 설정 중에 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 동기화에서 기본 테이블 대신 구체화된 뷰 이름을 소스 객체로 사용하세요.

Braze 대시보드에서 데이터 설정 > 클라우드 데이터 수집 > 소스로 이동하여 데이터 소스 추가를 선택한 다음 Google BigQuery를 선택합니다.

2.1단계: BigQuery 연결 정보 및 소스 테이블 추가

소스 이름을 입력한 다음 BigQuery 자격 증명과 구성을 입력합니다.

자격 증명 이름에는 Braze에서 이 자격 증명을 식별하는 데 도움이 되는 레이블을 입력합니다.
인증 방법으로는 1.2단계에서 생성한 자격 증명에 맞게 Workload Identity Federation 또는 Service Account Key를 선택합니다.
Workload Identity Federation의 경우, Google Cloud 설정에 사용할 Braze 주체 ARN을 복사한 다음 프로젝트 번호, 워크로드 아이덴티티 풀 ID, 공급자 ID, 서비스 계정 이메일을 입력합니다. 서비스 계정 키의 경우 JSON 키를 업로드합니다.

그런 다음 나머지 구성 필드를 입력합니다.

2.2단계: 연결 테스트 및 소스에 연결

Braze 대시보드에서 데이터 설정 > 클라우드 데이터 수집 > 소스로 이동하여 데이터 소스 추가를 선택한 다음 Databricks를 선택합니다.

2.1단계: Databricks 연결 정보 및 소스 테이블 추가

소스 이름을 입력한 다음 Databricks 자격 증명과 구성을 입력합니다.

자격 증명 이름에는 Braze에서 이 자격 증명을 식별하는 데 도움이 되는 레이블을 입력합니다.
인증 방법에서는 1.2단계에서 생성한 자격 증명에 맞게 OAuth M2M 또는 Personal Access Token을 선택합니다.
OAuth M2M의 경우 서비스 주체의 클라이언트 ID와 클라이언트 시크릿을 입력합니다. 개인 액세스 토큰의 경우 액세스 토큰을 입력합니다.

그런 다음 다음 단계로 진행합니다.

2.2단계: 연결 테스트 및 소스에 연결

참고

소스를 생성하려면 먼저 소스 테스트에 성공해야 합니다. 생성 페이지를 닫으면 소스가 저장되지 않습니다.

Braze 대시보드에서 데이터 설정 > 클라우드 데이터 수집 > 소스로 이동하여 데이터 소스 추가를 선택한 다음 Microsoft Fabric을 선택합니다.

2.1단계: 클라우드 데이터 수집 동기화 설정

소스 이름을 정하고 Microsoft Fabric 자격 증명과 구성을 입력합니다.

자격 증명 이름은 Braze에서 이 자격 증명에 붙이는 레이블이므로, 알아보기 쉬운 값을 설정하면 됩니다.
테넌트 ID, 주체 ID, 클라이언트 시크릿, 연결 문자열을 가져오는 방법은 1단계 섹션의 단계를 참조하세요.

2.2단계: 연결 테스트 및 소스에 연결

참고

소스를 생성하려면 먼저 소스 테스트에 성공해야 합니다. 생성 페이지를 닫으면 소스가 저장되지 않습니다.

3단계: Braze 대시보드에서 새 동기화 생성

데이터 설정 > 클라우드 데이터 수집 > 동기화로 이동하여 데이터 동기화 생성을 선택합니다.

3.1단계: 동기화 세부 정보 구성 및 데이터 정의

동기화 이름을 입력합니다. 그런 다음 활성 소스와 동기화 데이터 유형을 선택합니다. 다음으로 Visual 또는 Table을 선택하고 소스 테이블을 입력하거나, SQL을 선택해 커스텀 SQL 쿼리를 작성합니다. 마지막으로 미리 보기 및 유효성 검사를 선택합니다.

유효성 검사에 성공하면 데이터 미리 보기가 표시됩니다. 계속하려면 다음: 알림을 선택합니다. 유효성 검사에 실패하면 문제 해결에 도움이 되는 오류 메시지가 표시됩니다.

참고

다음 단계로 진행하려면 먼저 동기화 유효성 검사에 성공해야 합니다. 동기화 생성 페이지를 닫아야 하는 경우, 초안으로 저장을 선택해 진행 중인 작업을 보존하세요.

3.2단계: 알림 환경설정 추가

동기화 오류 알림을 받을 연락처 이메일을 입력합니다. Braze는 이 연락처 정보를 사용해 예기치 않은 테이블 액세스 손실과 같은 통합 오류에 대한 알림을 보냅니다.

연락처 이메일은 테이블 누락, 권한 문제 등 전역 또는 동기화 수준의 오류에 대한 알림만 받으며, 행 수준의 문제에 대한 알림은 받지 않습니다. 전역 오류는 동기화 실행을 막는 심각한 연결 문제를 나타냅니다.

이러한 문제에는 다음이 포함될 수 있습니다.

연결 문제
리소스 부족
권한 문제
카탈로그 티어의 공간 부족(카탈로그 동기화만 해당)

3.3단계: 스케줄 설정

마지막으로 동기화를 비반복 또는 반복으로 구성합니다.

비반복 동기화는 대시보드에서 지금 동기화를 선택하거나 동기화 트리거 엔드포인트를 호출할 때만 실행됩니다.

반복 동기화는 최소 5분마다, 최대 한 달에 한 번까지 실행할 수 있습니다. 기본적으로 대시보드에서 설정할 수 있는 가장 짧은 간격은 15분이며, 이는 웨어하우스 컴퓨팅 비용과 요청량을 관리하는 데 도움이 됩니다. 최소 5분마다 동기화하려면 Braze 지원팀 또는 고객 성공 매니저에게 문의하세요. Braze는 반복 동기화를 UTC 기준으로 예약합니다.

3.1단계: 동기화 세부 정보 구성 및 데이터 정의

참고

3.2단계: 알림 환경설정 추가

이러한 문제에는 다음이 포함될 수 있습니다.

연결 문제
리소스 부족
권한 문제
카탈로그 티어의 공간 부족(카탈로그 동기화만 해당)

3.3단계: 스케줄 설정

마지막으로 동기화를 비반복 또는 반복으로 구성합니다.

비반복 동기화는 대시보드에서 지금 동기화를 선택하거나 동기화 트리거 엔드포인트를 호출할 때만 실행됩니다.

3.1단계: 동기화 세부 정보 구성 및 데이터 정의

참고

3.2단계: 알림 환경설정 추가

연락처 이메일은 테이블 누락, 권한 문제 등 전역 또는 동기화 수준의 오류에 대한 알림만 받으며, 행 수준의 문제에 대한 알림은 받지 않습니다. 전역 오류는 동기화 실행을 막는 심각한 연결 문제를 나타냅니다. 이러한 문제에는 다음이 포함될 수 있습니다.

연결 문제
리소스 부족
권한 문제
카탈로그 티어의 공간 부족(카탈로그 동기화만 해당)

3.3단계: 스케줄 설정

마지막으로 동기화를 비반복 또는 반복으로 구성합니다.

비반복 동기화는 대시보드에서 지금 동기화를 선택하거나 동기화 트리거 엔드포인트를 호출할 때만 실행됩니다.

3.1단계: 동기화 세부 정보 구성 및 데이터 정의

참고

3.2단계: 알림 환경설정 추가

이러한 문제에는 다음이 포함될 수 있습니다.

연결 문제
리소스 부족
권한 문제
카탈로그 티어의 공간 부족(카탈로그 동기화만 해당)

3.3단계: 스케줄 설정

마지막으로 동기화를 비반복 또는 반복으로 구성합니다.

비반복 동기화는 대시보드에서 지금 동기화를 선택하거나 동기화 트리거 엔드포인트를 호출할 때만 실행됩니다.

3.1단계: 동기화 세부 정보 구성 및 데이터 정의

참고

3.2단계: 알림 환경설정 추가

이러한 문제에는 다음이 포함될 수 있습니다.

연결 문제
리소스 부족
권한 문제
카탈로그 티어의 공간 부족(카탈로그 동기화만 해당)

3.3단계: 스케줄 설정

마지막으로 동기화를 비반복 또는 반복으로 구성합니다.

비반복 동기화는 대시보드에서 지금 동기화를 선택하거나 동기화 트리거 엔드포인트를 호출할 때만 실행됩니다.

참고

통합이 초안 상태에서 활성 상태로 전환되려면 먼저 통합 유효성 검사에 성공해야 합니다. 생성 페이지를 닫아도 통합은 저장되며, 세부 정보 페이지로 다시 돌아가 변경 사항을 적용하고 유효성을 검사할 수 있습니다.

추가 통합 또는 사용자 설정(선택 사항)

Braze와 여러 통합을 설정할 수 있습니다. 추가 동기화를 생성할 때 Snowflake 계정에 연결하는 경우 기존 자격 증명을 재사용할 수 있습니다.

여러 통합에서 동일한 키 페어 사용자와 역할을 재사용하는 경우 공개 키를 다시 추가할 필요가 없습니다. 워크로드 아이덴티티 페더레이션(Workload Identity Federation) 자격 증명에는 추가할 공개 키가 없습니다.

Braze와 여러 통합을 설정할 수 있습니다. 추가 동기화를 생성할 때 동일한 Redshift 계정에 연결하는 경우 기존 자격 증명을 재사용할 수 있습니다.

여러 통합에서 동일한 사용자를 재사용하는 경우, 모든 활성 동기화에서 해당 사용자를 제거하기 전까지는 Braze 대시보드에서 사용자를 삭제할 수 없습니다.

Braze와 여러 통합을 설정할 수 있습니다. 추가 동기화를 생성할 때 동일한 BigQuery 계정에 연결하는 경우 기존 자격 증명을 재사용할 수 있습니다.

Braze와 여러 통합을 설정할 수 있습니다. 추가 동기화를 생성할 때 동일한 Databricks 계정에 연결하는 경우 기존 자격 증명을 재사용할 수 있습니다.

Braze와 여러 통합을 설정할 수 있습니다. 추가 동기화를 생성할 때 동일한 Fabric 계정에 연결하는 경우 기존 자격 증명을 재사용할 수 있습니다.

동기화 실행하기

활성화되면 동기화는 설정 중에 구성한 스케줄에 따라 실행됩니다. 스케줄과 관계없이 동기화를 실행하거나 최신 데이터를 가져오려면 지금 동기화를 선택하세요. 이 실행은 정기적으로 예약된 향후 동기화에 영향을 주지 않습니다. 데이터가 업데이트될 때 동기화를 자동으로 시작하려면 파이프라인에서 동기화 트리거 엔드포인트를 호출하세요.

New Stuff!