Data Landing Zone

Última atualização em 2023-06-08
  • Tópicos
  • Sources
    Exibir mais informações sobre este tópico
  • Criado para:
  • Developer
    User
    Admin
    Leader
IMPORTANTE

Esta página é específica do Data Landing Zone origem conector no Experience Platform. Para obter informações sobre como se conectar ao Data Landing Zone destino conector, consulte a Data Landing Zone página da documentação de destino.

Data Landing Zone é um Azure Blob interface de armazenamento de dados 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 containers é limitado ao total de dados fornecido com sua licença de Produtos e Serviços da Platform. Todos os clientes da Platform e seus serviços de aplicativos, como Customer Journey Analytics, Journey Orchestration, Intelligent Services, e Adobe Real-Time Customer Data Platform são provisionados com um Data Landing Zone contêiner por sandbox. Você pode ler e gravar arquivos no seu contêiner por meio de Azure Storage Explorer ou na interface de linha de comando.

Data Landing Zone oferece suporte à 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 seus Data Landing Zone contêiner por meio de uma conexão pública com a internet. Não são necessárias alterações na rede para que você acesse seu Data Landing Zone contêiner, 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 Platform impõe um tempo de expiração de sete dias rigoroso em todos os arquivos carregados em um Data Landing Zone recipiente. Todos os arquivos 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.

  • Os nomes dos componentes de diretório e arquivo não podem exceder 255 caracteres.
  • 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 ter escape adequado: ! ' ( ) ; @ & = + $ , % # [ ]
  • 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 sejam válidos 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 permitidos. Para obter as regras que regem strings Unicode em 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, COM9, PRN, AUX, NUL, CON, CLOCK$, caractere de ponto (.) e dois caracteres de ponto (…).

Gerenciar o conteúdo da Data Landing Zone

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

No Azure Storage Explorer Selecione o ícone de conexão no menu de navegação esquerdo. A variável Selecionar recurso é 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, em seguida, selecione Próxima.

select-connection-method

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

DICA

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

Forneça o seu Data Landing Zone SAS URL e selecione Próxima

enter-connection-info

A variável Resumo é exibida, fornecendo uma visão geral de suas configurações, incluindo informações sobre Blob endpoint e permissões. Quando estiver pronto, selecione Conectar.

resumo

Uma conexão bem-sucedida atualiza seu Azure Storage Explorer Interface com o seu Data Landing Zone recipiente.

dlz-user-container

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

upload

Depois de selecionar o arquivo que deseja fazer upload, você deve identificar o Blob digite como você deseja carregá-lo e o diretório de destino desejado. Quando terminar, selecione Carregar.

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

upload de arquivos

Fazer upload de arquivos para o Data Landing Zone usando a interface de linha de comando

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

Carregar 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 API REST:

# 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 Microsoft’s Python v12 SDK para carregar um arquivo em um Data Landing Zone:

DICA

Enquanto o exemplo abaixo usa o URI SAS completo para se conectar a um Azure Blob contêiner, é possível usar outros métodos e operações para autenticação. Veja isto Microsoft documento no 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)

Carregar um arquivo usando AzCopy

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

DICA

Embora o exemplo abaixo esteja usando a variável copy você pode usar outros comandos e opções para fazer upload de um arquivo no seu Data Landing Zone, utilizando AzCopy. Veja isto 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

Conectar Data Landing Zone para Platform

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

Uso de APIs

Uso da interface

IMPORTANTE

No momento, os links privados não são compatíveis ao conectar-se ao Experience Platform usando o Data Landing Zone. Os únicos métodos compatíveis de acesso são os métodos listados aqui.

Nesta página