Data Landing Zone

O Data Landing Zone é uma interface de armazenamento do Azure Blob provisionada pela Adobe Experience Platform, que concede a você acesso a um recurso de armazenamento de arquivos seguro e baseado em nuvem para trazer arquivos para a Platform. Você tem acesso a um contêiner Data Landing Zone por sandbox, e o volume total de dados em todos os contêineres é limitado ao total de dados fornecidos com sua licença de Produtos e Serviços da Plataforma. Todos os clientes do Experience Platform são provisionados com um contêiner Data Landing Zone por sandbox. Você pode ler e gravar arquivos no seu contêiner por meio do Azure Storage Explorer ou da interface de linha de comando.

O Data Landing Zone oferece suporte à autenticação baseada em SAS e seus dados estão protegidos com mecanismos de segurança de armazenamento Azure Blob padrão em repouso e em trânsito. A autenticação baseada em SAS permite que você acesse com segurança o contêiner do Data Landing Zone por meio de uma conexão pública com a Internet. Não há alterações de rede necessárias para você acessar o contêiner Data Landing Zone, o que significa que você não precisa definir nenhuma configuração de lista de permissões ou entre regiões para sua rede. O Experience Platform impõe um tempo de expiração estrito de sete dias em todos os arquivos e pastas carregados em um contêiner Data Landing Zone. Todos os arquivos e pastas são excluídos após sete dias.

Restrições de nomenclatura para arquivos e diretórios

Veja a seguir uma lista de restrições que você deve considerar ao nomear seus arquivos ou diretórios de armazenamento em nuvem.

Gerenciar o conteúdo da Data Landing Zone manage-the-contents-of-your-data-landing-zone

Você pode usar o Azure Storage Explorer para gerenciar o conteúdo do seu contêiner Data Landing Zone.

Na interface do usuário do Azure Storage Explorer, selecione o ícone de conexão no menu de navegação esquerdo. A janela Selecionar Recurso é exibida, fornecendo opções para conexão. Selecione Blob container para se conectar a Data Landing Zone.

Em seguida, selecione SAS (URL de assinatura de acesso compartilhado) como seu método de conexão e selecione Avançar.

Depois de selecionar seu método de conexão, você deve fornecer um nome para exibição e a URL SAS do contêiner Blob que corresponda ao seu contêiner Data Landing Zone.

Forneça a URL SAS do Data Landing Zone e selecione Avançar

A janela Resumo é exibida, fornecendo uma visão geral das configurações, incluindo informações sobre o ponto de extremidade e as permissões do Blob. Quando estiver pronto, selecione Conectar.

Uma conexão bem-sucedida atualiza a interface do usuário Azure Storage Explorer com o contêiner Data Landing Zone.

Com o contêiner Data Landing Zone conectado ao Azure Storage Explorer, você pode começar a carregar arquivos no contêiner Data Landing Zone. Para carregar, selecione Carregar e Carregar Arquivos.

Depois de selecionar o arquivo que deseja carregar, você deve identificar o tipo Blob com o qual deseja carregá-lo e o diretório de destino desejado. Quando terminar, selecione Carregar.

Carregar arquivos no Data Landing Zone usando a interface de linha de comando

Você também pode usar a interface de linha de comando do seu dispositivo e acessar arquivos de carregamento no Data Landing Zone.

Carregar um arquivo usando o Bash

O exemplo a seguir usa Bash e cURL para carregar um arquivo para um Data Landing Zone com a API REST Azure Blob Storage:

# 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}"

Carregar um arquivo usando o Python

O exemplo a seguir usa o SDK do Python v12 Microsoft’s para carregar um arquivo em um 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)

Carregar um arquivo usando AzCopy

O exemplo a seguir usa o utilitário Microsoft’s AzCopy para carregar um arquivo para um 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

Conectar Data Landing Zone a Platform

A documentação abaixo fornece informações sobre como trazer dados do seu contêiner do Data Landing Zone para a Adobe Experience Platform usando APIs ou a interface do usuário.

Uso de APIs

Uso da interface