Conectar Jupyter Notebook ao Serviço de consulta

Última atualização: 4 de abril de 2025
  • Tópicos:

Criado para:

  • Usuário
  • Desenvolvedor

Este documento aborda as etapas necessárias para conectar o Jupyter Notebook ao Serviço de Consulta da Adobe Experience Platform.

Introdução

Este guia requer que você já tenha acesso a Jupyter Notebook e esteja familiarizado com sua interface. Para baixar Jupyter Notebook ou obter mais informações, consulte a documentação Jupyter Notebook oficial.

Para adquirir as credenciais necessárias para conectar Jupyter Notebook ao Experience Platform, você deve ter acesso ao espaço de trabalho Consultas na interface do usuário do Experience Platform. Entre em contato com o administrador da organização se você não tiver acesso ao espaço de trabalho Consultas.

TIP
O Anaconda Navigator é uma interface gráfica de usuário (GUI) de desktop que fornece uma maneira mais fácil de instalar e iniciar programas comuns do Python, como o Jupyter Notebook. Também ajuda a gerenciar pacotes, ambientes e canais sem usar comandos de linha de comando.
Siga o processo de instalação guiada no site para instalar a versão preferencial do aplicativo.
Na tela inicial do Navegador Anaconda, selecione Jupyter Notebook na lista de aplicativos compatíveis para iniciar o programa.
Encontre mais informações na documentação oficial do Anaconda.

A documentação oficial do Jupyter fornece instruções para executar o bloco de anotações a partir da interface de linha de comando (CLI).

Launch Jupyter Notebook

Após abrir um novo aplicativo Web Jupyter Notebook, selecione a lista suspensa New na interface, seguida por Python 3 para criar um novo Bloco de Anotações. O editor Notebook é exibido.

Na primeira linha do editor Notebook, digite o seguinte valor: pip install psycopg2-binary e selecione Run na barra de comandos. Uma mensagem de sucesso é exibida abaixo da linha de entrada.

IMPORTANT
Como parte desse processo para formar uma conexão, você deve selecionar Run para executar cada linha de código.

Em seguida, importe um adaptador de banco de dados PostgreSQL para Python. Insira o valor: import psycopg2 e selecione Run. Não há mensagem de sucesso para este processo. Se não houver nenhuma mensagem de erro, continue para a próxima etapa.

Agora você deve fornecer suas credenciais do Adobe Experience Platform inserindo o valor: conn = psycopg2.connect("{YOUR_CREDENTIALS}"). As credenciais de conexão podem ser encontradas na seção Consultas, na guia Credenciais da interface do usuário do Experience Platform. Consulte a documentação sobre como encontrar as credenciais da organização para obter instruções detalhadas.

O uso de credenciais sem expiração é recomendado ao usar clientes de terceiros para economizar o esforço de inserir seus detalhes repetidamente. Consulte a documentação para obter instruções sobre como gerar e usar credenciais sem expiração.

IMPORTANT
Ao copiar credenciais da interface do usuário do Experience Platform, não há necessidade de formatação adicional das credenciais. Eles podem ser fornecidos em uma linha, com um único espaço entre as propriedades e os valores. As credenciais estão entre aspas e não separadas por vírgulas.
conn = psycopg2.connect('''sslmode=require host=<YOUR_HOST_CREDENTIAL> port=80 dbname=prod:all user=<YOUR_ORGANIZATION_ID> password=<YOUR_PASSWORD>''')"

Sua instância Jupyter Notebook agora está conectada ao Serviço de consulta.