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.

TIP
Anaconda Navigator ist eine grafische Benutzeroberfläche (GUI) für Desktops, die eine einfachere Möglichkeit bietet, gängige Python wie Jupyter Notebook zu installieren und zu starten. Außerdem können Pakete, Umgebungen und Kanäle ohne Verwendung von Befehlszeilenbefehlen verwaltet werden.
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.

IMPORTANT
Im Rahmen dieses Verbindungsprozesses müssen Sie Run auswählen, um jede Codezeile auszuführen.

Importieren Sie als Nächstes einen PostgreSQL Datenbankadapter für Python. Geben Sie den Wert ein: import psycopg2und 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.

IMPORTANT
Beim Kopieren von Anmeldeinformationen aus der Platform-Benutzeroberfläche ist keine zusätzliche Formatierung der Anmeldeinformationen erforderlich. Sie können in einer Zeile angegeben werden, wobei ein einziges Leerzeichen zwischen den Eigenschaften und Werten besteht. Die Anmeldeinformationen werden in Anführungszeichen eingeschlossen und nicht durch Kommas getrennt.
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.

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