DataGrip 2026.1 Help

在 Docker 容器中运行数据库

安装 Docker 插件

此功能依赖于 Docker 插件,您需要安装并启用它。

  1. Ctrl+Alt+S 打开设置,然后选择 Plugins

  2. 打开 Marketplace 选项卡,找到 Docker 插件,然后点击 安装 (如果提示,请重启 IDE)。

您可以使用 Docker 在容器中运行数据库。

在本教程中,您将学习如何运行带有 PostgreSQL 服务器的 Docker 容器,并使用 DataGrip 连接到它。

步骤 1。 拉取 PostgreSQL 服务器镜像

  1. 服务 工具窗口中,展开您的 Docker 连接并选择 镜像 节点。

  2. 要拉取的镜像 字段中,开始输入 postgres 并选择所需的镜像存储库。 例如,选择 postgres 来提取默认 postgres:latest 图像。

    获取带有 PostgreSQL 的 Docker 镜像
  3. Ctrl+Enter 并等待 Docker 拉取镜像。

步骤 2。 从 PostgreSQL 服务器镜像运行容器

  1. 展开 镜像 节点,选择 PostgreSQL 服务器图像,然后点击 创建容器按钮创建容器

    选择 PostgreSQL 映像并点击创建容器
  2. 创建Docker 配置 对话框内,点击 修改选项(M) 并选择 随机发布所有暴露端口 ,将所有暴露的容器端口发布到主机接口。

  3. 点击 修改选项(M) 并选择 环境变量。 在出现的 环境变量 字段中,您可以为 PostgreSQL 认证配置环境变量。

    Docker postgresql modify options
  4. 点击 "浏览" 按钮浏览。 在打开的 环境变量 对话框中,点击 "添加"按钮Add ,并添加名为 POSTGRES_HOST_AUTH_METHOD 且值为 trust 的变量。

    环境变量对话框
  5. 名称容器名称 字段中,为配置(例如 PostgreSQL Container )和容器(例如 postgresql )指定自定义名称。

    创建 Docker 配置对话框
  6. 应用更改并点击 运行

DataGrip 会创建并启动一个新的 Docker 容器。 它将在 服务 工具窗口中的 容器 节点下显示。

运行已创建的 Docker 容器

步骤 3。 连接到 PostgreSQL 服务器

Docker 会自动将容器内的默认 PostgreSQL 服务器端口 5432 映射到 临时端口范围 (通常从 32768 到 61000)内的主机端口。 在本教程中,我们以端口 55000 为例。

  1. 通过以下任一方式打开数据源属性:

    • 请导航至 文件(F) | 数据源

    • 数据库资源管理器⌘ 1 )工具栏上,点击 数据源图标数据源

    • 请按 Ctrl+Alt+Shift+S.

    打开数据源和驱动程序对话框
  2. 数据源和驱动程序 对话框中,点击 Add 图标 ("添加"图标 ),然后选择 PostgreSQL

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

    下载缺失的驱动文件链接

    下载的 JDBC 驱动程序的位置是 DataGrip 配置目录

    您还可以使用自己的数据库驱动程序,而不是提供的驱动程序。 有关使用驱动程序连接到数据库的更多信息,请参阅 将用户驱动程序添加到现有连接

    如果没有 下载缺失的驱动程序文件 链接,那么您已经拥有了所需的驱动程序。

  4. 请将主机名设置为 localhost ,端口号设置为 55000 (或映射到的任意主机端口),默认数据库和用户为 postgres。 我们使用了 trust 身份验证来运行 PostgreSQL 服务器,因此不需要密码。

  5. 确保可以使用提供的详细信息建立数据库连接。 为此,请点击连接详细信息部分底部的 测试连接 链接。

    测试连接链接

    如果您遇到任何连接问题,请参考 无法连接到数据库 页面。

  6. (可选)默认情况下,仅默认数据库和架构会被内省并可供使用。 如果您还想使用其他数据库和架构,请在 架构 选项卡中选择它们以进行内省。

    数据源和驱动程序对话框的 Schemas 选项卡
  7. 请点击 确定 以创建数据源。

成功测试连接到 PostgreSQL 数据源

步骤 4。 使用您的数据库

  • 一旦数据库在容器中运行,您就可以开始使用它。

    1. 有关在 DataGrip 中操作数据库对象的更多信息,请参阅 数据库对象

    2. 要编写并运行查询,请通过点击数据源并按下 F4 打开默认的 查询控制台

    3. 要查看和编辑数据库对象的数据,请双击该对象以打开 数据编辑器和查看器

    4. 要了解有关在 DataGrip 中导入和运行转储文件的信息,请参阅 Import导入 SQL 转储文件

PostgreSQL 数据库正在 Docker 中运行

摘要

在本教程中,您已学会如何:

  • 拉取并管理 Docker 镜像

  • 从 DBMS(如 PostgreSQL)镜像配置并运行容器

  • 建立 DataGrip 与容器中运行的数据库之间的连接

2026年 3月 24日