Verbinden von Jupyter Notebook mit dem Abfrage-Service
In diesem Dokument werden die Schritte beschrieben, die zum Verbinden von Jupyter Notebook mit dem Adobe Experience Platform Query Service erforderlich sind.
Erste Schritte
Dieses Handbuch setzt voraus, dass Sie bereits Zugriff auf Jupyter Notebook haben und mit der zugehörigen Benutzeroberfläche vertraut sind. Weitere Informationen zum Herunterladen von Jupyter Notebook oder finden Sie in der offiziellen Jupyter Notebook Dokumentation.
Um die erforderlichen Anmeldeinformationen zum Verbinden von Jupyter Notebook mit Experience Platform zu erhalten, müssen Sie auf den Arbeitsbereich Abfragen in der Platform-Benutzeroberfläche zugreifen können. Wenden Sie sich an Ihren Organisationsadministrator, wenn Sie derzeit keinen Zugriff auf den Arbeitsbereich Abfragen haben.
Folgen Sie dem geleiteten Installationsprozess auf ihrer Website, um Ihre bevorzugte Version der Anwendung zu installieren.
Wählen Sie im Startbildschirm des Anaconda Navigators in der Liste der unterstützten Anwendungen die Option Jupyter Notebook aus, 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 -Webanwendung geöffnet haben, wählen Sie in der Benutzeroberfläche das Dropdown-Menü New aus, gefolgt von Python 3, um ein neues Notebook zu erstellen. Der Editor 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. Eine Erfolgsmeldung wird unter der Eingabefelder angezeigt.
Importieren Sie als Nächstes einen PostgreSQL Datenbankadapter für Python. Geben Sie den Wert ein: import psycopg2und wählen Sie Run aus. Für diesen Prozess gibt es keine Erfolgsmeldung. Wenn keine Fehlermeldung vorhanden ist, 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 Verbindungsberechtigungen finden Sie im Abschnitt Abfragen auf der Registerkarte Anmeldedaten der Platform-Benutzeroberfläche. Detaillierte Anweisungen finden Sie in der Dokumentation zum Auffinden Ihrer Organisationsberechtigungen 🔗 .
Die Verwendung von nicht ablaufenden Anmeldeinformationen wird empfohlen, wenn Sie Clients von Drittanbietern verwenden, um das wiederholte Eingeben Ihrer Details zu vermeiden. Anweisungen zum Generieren und Verwenden von nicht ablaufenden Anmeldedaten finden Sie in der Dokumentation .
conn = psycopg2.connect('''sslmode=require host=<YOUR_HOST_CREDENTIAL> port=80 dbname=prod:all user=<YOUR_ORGANIZATION_ID> password=<YOUR_PASSWORD>''')"
Ihre Jupyter Notebook -Instanz ist jetzt mit Query Service verbunden.
Beispielabfrageausführung
Nachdem Sie Jupyter Notebook mit Query Service verbunden haben, können Sie mithilfe Ihrer Notebook -Eingaben Abfragen an Ihren Datensätzen 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 als Nächstes den Parameter (data im obigen Beispiel) auf, um die Abfrageergebnisse in einer unformatierten Antwort anzuzeigen.
Verwenden Sie die folgenden Befehle, um die Ergebnisse für Menschen lesbarer zu formatieren:
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)
Diese Befehle generieren keine Erfolgsmeldung. Wenn keine Fehlermeldung angezeigt wird, 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 tabellarisierten Abfrageergebnisse anzuzeigen.
Nächste Schritte
Nachdem Sie mit Query Service verbunden sind, können Sie mit Jupyter Notebook Abfragen schreiben. Weitere Informationen dazu, wie Sie Abfragen formulieren und ausführen, finden Sie im Handbuch zum Thema Ausführen von Abfragen.