Data Landing Zone

Data Landing Zone은(는) Adobe Experience Platform에서 프로비저닝한 Azure Blob 저장소 인터페이스로서, 파일을 플랫폼으로 가져올 수 있는 안전한 클라우드 기반 파일 저장소 기능에 액세스할 수 있도록 허용합니다. 샌드박스당 하나의 Data Landing Zone 컨테이너에 액세스할 수 있으며 모든 컨테이너의 총 데이터 볼륨은 Platform 제품 및 서비스 라이선스와 함께 제공되는 총 데이터로 제한됩니다. Experience Platform의 모든 고객은 샌드박스당 하나의 Data Landing Zone 컨테이너로 프로비저닝됩니다. Azure Storage Explorer 또는 명령줄 인터페이스를 통해 컨테이너에 파일을 읽고 쓸 수 있습니다.

Data Landing Zone은(는) SAS 기반 인증을 지원하며, 전송 중이거나 사용하지 않는 표준 Azure Blob 저장소 보안 메커니즘을 통해 데이터를 보호합니다. SAS 기반 인증을 사용하면 공용 인터넷 연결을 통해 Data Landing Zone 컨테이너에 안전하게 액세스할 수 있습니다. Data Landing Zone 컨테이너에 액세스하는 데 필요한 네트워크 변경 내용이 없습니다. 따라서 네트워크에 대한 허용 목록 또는 교차 지역 설정을 구성할 필요가 없습니다. Experience Platform은 Data Landing Zone 컨테이너에 업로드된 모든 파일 및 폴더에 엄격한 7일 만료 시간을 적용합니다. 모든 파일과 폴더는 7일 후에 삭제됩니다.

파일 및 디렉터리에 대한 이름 지정 제약 조건

다음은 클라우드 저장소 파일 또는 디렉터리의 이름을 지정할 때 고려해야 하는 제약 조건 목록입니다.

데이터 랜딩 영역의 콘텐츠 관리 manage-the-contents-of-your-data-landing-zone

Azure Storage Explorer을(를) 사용하여 Data Landing Zone 컨테이너의 콘텐츠를 관리할 수 있습니다.

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

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

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

Data Landing Zone SAS URL을 입력한 다음 다음 ​을(를) 선택하십시오.

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

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

Data Landing Zone 컨테이너가 Azure Storage Explorer에 연결되어 있으므로 이제 Data Landing Zone 컨테이너에 파일을 업로드할 수 있습니다. 업로드하려면 업로드 ​를 선택한 다음 파일 업로드 ​를 선택하십시오.

업로드할 파일을 선택했으면 업로드할 Blob 유형과 원하는 대상 디렉터리를 확인해야 합니다. 완료되면 업로드 ​를 선택합니다.

명령줄 인터페이스를 사용하여 Data Landing Zone에 파일 업로드

장치의 명령줄 인터페이스를 사용하여 Data Landing Zone에 대한 업로드 파일에 액세스할 수도 있습니다.

Bash를 사용하여 파일 업로드

다음 예제에서는 Bash 및 cURL을 사용하여 Azure Blob Storage REST API를 사용하여 Data Landing Zone에 파일을 업로드합니다.

# Set Azure Blob-related settings
DATE_NOW=$(date -Ru | sed 's/\+0000/GMT/')
AZ_VERSION="2018-03-28"
AZ_BLOB_URL="<URL TO BLOB ACCOUNT>"
AZ_BLOB_CONTAINER="<BLOB CONTAINER NAME>"
AZ_BLOB_TARGET="${AZ_BLOB_URL}/${AZ_BLOB_CONTAINER}"
AZ_SAS_TOKEN="<SAS TOKEN, STARTING WITH ? AND ENDING WITH %3D>"

# Path to the file we wish to upload
FILE_PATH="</PATH/TO/FILE>"
FILE_NAME=$(basename "$FILE_PATH")

# Execute HTTP PUT to upload file (remove '-v' flag to suppress verbose output)
curl -v -X PUT \
   -H "Content-Type: application/octet-stream" \
   -H "x-ms-date: ${DATE_NOW}" \
   -H "x-ms-version: ${AZ_VERSION}" \
   -H "x-ms-blob-type: BlockBlob" \
   --data-binary "@${FILE_PATH}" "${AZ_BLOB_TARGET}/${FILE_NAME}${AZ_SAS_TOKEN}"

Python을 사용하여 파일 업로드

다음 예제에서는 Microsoft’s Python v12 SDK를 사용하여 파일을 Data Landing Zone에 업로드합니다.

import os
from azure.storage.blob import ContainerClient

try:
    # Set Azure Blob-related settings
    sasUri = "<SAS URI>"
    srcFilePath = "<FULL PATH TO FILE>"
    srcFileName = os.path.basename(srcFilePath)

    # Connect to container using SAS URI
    containerClient = ContainerClient.from_container_url(sasUri)

    # Upload file to Data Landing Zone with overwrite enabled
    with open(srcFilePath, "rb") as fileToUpload:
        containerClient.upload_blob(srcFileName, fileToUpload, overwrite=True)

except Exception as ex:
    print("Exception: " + ex.strerror)

AzCopy을(를) 사용하여 파일 업로드

다음 예제에서는 Microsoft’s AzCopy 유틸리티를 사용하여 파일을 Data Landing Zone에 업로드합니다.

set sasUri=<FULL SAS URI, PROPERLY ESCAPED>
set srcFilePath=<PATH TO LOCAL FILE(S); WORKS WITH WILDCARD PATTERNS>

azcopy copy "%srcFilePath%" "%sasUri%" --overwrite=true --recursive=true

Data Landing Zone을(를) Platform에 연결

아래 설명서는 API 또는 사용자 인터페이스를 사용하여 Data Landing Zone 컨테이너에서 Adobe Experience Platform으로 데이터를 가져오는 방법에 대한 정보를 제공합니다.

API 사용

UI 사용