연결된 소스
연결된 소스는 Braze의 클라우드 데이터 수집(CDI) 기능으로 데이터를 직접 동기화하는 방식을 대체하는 제로 카피 방식입니다. 연결된 소스는 데이터 웨어하우스에 직접 쿼리하므로 기본 데이터를 Braze에 복사하지 않고도 새로운 Segments를 생성할 수 있습니다.
Braze 워크스페이스에 연결된 소스를 추가한 후에는 세그먼트 확장에서 CDI Segment를 생성할 수 있습니다. CDI 세그먼트 확장을 사용하면 데이터 웨어하우스에 직접 쿼리하는 SQL을 작성하고(CDI 연결된 소스를 통해 사용할 수 있게 된 데이터 활용), Braze에서 타겟팅할 수 있는 사용자 그룹을 생성하고 유지할 수 있습니다.
이 소스로 Segment를 생성하는 방법에 대한 자세한 내용은 CDI 세그먼트 확장을 참조하세요.
연결된 소스는 데이터 웨어하우스에서 직접 실행되므로, 데이터 웨어하우스에서 이러한 쿼리를 실행하는 데 드는 모든 비용은 고객이 부담합니다. 연결된 소스는 데이터 포인트를 기록하지 않으며, CDI 세그먼트 확장은 SQL Segment 크레딧을 소모하지 않습니다.
연결된 소스 통합하기
1단계: 리소스 연결
Cloud Data Ingestion 연결된 소스를 사용하려면 Braze와 인스턴스 양쪽에서 몇 가지 설정이 필요합니다. 다음 단계에 따라 통합을 설정하세요. 일부 단계는 데이터 웨어하우스에서, 일부 단계는 Braze 대시보드에서 진행합니다.
데이터 웨어하우스에서
- 역할을 생성하고 스키마에서 쿼리를 실행하고 테이블을 생성할 수 있는 권한을 부여합니다.
- 웨어하우스를 설정하고 해당 역할에 액세스 권한을 부여합니다.
- Workload Identity Federation 또는 RSA 키 페어를 사용하여 해당 역할의 사용자를 생성합니다.
- 구성에 따라 Snowflake 네트워크 정책에서 Braze IP를 허용해야 할 수도 있습니다.
Braze 대시보드에서
- Braze 대시보드에서 새 연결된 소스를 생성합니다.
- 연결된 소스의 동기화 세부 정보를 구성합니다.
- RSA 키 페어를 사용하는 경우 공개 키를 가져옵니다. Workload Identity Federation을 사용하는 경우 자격 증명 양식에서 명령문을 복사합니다.
데이터 웨어하우스에서
- RSA 키 페어를 사용하는 경우 인증용 Snowflake 사용자에 공개 키를 추가합니다. Workload Identity Federation을 사용하는 경우 Snowflake 워크시트에서 명령문을 실행합니다. 완료되면 연결된 소스를 사용하여 CDI 세그먼트 확장을 하나 이상 생성할 수 있습니다.
- Redshift 환경에서 소스 데이터와 필요한 리소스를 설정합니다.
- Braze 대시보드에서 새 연결된 소스를 생성합니다.
- 통합을 테스트합니다.
- 연결된 소스를 사용하여 CDI 세그먼트 확장을 하나 이상 생성합니다.
- BigQuery 환경에서 소스 데이터와 필요한 리소스를 설정합니다.
- Braze가 Workload Identity Federation 또는 서비스 계정 키를 통해 액세스할 서비스 계정을 생성하고, 동기화하려는 데이터가 포함된 BigQuery 프로젝트와 데이터 세트에 대한 액세스를 허용합니다.
- Braze 대시보드에서 새 연결된 소스를 생성합니다.
- 통합을 테스트합니다.
- 연결된 소스를 사용하여 CDI 세그먼트 확장을 하나 이상 생성합니다.
- Databricks 환경에서 소스 데이터와 필요한 리소스를 설정합니다.
- OAuth M2M(machine-to-machine) 인증용 서비스 주체 또는 개인 액세스 토큰을 생성하고, 동기화하려는 데이터가 포함된 Databricks 카탈로그와 스키마에 대한 액세스를 허용합니다.
- Braze 대시보드에서 새 연결된 소스를 생성합니다.
- 통합을 테스트합니다.
- 연결된 소스를 사용하여 CDI 세그먼트 확장을 하나 이상 생성합니다.
Braze가 Classic 및 Pro SQL 인스턴스에 연결할 때 2~5분 정도의 준비 시간이 발생할 수 있으며, 이로 인해 연결 설정 및 테스트는 물론 CDI 세그먼트 확장 생성 및 새로 고침 중에도 지연이 생길 수 있습니다. 서버리스 SQL 인스턴스를 사용하면 준비 시간을 최소화하고 쿼리 처리량을 개선할 수 있지만, 통합 비용이 약간 높아질 수 있습니다.
- 서비스 주체를 생성하고 통합에 사용할 Fabric 작업 공간에 대한 액세스를 허용합니다.
- Fabric 작업 공간에서 소스 데이터를 설정하고 서비스 주체에 권한을 부여합니다.
- Braze 대시보드에서 새 연결된 소스를 생성합니다.
- 통합을 테스트합니다.
- 연결된 소스를 사용하여 CDI 세그먼트 확장을 하나 이상 생성합니다.
2단계: 데이터 웨어하우스 설정
데이터 웨어하우스 환경에서 소스 데이터와 필요한 리소스를 설정합니다. 연결된 소스는 하나 이상의 테이블을 참조할 수 있으므로, Braze 사용자가 연결된 소스에 포함하려는 모든 테이블에 액세스할 권한이 있는지 확인하세요.
2.1단계: 역할 생성 및 권한 부여
연결된 소스에서 사용할 역할을 생성합니다. 이 역할은 CDI 세그먼트 확장에서 사용할 수 있는 테이블 목록을 생성하고, 소스 테이블을 쿼리하여 새 Segment를 생성하는 데 사용됩니다. 연결된 소스가 생성되면 Braze는 소스 스키마에서 사용자가 사용할 수 있는 모든 테이블의 이름과 설명을 검색합니다.
스키마의 모든 테이블에 대한 액세스 권한을 부여하거나 특정 테이블에만 권한을 부여할 수 있습니다. Braze 역할이 액세스할 수 있는 테이블은 모두 CDI 세그먼트 확장에서 쿼리할 수 있습니다.
Braze에서 Segment를 업데이트하기 전에 CDI 세그먼트 확장 쿼리 결과로 테이블을 생성할 수 있도록 create table 권한이 필요합니다. Braze는 Segment마다 임시 테이블을 생성하며, 이 테이블은 Braze가 Segment를 업데이트하는 동안에만 유지됩니다.
CREATE ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT CREATE TABLE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
-- grant access to all current and future tables or views in the schema
GRANT SELECT ON ALL TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON FUTURE TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
-- grant access to specific tables or views in the schema
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;
2.2단계: 웨어하우스 설정 및 Braze 역할에 액세스 권한 부여
CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;
GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;
웨어하우스에서 auto-resume 플래그가 켜져 있어야 합니다. 켜져 있지 않은 경우, 쿼리를 실행할 때 Braze가 웨어하우스를 켤 수 있도록 웨어하우스에 대한 추가 OPERATE 권한을 Braze에 부여해야 합니다.
2.3단계: 사용자 설정
Braze는 Workload Identity Federation 또는 RSA 키 페어를 사용하여 Snowflake에 인증합니다. 기존 RSA 키 페어 자격 증명은 계속 작동하며 마이그레이션할 필요가 없습니다. 다음 방법 중 하나를 따르세요.
2.1단계 및 2.2단계의 역할 및 웨어하우스 권한 부여를 사용합니다. Snowflake 계정에서 네트워크 정책을 사용하는 경우 2.4단계에 설명된 대로 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 계정의 사용자가 여러 워크스페이스에 중복되면 통합 생성이 실패합니다.
2.4단계: 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.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
2.1단계: 사용자 생성 및 권한 부여
CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT CREATE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;
연결된 소스에서 사용할 사용자를 생성합니다. 이 사용자는 CDI 세그먼트 확장에서 사용할 수 있는 테이블 목록을 생성하고, 소스 테이블을 쿼리하여 새 Segment를 생성하는 데 사용됩니다. 연결된 소스가 생성되면 Braze는 소스 스키마에서 사용자가 사용할 수 있는 모든 테이블의 이름과 설명을 검색합니다. 여러 CDI 통합을 생성하는 경우 스키마에 권한을 부여하거나 그룹을 사용하여 권한을 관리하는 것이 좋습니다.
스키마의 모든 테이블에 대한 액세스 권한을 부여하거나 특정 테이블에만 권한을 부여할 수 있습니다. Braze 역할이 액세스할 수 있는 테이블은 모두 CDI 세그먼트 확장에서 쿼리할 수 있습니다. 새 테이블이 생성되면 사용자에게 해당 테이블에 대한 액세스 권한을 부여하거나, 사용자에 대한 기본 권한을 설정하세요.
Braze에서 Segment를 업데이트하기 전에 CDI 세그먼트 확장 쿼리 결과로 테이블을 생성할 수 있도록 create table 권한이 필요합니다. Braze는 Segment마다 임시 테이블을 생성하며, 이 테이블은 Braze가 Segment를 업데이트하는 동안에만 유지됩니다.
2.2단계: Braze IP에 대한 액세스 허용
방화벽이나 기타 네트워크 정책이 있는 경우 Braze에 Redshift 인스턴스에 대한 네트워크 액세스 권한을 부여해야 합니다. Braze 대시보드의 리전에 해당하는 다음 IP에서의 액세스를 허용하세요.
Braze가 Redshift의 데이터에 액세스할 수 있도록 보안 그룹을 변경해야 할 수도 있습니다. 다음 섹션의 IP와 Redshift 클러스터 쿼리에 사용되는 포트(기본값은 5439)에서 인바운드 트래픽을 명시적으로 허용하세요. 인바운드 규칙이 “모두 허용”으로 설정되어 있더라도 이 포트에서 Redshift TCP 연결을 명시적으로 허용해야 합니다. 또한 Braze가 클러스터에 연결하려면 Redshift 클러스터의 엔드포인트에 공개적으로 액세스할 수 있어야 합니다.
Redshift 클러스터를 공개적으로 액세스할 수 있도록 하고 싶지 않다면, VPC와 EC2 인스턴스를 설정하고 SSH 터널을 사용하여 Redshift 데이터에 액세스할 수 있습니다. 자세한 내용은 AWS: 로컬 머신에서 프라이빗 Amazon Redshift 클러스터에 액세스하려면 어떻게 해야 하나요?를 참조하세요.
인스턴스 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
2.1단계: Braze용 자격 증명 생성
Braze가 테이블에 연결하고 데이터를 읽는 데 사용할 서비스 계정을 GCP에서 생성합니다. 서비스 계정에는 다음 권한이 있어야 합니다.
- BigQuery Connection User: Braze가 연결을 생성할 수 있도록 허용합니다.
- BigQuery User: Braze에 쿼리 실행, 데이터 세트 메타데이터 읽기, 테이블 목록 조회 권한을 제공합니다.
- BigQuery Data Viewer: Braze에 데이터 세트와 그 콘텐츠를 볼 수 있는 권한을 제공합니다.
- BigQuery Job User: Braze에 작업 실행 권한을 제공합니다.
- bigquery.tables.create Braze에 Segment 새로 고침 중 임시 테이블을 생성할 수 있는 권한을 제공합니다.
연결된 소스에서 사용할 서비스 계정을 생성합니다. 이 사용자는 CDI 세그먼트 확장에서 사용할 수 있는 테이블 목록을 생성하고, 소스 테이블을 쿼리하여 새 Segment를 생성하는 데 사용됩니다. 연결된 소스가 생성되면 Braze는 소스 스키마에서 사용자가 사용할 수 있는 모든 테이블의 이름과 설명을 검색합니다.
데이터 세트의 모든 테이블에 대한 액세스 권한을 부여하거나 특정 테이블에만 권한을 부여할 수 있습니다. Braze 역할이 액세스할 수 있는 테이블은 모두 CDI 세그먼트 확장에서 쿼리할 수 있습니다.
Braze에서 Segment를 업데이트하기 전에 CDI 세그먼트 확장 쿼리 결과로 테이블을 생성할 수 있도록 create table 권한이 필요합니다. Braze는 Segment마다 임시 테이블을 생성하며, 이 테이블은 Braze가 Segment를 업데이트하는 동안에만 유지됩니다.
Braze는 Workload Identity Federation 또는 서비스 계정 키를 사용하여 서비스 계정에 액세스할 수 있습니다. 기존 서비스 계정 키 자격 증명은 계속 작동하며 마이그레이션할 필요가 없습니다. 하나의 Workload Identity Federation 자격 증명으로 BigQuery와 Google Cloud Storage 소스를 모두 사용할 수 있습니다.
워크로드 아이덴티티 풀, 공급자, 서비스 계정을 설정하고 Braze 주체를 서비스 계정에 바인딩합니다. 단계는 Workload Identity Federation을 위한 Google Cloud 구성을 참조하세요. 다른 BigQuery 또는 Google Cloud Storage 소스에 대해 이미 Workload Identity Federation을 설정했다면 다시 설정할 필요가 없습니다. 기존 서비스 계정에 이 단계에 나열된 권한을 부여하세요.
서비스 계정을 생성하고 권한을 부여한 후 JSON 키를 생성합니다. 자세한 내용은 Google Cloud: 서비스 계정 키 생성 및 삭제를 참조하세요. 이 키는 나중에 Braze 대시보드에 업로드합니다.
2.2단계: Braze IP에 대한 액세스 허용
네트워크 정책이 적용되어 있는 경우 Braze에 BigQuery 인스턴스에 대한 네트워크 액세스 권한을 부여해야 합니다. 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
2.1단계: Braze용 자격 증명 생성
Braze는 서비스 주체를 사용한 OAuth M2M(machine-to-machine) 또는 개인 액세스 토큰으로 Databricks에 연결할 수 있습니다. Braze는 OAuth M2M을 권장합니다. 기존 개인 액세스 토큰 자격 증명은 계속 작동하며 마이그레이션할 필요가 없습니다.
어떤 방법을 선택하든 Braze는 이 자격 증명을 사용하여 CDI 세그먼트 확장에서 사용할 수 있는 테이블 목록을 생성하고, 소스 테이블을 쿼리하여 새 Segment를 생성합니다. 연결된 소스가 생성되면 Braze는 소스 스키마에서 사용자가 사용할 수 있는 모든 테이블의 이름과 설명을 검색합니다.
스키마의 모든 테이블에 대한 액세스 권한을 부여하거나 특정 테이블에만 권한을 부여할 수 있습니다. Braze 역할이 액세스할 수 있는 테이블은 모두 CDI 세그먼트 확장에서 쿼리할 수 있습니다.
Braze에서 Segment를 업데이트하기 전에 CDI 세그먼트 확장 쿼리 결과로 테이블을 생성할 수 있도록 CREATE TABLE 권한이 필요합니다. Braze는 Segment마다 임시 테이블을 생성하며, 이 테이블은 Braze가 Segment를 업데이트하는 동안에만 유지됩니다.
- 서비스 주체를 생성하고, 클라이언트 시크릿을 생성한 다음, SQL 웨어하우스에 대한 Can use 권한을 서비스 주체에 부여합니다. 단계는 Braze용 자격 증명 생성을 참조하세요.
- 연결된 소스에 사용되는 스키마에 대해
CREATE TABLE을 포함한 액세스 권한을 서비스 주체에 부여합니다. 권한 대상으로는 서비스 주체의 애플리케이션 ID(클라이언트 ID와 동일한 값)를 사용합니다.
GRANT USE CATALOG ON CATALOG `BRAZE-CLOUD-PRODUCTION` TO `APPLICATION_ID`;
GRANT USE SCHEMA, CREATE TABLE ON SCHEMA `BRAZE-CLOUD-PRODUCTION`.INGESTION TO `APPLICATION_ID`;
GRANT SELECT ON SCHEMA `BRAZE-CLOUD-PRODUCTION`.INGESTION TO `APPLICATION_ID`;
APPLICATION_ID를 서비스 주체의 애플리케이션 ID로 바꾸세요.
자격 증명 생성 단계에서 Braze 대시보드에 입력할 때까지 클라이언트 ID와 시크릿을 안전한 곳에 보관하세요.
- Databricks 워크스페이스의 상단 표시줄에서 Databricks 사용자 이름을 선택한 다음, 드롭다운에서 User Settings를 선택합니다.
- 서비스 계정에 연결된 소스에 사용되는 스키마에 대한
CREATE TABLE권한이 있는지 확인합니다. - Access tokens 탭에서 Generate new token을 선택합니다.
- “Braze CDI”처럼 이 토큰을 식별하는 데 도움이 되는 설명을 입력하고, Lifetime (days) 상자를 비워 두어 토큰의 수명을 무제한으로 변경합니다.
- Generate를 선택합니다.
- 표시된 토큰을 복사한 다음 Done을 선택합니다.
자격 증명 생성 단계에서 Braze 대시보드에 입력할 때까지 토큰을 안전한 곳에 보관하세요.
2.2단계: Braze IP에 대한 액세스 허용
네트워크 정책이 적용되어 있는 경우 Braze에 Databricks 인스턴스에 대한 네트워크 액세스 권한을 부여해야 합니다. 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
2.1단계: Fabric 리소스에 대한 액세스 권한 부여
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로의 데이터 흐름을 유지하려면 자격 증명이 만료되기 전에 갱신하세요.
2.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”을 활성화하여 서비스 주체가 외부 앱에서 데이터에 액세스할 수 있도록 합니다.
2.3단계: 웨어하우스 연결 문자열 가져오기
Braze가 연결하려면 웨어하우스의 SQL 엔드포인트가 필요합니다. SQL 엔드포인트를 가져오려면 Fabric의 workspace로 이동하여 항목 목록에서 웨어하우스 이름 위에 마우스를 올린 다음 Copy SQL connection string을 선택합니다. 3단계의 자격 증명 설정에 사용할 수 있도록 이 값을 준비해 두세요.
2.4단계: 방화벽에서 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.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
3단계: Braze 대시보드에서 연결된 소스 생성
3.1단계: Snowflake 연결 정보 및 소스 테이블 추가
Braze 대시보드에서 연결된 소스를 생성합니다. 데이터 설정 > 클라우드 데이터 수집 > 연결된 소스로 이동하여 데이터 소스 추가를 선택한 다음 Snowflake를 선택합니다.
소스 설정에서 다음을 입력합니다.
- 자격 증명 이름 및 인증 방법(Workload Identity Federation 또는 키 페어)
- 자격 증명: 계정 로케이터, 사용자 이름, 역할
- 구성: 웨어하우스, 데이터베이스, 스키마
Workload Identity Federation의 경우 명령문 복사를 선택하고 Snowflake 워크시트에서 실행한 다음 자격 증명 저장을 선택합니다. 키 페어의 경우 연결을 테스트하기 전에 자격 증명 저장 및 RSA 키 생성을 선택합니다.
3.2단계: 동기화 세부 정보 구성
연결된 소스의 이름을 지정합니다. 이 이름은 새 CDI 세그먼트 확장을 생성할 때 사용 가능한 소스 목록에 표시됩니다.
이 소스의 최대 실행 시간을 구성합니다. Braze는 최대 실행 시간을 초과하는 쿼리를 자동으로 중단합니다. 허용되는 최대 실행 시간은 60분이며, 실행 시간을 낮추면 Snowflake 계정에서 발생하는 비용을 줄일 수 있습니다. 이 설정은 동기화 및 이 소스를 사용하는 CDI 세그먼트 확장을 포함하여 이 소스를 통해 실행되는 쿼리에 적용됩니다.
쿼리가 지속적으로 시간 초과되고 최대 실행 시간을 60분으로 설정했다면, 쿼리 실행 시간을 최적화하거나 Braze 사용자에게 더 큰 웨어하우스를 할당하는 것을 고려해 보세요.
3.3단계: 공개 키 기록(키 페어)
연결 테스트 단계에서 RSA 공개 키를 기록해 두세요. Snowflake에서 통합을 완료하는 데 필요합니다.
3.1단계: Redshift 연결 정보 및 소스 테이블 추가
Braze 대시보드에서 연결된 소스를 생성합니다. 데이터 설정 > 클라우드 데이터 수집 > 연결된 소스로 이동하여 데이터 소스 추가를 선택한 다음 Amazon Redshift를 선택합니다.
소스 설정에서 다음을 입력합니다.
- 자격 증명: Redshift 호스트 URL, 사용자 이름, 비밀번호, 포트
- 구성: 데이터베이스 및 스키마
필요한 경우 SSH 터널로 연결을 활성화하고 터널 호스트, 터널 포트, 터널 사용자 이름을 입력합니다.
3.2단계: 동기화 세부 정보 구성
연결된 소스의 이름을 지정합니다. 이 이름은 새 CDI 세그먼트 확장을 생성할 때 사용 가능한 소스 목록에 표시됩니다.
이 소스의 최대 실행 시간을 구성합니다. Braze는 최대 실행 시간을 초과하는 쿼리를 자동으로 중단합니다. 허용되는 최대 실행 시간은 60분이며, 실행 시간을 낮추면 Redshift 계정에서 발생하는 비용을 줄일 수 있습니다. 이 설정은 동기화 및 이 소스를 사용하는 CDI 세그먼트 확장을 포함하여 이 소스를 통해 실행되는 쿼리에 적용됩니다.
쿼리가 지속적으로 시간 초과되고 최대 실행 시간을 60분으로 설정했다면, 쿼리 실행 시간을 최적화하거나 Braze 사용자에게 더 큰 웨어하우스를 할당하는 것을 고려해 보세요.
3.3단계: 공개 키 기록(선택 사항)
자격 증명에서 SSH 터널로 연결을 선택한 경우 연결 테스트 단계에서 RSA 공개 키를 기록해 두세요. Redshift에서 통합을 완료하는 데 필요합니다.
3.1단계: BigQuery 연결 정보 및 소스 테이블 추가
Braze 대시보드에서 연결된 소스를 생성합니다. 데이터 설정 > 클라우드 데이터 수집 > 연결된 소스로 이동하여 데이터 소스 추가를 선택한 다음 Google BigQuery를 선택합니다.
소스 설정에서 다음을 입력합니다.
- 자격 증명: 자격 증명 이름 및 인증 방법, 그리고 프로젝트 번호, 워크로드 아이덴티티 풀 ID, 공급자 ID, 서비스 계정 이메일(Workload Identity Federation) 또는 업로드한 JSON 키(서비스 계정 키) 중 하나
- 구성: 프로젝트 및 데이터 세트
3.2단계: 동기화 세부 정보 구성
연결된 소스의 이름을 지정합니다. 이 이름은 새 CDI 세그먼트 확장을 생성할 때 사용 가능한 소스 목록에 표시됩니다.
이 소스의 최대 실행 시간을 구성합니다. Braze는 최대 실행 시간을 초과하는 쿼리를 자동으로 중단합니다. 허용되는 최대 실행 시간은 60분이며, 실행 시간을 낮추면 BigQuery 계정에서 발생하는 비용을 줄일 수 있습니다. 이 설정은 동기화 및 이 소스를 사용하는 CDI 세그먼트 확장을 포함하여 이 소스를 통해 실행되는 쿼리에 적용됩니다.
쿼리가 지속적으로 시간 초과되고 최대 실행 시간을 60분으로 설정했다면, 쿼리 실행 시간을 최적화하거나 Braze 사용자에게 더 큰 웨어하우스를 할당하는 것을 고려해 보세요.
3.3단계: 연결 테스트
연결 테스트를 선택하여 사용자에게 표시되는 테이블 목록이 예상과 일치하는지 확인한 다음 완료를 선택합니다. 이제 연결된 소스가 생성되었으며 CDI 세그먼트 확장에서 사용할 준비가 되었습니다.
3.1단계: Databricks 연결 정보 및 소스 테이블 추가
Braze 대시보드에서 연결된 소스를 생성합니다. 데이터 설정 > 클라우드 데이터 수집 > 연결된 소스로 이동하여 데이터 소스 추가를 선택한 다음 Databricks를 선택합니다.
소스 설정에서 다음을 입력합니다.
- 자격 증명: 자격 증명 이름, 인증 방법, 호스트 이름, HTTP 경로, 그리고 클라이언트 ID 및 클라이언트 시크릿(OAuth M2M) 또는 액세스 토큰(개인 액세스 토큰) 중 하나
- 구성: 카탈로그 및 스키마
3.2단계: 동기화 세부 정보 구성
연결된 소스의 이름을 지정합니다. 이 이름은 새 CDI 세그먼트 확장을 생성할 때 사용 가능한 소스 목록에 표시됩니다.
이 소스의 최대 실행 시간을 구성합니다. Braze는 최대 실행 시간을 초과하는 쿼리를 자동으로 중단합니다. 허용되는 최대 실행 시간은 60분이며, 실행 시간을 낮추면 Databricks 계정에서 발생하는 비용을 줄일 수 있습니다. 이 설정은 동기화 및 이 소스를 사용하는 CDI 세그먼트 확장을 포함하여 이 소스를 통해 실행되는 쿼리에 적용됩니다.
쿼리가 지속적으로 시간 초과되고 최대 실행 시간을 60분으로 설정했다면, 쿼리 실행 시간을 최적화하거나 Braze 사용자에게 더 큰 웨어하우스를 할당하는 것을 고려해 보세요.
3.3단계: 연결 테스트
연결 테스트를 선택하여 사용자에게 표시되는 테이블 목록이 예상과 일치하는지 확인한 다음 완료를 선택합니다. 이제 연결된 소스가 생성되었으며 CDI 세그먼트 확장에서 사용할 준비가 되었습니다.
3.1단계: Microsoft Fabric 연결 정보 및 소스 테이블 추가
Braze 대시보드에서 연결된 소스를 생성합니다. 데이터 설정 > 클라우드 데이터 수집 > 연결된 소스로 이동하여 데이터 소스 추가를 선택한 다음 Microsoft Fabric을 선택합니다.
소스 설정에서 다음을 입력합니다.
- 자격 증명: 자격 증명 이름, 테넌트 ID, 주체 ID, 클라이언트 시크릿, 연결 문자열
- 구성: 데이터베이스 및 스키마
워크스페이스에서 SSH 터널로 연결을 사용할 수 있고 설정에 필요한 경우 터널 호스트, 터널 포트, 터널 사용자 이름도 입력합니다.
3.2단계: 동기화 세부 정보 구성
연결된 소스의 이름을 지정합니다. 이 이름은 새 CDI 세그먼트 확장을 생성할 때 사용 가능한 소스 목록에 표시됩니다.
이 소스의 최대 실행 시간을 구성합니다. Braze는 최대 실행 시간을 초과하는 쿼리를 자동으로 중단합니다. 허용되는 최대 실행 시간은 60분이며, 실행 시간을 낮추면 Microsoft Fabric 계정에서 발생하는 비용을 줄일 수 있습니다. 이 설정은 동기화 및 이 소스를 사용하는 CDI 세그먼트 확장을 포함하여 이 소스를 통해 실행되는 쿼리에 적용됩니다.
쿼리가 지속적으로 시간 초과되고 최대 실행 시간을 60분으로 설정했다면, 쿼리 실행 시간을 최적화하거나 Fabric 용량을 확장하는 것을 고려해 보세요.
3.3단계: 연결 테스트
연결 테스트를 선택하여 사용자에게 표시되는 테이블 목록이 예상과 일치하는지 확인한 다음 완료를 선택합니다. 이제 연결된 소스가 생성되었으며 CDI 세그먼트 확장에서 사용할 준비가 되었습니다.
4단계: 데이터 웨어하우스 구성 마무리
이전 단계에서 자격 증명 양식의 명령문을 이미 실행했습니다. Braze에서 연결 테스트를 선택한 다음 완료를 선택합니다. 이제 연결된 소스가 생성되었으며 CDI 세그먼트 확장에서 사용할 준비가 되었습니다.
이전 단계에서 기록한 공개 키를 Snowflake의 사용자에게 추가합니다. 이렇게 하면 Braze가 Snowflake에 연결할 수 있습니다. 자세한 내용은 Snowflake 키 페어 인증을 참조하세요.
ALTER USER BRAZE_INGESTION_USER SET rsa_public_key='{INSERT_YOUR_KEY}';
나중에 키를 교체하려면 데이터 설정 > 클라우드 데이터 수집 > 자격 증명으로 이동하여 Snowflake 데이터 액세스 자격 증명에서 자격 증명을 열고 자격 증명 교체를 선택합니다. 세부 정보 모달에 대한 내용은 Snowflake 자격 증명 검토를 참조하세요.
Snowflake의 사용자에게 키를 추가한 후 Braze에서 연결 테스트를 선택한 다음 완료를 선택합니다. 이제 연결된 소스가 생성되었으며 CDI 세그먼트 확장에서 사용할 준비가 되었습니다.
SSH 터널로 연결하는 경우 이전 단계에서 기록한 공개 키를 SSH 터널 사용자에게 추가합니다.
사용자에게 키를 추가한 후 Braze에서 연결 테스트를 선택한 다음 완료를 선택합니다. 이제 연결된 소스가 생성되었으며 CDI 세그먼트 확장에서 사용할 준비가 되었습니다.
BigQuery에는 해당되지 않습니다.
Databricks에는 해당되지 않습니다.
Microsoft Fabric에는 해당되지 않습니다.
소스가 “초안” 상태에서 “활성” 상태로 전환되려면 먼저 테스트를 성공적으로 완료해야 합니다. 생성 페이지를 닫아야 하는 경우에도 통합은 저장되며, 나중에 세부 정보 페이지로 돌아와 변경하고 테스트할 수 있습니다.
추가 통합 또는 사용자 설정(선택 사항)
Braze와 여러 개의 통합을 설정할 수 있지만, 각 통합은 서로 다른 스키마에 연결되도록 구성해야 합니다. 추가 연결을 만들 때 동일한 Snowflake 계정에 연결하는 경우 기존 자격 증명을 재사용할 수 있습니다.
여러 통합에서 동일한 키 페어 사용자와 역할을 재사용하는 경우 공개 키를 다시 추가할 필요가 없습니다. 워크로드 아이덴티티 페더레이션(Workload Identity Federation) 자격 증명에는 추가할 공개 키가 없습니다.
Braze와 여러 개의 소스를 설정할 수 있지만, 각 소스는 서로 다른 스키마에 연결되도록 구성해야 합니다. 추가 소스를 만들 때 동일한 Redshift 계정에 연결하는 경우 기존 자격 증명을 재사용할 수 있습니다.
Braze와 여러 개의 소스를 설정할 수 있지만, 각 소스는 서로 다른 데이터 세트에 연결되도록 구성해야 합니다. 추가 소스를 만들 때 동일한 BigQuery 계정에 연결하는 경우 기존 자격 증명을 재사용할 수 있습니다.
Braze와 여러 개의 소스를 설정할 수 있지만, 각 소스는 서로 다른 스키마에 연결되도록 구성해야 합니다. 추가 소스를 만들 때 동일한 Databricks 계정에 연결하는 경우 기존 자격 증명을 재사용할 수 있습니다.
Braze와 여러 개의 소스를 설정할 수 있지만, 각 소스는 서로 다른 스키마에 연결되도록 구성해야 합니다. 추가 소스를 만들 때 동일한 Azure 계정에 연결하는 경우 기존 자격 증명을 재사용할 수 있습니다.
연결된 소스 사용
소스가 생성되면 이를 사용하여 하나 이상의 CDI 세그먼트 확장을 만들 수 있습니다. 이 소스로 세그먼트를 만드는 방법에 대한 자세한 내용은 CDI 세그먼트 확장 설명서를 참조하세요.
최대 런타임을 60분으로 설정했는데도 쿼리가 계속 시간 초과된다면 쿼리 실행 시간을 최적화하거나 Braze 사용자에게 더 많은 컴퓨팅 리소스(예: 더 큰 웨어하우스)를 할당해 보세요.