Microsoft Fabric용 클라우드 데이터 수집

이 페이지에서는 클라우드 데이터 수집(CDI)을 사용하여 Microsoft Fabric의 데이터를 Braze로 동기화하는 데 필요한 모든 내용을 다룹니다. Fabric에서 생성해야 하는 리소스, Braze에서 소스를 연결하고 동기화를 생성하는 방법, 데이터 유형별 소스 테이블, Fabric 관련 문제 해결 방법을 확인할 수 있습니다.

설정 개요

1. 지원되는 인증 방법 중 하나를 사용하여 Braze 인증을 설정하고 Fabric API에 대한 액세스 권한을 부여합니다.
2. 공유 워크스페이스를 설정하고 서비스 주체에 해당 워크스페이스에 대한 액세스 권한을 부여합니다.
3. 공유 Fabric 워크스페이스에서 Braze로 동기화할 테이블 또는 뷰를 설정합니다.
4. Braze 대시보드에서 새 소스와 동기화를 생성합니다.
5. 통합을 검증하고 동기화를 시작합니다.

1단계: 인증 설정

Braze는 다음 인증 방법으로 Fabric 웨어하우스에 연결합니다.

Service principal

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

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

애플리케이션을 등록하려면 Microsoft Entra ID에서 앱 등록을 생성할 수 있는 권한이 필요합니다. 이 권한이 없다면 Entra 관리자에게 이 단계를 완료하고 자격 증명을 공유해 달라고 요청하세요.

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

참고

Azure에서는 서비스 주체 시크릿의 만료 기간을 무제한으로 설정할 수 없습니다. Braze로의 데이터 흐름이 끊기지 않도록 자격 증명이 만료되기 전에 갱신하세요.

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을 활성화하여 서비스 주체가 외부 앱에서 데이터에 액세스할 수 있도록 합니다.

3단계: 공유 워크스페이스 설정 및 액세스 권한 부여

Braze에 연결하려는 모든 Fabric 리소스는 공유 워크스페이스에 있어야 합니다. 지금까지 기본 My Workspace만 사용해 왔다면 새 공유 워크스페이스를 생성하세요.

1. 탐색 메뉴에서 Workspaces를 선택한 다음 + New workspace를 선택합니다.
2. 워크스페이스의 Name을 입력한 다음 Apply를 선택합니다.

공유 워크스페이스가 준비되면 서비스 주체에 액세스 권한을 부여합니다.

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

이제 서비스 주체가 SQL 엔드포인트를 통해 이 워크스페이스의 Fabric 웨어하우스 리소스(Braze에 사용할 웨어하우스 포함)에 액세스할 수 있습니다.

4단계: 소스 테이블 설정

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

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

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

참고

PAYLOAD 열을 사용하는 경우 소스 테이블이나 뷰에 다음 탭에 나열되지 않은 열(예: 감사 또는 해싱용 열)을 포함할 수 있습니다. Braze는 이 탭에 설명된 열만 읽으며, 그 외의 열은 클라우드 데이터 수집 동기화 중에 사용되지 않습니다.

동기화할 데이터 유형에 해당하는 탭을 선택하세요.

• 사용자 속성
• 커스텀 이벤트
• 구매 이벤트
• 카탈로그 항목
• canvas 트리거
• 사용자 삭제

사용자 속성, 커스텀 이벤트, 구매 이벤트는 모두 동일한 형태의 소스 테이블을 사용합니다. PAYLOAD의 내용만 다릅니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

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 중 하나). 소스 테이블에는 식별자 유형 한 가지, 두 가지, 세 가지, 네 가지 또는 다섯 가지 모두에 대한 열이 있을 수 있습니다.
  • 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는 사용자 속성 객체 형식을 따릅니다. 중첩 커스텀 속성, 객체 배열, 구독 그룹 상태를 포함할 수 있습니다. 페이로드 예시는 테이블 설정을 참조하세요.

커스텀 이벤트는 사용자 속성과 동일한 소스 테이블을 사용합니다. 사용자 속성 탭에 표시된 테이블을 생성한 다음 PAYLOAD를 이벤트 객체로 채우세요.

이벤트를 동기화하려면 이벤트 이름이 필요합니다. time 필드는 ISO 8601 문자열 또는 yyyy-MM-dd'T'HH:mm:ss:SSSZ 형식으로 지정합니다. time 필드가 없으면 Braze는 UPDATED_AT 열 값을 이벤트 시간으로 사용합니다. app_id, properties를 포함한 기타 필드는 선택 사항입니다.

행당 하나의 이벤트를 동기화할 수 있습니다.

1
2
3
4
5
6
7
8
9

{
    "app_id" : "your-app-id",
    "name" : "rented_movie",
    "time" : "2013-07-16T19:20:45+01:00",
    "properties": {
        "movie": "The Sad Egg",
        "director": "Alex Smith"
    }
}

구매 이벤트는 사용자 속성과 동일한 소스 테이블을 사용합니다. 사용자 속성 탭에 표시된 테이블을 생성한 다음 PAYLOAD를 구매 객체로 채우세요.

