데이터 랜딩 영역 대상

개요 overview

Data Landing Zone은 Adobe Experience Platform에 의해 프로비저닝된 Azure Blob 스토리지 인터페이스로, 이를 통해 안전한 클라우드 기반 파일 스토리지 시설에 액세스하여 Platform에서 파일을 내보낼 수 있습니다. 샌드박스당 하나의 Data Landing Zone 컨테이너에 액세스할 수 있으며 모든 컨테이너의 총 데이터 볼륨은 Platform 제품 및 서비스 라이선스와 함께 제공되는 총 데이터로 제한됩니다. Customer Journey Analytics, Journey Orchestration, Intelligent Services 및 Real-Time Customer Data Platform과(와) 같은 플랫폼과 해당 애플리케이션의 모든 고객에게 샌드박스당 하나의 Data Landing Zone 컨테이너가 제공됩니다. Azure Storage Explorer 또는 명령줄 인터페이스를 통해 컨테이너에 파일을 읽고 쓸 수 있습니다.

Data Landing Zone은(는) SAS 기반 인증을 지원하며, 전송 중이거나 사용하지 않는 표준 Azure Blob 저장소 보안 메커니즘을 통해 데이터를 보호합니다. SAS는 공유 액세스 서명을 의미합니다.

SAS 기반 인증을 사용하면 공용 인터넷 연결을 통해 Data Landing Zone 컨테이너에 안전하게 액세스할 수 있습니다. Data Landing Zone 컨테이너에 액세스하는 데 필요한 네트워크 변경 내용이 없습니다. 따라서 네트워크에 대한 허용 목록 또는 교차 지역 설정을 구성할 필요가 없습니다.

플랫폼은 Data Landing Zone 컨테이너에 업로드된 모든 파일에 엄격한 7일 TTL(time-to-live)을 적용합니다. 모든 파일은 7일 후에 삭제됩니다.

API 또는 UI를 통해 데이터 랜딩 영역 저장소에 연결합니다. connect-api-or-ui

지원되는 대상자 supported-audiences

이 섹션에서는 이 대상으로 내보낼 수 있는 대상자 유형을 설명합니다.

내보내기 유형 및 빈도 export-type-frequency

대상 내보내기 유형 및 빈도에 대한 자세한 내용은 아래 표를 참조하십시오.

데이터 세트 내보내기 export-datasets

이 대상은 데이터 세트 내보내기를 지원합니다. 데이터 세트 내보내기 설정 방법에 대한 자세한 내용은 튜토리얼을 참조하십시오.

내보낸 데이터의 파일 형식 file-format

대상 데이터 ​를 내보낼 때 Platform은 사용자가 제공한 저장소 위치에 .csv, parquet 또는 .json 파일을 만듭니다. 파일에 대한 자세한 내용은 대상 활성화 자습서에서 내보내기에 지원되는 파일 형식 섹션을 참조하십시오.

데이터 세트 ​를 내보낼 때 Platform은 사용자가 제공한 저장소 위치에 .parquet 또는 .json 파일을 만듭니다. 파일에 대한 자세한 내용은 데이터 세트 내보내기 자습서에서 데이터 세트 내보내기에 성공했는지 확인 섹션을 참조하십시오.

전제 조건 prerequisites

Data Landing Zone 대상을 사용하려면 먼저 다음 필수 구성 요소를 충족해야 합니다.

Data Landing Zone 컨테이너를 Azure Storage Explorer에 연결

Azure Storage Explorer을(를) 사용하여 Data Landing Zone 컨테이너의 콘텐츠를 관리할 수 있습니다. Data Landing Zone을(를) 사용하려면 먼저 자격 증명을 검색하고 Azure Storage Explorer에 입력한 다음 Data Landing Zone 컨테이너를 Azure Storage Explorer에 연결해야 합니다.

Azure Storage Explorer UI의 왼쪽 탐색 막대에서 연결 아이콘을 선택합니다. 연결할 수 있는 옵션을 제공하는 리소스 선택 창이 나타납니다. Data Landing Zone 저장소에 연결하려면 Blob container ​을(를) 선택하십시오.

다음으로 연결 방법으로 SAS(공유 액세스 서명 URL) ​을(를) 선택한 후 다음 ​을(를) 선택합니다.

연결 방법을 선택한 후 Data Landing Zone 컨테이너에 해당하는 표시 이름 및 Blob컨테이너 SAS URL ​을(를) 제공해야 합니다.

Data Landing Zone에 대한 자격 증명을 검색합니다. retrieve-dlz-credentials

Data Landing Zone 자격 증명을 검색하려면 플랫폼 API를 사용해야 합니다. 자격 증명을 검색하기 위한 API 호출에 대해서는 아래에 설명되어 있습니다. 헤더에 필요한 값을 가져오는 방법에 대한 자세한 내용은 Adobe Experience Platform API 시작하기 안내서를 참조하십시오.

