PostgreSQL
官方文档与软件
准备开始
本文介绍如何在 WebStorm 中为 连接 到您的 PostgreSQL 数据库创建数据源,并运行测试连接的一般流程。 假设您已具备必要的连接详细信息,且数据库正在运行。
例如,若要在本机运行数据库并连接到该数据库,必须先在计算机上安装相应的 DBMS 软件。
要了解您的 DBMS 软件,请参阅其 官方文档。
连接到 PostgreSQL 数据库
要连接到数据库,请创建数据源以存储您的连接详细信息。
选择您要创建的数据源。 您可以通过以下任一方式进行:
在主菜单中,转到 ,然后选择 PostgreSQL。
在 数据库 工具窗口中,点击工具栏上的
新建。 导航至 数据源 ,然后选择 PostgreSQL。

在 常规 选项卡的 数据源和驱动程序 对话框右侧,指定驱动程序和连接类型。
在 驱动程序 列表中,保留默认驱动选项,除非连接需要其他驱动。
在 连接类型 列表中,根据您的连接详细信息选择连接类型:
默认 :通过 主机、 端口、 数据库 和 URL 连接。
仅限 URL :仅通过 URL 进行连接。
对于 仅限 URL 连接类型 ,使用并保留您输入的 JDBC URL(包括数据库凭据)。
对于其他连接类型,JDBC URL 会被分解为连接详细信息。 您可以单独指定这些信息并使用自动生成的 URL,也可以直接在对应字段中输入 URL。

检查连接设置区域底部是否存在 下载缺失的驱动程序文件 链接。 点击此链接以下载与数据库交互所需的驱动。 有关直接下载链接,请参阅 JetBrains JDBC 驱动 页面。

JDBC 驱动的下载位置为 WebStorm 配置目录。
您也可以使用自己的数据库驱动,而不是提供的驱动。 有关使用您自己的驱动连接数据库的详细信息,请参阅 将用户驱动添加到现有连接。
如果没有 下载缺失的驱动程序文件 链接,说明您已经具备所需的驱动。
指定数据库连接详细信息。 或者,也可以将 JDBC URL 粘贴到 URL 字段中。
在 主机 字段中输入服务器地址。
在 端口 字段中输入 PostgreSQL 的端口号。 默认端口为 5432。
从 身份验证 下拉列表中选择用于验证连接的身份验证方式。 可用的选项包括:
pgpass :使用 pgpass 文件。 此文件可存储在用户的主目录中。 您可以在 postgresql.org 的密码文件页面 阅读有关密码文件及其位置的更多信息。
用户与密码 :使用登录名和密码进行身份验证。
无身份验证 :不需要身份验证。
在 用户 和 密码 字段中输入您的用户凭据。
如无需密码,请将 密码 字段留空。
如需删除已输入的密码,请右键单击 密码 字段并选择 设为空。

在 数据库 字段中输入要连接的数据库名称。
在 URL 字段中,WebStorm 会根据其他连接设置的值自动生成 JDBC URL。
如需使用包含特定附加设置的 JDBC URL,请将其粘贴到 URL 字段中。 要使用的通用 URL 格式如下:
格式:
jdbc:postgresql://<host_address>:<port_number>/<database_name>示例:
jdbc:postgresql://127.0.0.1:5432/myDatabase
有关 URL 格式的更多信息,请参阅 PostgreSQL 官方文档。

从 身份验证 下拉列表中选择用于验证连接的身份验证方式。 可用的选项包括:
用户与密码 :使用登录名和密码进行身份验证。
无身份验证 :不需要身份验证。
在 用户 和 密码 字段中输入您的用户凭据。
如无需密码,请将 密码 字段留空。
如需删除已输入的密码,请右键单击 密码 字段并选择 设为空。

在 URL 字段中,WebStorm 会根据其他连接设置的值自动生成 JDBC URL。
如需使用包含特定附加设置的 JDBC URL,请将其粘贴到 URL 字段中。
有关 URL 格式的更多信息,请参阅 PostgreSQL 官方文档。

有关 常规 选项卡及 数据源和驱动程序 对话框(Shift+Enter )中连接设置和属性的参考信息,请参阅 连接设置与特定 DBMS 属性。
请确保能使用提供的信息建立数据库连接。 为此,请单击连接详细信息部分底部的 测试连接 链接。

如遇连接问题,请参阅 无法连接到数据库 页面。
(可选)默认情况下,仅对默认数据库和架构执行反向工程并可用于操作。 如需使用其他数据库和架构,请在 架构 选项卡中选择它们以进行反向工程。

单击 确定 以创建数据源。
在 数据库 工具窗口中找到新建的数据源。
Kerberos 认证
在使用 Kerberos 身份验证连接 PostgreSQL 数据库前,请通过命令提示符或 终端 运行 Kerberos 命令,确认您已拥有身份验证票据。
如果您的计算机上存在票据缓存文件且
useTicketCache设置为true,请运行klist命令。 请确保您的票据包含在缓存列表中。如果您的计算机未启用票据缓存,请执行以下操作:
运行
klist命令,并确保其列出了您的票据。如果您的身份验证票据未出现在列表中,请使用您的用户名运行
kinit命令从服务器获取票据:kinit <username>。 系统提示时请输入密码。
有关 Kerberos 票据的更多信息,请参阅 Kerberos 网站。
在 Windows 上配置数据源之前,还请检查操作系统是否具有 krb5.ini Kerberos 配置文件 ,并相应配置数据源。
要将 PostgreSQL 数据源配置为使用 Kerberos 身份验证,请执行以下步骤:
创建以下
/etc/jaas.conf配置文件:pgjdbc { com.sun.security.auth.module.Krb5LoginModule required useTicketCache=true debug=true renewTGT=true doNotPrompt=true; };打开 数据源和驱动程序 对话框(Shift+Enter ),选择您的数据源,并导航至 高级 选项卡。
在 VM 选项 字段中输入以下内容:
-Djava.security.auth.login.config=/etc/jaas.conf
单击 确定 保存更改并关闭对话框。
打开 数据源和驱动程序 对话框(Shift+Enter ),选择您的数据源,并导航到 高级 选项卡。
在属性表中,向下滚动至最后一行,将
gsslib输入为 名称 ,将sspi输入为 值。
或者,您也可以在 常规 选项卡中,将 gsslib=sspi 添加到 URL 字段中的数据库 JDBC URL。
如遇连接问题,请执行以下操作:
通过将在 高级 选项卡的 VM 选项 字段中添加
-Dsun.security.krb5.debug=true,启用调试日志。单击 测试连接。
定位 idea.log 文件 ,并将其附加到您的 支持请求中。
连接设置与特定 DBMS 属性
连接设置
有关 数据源和驱动程序 对话框的 常规 及其他选项卡中连接设置(例如, 主机、 端口 等)的参考信息,请参阅 数据源 (Shift+Enter)。
特定 DBMS 属性
“架构”选项卡
项目 | 描述 |
|---|---|
显示内部系统架构 | 显示 pg_temp 或 p_toast 等内部系统架构。 |
显示模板数据库 | 显示模板数据库。 |