Connetti Jupyter Notebook a Query Service
Questo documento descrive i passaggi necessari per la connessione Jupyter Notebook con Adobe Experience Platform Query Service.
Introduzione
Questa guida richiede di avere già accesso a Jupyter Notebook e hanno familiarità con la relativa interfaccia. Per scaricare Jupyter Notebook o per ulteriori informazioni, consulta ufficiale Jupyter Notebook documentazione.
Per acquisire le credenziali necessarie per la connessione Jupyter Notebook ad Experience Platform, devi avere accesso al Query nell’interfaccia utente di Platform. Contatta l’amministratore dell’organizzazione se al momento non hai accesso a Query Workspace.
Seguire la procedura di installazione guidata sul sito Web per installare la 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 sezione 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 un nuovo Jupyter Notebook applicazione web, seleziona la New dall’interfaccia utente, seguito da Python 3 per creare un nuovo blocco appunti. Il Notebook viene visualizzato l'editor.
Sulla prima riga del Notebook , immetti il seguente valore: pip install psycopg2-binary
e seleziona Run dalla barra dei comandi. Sotto la riga di input viene visualizzato un messaggio di operazione riuscita.
Quindi, importa un PostgreSQL adattatore di database per Python. Immetti il valore: import psycopg2
e seleziona Run. Nessun messaggio di operazione riuscita per questo processo. Se non viene visualizzato alcun messaggio di errore, procedere al passaggio successivo.
A questo punto è necessario fornire le credenziali Adobe Experience Platform immettendo il valore: conn = psycopg2.connect("{YOUR_CREDENTIALS}")
. Le credenziali di connessione sono disponibili in Query sezione, sotto Credenziali dell’interfaccia utente di Platform. Consulta la documentazione su come trova le credenziali della tua organizzazione per istruzioni dettagliate.
L’utilizzo di credenziali senza scadenza è consigliato quando si utilizzano client di terze parti per facilitare l’immissione ripetuta dei dettagli. Per istruzioni su, consulta la documentazione di come generare e utilizzare credenziali senza scadenza.
conn = psycopg2.connect('''sslmode=require host=<YOUR_HOST_CREDENTIAL> port=80 dbname=prod:all user=<YOUR_ORGANIZATION_ID> password=<YOUR_PASSWORD>''')"
Il tuo Jupyter Notebook L’istanza è ora connessa a Query Service.
Esempio di esecuzione di una query
Ora che hai effettuato la connessione Jupyter Notebook In Query Service, puoi eseguire query sui set di dati utilizzando il tuo Notebook input. 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]
Quindi, chiama 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 pd
import numpy as np
df = 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.
Inserisci ed esegui il df.head()
per visualizzare i risultati della query tabularizzata.
Passaggi successivi
Dopo aver stabilito la connessione a Query Service, puoi utilizzare Jupyter Notebook per scrivere query. Per ulteriori informazioni su come scrivere ed eseguire query, leggere guida all’esecuzione delle query.