Essa página é específica do Data Landing Zone source conector no Experience Platform. Para obter informações sobre como se conectar ao Data Landing Zone destino , consulte o Data Landing Zone página da documentação de destino.
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 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 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 tempo de expiração 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.
Esta é uma lista de restrições que você deve considerar ao nomear seus arquivos ou diretórios de armazenamento em nuvem.
/
). Se fornecido, ele será removido automaticamente.! ' ( ) ; @ & = + $ , % # [ ]
" \ / : | < > * ?
.\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
, \u0081
e 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.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.
Em seguida, selecione URL de assinatura de acesso compartilhado (SAS) como seu método de conexão e selecione Próximo.
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.
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
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.
Uma conexão bem-sucedida atualiza sua Azure Storage Explorer Interface do usuário com seu Data Landing Zone contêiner.
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.
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. |
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.
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}"
O exemplo a seguir usa Microsoft’s Python v12 SDK para fazer upload de um arquivo para um Data Landing Zone:
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)
O exemplo a seguir usa Microsoft’s AzCopy para carregar um arquivo em um Data Landing Zone:
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
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.