API 형식

GET /data/foundation/connectors/landingzone/credentials?type=dlz_destination

요청

다음 요청 예제는 기존 랜딩 영역에 대한 자격 증명을 검색합니다.

curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination' \
  -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' \

응답

다음 응답은 랜딩 영역의 자격 증명 정보를 반환합니다. 여기에는 현재 SASToken 및 SASUri과(와) 랜딩 영역 컨테이너에 해당하는 storageAccountName이(가) 포함됩니다.

{
    "containerName": "dlz-destination",
    "SASToken": "sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D",
    "storageAccountName": "dlblobstore99hh25i3df123",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-destination?sv=2022-09-11&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D"
}

Data Landing Zone 자격 증명 업데이트 update-dlz-credentials

원할 경우 자격 증명을 새로 고칠 수도 있습니다. Connectors API의 /credentials 끝점에 POST 요청을 하여 SASToken을(를) 업데이트할 수 있습니다.

API 형식

POST /data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh

요청

다음 요청은 랜딩 영역 자격 증명을 업데이트합니다.

curl -X POST \
  'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=dlz_destination&action=refresh' \
  -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' \

응답

다음 응답은 SASToken 및 SASUri에 대해 업데이트된 값을 반환합니다.

{
    "containerName": "dlz-destination",
    "SASToken": "sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D",
    "storageAccountName": "dlblobstore99hh25i3dflek",
    "SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-destination?sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D"
}

위에서 설명한 API 호출에서 반환된 대로 표시 이름(containerName)과 Data Landing Zone SAS URL을 입력한 다음 다음 ​을 선택합니다.

Blob 끝점 및 사용 권한에 대한 정보를 포함하여 설정에 대한 개요를 제공하는 요약 창이 나타납니다. 준비가 되면 연결 ​을 선택합니다.

연결에 성공하면 Azure Storage Explorer UI가 Data Landing Zone 컨테이너로 업데이트됩니다.

Data Landing Zone 컨테이너를 Azure Storage Explorer에 연결하면 이제 Experience Platform에서 Data Landing Zone 컨테이너로 파일을 내보낼 수 있습니다. 파일을 내보내려면 아래 섹션에 설명된 대로 Experience Platform UI에서 Data Landing Zone 대상에 대한 연결을 설정해야 합니다.

대상에 연결 connect

이 대상에 연결하려면 대상 구성 자습서에 설명된 단계를 따르십시오. 대상 구성 워크플로에서 아래 두 섹션에 나열된 필드를 채웁니다.

대상으로 인증 authenticate

필수 구성 요소 섹션에 설명된 대로 Data Landing Zone 컨테이너를 Azure Storage Explorer에 연결했는지 확인하십시오. Data Landing Zone은(는) Adobe이 프로비전된 저장소이므로 Experience Platform UI에서 대상을 인증하기 위해 더 이상 단계를 수행할 필요가 없습니다.

대상 세부 정보 입력 destination-details

대상에 대한 세부 정보를 구성하려면 아래의 필수 및 선택 필드를 채우십시오. UI에서 필드 옆에 있는 별표는 필드가 필수임을 나타냅니다.

경고 활성화 enable-alerts

경고를 활성화하여 대상에 대한 데이터 흐름 상태에 대한 알림을 받을 수 있습니다. 목록에서 경고를 선택하여 데이터 흐름 상태에 대한 알림을 수신합니다. 경고에 대한 자세한 내용은 UI를 사용하여 대상 경고 구독에 대한 안내서를 참조하십시오.

대상 연결에 대한 세부 정보를 모두 제공했으면 다음 ​을 선택합니다.

이 대상으로 대상자 활성화 activate

이 대상에 대한 대상자 활성화에 대한 지침은 대상자 데이터를 일괄 프로필 내보내기 대상으로 활성화를 참조하십시오.

일정 조정

예약 단계에서 Data Landing Zone 대상에 대해 내보내기 일정을 설정할 수 있으며 내보낸 파일의 이름을 구성할 수도 있습니다.

속성 및 ID 매핑 map

매핑 단계에서는 프로필에 내보낼 특성 및 ID 필드를 선택할 수 있습니다. 내보낸 파일의 헤더를 원하는 이름으로 변경하도록 선택할 수도 있습니다. 자세한 내용은 일괄 처리 대상 활성화 UI 자습서에서 매핑 단계를 참조하십시오.

성공적인 데이터 내보내기 유효성 검사 exported-data

데이터를 성공적으로 내보냈는지 확인하려면 Data Landing Zone 저장소를 확인하고 내보낸 파일에 예상 프로필 모집단이 포함되어 있는지 확인하십시오.