Data Landing Zone

IMPORTANT
このページは、Experience Platformの Data Landing Zone ソース コネクタに固有のページです。 Data Landing Zone 宛先 コネクタへの接続について詳しくは、Data Landing Zone 宛先ドキュメントページを参照してください。

Data Landing Zone は、Adobe Experience Platformによってプロビジョニングされた Azure Blob ストレージインターフェイスであり、ファイルを Platform に取り込むための安全なクラウドベースのファイルストレージ機能にアクセスできます。 サンドボックスごとに 1 つの Data Landing Zone コンテナに対するアクセス権があります。すべてのコンテナの合計データ量は、Platform 製品およびサービスライセンスで提供される合計データ量に制限されます。Platform とそのアプリケーション(Customer Journey Analytics、Journey Orchestration、Intelligent Services、Adobe Real-Time Customer Data Platform など)のすべての顧客は、サンドボックスごとに 1 つの Data Landing Zone コンテナを使用してプロビジョニングされます。 Azure Storage Explorer またはコマンドラインインターフェイスを通じて、コンテナに対してファイルの読み取りと書き込みを行うことができます。

Data Landing Zone は SAS ベースの認証をサポートし、そのデータは保存時および転送中は標準 Azure Blob ストレージセキュリティメカニズムで保護されます。SAS ベースの認証を使用すると、パブリックインターネット接続を介して Data Landing Zone コンテナに安全にアクセスできます。ユーザーが Data Landing Zone コンテナにアクセスする場合、ネットワークの変更は必要ありません。つまり、ネットワークの許可リストや地域間設定は必要ありません。 Platform では、Data Landing Zone コンテナにアップロードされるすべてのファイルに対して厳密に 7 日間の有効期限が適用されます。 すべてのファイルは 7 日後に削除されます。

ファイルとディレクトリの命名制約

クラウドストレージファイルまたはディレクトリに名前を付ける際に考慮する必要がある制約のリストを次に示します。

  • ディレクトリ名とファイルコンポーネント名は 255 文字を超えてはなりません。
  • ディレクトリ名とファイル名の末尾にスラッシュ(/)は使用できません。使用した場合、自動的に削除されます。
  • 次の予約 URL 文字は、適切にエスケープする必要があります。! ' ( ) ; @ & = + $ , % # [ ]
  • 次の文字は使用できません。" \ / : | < > * ?
  • 無効な URL パス文字は使用できません。\uE000 のようなコードポイントは、NTFS ファイル名では有効ですが、有効な Unicode 文字ではありません。さらに、制御文字(0x00 から 0x1F\u0081 など)など、一部の ASCII 文字または Unicode 文字も許可されていません。 HTTP/1.1 で Unicode 文字列を規定するルールについては、RFC 2616、セクション 2.2:基本ルールおよび RFC 3987 を参照してください。
  • 次のファイル名は使用できません:LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、PRN、AUX、NUL、CON、CLOCK$、ドット文字(.)、2 つのドット文字(…)。

データランディングゾーンのコンテンツを管理 manage-the-contents-of-your-data-landing-zone

Azure Storage Explorer を使用して Data Landing Zone コンテナのコンテンツを管理することができます。

Azure Storage Explorer UI で、左側のナビゲーションにある「接続」アイコンを選択します。 リソースを選択 ​ウィンドウが開き、接続するオプションが表示されます。Data Landing Zone に接続する Blob container を選択してください。

select-resource

次に、接続方法として「共有アクセス署名 URL (SAS)」を選択し、「次へ」をクリックします。

select-connection-method

接続方法を選択した後、次に、Data Landing Zone コンテナに対応する 表示名 および Blobコンテナ SAS URL を指定する必要があります。

TIP
Data Landing Zone の資格情報は、Platform UI のソースカタログから取得できます。

Data Landing Zone SAS URL を入力し、「次へ を選択します

enter-connection-info

概要 ​ウィンドウが開き、Blob エンドポイントと権限を含む設定の概要が表示されます。準備ができたら、「接続」を選択します。

概要

接続が成功すると、Azure Storage Explorer UI と Data Landing Zone コンテナが更新されます。

dlz-user-container

Data Landing Zone コンテナが Azure Storage Explorer に接続され、Data Landing Zone コンテナへのファイルのアップロードを開始できるようになりました。 アップロードするには、「アップロード」を選択し、「ファイルをアップロード」を選択します。

アップロード

アップロードするファイルを選択したら、そのファイルをアップロードする Blob タイプと目的の宛先ディレクトリを特定する必要があります。 終了したら「アップロード」を選択します。

Blob タイプ
説明
ブロック Blob
ブロック Blobs は、大量のデータを効率的にアップロードするために最適化されています。 ブロック Blobs は、Data Landing Zone の既定のオプションです。
Append Blob
追加 Blobs は、ファイルの最後にデータを追加する場合に最適化されています。

upload-files

コマンドラインインターフェイスを使用した 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’sPython v12 SDK を使用して、ファイルを Data Landing Zone にアップロードします。

TIP
次の例では、完全な SAS URI を使用して Azure Blob コンテナに接続しますが、他の方法や操作を使用して認証することもできます。 詳しくは、この Microsoft Python v12 SDK に関するドキュメントを参照してください。
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 を使用したファイルのアップロード

次の例では、AzCopy ユーティリティ Microsoft’s 使用してファイルを Data Landing Zone にアップロードします。

TIP
以下の例では copy コマンドを使用していますが、他のコマンドおよびオプションを使用して、AzCopy を使用して Data Landing Zone にファイルをアップロードできます。 詳しくは、この Microsoft AzCopy ドキュメントを参照してください。
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 の使用

IMPORTANT
Data Landing Zone を使用してExperience Platformに接続する場合、プライベートリンクは現在サポートされていません。 アクセスでサポートされているメソッドは、 こちらに示すメソッドのみです。
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089