文件Experience Platform查詢服務指南

將GitHub Copilot和Visual Studio Code連線到查詢服務

最後更新: 2025年5月5日
  • 主題:
  • 查詢

建立對象:

  • 使用者
  • 開發人員
IMPORTANT
使用此整合工具之前,您必須瞭解哪些資料會與GitHub共用。 共用資料包含正在編輯的程式碼和檔案的相關資訊(「提示」)以及使用者動作的詳細資訊(「使用者參與資料」)。 請檢閱GitHub Copilot的隱私權宣告,瞭解其收集的資料。 您也必須考慮涉及協力廠商服務的安全性影響,因為您有責任確保遵守組織的資料控管原則。 對於使用此工具而可能導致的任何資料相關疑慮或問題,Adobe概不負責。 如需詳細資訊,請參閱GitHub檔案。

GitHub Copilot由OpenAI Codex提供技術支援,是AI驅動的工具,可藉由直接在編輯器中建議程式碼片段和整個功能,來強化您的程式碼體驗。 與Visual Studio Code (VS Code)整合,Copilot可大幅加快您的工作流程,尤其是在處理複雜查詢時。 請依照本指南瞭解如何將GitHub Copilot和VS Code連線至查詢服務,以更有效率的方式撰寫和管理您的查詢。 如需Copilot的詳細資訊,請造訪GitHub的Copilot產品頁面和正式 Copilot 檔案。

本檔案說明使用Adobe Experience Platform查詢服務連線GitHub Copilot和VS Code所需的步驟。

快速入門

本指南要求您已存取GitHub帳戶並註冊GitHub Copilot。 您可以從GitHub網站註冊。 您也需要VS Code。 您可從其官方網站🔗下載1}。 VS Code

安裝VS Code並啟動您的Copilot訂閱後,請取得Experience Platform的連線認證。 這些認證位於Experience Platform UI中查詢工作區的認證索引標籤中。 閱讀的認證指南,瞭解如何在Experience Platform UI中找到這些值。 如果您目前無法存取查詢工作區,請連絡組織管理員。

必要的Visual Studio Code副檔名

您必須使用下列Visual Studio Code擴充功能,才能直接在程式碼編輯器中有效管理和查詢您的Experience Platform SQL資料庫。 下載並安裝這些擴充功能。

  • SQLTools:使用SQLTools擴充功能來管理及查詢多個SQL資料庫。 它包含查詢執行器、SQL格式化程式和連線總管等功能,並支援其他驅動程式以提高開發人員的生產力。 如需詳細資訊,請閱讀Visual Studio Marketplace的概觀。
  • SQLTools PostgreSQL/Cockroach驅動程式:此擴充功能可讓您直接在程式碼編輯器中連線、查詢及管理PostgreSQL與CockroachDB資料庫。

下一個擴充功能會啟用GitHub Copilot及其聊天功能。

  • GitHub Copilot:在您輸入時提供內嵌編碼建議。
  • GitHub Copilot 聊天:提供對話式AI協助的隨附擴充功能。

建立連線

選取圓柱圖示( 圓柱圖示。 ),後面接著​ Add New Connection ​或圓柱加號圖示( 圓柱加號圖示。 )。VS Code

反白顯示Visual Studio Code UI與SQL Tool擴充功能及新增連線。

Connection Assistant ​出現。 選取​ PostgreSQL ​資料庫驅動程式。

在VS Code中反白顯示PostgreSQl的SQLTools設定頁面。

輸入連線設定

Connection Settings檢視出現。 在SQLTools Connection Assistant的適當欄位中輸入您的Experience Platform連線認證。 下表會說明必要的值。

屬性
說明
Connection name

提供Prod_MySQL_Server之類的"Connection name",其內容應具描述性並清楚指出其用途(例如MySQL伺服器的生產環境)。 最佳實務包括:

  • 遵循您組織的命名慣例,以確保其在系統內是唯一的。
  • 保持簡潔,以保持清晰度並避免與其他連線混淆。
  • 在名稱中包含連線功能或環境的相關詳細資訊。
Connect using
使用​ Server and Port ​選項來指定伺服器的位址(主機名稱)和連線埠號碼,以建立與Experience Platform的直接連線
Server address
輸入您的Experience Platform Postgres認證中提供的​ 主機 ​值,例如acmeprod.platform-query.adobe.io。
Port
Experience Platform服務的此值通常為80。
Database
輸入您的Experience Platform Postgres認證中提供的​ 資料庫 ​值,例如prod:all。
Username
此屬性是指您的組織ID。 輸入您的Experience Platform Postgres認證中提供的​ 使用者名稱 ​值。
Password
此屬性是您的存取權杖。 輸入您的Experience Platform Postgres認證中提供的​ 密碼 ​值。

