Criar uma conexão de origem Azure Blob na interface
Este tutorial fornece etapas para a criação de uma conexão de origem Azure Blob (a seguir denominada "Blob") usando a interface do usuário da Platform.
Introdução
Este tutorial requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:
-
Experience Data Model (XDM) Sistema: a estrutura padronizada para organizar os dados de experiência do cliente no Experience Platform.
- Noções básicas sobre a composição de esquema: saiba mais sobre os blocos de construção básicos de esquemas XDM, incluindo princípios-chave e práticas recomendadas na composição de esquema.
- Tutorial do Editor de esquemas: saiba como criar esquemas personalizados usando a interface do Editor de esquemas.
-
Real-Time Customer Profile: Fornece um perfil de consumidor unificado em tempo real com base em dados agregados de várias fontes.
Se você já tiver uma conexão Blob válida, ignore o restante deste documento e prossiga para o tutorial em configurando um fluxo de dados.
Formatos de arquivo não suportados
O Experience Platform suporta os seguintes formatos de arquivo a serem assimilados de armazenamentos externos:
- Valores separados por delimitadores (DSV): você pode usar qualquer delimitador de coluna única, como tabulação, vírgula, barra vertical, ponto e vírgula ou hash, para coletar arquivos simples em qualquer formato.
- Notação de objeto do JavaScript (JSON): os arquivos de dados formatados em JSON devem ser compatíveis com XDM.
- Apache Parquet: os arquivos de dados formatados com Parquet devem ser compatíveis com XDM.
Coletar credenciais necessárias
Para acessar o armazenamento do Blob no Experience Platform, você deve fornecer valores válidos para as seguintes credenciais:
| table 0-row-2 1-row-2 | |
|---|---|
| Credencial | Descrição |
| String de conexão | Uma cadeia de caracteres que contém as informações de autorização necessárias para autenticar Blob em Experience Platform. O padrão da cadeia de conexão Blob é: DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}. Para obter mais informações sobre cadeias de conexão, consulte este documento Blob em configurando cadeias de conexão. |
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Credencial | Descrição |
| URI SAS | O URI de assinatura de acesso compartilhado que você pode usar como um tipo de autenticação alternativo para conectar sua conta do Blob. O padrão do URI SAS Blob é: https://{ACCOUNT_NAME}.blob.core.windows.net/?sv=<storage version>&st={START_TIME}&se={EXPIRE_TIME}&sr={RESOURCE}&sp={PERMISSIONS}>&sip=<{IP_RANGE}>&spr={PROTOCOL}&sig={SIGNATURE}> Para obter mais informações, consulte este Blob documento em URIs de assinatura de acesso compartilhado. |
| Contêiner | O nome do container ao qual você deseja designar acesso. Ao criar uma nova conta com a origem Blob, você pode fornecer um nome de contêiner para especificar o acesso do usuário à subpasta de sua escolha. |
| Caminho da pasta | O caminho para a pasta à qual você deseja fornecer acesso. |
Depois de obter as credenciais necessárias, você poderá seguir as etapas abaixo para conectar o armazenamento do Blob ao Experience Platform
Conectar sua conta do Blob
Na interface da Platform, selecione Fontes na barra de navegação esquerda para acessar o espaço de trabalho Fontes. A tela Catálogo exibe uma variedade de fontes com as quais você pode criar uma conta.
Você pode selecionar a categoria apropriada no catálogo no lado esquerdo da tela. Como alternativa, você pode encontrar a fonte específica com a qual deseja trabalhar usando a barra de pesquisa.
Na categoria Armazenamento na nuvem, selecione Armazenamento do Azure Blob e Adicionar dados.
A página Conectar-se ao Armazenamento Azure Blob é exibida. Nesta página, você pode usar credenciais novas ou existentes.
Conta existente
Para usar uma conta existente, selecione a conta Blob com a qual deseja criar um novo fluxo de dados e clique em Avançar para continuar.
Nova conta
Se você estiver criando uma nova conta, selecione Nova conta e forneça um nome e uma descrição opcional para sua nova conta Blob.
A origem Blob dá suporte à autenticação de chave de conta e à autenticação de assinatura de acesso compartilhado (SAS). Uma autenticação baseada em chave de conta requer uma cadeia de conexão para verificação, enquanto uma autenticação SAS usa um URI que permite autorização delegada segura de sua conta.
Durante essa etapa, também é possível designar as subpastas às quais sua conta terá acesso definindo o nome do container e o caminho para a subpasta.
Para autenticar com uma chave de conta, selecione Autenticação da chave de conta e forneça sua cadeia de conexão. Durante essa etapa, também é possível designar o nome e o caminho do container para a subpasta à qual você deseja acessar o. Quando terminar, selecione Conectar à origem.
Você pode usar SAS para criar credenciais de autenticação com vários graus de acesso, já que uma autenticação baseada em SAS permite definir permissões, datas de início e expiração, bem como provisões para recursos específicos.
Para autenticar com uma assinatura de acesso compartilhado, selecione Autenticação de assinatura de acesso compartilhado e forneça seu URI SAS. Durante essa etapa, também é possível designar o nome e o caminho do container para a subpasta à qual você deseja acessar o. Quando terminar, selecione Conectar à origem.
Próximas etapas
Seguindo este tutorial, você estabeleceu uma conexão com sua conta do Blob. Agora você pode seguir para o próximo tutorial e configurar um fluxo de dados para trazer dados do seu armazenamento em nuvem para a Platform.