[Ultimate]{class="badge positive"}
Flow Service API를 사용하여 Azure Event Hubs 소스 연결 만들기
Flow Service API을(를) 사용하여 Azure Event Hubs (이하 "Event Hubs")을(를) Experience Platform에 연결하는 방법을 알아보려면 이 자습서를 읽어 보십시오.
시작하기
이 안내서를 사용하려면 Adobe Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.
다음 섹션에서는 Flow Service API를 사용하여 Event Hubs을(를) 플랫폼에 성공적으로 연결하기 위해 알아야 할 추가 정보를 제공합니다.
필요한 자격 증명 수집
Flow Service이(가) Event Hubs 계정에 연결하려면 다음 연결 속성에 대한 값을 제공해야 합니다.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
---|---|
자격 증명 | 설명 |
sasKeyName |
SAS 키 이름이라고도 하는 인증 규칙의 이름입니다. |
sasKey |
Event Hubs 네임스페이스의 기본 키입니다. Event Hubs 목록을 채우려면 sasKey 에 해당하는 sasPolicy 에 manage 권한이 구성되어 있어야 합니다. |
namespace |
액세스 중인 Event Hub의 네임스페이스입니다. Event Hub 네임스페이스는 하나 이상의 Event Hubs을(를) 만들 수 있는 고유한 범위 컨테이너를 제공합니다. |
connectionSpec.id |
연결 사양은 기본 및 소스 연결 만들기와 관련된 인증 사양을 포함하여 소스의 커넥터 속성을 반환합니다. Event Hubs 연결 사양 ID: bf9f5905-92b7-48bf-bf20-455bc6b60a4e . |
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
---|---|
자격 증명 | 설명 |
sasKeyName |
SAS 키 이름이라고도 하는 인증 규칙의 이름입니다. |
sasKey |
Event Hubs 네임스페이스의 기본 키입니다. Event Hubs 목록을 채우려면 sasKey 에 해당하는 sasPolicy 에 manage 권한이 구성되어 있어야 합니다. |
namespace |
액세스 중인 Event Hub의 네임스페이스입니다. Event Hub 네임스페이스는 하나 이상의 Event Hubs을(를) 만들 수 있는 고유한 범위 컨테이너를 제공합니다. |
eventHubName |
Azure Event Hub 이름을 입력하십시오. Event Hub 이름에 대한 자세한 내용은 Microsoft 설명서를 참조하십시오. |
connectionSpec.id |
연결 사양은 기본 및 소스 연결 만들기와 관련된 인증 사양을 포함하여 소스의 커넥터 속성을 반환합니다. Event Hubs 연결 사양 ID: bf9f5905-92b7-48bf-bf20-455bc6b60a4e . |
Event Hubs의 SAS(공유 액세스 서명) 인증에 대한 자세한 내용은 Azure SAS 사용 가이드를 참조하십시오.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
---|---|
자격 증명 | 설명 |
tenantId |
권한을 요청하려는 테넌트 ID입니다. 테넌트 ID는 GUID 또는 친숙한 이름으로 포맷할 수 있습니다. 참고: 테넌트 ID는 Microsoft Azure 인터페이스에서 "디렉터리 ID"라고 합니다. |
clientId |
앱에 할당된 애플리케이션 ID입니다. Azure Active Directory을(를) 등록한 Microsoft Entra ID 포털에서 이 ID를 검색할 수 있습니다. |
clientSecretValue |
앱을 인증하기 위해 클라이언트 ID와 함께 사용되는 클라이언트 암호입니다. Azure Active Directory을(를) 등록한 Microsoft Entra ID 포털에서 클라이언트 암호를 검색할 수 있습니다. |
namespace |
액세스 중인 Event Hub의 네임스페이스입니다. Event Hub 네임스페이스는 하나 이상의 Event Hubs을(를) 만들 수 있는 고유한 범위 컨테이너를 제공합니다. |
Azure Active Directory에 대한 자세한 내용은 Microsoft Entra ID 사용에 대한 Azure 안내서를 참조하세요.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
---|---|
자격 증명 | 설명 |
tenantId |
권한을 요청하려는 테넌트 ID입니다. 테넌트 ID는 GUID 또는 친숙한 이름으로 포맷할 수 있습니다. 참고: 테넌트 ID는 Microsoft Azure 인터페이스에서 "디렉터리 ID"라고 합니다. |
clientId |
앱에 할당된 애플리케이션 ID입니다. Azure Active Directory을(를) 등록한 Microsoft Entra ID 포털에서 이 ID를 검색할 수 있습니다. |
clientSecretValue |
앱을 인증하기 위해 클라이언트 ID와 함께 사용되는 클라이언트 암호입니다. Azure Active Directory을(를) 등록한 Microsoft Entra ID 포털에서 클라이언트 암호를 검색할 수 있습니다. |
namespace |
액세스 중인 Event Hub의 네임스페이스입니다. Event Hub 네임스페이스는 하나 이상의 Event Hubs을(를) 만들 수 있는 고유한 범위 컨테이너를 제공합니다. |
eventHubName |
Azure Event Hub 이름을 입력하십시오. Event Hub 이름에 대한 자세한 내용은 Microsoft 설명서를 참조하십시오. |
이러한 값에 대한 자세한 내용은 이 이벤트 허브 문서를 참조하세요.
Platform API 사용
Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 Platform API 시작에 대한 안내서를 참조하십시오.
기본 연결 만들기
원본 연결을 만드는 첫 번째 단계는 Event Hubs 원본을 인증하고 기본 연결 ID를 생성하는 것입니다. 기본 연결 ID를 사용하면 소스 내에서 파일을 탐색 및 탐색하고 데이터 유형 및 형식에 대한 정보를 포함하여 수집할 특정 항목을 식별할 수 있습니다.
기본 연결 ID를 만들려면 Event Hubs 인증 자격 증명을 요청 매개 변수의 일부로 제공하는 동안 /connections
끝점에 POST 요청을 하십시오.
API 형식
POST /connections
표준 인증을 사용하여 계정을 만들려면 sasKeyName
, sasKey
및 namespace
에 대한 값을 제공하는 동안 /connections
끝점에 POST 요청을 합니다.
accordion | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | ||||||||||||||
|
accordion | ||
---|---|---|
응답 | ||
성공한 응답은 고유 식별자(
|
SAS 인증을 사용하여 계정을 만들려면 sasKeyName
, sasKey
, namespace
및 eventHubName
에 대한 값을 제공하는 동안 /connections
끝점에 POST 요청을 합니다.
accordion | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | ||||||||||||||||
|
accordion | ||
---|---|---|
응답 | ||
성공한 응답은 고유 식별자(
|
Azure Active Directory 인증을 사용하여 계정을 만들려면 tenantId
, clientId
, clientSecretValue
및 namespace
에 대한 값을 제공하는 동안 /connections
끝점에 POST 요청을 하세요.
accordion | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | ||||||||||||||||
|
accordion | ||
---|---|---|
응답 | ||
성공한 응답은 고유 식별자(
|
Azure Active Directory 인증을 사용하여 계정을 만들려면 tenantId
, clientId
, clientSecretValue
, namespace
및 eventHubName
에 대한 값을 제공하는 동안 /connections
끝점에 POST 요청을 만듭니다.
accordion | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | ||||||||||||||||||
|
accordion | ||
---|---|---|
응답 | ||
성공한 응답은 고유 식별자(
|
소스 연결 만들기
소스 연결은 데이터가 수집되는 외부 소스와의 연결을 만들고 관리합니다. 소스 연결은 데이터 소스, 데이터 형식 및 데이터 흐름을 만드는 데 필요한 소스 연결 ID와 같은 정보로 구성됩니다. 소스 연결 인스턴스는 테넌트 및 조직에만 해당됩니다.
소스 연결을 만들려면 Flow Service API의 /sourceConnections
끝점에 대한 POST 요청을 만듭니다.
API 형식
POST /sourceConnections
요청
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/sourceConnections' \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"name": "Azure Event Hubs source connection",
"description": "A source connection for Azure Event Hubs",
"baseConnectionId": "4cdbb15c-fb1e-46ee-8049-0f55b53378fe",
"connectionSpec": {
"id": "bf9f5905-92b7-48bf-bf20-455bc6b60a4e",
"version": "1.0"
},
"data": {
"format": "json"
},
"params": {
"eventHubName": "{EVENT_HUB_NAME}",
"dataType": "raw",
"reset": "latest",
"consumerGroup": "{CONSUMER_GROUP}"
}
}'
name
description
baseConnectionId
connectionSpec.id
bf9f5905-92b7-48bf-bf20-455bc6b60a4e
.data.format
json
뿐입니다.params.eventHubName
params.dataType
raw
및 xdm
입니다.params.reset
latest
을(를) 사용하여 가장 최근 데이터에서 읽기를 시작하고 earliest
을(를) 사용하여 스트림에서 사용 가능한 첫 번째 데이터에서 읽기를 시작합니다. 이 매개 변수는 선택 사항이며 지정하지 않은 경우 기본값은 earliest
입니다.params.consumerGroup
$Default
입니다. 자세한 내용은 이 Event Hubs 이벤트 소비자 가이드를 참조하세요. 참고: Event Hubs 소비자 그룹은 지정된 시간에 단일 흐름에만 사용할 수 있습니다.다음 단계
이 자습서에 따라 Flow Service API를 사용하여 Event Hubs 소스 연결을 만들었습니다. 다음 자습서에서 이 원본 연결 ID를 사용하여 API를 사용하여 스트리밍 데이터 흐름을 만들 Flow Service 수 있습니다.