Anslut Jupyter Notebook till frågetjänsten
Det här dokumentet innehåller de steg som krävs för att ansluta Jupyter Notebook till 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 dess gränssnitt. Om du vill hämta Jupyter Notebook eller om du vill ha mer information läser du officiell Jupyter Notebook dokumentation.
Om du vill få de nödvändiga autentiseringsuppgifterna för att ansluta Jupyter Notebook till Experience Platform måste du ha tillgång till arbetsytan Queries i plattformsgränssnittet. Kontakta din organisationsadministratör om du inte har tillgång till arbetsytan Queries.
Följ den guidade installationsprocessen på deras webbplats för att installera den version av programmet som du föredrar.
Välj Jupyter Notebook i listan över program som stöds för att starta programmet på startskärmen för Anaconda Navigator.
Mer information finns i den officiella Anaconda-dokumentationen.
Den officiella Jupyter-dokumentationen innehåller anvisningar om hur du kör anteckningsboken från kommandoradsgränssnittet (CLI).
Starta Jupyter Notebook
När du har öppnat ett nytt Jupyter Notebook-webbprogram väljer du listrutan New i gränssnittet, följt av Python 3, för att skapa en ny anteckningsbok. Notebook-redigeraren visas.
Ange följande värde på den första raden i Notebook-redigeraren: pip install psycopg2-binary och välj Run i kommandofältet. Ett meddelande om att åtgärden lyckades visas under inmatningsraden.
Importera sedan ett PostgreSQL-databaskort för Python. Ange värdet: import psycopg2 och välj 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-autentiseringsuppgifter genom att ange värdet: conn = psycopg2.connect("{YOUR_CREDENTIALS}"). Dina anslutningsautentiseringsuppgifter finns i avsnittet Queries på fliken Credentials i användargränssnittet för plattformen. Mer information finns i dokumentationen om hur du hittar dina organisationsuppgifter.
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 autentiseringsuppgifter som inte upphör att gälla.
conn = psycopg2.connect('''sslmode=require host=<YOUR_HOST_CREDENTIAL> port=80 dbname=prod:all user=<YOUR_ORGANIZATION_ID> password=<YOUR_PASSWORD>''')"
Jupyter Notebook-instansen är nu ansluten till frågetjänsten.
Exempelfrågekörning
Nu när du har anslutit Jupyter Notebook till frågetjänsten kan du utföra frågor på dina datauppsättningar med dina 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) för att visa frågeresultaten 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 pdimport numpy as npdf = 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 funktionen df.head() för att se resultatet av en tabellfråga.
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 guidensom kör frågor.