Data Landing Zone
Data Landing Zone は Azure Blob Adobe Experience Platformによってプロビジョニングされたストレージインターフェイス。安全なクラウドベースのファイルストレージ機能にアクセスして、ファイルを 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 では、にアップロードされるすべてのファイルで厳密に 7 日間の有効期限が適用されます Data Landing Zone コンテナ。 すべてのファイルは 7 日後に削除されます。
ファイルとディレクトリの命名制約
クラウドストレージファイルまたはディレクトリに名前を付ける際に考慮する必要がある制約のリストを次に示します。
- ディレクトリ名とファイルコンポーネント名は 255 文字を超えてはなりません。
- ディレクトリ名とファイル名の末尾にスラッシュ(
/
)は使用できません。使用した場合、自動的に削除されます。 - 次の予約 URL 文字は、適切にエスケープする必要があります。
! ' ( ) ; @ & = + $ , % # [ ]
- 次の文字は使用できません。
" \ / : | < > * ?
- 無効な URL パス文字は使用できません。
\uE000
のようなコードポイントは、NTFS ファイル名では有効ですが、有効な Unicode 文字ではありません。また、制御文字などの ASCII 文字や Unicode 文字もあります0x00
対象:0x1F
,\u0081
、など)も許可されません。 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 で、左側のナビゲーションの「接続」アイコンを選択します。 リソースを選択 ウィンドウが開き、接続するオプションが表示されます。を選択 Blob container 接続先 Data Landing Zone.
次に、接続方法として「共有アクセス署名 URL (SAS)」を選択し、「次へ」をクリックします。
接続方法を選択した後、次にを指定する必要があります 表示名 および Blobコンテナ SAS URL これはに対応します Data Landing Zone コンテナ。
を指定 Data Landing Zone SAS URL を指定し、を選択します。 次
概要 ウィンドウが開き、Blob エンドポイントと権限を含む設定の概要が表示されます。準備ができたら、「接続」を選択します。
接続が成功すると、Azure Storage Explorer UI と Data Landing Zone コンテナが更新されます。
と Data Landing Zone に接続されたコンテナ Azure Storage Explorerこれで、へのファイルのアップロードを開始できます Data Landing Zone コンテナ。 アップロードするには、を選択します Upload を選択してから、 ファイルのアップロード.
アップロードするファイルを選択したら、 Blob 名前を付けてアップロードするものと、目的の宛先ディレクトリを入力します。 終了したら、 Upload.
へのファイルのアップロード Data Landing Zone コマンドラインインターフェイスの使用
また、デバイスのコマンドラインインターフェイスを使用して、にアップロードファイルにアクセスすることもできます Data Landing Zone.
Bash を使用したファイルのアップロード
次の例では、Bash と cURL を使用してにファイルをアップロードします Data Landing Zone (を使用) Azure Blob Storage REST API:
# 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:
copy
コマンド。他のコマンドやオプションを使用して、 Data Landing Zone、使用 AzCopy. これを表示 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
以下のドキュメントでは、 Data Landing Zone api またはユーザーインターフェイスを使用したAdobe Experience Platformへのコンテナ。