将GitHub Copilot和Visual Studio Code连接到查询服务

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所需的步骤。

快速入门 get-started

本指南要求您已经拥有GitHub帐户的访问权限并注册了GitHub Copilot。 您可以从GitHub网站注册。 您还需要VS Code。 您可从他们的官方网站🔗下载1}。 VS Code

安装VS Code并激活Copilot订阅后,获取Experience Platform的连接凭据。 这些凭据位于Experience Platform UI中查询工作区的凭据选项卡中。 阅读的凭据指南,了解如何在Experience Platform UI中找到这些值。 如果您当前无权访问查询工作区,请联系您的组织管理员。

所需的Visual Studio Code扩展 required-extensions

需要以下Visual Studio Code扩展才能直接在代码编辑器中有效地管理和查询Experience Platform SQL数据库。 下载并安装这些扩展。

  • SQLTools:使用SQLTools扩展管理和查询多个SQL数据库。 它包含查询运行器、SQL格式器和连接资源管理器等功能,并支持其他驱动程序以提高开发人员的工作效率。 有关详细信息,请阅读Visual Studio Marketplace上的概述。
  • SQLTools PostgreSQL/Cockroach驱动程序:此扩展允许您直接在代码编辑器中连接、查询和管理PostgreSQL和CockroachDB数据库。

后续扩展将启用GitHub Copilot及其聊天功能。

创建连接 create-connection

选择圆柱图标( 圆柱图标。 ),后跟​ Add New Connection ​或圆柱加号图标( 圆柱加号图标。 )。VS Code

突出显示带有SQL Tool扩展和添加新连接的Visual Studio代码UI。

出现​ Connection Assistant。 选择​ PostgreSQL ​数据库驱动程序。

在VS Code中突出显示PostgreSQl的SQLTools设置页。

输入连接设置 input-connection-settings

出现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
已突出显示“测试连接”的“连接助手”工作区。 {width="100" modal="regular"}

正确输入连接详细信息后,选择​ Save Connection ​以确认设置。

已突出显示“保存连接”的连接助理工作区。

将显示Review connection details视图并显示您的连接凭据。 当您确定连接详细信息准确时,请选择​ Connect Now

高亮显示了“查看连接详细信息”视图,其中显示了“立即连接”。

您的VS Code工作区随来自GitHub Copilot的建议一起出现。

在VS Code. 中连接的SQL会话

GitHub Copilot快速指南

连接到您的Experience Platform实例后,您可以使用Copilot作为AI编码助手,帮助您更快更自信地编写代码。 本节介绍其主要功能及其使用方式。

GitHub Copilot 入门 get-started-with-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的设置面板。

代码完成 code-completions

安装GitHub Copilot扩展并登录后,它会自动激活名为​ Ghost Text ​的功能,此功能会在您键入时建议代码完成。 这些建议可帮助您更有效地编写代码,并且中断较少。 您还可以使用注释来指导AI代码建议。 这意味着非技术用户可以将纯语音转换为代码以浏览其数据。

带有代码建议的VSCode UI和突出显示的GitHub Copilot图标。

TIP
如果要为特定文件或语言禁用Copilot,请选择状态栏中的图标并禁用它。

接受完整的或部分重影文本建议 accept-suggestions

当GitHub Copilot建议代码完成时,您可以接受部分或完整的建议。 选择​ Tab ​接受整个建议,或按住​ Control(或Mac上的Command) ​并按​ 向右箭头 ​接受部分文本。 若要取消建议,请按​ Escape

TIP
如果未获得建议,请确保以文件的语言🔗启用Copilot 。

在VS Code编辑器中,部分键入的代码旁边显示GitHub Copilot的灰色文本建议为Ghost Text。

替代建议 alternative-suggestions

若要循环显示替代代码建议,请在Copilot对话框中选择箭头。

显示Copilot替代建议面板的VS Code编辑器。

使用内联聊天 inline-chat

您还可以直接与Copilot聊天有关您的代码。 使用​ Control(或Command) + I ​触发内联聊天对话框。 此功能用于循环处理您的代码并在上下文中优化建议。 您可以突出显示代码块,并在接受之前使用内联聊天查看AI提出的其他解决方案。

具有差异视图的内联聊天窗口

专用聊天视图 dedicated-chat

您可以使用更传统的聊天界面和专用的聊天侧边栏来形成想法和策略、解决编码问题并讨论实施详细信息。 选择聊天图标( Copilot聊天图标。VS Code侧边栏中的 )打开专用聊天窗口。

突出显示聊天图标的GitHub Copilot聊天边栏。

您还可以通过选择历史记录图标( 历史记录图标)来访问聊天历史记录。 )。

后续步骤

您现在可以从代码编辑器高效地直接查询Experience Platform数据库,并使用GitHub Copilot的AI支持的代码建议来简化编写和优化SQL查询。 有关如何编写和运行查询的详细信息,请参阅查询执行的指南

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