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 da Platform e seus aplicativos, como Customer Journey Analytics, Journey Orchestration, Intelligent Services e Adobe Real-Time Customer Data 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 Platform impõe um tempo de expiração estrito de sete dias em todos os arquivos carregados em um contêiner Data Landing Zone. 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 um 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 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 (como0x00
a0x1F
,\u0081
e assim por diante), também não são permitidos. Para regras que regem cadeias de caracteres 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 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:
copy
, você pode usar outros comandos e opções para carregar um arquivo no Data Landing Zone, usando AzCopy. Consulte este 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 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.