DataGrip 2025.2 Help

版本控制系统中的数据库

DDL data source 是一个基于包含数据定义语言语句(DDL 语句)的 SQL 文件的数据库结构的虚拟视图。 您可以在编辑器中引用这些文件中定义的所有表、列和其他对象。 还支持图表。

将这些 SQL 文件存储在版本控制系统 (VCS) 中是一种将您的数据库置于 VCS 下的方式。

使用 VCS 的一般工作流程如下:

  1. 配置 VCS 集成。

    首先,您需要在 IDE 中启用并配置 VCS 集成。 这将允许您直接从 IDE 共享和应用更改。

    例如,我们将使用 Git 和 GitHub。

  2. 准备一个目录。

    启用 VCS 集成后,准备一个您将共享为存储库的目录。 您可以通过将现有存储库克隆到某个目录来完成此操作。 此目录还将是您的 DDL 数据源的根文件夹。

  3. 准备一个 DDL 数据源。

    然后,您需要通过将常规数据源(例如 SQLite)导出到准备好的目录来创建您的 DDL 数据源。

    在本教程中,我们将把一个常规数据源导出到一个作为存储库共享的空目录。

  4. 将常规数据源映射到 DDL 数据源。

    然后,您需要在常规数据源和 DDL 数据源之间创建一个映射。 您需要通过映射来设置您想要共享的内容。 例如,您几乎不需要共享所有系统或模板模式。 因此,您可以选择那些将与您的同事共享的模式。

  5. 共享您的 DDL 数据源。

    为了使您的常规数据源的数据库可以在 VCS 下使用,您需要将 DDL 数据源的 SQL 文件提交并推送到远程存储库。

  6. 根据您的需求,您可以导出更改并通过 VCS 共享它们,或者拉取更改并将其应用到您的数据源。 双向同步是通过 DDL 数据源完成的。

配置您的版本控制系统

启用 Git 插件

此功能依赖于 Git 插件,该插件默认在 DataGrip 中捆绑并启用。 如果相关功能不可用,请确保您未禁用该插件。

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

  2. 打开 已安装 选项卡,找到 Git 插件,并选中插件名称旁边的复选框。

安装 GitHub 插件

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

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

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

我们将使用 Git 作为版本控制系统,并使用 GitHub 作为存储库的存储位置。 要在 GitHub 上创建一个存储库,请按照 docs.github.com 上的创建存储库教程 中的步骤操作。

第一步,我们需要启用 VCS 插件并登录 GitHub。

步骤 1。 启用 JetBrains 的 VCS 插件

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

  2. 打开 已安装 选项卡。

  3. 在搜索字段中输入 Git ,然后按 Enter

  4. 选中 Git 插件名称旁边的复选框。

  5. 打开 Marketplace 选项卡。

  6. 安装并启用 GitHub 插件。

  7. 重启 IDE。

启用 JetBrains 的 VCS 插件

然后,您需要使用具有访问包含 DDL 数据源的存储库权限的用户帐户在 GitHub 上进行授权。

步骤 2。 登录 GitHub

  1. Ctrl+Alt+S 打开设置,然后选择 版本控制 | GitHub

  2. 点击 "添加"按钮

  3. 请选择 通过 GitHub 登录

  4. 在打开的浏览器窗口中输入您的 GitHub 凭证。 如果您启用了 two-factor authentication ,您将被要求输入一个将通过短信或移动应用程序发送给您的代码。

安装所有必要的插件后,您需要在 IDE 中启用 VCS 集成。

步骤 3。 启用版本控制集成

  1. 从主菜单中单击 Git(G) | 启用版本控制集成

  2. 启用版本控制集成 对话框中,确保列表中选择了 Git ,然后单击 确定

    启用版本控制集成

现在将存储库从 GitHub 克隆到您的本地计算机。

准备一个目录

  1. 点击 Git | Clone

  2. URL 字段中,输入您的存储库的 URL。 例如, https://github.com/JetBrainsUser/mySQLiteDDL.git

  3. 目录 字段中,单击 将目录附加到项目的图标 图标并指定存储库文件的目录。 例如, /Users/jetbrains/DataGripProjects/mySQLiteDDL

  4. 请点击 克隆

  5. 打开项目 对话框中,点击 附加(A)…

    存储库文件夹将出现在 个文件 工具窗口中。

    克隆存储库

准备一个 DDL 数据源

完成所有 VCS 配置后,您可以开始准备您的 DDL 数据源。

步骤 1。 将现有数据源导出为 DDL 数据源

  1. 数据库资源管理器 中,右键单击您想要转储到 DDL 数据源的数据源,然后选择 导入/导出 | 转储到DDL 数据源

    若要配置 DDL 数据源的代码设置,请参阅 配置 DDL 生成设置

  2. 数据源和驱动程序 对话框中,选择DDL数据源,然后点击 添加目录或DDL 文件

  3. 在文件浏览器中,导航到将存储数据源的 DDL 文件的目录,然后点击 打开

  4. 点击 确定

  5. 将文件添加到Git 对话框中,单击 添加(A) 将您的 DDL 数据源的 SQL 文件添加到 Git。

