Verbinden von Jupyter Notebook mit dem Abfrage-Service
In diesem Dokument werden die Schritte beschrieben, die zum Verbinden von Jupyter Notebook mit dem Abfrage-Service von Adobe Experience Platform erforderlich sind.
Erste Schritte
Für dieses Handbuch müssen Sie bereits Zugriff auf Jupyter Notebook haben und mit dessen Benutzeroberfläche vertraut sein. Informationen zum Herunterladen von Jupyter Notebook oder weitere Informationen finden Sie unter Official Jupyter Notebook Documentation.
Um die erforderlichen Anmeldeinformationen zum Verbinden von Jupyter Notebook mit Experience Platform zu erhalten, benötigen Sie Zugriff auf den Arbeitsbereich Abfragen in der Platform-Benutzeroberfläche. Wenden Sie sich an den Admin Ihrer Organisation, wenn Sie derzeit keinen Zugriff auf den Arbeitsbereich Abfragen haben.
Folgen Sie dem geführten Installationsprozess auf der Website von installieren Sie Ihre bevorzugte Version des Programms.
Wählen Sie im Anaconda Navigator-Startbildschirm die Option Jupyter Notebook aus der Liste der unterstützten Programme, um das Programm zu starten.
Weitere Informationen finden Sie in der offiziellen Anaconda-Dokumentation.
Die offizielle Jupyter-Dokumentation enthält Anweisungen zum Ausführen des Notebooks über die Befehlszeilenschnittstelle (CLI).
Launch Jupyter Notebook
Nachdem Sie eine neue Jupyter Notebook-Web-Anwendung geöffnet haben, wählen Sie das Dropdown-Menü New in der Benutzeroberfläche und dann Python 3 aus, um ein neues Notebook zu erstellen. Der Notebook wird angezeigt.
Geben Sie in der ersten Zeile des Notebook-Editors den folgenden Wert ein: pip install psycopg2-binary
und wählen Sie Run in der Befehlsleiste aus. Unterhalb der Eingabezeile wird eine Erfolgsmeldung angezeigt.
Importieren Sie als Nächstes einen PostgreSQL Datenbankadapter für Python. Geben Sie den Wert ein: import psycopg2
und wählen Sie Run aus. Es gibt keine Erfolgsmeldung für diesen Prozess. Wenn keine Fehlermeldung angezeigt wird, fahren Sie mit dem nächsten Schritt fort.
Sie müssen jetzt Ihre Adobe Experience Platform-Anmeldeinformationen angeben, indem Sie den Wert eingeben: conn = psycopg2.connect("{YOUR_CREDENTIALS}")
. Ihre Anmeldeinformationen für die Verbindung finden Sie Abschnitt Abfragen“ auf der Registerkarte Anmeldeinformationen der Platform-Benutzeroberfläche. Detaillierte Anweisungen finden Sie in der Dokumentation Suchen derIhres Unternehmens .
Die Verwendung nicht ablaufender Anmeldeinformationen wird empfohlen, wenn Sie Drittanbieter-Clients verwenden, um sich die wiederholte Eingabe Ihrer Details zu ersparen. In der Dokumentation finden Anweisungen zum Generieren und Verwenden nicht ablaufender Anmeldeinformationen.
conn = psycopg2.connect('''sslmode=require host=<YOUR_HOST_CREDENTIAL> port=80 dbname=prod:all user=<YOUR_ORGANIZATION_ID> password=<YOUR_PASSWORD>''')"
Ihre Jupyter Notebook ist jetzt mit dem Abfrage-Service verbunden.
Beispielhafte Abfrageausführung
Nachdem Sie nun Jupyter Notebook mit dem Abfrage-Service verbunden haben, können Sie mit Ihren Notebook Abfragen für Ihre Datensätze durchführen. Im folgenden Beispiel wird eine einfache Abfrage verwendet, um den Prozess zu demonstrieren.
Geben Sie die folgenden Werte ein:
cur = conn.cursor()
cur.execute('''<YOUR_QUERY_HERE>''')
data = [r for r in cur]
Rufen Sie anschließend den Parameter auf (data
im obigen Beispiel), um die Abfrageergebnisse in einer unformatierten Antwort anzuzeigen.
Um die Ergebnisse besser lesbar zu formatieren, verwenden Sie die folgenden Befehle:
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)
Diese Befehle erzeugen keine Erfolgsmeldung. Wenn keine Fehlermeldung vorliegt, können Sie eine Funktion verwenden, um die Ergebnisse Ihrer SQL-Abfrage in einem Tabellenformat auszugeben.
Geben Sie die Funktion df.head()
ein und führen Sie sie aus, um die tabellarischen Abfrageergebnisse anzuzeigen.
Nächste Schritte
Nachdem Sie sich mit dem Abfrage-Service verbunden haben, können Sie Jupyter Notebook verwenden, um Abfragen zu schreiben. Weitere Informationen dazu, wie Sie Abfragen formulieren und ausführen, finden Sie im Handbuch zum Thema Ausführen von Abfragen.