将DbVisualizer连接到Query Service connect-dbvisualizer

本文档介绍了将DbVisualizer数据库工具连接到Adobe Experience Platform Query Service的步骤。

快速入门

本指南要求您已具有对DbVisualizer桌面应用程序的访问权限,并且熟悉如何导航其界面。 要下载DbVisualizer桌面应用或了解详细信息,请参阅官方 DbVisualizer 文档

要获取将​ DbVisualizer连接到Experience Platform所需的凭据,您必须有权访问Platform UI中的查询工作区。 如果您当前无权访问查询工作区,请联系您的组织管理员。

创建数据库连接 connect-database

在本地计算机上安装了桌面应用程序后,请按照官方的BDVisualizer说明创建新的数据库连接

从Connections列表中选择​ PostgreSQL ​后,将显示新PostgreSQL连接的Object View选项卡。

为您的连接设置驱动程序属性 properties

从PostgreSQL对象视图选项卡中,选择​ Properties ​选项卡,然后从导航侧边栏中选择​ Driver Properties。 有关驱动程序属性的详细信息,请参阅官方文档。

接下来,输入下表所述的驱动程序属性。

IMPORTANT
要将DBVisualizer与Adobe Experience Platform连接,必须启用SSL。 请参阅SSL模式文档,了解对Adobe Experience Platform查询服务的第三方连接的SSL支持,以及如何使用verify-full SSL模式进行连接。
属性
描述
PGHOST
PostgreSQL服务器的主机名。 此值是您的Experience Platform 主机凭据
ssl
定义SSL值1以允许使用SSL。
sslmode
这将控制SSL保护的级别。 将第三方客户端连接到Adobe Experience Platform时,建议您使用require SSL模式。 require模式确保所有通信都需要加密,并且网络被信任可以连接到正确的服务器。 不需要验证服务器SSL证书。
user
连接到数据库的用户名是您的组织ID。 它是一个以@Adobe.Org结尾的字母数字字符串。 此值是您的Experience Platform 用户名凭据

使用搜索栏查找每个属性,然后为参数值选择相应的单元格。 单元格将以蓝色突出显示。 在值字段中输入您的Platform凭据,然后选择​ Apply ​以添加驱动程序属性。

NOTE
要添加第二个user配置文件,请从参数列中选择user,然后选择蓝色+ (加号)图标为每个用户添加凭据。 选择​ Apply ​以添加驱动程序属性。

Edited列显示一个复选标记,表示参数值已更新。

输入查询服务凭据 query-service-credentials

要查找连接BBVisualizer与查询服务所需的凭据,请登录到Platform UI并从左侧导航中选择​ 查询,然后依次选择​ 凭据。 有关查找​ 主机端口数据库用户名 ​和​ 密码 ​凭据的详细信息,请阅读凭据指南

Experience Platform查询工作区的“凭据”页面中突出显示了凭据和即将过期的凭据。

IMPORTANT
Query Service还提供未过期的凭据,以允许对第三方客户端进行一次性设置。 请参阅文档有关如何生成和使用未过期的凭据的完整说明。 如果您希望将BDVisualizer作为一次性设置进行连接,则必须完成此过程。 获得的credentialtechnicalAccountId值包含DBVisualizer password参数的值。

身份验证 authentication

要在每次建立连接时都要求用户ID和基于密码的身份验证,请导航到Properties选项卡,然后从PostgreSQL下的导航侧边栏中选择​ Authentication

在连接身份验证面板中,选中​ Require Userid ​和​ Require Password ​复选框,然后选择​ Apply。 有关设置身份验证选项的详细信息,请参阅官方文档。

连接到平台

您可以使用过期或不过期的凭据建立连接。 若要建立连接,请从PostgreSQL对象视图选项卡中选择​ Connection ​选项卡,然后为以下设置输入您的Experience Platform凭据。 官方DBVisualizer网站上提供了设置手动连接的补充说明。

NOTE
下表中的BDVisualizer所需的所有凭据对于过期凭据和不过期凭据都是相同的,除非在参数描述中有所说明。
连接参数
描述
名称
为您的连接创建名称。 建议您提供易于识别的名称以识别连接。
数据库服务器
这是您的Experience Platform 主机 ​凭据。
数据库端口
Query Service的端口。 您必须使用端口​ 80 ​或​ 5432 ​来连接Query Service。
数据库
使用您的Experience Platform 数据库 ​凭据值: prod:all
数据库用户ID
这是您的平台组织ID。 使用您的Experience Platform 用户名 ​凭据值。 ID将采用ORG_ID@AdobeOrg格式。
数据库密码
此字母数字字符串是您的Experience Platform 密码 ​凭据。 如果要使用未过期的凭据,此值是从JSON配置文件中下载的technicalAccountIDcredential中的连接参数。 密码值采用以下形式: {technicalAccountId}:{credential}。 未过期凭据的配置JSON文件是在其初始化期间的一次性下载,该Adobe不保留的副本。

输入所有相关凭据后,选择​ Connect

Connect对话框出现在会话的第一次。 输入用户ID和密码,然后选择​ Connect。 日志中将显示一条消息,确认连接成功。

后续步骤

现在您已将DbVisualizer与Query Service连接,可以使用DbVisualizer编写查询。 有关如何编写和运行查询的详细信息,请阅读有关查询执行🔗的指南。

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