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.

TIP
Anaconda Navigator är ett grafiskt användargränssnitt (GUI) som gör det enklare att installera och starta vanliga Python-program som Jupyter Notebook. Det underlättar också hanteringen av paket, miljöer och kanaler utan kommandoradskommandon.
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.

IMPORTANT
Som en del av den här processen för att skapa en anslutning måste du välja Run för att köra varje kodrad.

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.

IMPORTANT
När du kopierar inloggningsuppgifter från plattformsgränssnittet behövs ingen ytterligare formatering av inloggningsuppgifterna. De kan anges på en rad med ett enda mellanrum mellan egenskaperna och värdena. Autentiseringsuppgifterna omges av citattecken och inte kommaavgränsade.
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 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 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.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb