將Jupyter Notebook連線至查詢服務
本檔案說明連線Jupyter Notebook與Adobe Experience Platform查詢服務所需的步驟。
快速入門
本指南要求您已擁有Jupyter Notebook的存取權並熟悉其介面。 若要下載Jupyter Notebook或如需詳細資訊,請參閱正式 Jupyter Notebook 檔案。
若要取得連線Jupyter Notebook至Experience Platform所需的認證,您必須能存取Platform UI中的查詢工作區。 如果您目前無法存取查詢工作區,請連絡組織管理員。
請依照其網站上的引導式安裝程式,以安裝您偏好的應用程式版本。
在「Anaconda導覽器」首頁畫面中,從支援的應用程式清單中選取 Jupyter Notebook 以啟動程式。
如需詳細資訊,請參閱Anaconda官方檔案。
官方Jupyter檔案提供從命令列介面🔗 (CLI) 執行筆記本的指示。
Launch Jupyter Notebook
開啟新的Jupyter Notebook Web應用程式後,從UI選取 New 下拉式清單,接著選取 Python 3 以建立新的Notebook。 Notebook編輯器出現。
在Notebook編輯器的第一行,輸入下列值: pip install psycopg2-binary
並從命令列選取 Run。 成功訊息會顯示在輸入行的下方。
接下來,為Python匯入PostgreSQL資料庫配接器。 輸入值: import psycopg2
並選取 Run。 此程式沒有成功訊息。 如果沒有錯誤訊息,請繼續進行下一個步驟。
您現在必須輸入值來提供您的Adobe Experience Platform認證: conn = psycopg2.connect("{YOUR_CREDENTIALS}")
。 您可以在Platform UI的認證標籤下的查詢區段中找到您的連線認證。 如需詳細指示,請參閱有關如何尋找組織認證的檔案。
使用協力廠商使用者端時,建議使用不會到期的認證,以省下重複輸入詳細資料的時間。 請參閱檔案以瞭解如何產生及使用不會到期的認證的說明。
conn = psycopg2.connect('''sslmode=require host=<YOUR_HOST_CREDENTIAL> port=80 dbname=prod:all user=<YOUR_ORGANIZATION_ID> password=<YOUR_PASSWORD>''')"
您的Jupyter Notebook執行個體現在已連線至查詢服務。
範例查詢執行
現在您已將Jupyter Notebook連線至查詢服務,您可以使用Notebook輸入對資料集執行查詢。 下列範例使用簡單查詢來示範此程式。
輸入下列值:
cur = conn.cursor()
cur.execute('''<YOUR_QUERY_HERE>''')
data = [r for r in cur]
接著,呼叫引數(上述範例中的data
),以未格式化的回應顯示查詢結果。
若要以更易讀的方式格式化結果,請使用下列命令:
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)
這些命令不會產生成功訊息。 如果沒有錯誤訊息,您可以使用函式以表格格式輸出SQL查詢的結果。
輸入並執行df.head()
函式,以檢視表格化的查詢結果。
後續步驟
現在您已連線到查詢服務,您可以使用Jupyter Notebook來撰寫查詢。 如需如何撰寫和執行查詢的詳細資訊,請參閱執行查詢指南。