步骤 2。 添加 DDL 映射

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

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

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

    • 请按 Ctrl+Alt+Shift+S.

    打开数据源和驱动程序对话框
  2. 点击 DDL 映射 选项卡。

    或者,您可以通过右键单击 数据库资源管理器视图(V) | 工具窗口 | 数据库资源管理器 )中的数据源并选择 DDL 映射 | 创建 DDL 映射 来访问此选项卡。

  3. 点击 以获取 数据源

  4. 请选择 SQLite

  5. 点击 以获取 DDL 数据源

  6. 请选择 SQLite (DDL)

  7. 作用域 树中,选择将在映射中使用的模式或数据库(例如, main)。

  8. 如果出现 转储DDL 对话框,请单击 稍后

共享您的 DDL 数据源

为了使您的 DDL 数据源的 DDL 文件出现在远程存储库中,请提交并推送它们。

提交并推送您的 DDL 文件

  1. 通过单击主工具栏中的 更多工具窗口 图标并选择 提交 ,打开 提交 工具窗口。

  2. 提交 工具窗口中,选中 Changes 附近的复选框以选择所有更改。

  3. 输入提交信息。

  4. 要从 当前分支 推送更改,请按 Ctrl+Shift+K 或从主菜单中选择 Git | 推送

  5. 点击 推送(P)

    将您的 DDL 数据源提交并推送到 VCS

共享项目数据源的更改

如果您对数据源进行了更改并希望在 VCS 中共享,此工作流程可能会对您有所帮助。 例如,让我们向 SQLite 数据源添加一个新表(actor_1)。

向数据源添加一个新表(actor_1)

步骤 1。 从数据源更新 DDL 数据源

  • 数据库资源管理器 中,右键单击一个 DDL 数据源,然后选择 DDL 映射 | 从SQLite 更新

步骤 2。 将您的更改提交并推送到 VCS

  1. 打开位于左侧的垂直 Commit 工具窗口 Alt+0

  2. 当您的更改准备好提交时,请选择相应的文件或整个更改集。

    如果您按下 Ctrl+K ,整个活动的更改列表将被选中。

  3. 输入提交信息。 您可以单击 提交消息历史按钮 从最近的提交消息列表中进行选择。

  4. 要从 当前分支 推送更改,请按 Ctrl+Shift+K 或从主菜单中选择 Git | 推送

  5. 点击 推送(P)

    将您的更改提交并推送到 VCS

从 VCS 获取更改并将其应用到项目数据源

如果您尚未克隆存储库且必要的更改已存在,请克隆存储库, 创建一个 DDL 数据源 ,并 添加一个 DDL 映射。 然后继续执行 迁移过程

否则,请更新存储库的本地副本并迁移更改。

步骤 1。 从 VCS 更新项目

  • 选择更新类型(此策略将应用于所有处于 Git 版本控制下的根目录):

    • 将传入的更改合并到当前分支 :选择此选项以在更新期间执行 合并。 这相当于先运行 git fetch ,然后运行 git merge ,或 git pull --no-rebase

    • 将当前分支在传入更改之上重新基底 :选择此选项以在更新期间执行 rebase。 这相当于运行 git fetch 然后 git rebase ,或者 git pull --rebase (所有本地提交将会被放置在更新后的上游头部之上)。

如果您选择将来不显示 更新项目 对话框,然后想要稍后修改默认更新策略,请转到 版本控制 | 确认 设置页面  Ctrl+Alt+S ,选择 更新 位于 在之前显示选项 下,并在下次执行更新时修改更新策略。

当更新操作完成后, 更新信息选项卡会添加到 Git 工具窗口 Alt+9 中。 它列出了自上次与远程同步以来所做的所有提交,并让您像在 日志选项卡 中一样查看这些更改。

在 Git 工具窗口中更新项目

步骤 2。 迁移更改到数据源

  1. 数据库资源管理器 中,右键单击一个数据源,然后选择 SQL 脚本 | 从SQLite (DDL) 应用

  2. 迁移 对话框中,修改在 脚本预览 选项卡中生成的脚本。 只保留您计划执行的那些脚本。

  3. 点击 执行

    迁移更改到数据源

提高效率的提示

  • 文件的所有操作也适用于 DDL 数据源元素。 例如,您可以从 数据库资源管理器 删除、复制或提交与模式元素相关的文件。

    与文件相关的操作

当您更改相应文件时,自动刷新 DDL 数据源

  • 如果启用了 自动同步 选项,DDL 数据源将自动随着相应文件的更改而刷新。 这已经是默认行为,但现在您可以禁用它。

    当您更改相应文件时,刷新 DDL 数据源

初始搜索路径

  • 新建文件布局 选项卡上,您可以为数据库和模式定义名称,这些名称将在 DDL 数据源中显示。 DDL 脚本通常不包含名称,在这些情况下,默认情况下将为数据库和模式提供占位名称。

    默认模式/数据库
最后修改日期: 2025年 9月 26日