Verbinden Jupyter Notebook zu Query Service

In diesem Dokument werden die zum Verbinden erforderlichen Schritte beschrieben. Jupyter Notebook mit Adobe Experience Platform Query Service.

Erste Schritte

Für dieses Handbuch benötigen Sie bereits Zugriff auf Jupyter Notebook und sind mit der Benutzeroberfläche vertraut. Zum Herunterladen Jupyter Notebook Weitere Informationen finden Sie unter offiziell Jupyter Notebook Dokumentation.

So erwerben Sie die erforderlichen Anmeldeinformationen zum Herstellen einer Verbindung Jupyter Notebook zur Experience Platform benötigen Sie Zugriff auf die Abfragen Arbeitsbereich in der Platform-Benutzeroberfläche. Wenden Sie sich an Ihren Organisationsadministrator, wenn Sie derzeit keinen Zugriff auf die Abfragen Arbeitsbereich.

TIPP

Anaconda Navigator ist eine grafische Desktop-Benutzeroberfläche (GUI), die eine einfachere Möglichkeit bietet, allgemeine Python Programme wie Jupyter Notebook. Es hilft auch, Pakete, Umgebungen und Kanäle zu verwalten, ohne Befehlszeilenbefehle zu verwenden.
Sie können die von Ihnen bevorzugte Version des Programms installieren von ihrer Website aus.
Folgen Sie dem geleiteten Installationsprozess. Wählen Sie auf dem Startbildschirm des Anaconda Navigators die Option Jupyter Notebook aus der Liste der unterstützten Anwendungen, um das Programm zu starten.
Die Anaconda Navigator Startbildschirm mit Jupyter Notebook hervorgehoben.
Weitere Informationen finden Sie in der amtliche Dokumentation.

Launch Jupyter Notebook

Nachdem Sie eine neue Jupyter Notebook Webanwendung, wählen Sie die New Dropdown-Liste, gefolgt von Python 3 , um ein neues Notebook zu erstellen. Die Notebook Editor angezeigt.

Die Jupiter Notebook Registerkarte Datei mit der New Dropdown und Python 3 hervorgehoben.

In der ersten Zeile des Notebook den folgenden Wert eingeben: pip install psycopg2-binary und wählen Sie Run über die Befehlszeile. Eine Erfolgsmeldung wird unter der Eingabefelder angezeigt.

WICHTIG

Um eine Verbindung herzustellen, müssen Sie im Rahmen dieses Prozesses die Option Run um jede Codezeile auszuführen.

Die Notebook Benutzeroberfläche mit hervorgehobenem Befehl "Installationsbibliotheken".

Importieren Sie anschließend eine PostgreSQL Datenbankadapter für Python. Geben Sie den Wert ein: import psycopg2und wählen Sie Run. Für diesen Prozess gibt es keine Erfolgsmeldung. Wenn keine Fehlermeldung vorhanden ist, fahren Sie mit dem nächsten Schritt fort.

Die Notebook Benutzeroberfläche mit hervorgehobenem Code des Importdatenbank-Treibers.

Sie müssen jetzt Ihre Adobe Experience Platform-Anmeldeinformationen angeben, indem Sie den Wert eingeben: conn = psycopg2.connect("{YOUR_CREDENTIALS}"). Ihre Anmeldedaten für die Verbindung finden Sie im Abfragen unter Anmeldeinformationen Registerkarte der Platform-Benutzeroberfläche. Weitere Informationen finden Sie in der Dokumentation Organisationsberechtigungen finden für detaillierte Anweisungen.

Die Verwendung von nicht ablaufenden Anmeldeinformationen wird empfohlen, wenn Sie Clients von Drittanbietern verwenden, um das wiederholte Eingeben Ihrer Details zu vermeiden. Anweisungen finden Sie in der Dokumentation zu Generieren und Verwenden von nicht ablaufenden Anmeldedaten.

WICHTIG

Stellen Sie beim Kopieren von Anmeldeinformationen aus der Platform-Benutzeroberfläche sicher, dass keine zusätzliche Formatierung der Anmeldeinformationen vorhanden ist. Sie sollten sich alle in einer Zeile befinden, mit einem einzigen Leerzeichen zwischen den Eigenschaften und Werten. Die Anmeldeinformationen sind in Anführungszeichen gesetzt und not durch Kommas getrennt.

Die Notebook Benutzeroberfläche mit hervorgehobenen Verbindungsanmeldedaten.

Ihre Jupyter Notebook -Instanz ist jetzt mit Query Service verbunden.

Beispielabfrageausführung

Nachdem Sie eine Verbindung hergestellt haben Jupyter Notebook Für Query Service können Sie mithilfe Ihrer Notebook Eingaben. 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 auf (data im obigen Beispiel), um die Abfrageergebnisse in einer unformatierten Antwort anzuzeigen.

Die Notebook Benutzeroberfläche mit Befehlen zum Zurückgeben und Anzeigen von SQL-Ergebnissen im Notebook.

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 pd
  • import numpy as np

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.

Die zum Formatieren der SQL-Ergebnisse erforderlichen Befehle.

Geben Sie ein und führen Sie die df.head() -Funktion, um die tabularisierten Abfrageergebnisse anzuzeigen.

Tabellarische Ergebnisse Ihrer SQL-Abfrage in Jupyter Notebook.

Nächste Schritte

Nachdem Sie sich mit Query Service verbunden haben, können Sie Jupyter Notebook , um Abfragen zu schreiben. Weitere Informationen dazu, wie Sie Abfragen formulieren und ausführen, finden Sie im Handbuch zum Thema Ausführen von Abfragen.

Auf dieser Seite