連線小幫手工作區中數個設定已反白顯示。

接著,選取​ Use Password,接著從出現的下拉式功能表中選取​ Save as plaintext in settings。 Password欄位隨即顯示。 使用此文字輸入欄位來輸入您的存取權杖。

[使用密碼]、其下拉式功能表及[密碼]欄位已反白顯示。

最後,若要啟用SSL,請選取SSL輸入欄位,然後從出現的下拉式功能表中選擇Enabled。

下拉式功能表中已啟用的SSL欄位已反白顯示。

TIP
輸入所有認證後,您可以在儲存連線之前先測試連線。 向下捲動至工作區底部並選取​ Test Connection。
已反白測試連線的連線助理工作區。

正確輸入連線詳細資料後,請選取「Save Connection」以確認您的設定。

已反白顯示[儲存連線]的連線助理工作區。

Review connection details檢視會出現,並顯示您的連線認證。 當您確定連線詳細資料正確時,請選取​ Connect Now。

檢閱連線詳細資料檢視中,已反白顯示[立即連線]。

您的VS Code工作區出現,並附上GitHub Copilot的建議。

VS Code. 中的連線SQL工作階段

GitHub Copilot快速指南

連線至您的Experience Platform執行個體後,您就可以使用Copilot做為AI編碼助理,協助您更快且更自信地撰寫程式碼。 本節說明其主要功能及使用方式。

快速入門:GitHub Copilot

首先,確定您已安裝最新版本的VS Code。 過時的VS Code版本可能會使索引鍵Copilot功能無法如預期運作。 接下來,確定已啟用Enable Auto Completions設定。 如果Copilot已正確執行,Copilot圖示 ( Copilot圖示 )會顯示在您的狀態列中(如果有問題,則會改為顯示Copilot錯誤圖示)。 選取​ Copilot圖示 ​以開啟GitHub Copilot功能表。 從​ GitHub Copilot功能表,選取​ Edit Settings

已顯示GitHub Copilot Menu並反白顯示Copilot圖示和[編輯設定]的VS Code編輯器。

向下捲動選項,並確認已針對Enable Auto Completions設定啟用核取方塊。

已選取並反白顯示[啟用自動完成]核取方塊的GitHub Copilot設定面板。

程式碼完成

安裝GitHub Copilot擴充功能並登入後,它會自動啟用名為​ Ghost Text ​的功能,此功能會在您輸入時建議程式碼完成。 這些建議可協助您以更少的中斷更有效率地撰寫程式碼。 您也可以使用註解來指導AI程式碼建議。 這表示非技術使用者可以將純語音轉換為程式碼,以探索其資料。

含有程式碼建議的VSCode UI和醒目提示的GitHub Copilot圖示。

TIP
如果您想要針對特定檔案或語言停用Copilot,請選取狀態列中的圖示並加以停用。

接受完整的或部分Ghost文字建議

當GitHub Copilot建議程式碼完成時,您可以接受部分或完整的建議。 選取​ Tab ​以接受整個建議,或按住​ Control (或Mac上的命令) ​並按下​ 向右鍵 ​以接受部分文字。 若要關閉建議,請按​ Escape。

TIP
如果未取得建議,請確定已以您檔案的語言🔗啟用Copilot 。

VS Code編輯器在部分輸入的程式碼旁顯示GitHub Copilot模糊的灰色文字建議,作為Ghost文字。

替代建議

若要循環顯示替代程式碼建議,請在Copilot對話方塊中選取箭頭。

顯示Copilot替代建議面板的VS Code編輯器。

使用內嵌聊天

您也可以直接與Copilot聊天有關您的程式碼。 使用​ Control (或Command) + I ​觸發內嵌聊天對話方塊。 此功能用於疊代您的程式碼並修訂內容中的建議。 您可以反白標示程式碼區塊,並在接受前使用內嵌聊天室檢視AI提出的不同解決方案。

具有差異檢視的內嵌聊天視窗

專屬聊天檢視

您可以使用較傳統的聊天介面和專用的聊天側邊欄,來形成想法和策略、解決編碼問題並討論實作詳細資訊。 選取聊天圖示( Copilot聊天圖示。VS Code側邊欄中的 )以開啟專屬的聊天視窗。

反白顯示聊天圖示的GitHub Copilot聊天側邊欄。

您也可以選取歷程記錄圖示( 歷程記錄圖示)來存取聊天歷程記錄。 )。

後續步驟

您現在已準備好直接從程式碼編輯器有效率地查詢Experience Platform資料庫,並使用GitHub Copilot的AI支援程式碼建議來簡化撰寫和最佳化SQL查詢。 如需如何撰寫和執行查詢的詳細資訊,請參閱查詢執行的指南。

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