Anslut Jupyter Notebook till frågetjänst
Det här dokumentet innehåller de steg som krävs för att ansluta Jupyter Notebook med Adobe Experience Platform Query Service.
Komma igång
Den här guiden kräver att du redan har åtkomst till Jupyter Notebook och känner till gränssnittet. För nedladdning Jupyter Notebook Mer information finns i officiell Jupyter Notebook dokumentation.
Hämta nödvändiga autentiseringsuppgifter för anslutning Jupyter Notebook till Experience Platform måste du ha tillgång till Queries i plattformsgränssnittet. Kontakta din organisations administratör om du inte har tillgång till Queries arbetsyta.
Följ den guidade installationsprocessen på deras webbplats för att installera den version av programmet som du föredrar.
På startskärmen för Anaconda Navigator väljer du Jupyter Notebook i listan över program som stöds för att starta programmet.
Mer information finns i officiell dokumentation för Anaconda.
I den officiella Jupyter-dokumentationen finns instruktioner för att köra anteckningsboken från kommandoradsgränssnittet (CLI).
Starta Jupyter Notebook
När du har öppnat en ny Jupyter Notebook webbprogram väljer du New listruta från användargränssnittet, följt av Python 3 för att skapa en ny anteckningsbok. The Notebook redigeraren visas.
På första raden i Notebook anger du följande värde: pip install psycopg2-binary
och markera Run i kommandofältet. Ett meddelande om att åtgärden lyckades visas under inmatningsraden.
Importera sedan en PostgreSQL databasadapter för Python. Ange värdet: import psycopg2
och markera Run. Det finns inget meddelande om att processen lyckades. Om det inte finns något felmeddelande fortsätter du till nästa steg.
Du måste nu ange dina Adobe Experience Platform-uppgifter genom att ange värdet: conn = psycopg2.connect("{YOUR_CREDENTIALS}")
. Dina anslutningsreferenser finns i Queries -avsnittet, under Credentials -fliken i plattformsgränssnittet. Läs dokumentationen om hur du hitta organisationens autentiseringsuppgifter för detaljerade anvisningar.
Vi rekommenderar att du använder inloggningsuppgifter som inte upphör att gälla när du använder tredjepartsklienter för att spara arbetet med att ange dina uppgifter upprepade gånger. I dokumentationen finns instruktioner om hur du genererar och använder inloggningsuppgifter som inte förfaller.
conn = psycopg2.connect('''sslmode=require host=<YOUR_HOST_CREDENTIAL> port=80 dbname=prod:all user=<YOUR_ORGANIZATION_ID> password=<YOUR_PASSWORD>''')"
Dina Jupyter Notebook -instansen är nu ansluten till frågetjänsten.
Exempelfrågekörning
Nu när du är ansluten Jupyter Notebook för att fråga tjänsten kan du utföra frågor på dina datauppsättningar med Notebook indata. I följande exempel används en enkel fråga för att demonstrera processen.
Ange följande värden:
cur = conn.cursor()
cur.execute('''<YOUR_QUERY_HERE>''')
data = [r for r in cur]
Anropa sedan parametern (data
i exemplet ovan) om du vill visa frågeresultatet i ett oformaterat svar.
Använd följande kommandon om du vill formatera resultatet på ett mer läsbart sätt:
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)
Dessa kommandon genererar inget meddelande om att åtgärden lyckades. Om det inte finns något felmeddelande kan du sedan använda en funktion för att skriva ut resultatet av SQL-frågan i ett tabellformat.
Ange och kör df.head()
-funktion för att se sökresultaten i tabellform.
Nästa steg
Nu när du har anslutit till frågetjänsten kan du använda Jupyter Notebook för att skriva frågor. Mer information om hur du skriver och kör frågor finns i köra frågeguide.