Connetti Jupyter Notebook a Query Service
Questo documento descrive i passaggi necessari per connettere Jupyter Notebook a Adobe Experience Platform Query Service.
Introduzione
Questa guida richiede che tu abbia già accesso a Jupyter Notebook e che tu abbia familiarità con la relativa interfaccia. Per scaricare Jupyter Notebook o per ulteriori informazioni, consulta la documentazione Jupyter Notebook ufficiale.
Per acquisire le credenziali necessarie per la connessione di Jupyter Notebook a Experience Platform, è necessario avere accesso all'area di lavoro Query nell'interfaccia utente di Platform. Contatta l'amministratore dell'organizzazione se al momento non hai accesso all'area di lavoro Query.
Segui il processo di installazione guidata sul loro sito Web per installare la tua versione preferita dell'applicazione.
Dalla schermata iniziale di Anaconda Navigator, selezionare Jupyter Notebook dall'elenco delle applicazioni supportate per avviare il programma.
Ulteriori informazioni sono disponibili nella documentazione ufficiale di Anaconda.
La documentazione ufficiale di Jupyter fornisce istruzioni per eseguire il blocco appunti dall'interfaccia della riga di comando (CLI).
Launch Jupyter Notebook
Dopo aver aperto una nuova applicazione Web Jupyter Notebook, selezionare il menu a discesa New dall'interfaccia utente, seguito da Python 3 per creare un nuovo blocco appunti. Viene visualizzato l'editor Notebook.
Nella prima riga dell'editor Notebook immettere il valore seguente: pip install psycopg2-binary e selezionare Run dalla barra dei comandi. Sotto la riga di input viene visualizzato un messaggio di operazione riuscita.
Importare quindi un adattatore di database PostgreSQL per Python. Immettere il valore import psycopg2 e selezionare Run. Nessun messaggio di operazione riuscita per questo processo. Se non viene visualizzato alcun messaggio di errore, procedere al passaggio successivo.
Immettere le credenziali Adobe Experience Platform immettendo il valore: conn = psycopg2.connect("{YOUR_CREDENTIALS}"). Le credenziali di connessione sono disponibili nella sezione Query della scheda Credenziali dell'interfaccia utente di Platform. Per istruzioni dettagliate, consulta la documentazione su come trovare le credenziali della tua organizzazione.
L’utilizzo di credenziali senza scadenza è consigliato quando si utilizzano client di terze parti per facilitare l’immissione ripetuta dei dettagli. Per istruzioni su come generare e utilizzare credenziali senza scadenza, consulta la documentazione.
conn = psycopg2.connect('''sslmode=require host=<YOUR_HOST_CREDENTIAL> port=80 dbname=prod:all user=<YOUR_ORGANIZATION_ID> password=<YOUR_PASSWORD>''')"
L'istanza Jupyter Notebook è ora connessa a Query Service.
Esempio di esecuzione di una query
Dopo aver connesso Jupyter Notebook a Query Service, è possibile eseguire query sui set di dati utilizzando gli input di Notebook. Nell'esempio seguente viene utilizzata una query semplice per illustrare il processo.
Immetti i seguenti valori:
cur = conn.cursor()
cur.execute('''<YOUR_QUERY_HERE>''')
data = [r for r in cur]
Chiamare quindi il parametro (data nell'esempio precedente) per visualizzare i risultati della query in una risposta non formattata.
Per formattare i risultati in modo più leggibile, utilizzare i seguenti comandi:
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)
Questi comandi non generano un messaggio di successo. Se non viene visualizzato alcun messaggio di errore, è possibile utilizzare una funzione per generare i risultati della query SQL in un formato tabella.
Immettere ed eseguire la funzione df.head() per visualizzare i risultati delle query tabulari.
Passaggi successivi
Dopo aver stabilito la connessione a Query Service, è possibile utilizzare Jupyter Notebook per scrivere query. Per ulteriori informazioni su come scrivere ed eseguire query, leggere la guida alle query in esecuzione.