구매 이벤트를 동기화하려면 product_id, currency, price가 필요합니다. 선택 사항인 time 필드는 ISO 8601 문자열 또는 yyyy-MM-dd'T'HH:mm:ss:SSSZ 형식으로 지정합니다. time 필드가 없으면 Braze는 UPDATED_AT 열 값을 이벤트 시간으로 사용합니다. app_id, quantity, properties를 포함한 기타 필드는 선택 사항입니다.

행당 하나의 구매 이벤트를 동기화할 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12

{
    "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에서 대상 카탈로그를 먼저 생성하세요. 전체 카탈로그 워크플로는 카탈로그 데이터 동기화 및 삭제를 참조하세요.

1
2
3
4
5
6
7
8

CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PAYLOAD VARCHAR NOT NULL,
  ID VARCHAR NOT NULL,
  DELETED BIT
)
GO

통합 이름은 Braze에서 생성한 카탈로그 이름과 정확히 일치해야 합니다.

동기화가 실행될 때마다 소스 테이블이 완전히 새로 고쳐지도록 카탈로그 데이터로 뷰를 생성하는 것이 좋습니다. 예를 들어 id와 네 개의 추가 속성이 있는 제품 데이터 테이블(product_catalog)이 있다면 다음 뷰를 동기화할 수 있습니다.

1
2
3
4
5
6
7

CREATE VIEW [braze].[user_update_example]
AS SELECT
    id as ID,
    CURRENT_TIMESTAMP as UPDATED_AT,
    JSON_OBJECT('attribute_1':attribute_1, 'attribute_2':attribute_2, 'attribute_3':attribute_3, 'attribute_4':attribute_4) as PAYLOAD

FROM [braze].[product_catalog] ;

Canvas 트리거는 제로 카피 개인화를 지원합니다. 대상 Canvas 설정 및 고려 사항은 제로 카피 개인화를 참조하세요.

1
2
3
4
5
6
7
8
9
10
11

CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PROPERTIES VARCHAR NOT NULL,
  --at least one of external_id or alias_name and alias_label is required
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR
)
GO

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 문자열이어야 합니다. 행에 속성이 없으면 빈 {} 문자열을 입력하세요.

서비스 주체를 생성하고 권한을 부여합니다. 다른 동기화에서 사용 중인 자격 증명이 이미 있다면 재사용할 수 있지만, 해당 자격 증명이 Canvas 트리거 테이블에 액세스할 수 있는지 확인하세요.

시작하려면 새 동기화를 생성할 때 Canvas 트리거 데이터 유형을 선택하세요.

사용자 삭제를 위한 소스 테이블에는 하나 이상의 사용자 식별자 유형과 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에서 무시됩니다.

1
2
3
4
5
6
7
8
9
10
11
12

CREATE OR ALTER TABLE [warehouse].[schema].[users_deletes]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  --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_NAME VARCHAR,
  ALIAS_LABEL VARCHAR,
  --braze_id can only be used to update existing users created through the Braze SDK
  BRAZE_ID VARCHAR
)
GO

통합 실행 중에 올바른 작업이 수행되도록 가져오기 동기화 생성 페이지에서 데이터 유형을 사용자 삭제로 설정하세요. 자세한 내용은 클라우드 데이터 수집으로 사용자 삭제하기를 참조하세요.

경고

고객 프로필 삭제는 되돌릴 수 없습니다. 삭제 작업은 사용자를 영구적으로 제거하므로 데이터에 불일치가 발생할 수 있습니다. 자세한 내용은 고객 프로필 삭제의 영향을 참조하세요.

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

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

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

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

• united states (us)
• european union (eu)
• australia (au)
• indonesia (id)
• japan (jp)
• south korea (kr)

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

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

7.1단계: Microsoft Fabric 연결 정보 추가

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

• 자격 증명 이름은 Braze에서 이 자격 증명을 식별하는 레이블이므로 알아보기 쉬운 값으로 설정하면 됩니다.
• 1단계에서 설정한 인증 방법의 자격 증명을 입력합니다. 다음을 입력합니다: Tenant ID, Principal ID, and Client Secret.
• 연결 문자열은 5단계를 참조하세요.

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

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

참고

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

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

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

동기화 세부 정보 구성 및 데이터 정의

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

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

참고

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

알림 기본 설정 추가

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

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

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

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

스케줄 설정

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

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

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

참고

통합이 초안 상태에서 활성 상태로 전환되려면 먼저 유효성 검사에 성공해야 합니다. 생성 페이지를 닫으면 통합이 저장되며, 세부 정보 페이지를 다시 방문하여 변경하고 유효성 검사를 진행할 수 있습니다.

동기화 실행

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

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

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

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

Microsoft Fabric을 연결된 소스로 사용

연결된 소스는 Braze로 데이터를 동기화하는 대신 사용할 수 있는 제로 카피 방식입니다. Braze는 기본 데이터를 복사하지 않고 Fabric 웨어하우스를 직접 쿼리하여 CDI 세그먼트를 구축합니다. 개념, 제한 사항, 비용 영향에 대해서는 연결된 소스를 참조하세요.

