Conectar Jupyter Notebook ao Serviço de consulta
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 de usuário da Platform. Entre em contato com o administrador da organização se você não tiver acesso ao espaço de trabalho Consultas.
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.
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}"). Suas credenciais de conexão podem ser encontradas na seção Consultas, na guia Credenciais da interface do usuário da plataforma. 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.
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.
Exemplo de execução de consulta
Agora que você conectou o Jupyter Notebook ao Serviço de Consulta, é possível executar consultas em seus conjuntos de dados usando suas entradas Notebook. O exemplo a seguir usa uma consulta simples para demonstrar o processo.
Insira os seguintes valores:
cur = conn.cursor()
cur.execute('''<YOUR_QUERY_HERE>''')
data = [r for r in cur]
Em seguida, chame o parâmetro (data no exemplo acima) para exibir os resultados da consulta em uma resposta não formatada.
Para formatar os resultados de uma maneira mais legível, use os seguintes comandos:
colnames = [desc[0] for desc in cur.description]import pandas as pdimport numpy as npdf = pd.DataFrame(samples,columns=colnames)df.fillna(0,inplace=True)
Esses comandos não geram uma mensagem de sucesso. Se não houver mensagem de erro, você poderá usar uma função para produzir os resultados da sua consulta SQL em formato de tabela.
Insira e execute a função df.head() para ver os resultados da consulta tabulada.
Próximas etapas
Agora que você se conectou ao Serviço de Consulta, pode usar Jupyter Notebook para gravar consultas. Para obter mais informações sobre como gravar e executar consultas, leia o guia de execução de consultas.