Data Landing Zone

Data Landing Zone é um Azure Blob interface de armazenamento provisionada pela Adobe Experience Platform, permitindo que você acesse um recurso de armazenamento de arquivos seguro e baseado em nuvem para trazer arquivos para a plataforma. Você tem acesso a um Data Landing Zone por sandbox, e o volume total de dados em todos os contêineres está limitado aos dados totais fornecidos com sua licença de Produtos e Serviços da plataforma . Todos os clientes da Platform e seus serviços de aplicativos, como Customer Journey Analytics, Journey Orchestration, Intelligent Servicese Real-time Customer Data Platform são provisionados com um Data Landing Zone contêiner por sandbox. Você pode ler e gravar arquivos no contêiner por meio de Azure Storage Explorer ou sua interface de linha de comando.

Data Landing Zone O suporta autenticação baseada em SAS e seus dados estão protegidos com o padrão Azure Blob mecanismos de segurança de armazenamento em repouso e em trânsito. A autenticação baseada em SAS permite que você acesse com segurança sua Data Landing Zone por meio de uma conexão pública com a Internet. Não são necessárias alterações de rede para que você acesse seu Data Landing Zone , o que significa que não é necessário configurar nenhuma configuração lista de permissões ou entre regiões para sua rede. A Platform impõe um TTL (time-to-live) estrito de sete dias em todos os arquivos carregados em um Data Landing Zone contêiner. Todos os arquivos são excluídos após sete dias.

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

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

  • Os nomes de componentes de diretório e arquivo não podem exceder 255 caracteres.
  • Os nomes de diretório e arquivo não podem terminar com uma barra (/). Se fornecido, ele será removido automaticamente.
  • Os seguintes caracteres de URL reservados devem ser evitados corretamente: ! ' ( ) ; @ & = + $ , % # [ ]
  • Os seguintes caracteres não são permitidos: " \ / : | < > * ?.
  • Caracteres de caminho de URL inválidos não permitidos. Pontos de código como \uE000, embora válidas em nomes de arquivo NTFS, não são caracteres Unicode válidos. Além disso, alguns caracteres ASCII ou Unicode, como caracteres de controle (como 0x00 para 0x1F, \u0081e assim por diante), também não são permitidas. Para obter as regras que regem as cadeias de caracteres Unicode no HTTP/1.1, consulte RFC 2616, Seção 2.2: Regras básicas e RFC 3987.
  • Os seguintes nomes de arquivo não são permitidos: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, caractere de ponto (…) e dois caracteres de ponto (.).

Gerencie o conteúdo de seu Data Landing Zone

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

No Azure Storage Explorer Na interface do usuário, selecione o ícone de conexão na navegação à esquerda. O Selecionar recurso for exibida, fornecendo opções para conexão. Selecionar Blob container para se conectar a Data Landing Zone.

select-resource

Em seguida, selecione URL de assinatura de acesso compartilhado (SAS) como seu método de conexão e selecione Próximo.

select-connection-method

Depois de selecionar seu método de conexão, você deve fornecer uma nome de exibição e BlobURL SAS do contêiner que corresponde ao seu Data Landing Zone contêiner.

DICA

Você pode recuperar seu Data Landing Zone credenciais do catálogo de origens na interface do usuário da plataforma.

Forneça sua Data Landing Zone URL SAS e selecione Próximo

enter-connection-info

O Resumo for exibida, fornecendo uma visão geral de suas configurações, incluindo informações sobre Blob endpoint e permissões. Quando estiver pronto, selecione Connect.

resumo

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

dlz-user-container

Com seu Data Landing Zone contêiner conectado a Azure Storage Explorer, agora é possível iniciar o upload de arquivos no Data Landing Zone contêiner. Para fazer upload, selecione Upload e depois selecione Fazer upload de arquivos.

fazer upload

Após selecionar o arquivo que deseja fazer upload, é necessário identificar a variável Blob digite o que deseja fazer upload como e do diretório de destino desejado. Quando terminar, selecione Upload.

Blob tipos Descrição
Bloco Blob Bloco Blobs são otimizadas para carregar grandes quantidades de dados de maneira eficiente. Bloco Blobs são a opção padrão para Data Landing Zone.
Anexar Blob Anexar Blobs são otimizadas para anexar dados ao final do arquivo.

upload de arquivos

Carregue arquivos no Data Landing Zone usando a interface da linha de comando

Você também pode usar a interface da linha de comando do seu dispositivo e acessar arquivos de upload para o seu Data Landing Zone.

Fazer upload de um arquivo usando o Bash

O exemplo a seguir usa Bash e cURL para fazer upload de um arquivo para um Data Landing Zone com o 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}"

Fazer upload de um arquivo usando Python

O exemplo a seguir usa Microsoft’s Python v12 SDK para fazer upload de um arquivo para um Data Landing Zone:

DICA

Enquanto o exemplo abaixo usa o URI SAS completo para se conectar a um Azure Blob , você pode usar outros métodos e operações para autenticar. Veja isso Microsoft documento sobre o Python v12 SDK para obter mais informações.

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)

Fazer upload de um arquivo usando AzCopy

O exemplo a seguir usa Microsoft’s AzCopy para carregar um arquivo em um Data Landing Zone:

DICA

Enquanto o exemplo abaixo está usando a variável copy , você pode usar outros comandos e opções para fazer upload de um arquivo para seu Data Landing Zone, usando AzCopy. Veja isso Microsoft AzCopy documento para obter mais informações.

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

Connect Data Landing Zone para Platform

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

Uso de APIs

Uso da interface do usuário

Nesta página