1단계: 인증 설정 및 액세스 권한 부여

1단계, 2단계, 3단계에 설명된 것과 동일한 설정을 따릅니다. 그런 다음 5단계에 설명된 대로 웨어하우스 연결 문자열을 가져오고, 6단계에 설명된 대로 Braze IP를 허용합니다.

Fabric 워크스페이스에서 소스 데이터를 설정하고 서비스 주체에 권한을 부여합니다. 연결된 소스는 하나 이상의 테이블을 참조할 수 있으므로, 연결된 소스에 포함하려는 모든 테이블에 Braze 서비스 주체가 액세스할 수 있는 권한이 있는지 확인하세요.

2단계: Braze에서 연결된 소스 생성

데이터 설정 > 클라우드 데이터 수집 > 연결된 소스로 이동하여 데이터 소스 추가를 선택한 다음 Microsoft Fabric을 선택합니다.

소스 설정에서 다음을 입력합니다.

• 자격 증명: 자격 증명 이름, 연결 문자열 및 인증 방법에 해당하는 필드. 다음을 입력합니다: Tenant ID, Principal ID, and Client Secret.
• 구성: 데이터베이스 및 스키마

워크스페이스에서 SSH 터널로 연결을 사용할 수 있고 설정에 필요한 경우 터널 호스트, 터널 포트, 터널 사용자 이름도 입력합니다.

연결된 소스의 이름을 정합니다. 이 이름은 새 CDI 세그먼트 확장을 생성할 때 사용 가능한 소스 목록에 표시됩니다.

이 소스의 최대 실행 시간을 구성합니다. Braze는 최대 실행 시간을 초과하는 쿼리를 자동으로 중단합니다. 허용되는 최대 실행 시간은 60분이며, 실행 시간을 낮게 설정하면 Microsoft Fabric 계정에서 발생하는 비용을 줄일 수 있습니다. 이 설정은 이 소스를 통해 실행되는 쿼리에 적용되며, 이 소스를 사용하는 동기화와 CDI 세그먼트 확장도 포함됩니다.

참고

최대 실행 시간을 60분으로 설정했는데도 쿼리가 계속 시간 초과된다면 쿼리 실행 시간을 최적화하거나 Fabric 용량을 확장해 보세요.

연결 테스트를 선택하여 사용자에게 표시되는 테이블 목록이 예상과 일치하는지 확인한 다음 완료를 선택합니다. 이제 연결된 소스가 생성되어 CDI 세그먼트 확장에서 사용할 수 있습니다.

Braze와 여러 연결된 소스를 설정할 수 있지만, 각 소스는 서로 다른 스키마에 연결하도록 구성해야 합니다. 추가 소스를 생성할 때 동일한 Azure 계정에 연결하는 경우 기존 자격 증명을 재사용할 수 있습니다.

기존 열에서 페이로드 형식 지정

내부적으로 각 속성을 개별 열에 저장하는 방식을 선호한다면, Braze와의 동기화를 채우기 위해 해당 열을 JSON 문자열로 변환해야 합니다. Microsoft Fabric에서 다음 쿼리를 사용하여 소스 열을 CDI 필드 형식으로 변환하세요.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

CREATE TABLE [braze].[users] (
    attribute_1 VARCHAR,
    attribute_2 VARCHAR,
    attribute_3 VARCHAR,
    attribute_4 VARCHAR,
    user_id VARCHAR
)
GO

CREATE VIEW [braze].[user_update_example]
AS SELECT
    user_id as EXTERNAL_ID,
    CURRENT_TIMESTAMP as UPDATED_AT,
    JSON_OBJECT('attribute_1':attribute_1, 'attribute_2':attribute_2, 'attribute_3':attribute_3, 'attribute_4':attribute_4) as PAYLOAD

FROM [braze].[users] ;

추가 최적화 가이드는 클라우드 데이터 수집 모범 사례를 참조하세요.

문제 해결

연결 테스트 실행 속도가 느림

연결 테스트는 데이터 웨어하우스에서 실행되므로 용량을 늘리면 속도가 개선될 수 있습니다.

서비스 주체 시크릿이 만료됨

Azure에서는 서비스 주체 시크릿에 무제한 만료를 허용하지 않습니다. 동기화가 인증 오류로 실패하기 시작하면 Microsoft Entra ID에서 클라이언트 시크릿을 갱신하고 Braze에서 자격 증명을 업데이트하세요.

SQL 검사를 실행할 위치

CDI 통합에서 사용하는 것과 동일한 테이블 또는 뷰를 대상으로 Fabric SQL 쿼리 편집기에서 직접 유효성 검사를 실행하세요. Fabric은 LIMIT를 지원하지 않으므로 TOP과 같은 동등한 구문을 사용하세요.

관련 페이지

• 필수 열과 페이로드 형식은 테이블 설정을 참조하세요.
• 동기화 일정 설정과 데이터 포인트 효율성은 모범 사례를 참조하세요.
• 동기화 실행 모니터링은 동기화 로그 및 관측 가능성을 참조하세요.
• 모든 소스에 공통된 질문은 FAQ를 참조하세요.