기본 연결 만들기
기본 연결은 소스의 인증 자격 증명, 연결의 현재 상태 및 고유한 기본 연결 ID를 포함하여 소스와 Experience Platform 간에 정보를 유지합니다. 기본 연결 ID를 사용하면 소스 내에서 파일을 탐색 및 탐색하고 데이터 유형 및 형식에 대한 정보를 포함하여 수집할 특정 항목을 식별할 수 있습니다.
기본 연결 ID를 만들려면 Azure Data Explorer 인증 자격 증명을 요청 매개 변수의 일부로 제공하는 동안 /connections 끝점에 대한 POST 요청을 만듭니다.
API 형식
POST /connections
요청
다음 요청은 Azure Data Explorer에 대한 기본 연결을 만듭니다.
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Azure Azure Data Explorer connection",
"description": "A connection for Azure Azure Data Explorer",
"auth": {
"specName": "Service Principal Based Authentication",
"params": {
"endpoint": "{ENDPOINT}",
"database": "{DATABASE}",
"tenant": "{TENANT}",
"servicePrincipalId": "{SERVICE_PRINCIPAL_ID}",
"servicePrincipalKey": "{SERVICE_PRINCIPAL_KEY}"
}
},
"connectionSpec": {
"id": "0479cc14-7651-4354-b233-7480606c2ac3",
"version": "1.0"
}
}'
| 매개변수 | 설명 |
|---|---|
auth.params.endpoint | Azure Data Explorer 서버의 끝점입니다. |
auth.params.database | Azure Data Explorer 데이터베이스의 이름입니다. |
auth.params.tenant | Azure Data Explorer 데이터베이스에 연결하는 데 사용되는 고유한 테넌트 ID입니다. |
auth.params.servicePrincipalId | Azure Data Explorer 데이터베이스에 연결하는 데 사용되는 고유한 서비스 사용자 ID입니다. |
auth.params.servicePrincipalKey | Azure Data Explorer 데이터베이스에 연결하는 데 사용되는 고유한 서비스 사용자 키. |
connectionSpec.id | Azure Data Explorer 연결 사양 ID: 0479cc14-7651-4354-b233-7480606c2ac3. |
응답
응답이 성공하면 고유 식별자(id)를 포함하여 새로 만든 연결의 세부 정보가 반환됩니다. 이 ID는 다음 자습서에서 데이터를 탐색하는 데 필요합니다.
{
"id": "f088e4f2-2464-480c-88e4-f22464b80c90",
"etag": "\"43011faa-0000-0200-0000-5ea740cd0000\""
}