# Apache Derby 数据库

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

Procedure: 启用 数据库工具和 SQL 插件

此功能依赖于 数据库工具和 SQL 插件，该插件默认情况下在 IntelliJ IDEA 中绑定并启用。 如果相关功能不可用，请确保您没有禁用插件。

> **Note:**
> 没有 Ultimate 订阅时，数据库工具和 SQL 的功能支持在 IntelliJ IDEA 中受限。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  数据库工具和 SQL  插件并点击   启用  。

Procedure: 官方文档和软件

* 有关 Apache Derby 数据库 的完整信息，请参阅 [官方文档](https://db.apache.org/derby/)。

* 要下载 Apache Derby 数据库 数据库软件，请参阅 [官方软件下载](https://db.apache.org/derby/derby_downloads.html)。

支持的 DBMS 版本：10。

### 开始之前

本主题介绍了如何在 IntelliJ IDEA 中为 [连接](connecting-to-a-database.html)到 Apache Derby 数据库 数据库创建数据源并运行测试连接的一般过程。 假设您已经拥有必要的连接详细信息，并且数据库已启动并运行。

例如，如果您想在您的机器上运行数据库并连接到该数据库，则必须首先在机器上安装相应的 DBMS 软件。

要了解您的 DBMS 软件，请参阅其 [官方文档](#official_information_links)。

Procedure: 连接到 Apache Derby 数据库

要连接到数据库，请创建一个数据源以存储您的连接详细信息。

1. 选择您要创建的数据源。 您可以通过以下方式执行此操作：

* 在主菜单中，前往 `文件 | 新建 | 数据源` 并选择 Apache Derby 数据库 。

* 在 数据库 工具窗口中，点击工具栏上的 ![新建图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 新建 。 导航到 数据源 并选择 Apache Derby 数据库 。

![创建一个新的数据源](https://resources.jetbrains.com/help/img/idea/2026.3/create_new_data_source.png)

2. 在   常规   选项卡的   数据源和驱动程序   对话框右侧窗格中，指定驱动程序和连接类型。

1.

从   驱动程序   列表中，选择用于连接的 JDBC 驱动程序。

对于 Apache Derby 数据库来说，支持的驱动程序有   Apache Derby 数据库（嵌入式）  和   Apache Derby 数据库（远程）  。 有关 Apache Derby 数据库 数据库的更多信息，请参阅官方文档： [内嵌数据库](https://db.apache.org/derby/papers/DerbyTut/embedded_intro.html)、 [远程数据库](https://db.apache.org/derby/papers/DerbyTut/ns_intro.html)。

2.

从   连接类型  列表中，根据您拥有的连接详情选择连接类型：

适用于 Apache Derby（嵌入式）的连接类型
: * 嵌入式 ：使用数据库文件夹的路径进行连接。
:
: * 内存中 ：连接到完全存储在主内存中的临时数据库。
:
: * 仅限 URL ：仅使用 URL 进行连接。

Apache Derby（远程）的连接类型
: * 默认 ：使用 主持人 、 端口 、 数据库 和 URL 连接。
:
: * 仅限 URL ：仅使用 URL 进行连接。

对于   仅限 URL   [连接类型](data-sources-and-drivers-dialog.html#connection_type)，您输入的 JDBC URL 会被原样使用，包括数据库凭据。

> **Note:**
> 对于   仅限 URL   连接类型，JDBC URL 以纯文本形式存储，并且也可以在 [IDE 日志文件](troubleshooting-materials.html#locate-ide-log) 和 [数据源信息](managing-data-sources.html#share-data-sources-between-different-ide-instances) 中找到。

对于其他连接类型，JDBC URL 被分解为连接详细信息。 您可以分别指定它们并使用自动生成的 URL，或者直接在对应字段中输入 URL。

![数据源和驱动程序对话框的常规选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_general_tab.png)

3. 请检查连接设置区域底部是否有一个   下载缺少的驱动程序文件   链接。 点击此链接下载与数据库交互所需的驱动程序。 如需直接下载链接，请参考 [JetBrains JDBC drivers](https://www.jetbrains.com/zh-cn/datagrip/jdbc-drivers/)页面。

![下载缺失的驱动文件链接](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_download_missing_drivers_link.png)

下载的 JDBC 驱动程序的位置是 [IntelliJ IDEA 配置目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#config-directory)。

您也可以使用自己的数据库驱动程序，而不是提供的那些。 要了解有关使用驱动程序连接到数据库的更多信息，请参阅 [将用户驱动程序添加到现有连接中](jdbc-drivers.html#configure_a_jdbc_driver_for_an_existing_data_source)。

如果没有   下载缺少的驱动程序文件   链接，则表示您已经拥有所需的驱动程序。

4. 请指定数据库连接详情。 或者，粘贴 JDBC URL 到   URL   字段中。

Apache Derby（内嵌）的连接类型和设置
: 默认:
:
:
: 1.  在   路径   中输入数据库文件或文件夹的路径。 或者，点击   打开   图标 ( ![打开按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg))，并导航到它。
:
: 2.
:
: 从   身份验证   下拉列表中，选择您想要用于验证连接的身份验证方法。 有以下选项：
:
:
:
: * 用户 & 密码 ：使用您的登录名和密码。
:
: * 无认证 ：不需要身份验证。
:
:
:
: 3.
:
: 在   用户  和   密码  字段中，输入您的用户凭证。
:
:
:
: 要使用无密码，请将   密码  字段留空。
:
:
:
: 要删除曾经输入的密码，请右键点击   密码  字段并选择   设置为空  。
:
:
:
: !["设置为空"上下文菜单操作](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_password_set_empty.png)
:
: 4.
:
: 选中   创建数据库   复选框以创建新数据库并连接到它。
:
:
:
: 有关详细信息，请参阅 [特定于 DBMS 的“常规”选项卡参考](#reference)。
:
:
:
: 5.
:
: 在   URL  字段中，IntelliJ IDEA 将根据其他连接设置的值自动生成 JDBC URL。
:
:
:
: 如果您需要使用带有某些附加设置的 JDBC URL，请将其粘贴到   URL   字段中。 通常使用的 URL 如下：
:
:
:
: * 格式： `jdbc:derby:<path_to_the_file_or_folder>`
:
: * 示例： `jdbc:derby:myDatabase`
:
:
:
: 有关 URL 格式的更多信息，请参阅 [Apache Derby 数据库 官方文档](https://db.apache.org/derby/docs/10.16/devguide/cdevdvlp34964.html)。
:
:
:
:
:
: ![数据库连接详情](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_details_derby_emb_default.png)
:
: 内存中:
:
:
: 1.  在   路径   中输入数据库文件或文件夹的路径。 或者，点击   打开   图标 ( ![打开按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg))，并导航到它。
:
: 2.
:
: 从   身份验证   下拉列表中，选择您想要用于验证连接的身份验证方法。 有以下选项：
:
:
:
: * 用户 & 密码 ：使用您的登录名和密码。
:
: * 无认证 ：不需要身份验证。
:
:
:
: 3.
:
: 在   用户  和   密码  字段中，输入您的用户凭证。
:
:
:
: 要使用无密码，请将   密码  字段留空。
:
:
:
: 要删除曾经输入的密码，请右键点击   密码  字段并选择   设置为空  。
:
:
:
: !["设置为空"上下文菜单操作](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_password_set_empty.png)
:
: 4.
:
: 选中   创建数据库   复选框以创建新数据库并连接到它。
:
:
:
: 有关详细信息，请参阅 [特定于 DBMS 的“常规”选项卡参考](#reference)。
:
:
:
: 5.
:
: 在   URL  字段中，IntelliJ IDEA 将根据其他连接设置的值自动生成 JDBC URL。
:
:
:
: 如果您需要使用带有某些附加设置的 JDBC URL，请将其粘贴到   URL   字段中。 通常使用的 URL 如下：
:
:
:
: * 格式： `jdbc:derby:memory:<path_to_the_file_or_folder>`
:
: * 示例： `jdbc:derby:memory:myDatabase`
:
:
:
: 有关 URL 格式的更多信息，请参阅 [Apache Derby 数据库 官方文档](https://db.apache.org/derby/docs/10.16/devguide/cdevdvlp34964.html)。
:
:
:
:
:
: ![数据库连接详情](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_details_derby_emb_inmemory.png)
:
: 仅限 URL:
:
:
: 1.
:
: 从   身份验证   下拉列表中，选择您想要用于验证连接的身份验证方法。 有以下选项：
:
:
:
: * 用户 & 密码 ：使用您的登录名和密码。
:
: * 无认证 ：不需要身份验证。
:
:
:
: 2.
:
: 在   用户  和   密码  字段中，输入您的用户凭证。
:
:
:
: 要使用无密码，请将   密码  字段留空。
:
:
:
: 要删除曾经输入的密码，请右键点击   密码  字段并选择   设置为空  。
:
:
:
: !["设置为空"上下文菜单操作](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_password_set_empty.png)
:
: 3.
:
: 在   URL  字段中，IntelliJ IDEA 将根据其他连接设置的值自动生成 JDBC URL。
:
:
:
: 如果您需要使用带有某些附加设置的 JDBC URL，请将其粘贴到   URL   字段中。
:
:
:
: 有关 URL 格式的更多信息，请参阅 [Apache Derby 数据库 官方文档](https://db.apache.org/derby/docs/10.16/devguide/cdevdvlp34964.html)。
:
:
:
: > **Warning:**
: > 对于   仅限 URL   连接类型，   URL   字段的内容将以明文形式存储，同时也会在 [IDE 日志文件](troubleshooting-materials.html#locate-ide-log) 和 [数据源设置文件](managing-data-sources.html#locate_the_datasources_xml_file) 中可见。
: >
: >
: >
: > 使用指定的字段提供您的敏感连接详细信息，而不是将它们放入   URL   字段中。
:
:
:
:
:
: ![数据库连接详情](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_details_derby_emb_urlonly.png)

Apache Derby 的连接种类和设置（远程）
: 默认:
:
:
: 1.  在   主持人   字段中，输入您的服务器地址。
:
: 2.
:
: 在   端口   字段中，输入 Apache Derby 数据库 的端口。 默认端口为 1527。
:
:
:
: > **Note:**
: > 在您的系统上，实际端口号可能会有所不同。 请与您的数据库管理员、服务器设置或托管服务提供商核实您使用的端口号是否正确。
:
:
:
: 3.
:
: 从   身份验证   下拉列表中，选择您想要用于验证连接的身份验证方法。 有以下选项：
:
:
:
: * 用户 & 密码 ：使用您的登录名和密码。
:
: * 无认证 ：不需要身份验证。
:
:
:
: 4.
:
: 在   用户  和   密码  字段中，输入您的用户凭证。
:
:
:
: 要使用无密码，请将   密码  字段留空。
:
:
:
: 要删除曾经输入的密码，请右键点击   密码  字段并选择   设置为空  。
:
:
:
: !["设置为空"上下文菜单操作](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_password_set_empty.png)
:
: 5.  在   数据库  字段中，输入您要连接的数据库名称。
:
: 6.
:
: 在   URL  字段中，IntelliJ IDEA 将根据其他连接设置的值自动生成 JDBC URL。
:
:
:
: 如果您需要使用带有某些附加设置的 JDBC URL，请将其粘贴到   URL   字段中。 通常使用的 URL 如下：
:
:
:
: * 格式： `jdbc:derby://<host_address>:<port_number>/<database_name>`
:
: * 示例： `jdbc:derby://127.0.0.1:1527/myDatabase`
:
:
:
:
:
: ![数据库连接详情](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_details_derby_rem_default.png)
:
: 仅限 URL:
:
:
: 1.
:
: 从   身份验证   下拉列表中，选择您想要用于验证连接的身份验证方法。 有以下选项：
:
:
:
: * 用户 & 密码 ：使用您的登录名和密码。
:
: * 无认证 ：不需要身份验证。
:
:
:
: 2.
:
: 在   用户  和   密码  字段中，输入您的用户凭证。
:
:
:
: 要使用无密码，请将   密码  字段留空。
:
:
:
: 要删除曾经输入的密码，请右键点击   密码  字段并选择   设置为空  。
:
:
:
: !["设置为空"上下文菜单操作](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_password_set_empty.png)
:
: 3.
:
: 在   URL  字段中，IntelliJ IDEA 将根据其他连接设置的值自动生成 JDBC URL。
:
:
:
: 如果您需要使用带有某些附加设置的 JDBC URL，请将其粘贴到   URL   字段中。 通常使用的 URL 如下：
:
:
:
: * 格式： `jdbc:derby://<host_address>:<port_number>/<database_name>`
:
: * 示例： `jdbc:derby://127.0.0.1:1527/myDatabase`
:
:
:
: > **Warning:**
: > 对于   仅限 URL   连接类型，   URL   字段的内容将以明文形式存储，同时也会在 [IDE 日志文件](troubleshooting-materials.html#locate-ide-log) 和 [数据源设置文件](managing-data-sources.html#locate_the_datasources_xml_file) 中可见。
: >
: >
: >
: > 使用指定的字段提供您的敏感连接详细信息，而不是将它们放入   URL   字段中。
:
:
:
:
:
: ![数据库连接详情](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_details_derby_rem_urlonly.png)

有关在   常规   和其他   数据源和驱动程序   对话框选项卡（ `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) ）上的连接设置与属性的参考信息，请参见 [连接设置和 DBMS 特定属性](#reference)。

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

![测试连接链接](https://resources.jetbrains.com/help/img/idea/2026.3/db_test_connection_link.png)

如果您遇到任何连接问题，请参考 [无法连接到数据库](connectivity-problems.html)页面。

6. （可选）默认情况下，仅默认模式会被内省并可供使用。 如果您还想使用其他模式，请在   架构   选项卡中选择它们以进行内省。

![数据源和驱动程序对话框的 Schemas 选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_schemas_tab.png)

7. 点击   OK   创建数据源。

8. 在   数据库   工具窗口中找到您的新数据源。

* 有关 数据库 工具窗口的更多信息，请参见相应的 [参考主题](database-tool-window.html)。 > **Tip:** > 要在新数据源节点下查看更多模式，请点击 第 N 个，共 M 个 按钮并选择您需要的模式。 IntelliJ IDEA 将进行内省并显示它们。 > > > > ![选择数据库和架构以在数据库工具窗口中进行自省和显示](https://resources.jetbrains.com/help/img/idea/2026.3/connection_flow_show_databases_and_schemas.png)

* 有关在 IntelliJ IDEA 中使用数据库对象的更多信息，请参考 [数据库对象](database-objects.html)。

* 要编写并运行查询，请通过点击数据源并按下 `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) 打开默认的 [查询控制台](query-consoles.html)。

* 若要查看和编辑数据库对象的数据，请双击该对象以打开 [数据编辑器和查看器](data-editor-and-viewer.html)。

## 连接设置和 DBMS 特定属性

### 连接设置

有关   数据源和驱动程序   对话框（ `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS))）中   常规   及其他选项卡上的连接设置（例如，   主持人  、   端口   等）的参考信息，请参见 [数据源](data-sources-and-drivers-dialog.html#db)。

### 特定 DBMS 的属性

#### 常规选项卡

|  条目  |  描述  |  连接类型  |
| --- | --- | --- |
|  路径  |     数据库文件或文件夹的路径。     |     驱动程序：   Apache Derby 数据库（嵌入式）         连接类型：   默认  、   内存中       |
|  创建数据库  |     向 URL 添加实参以创建数据库。     |

## See also

### 参考

[数据源及其元素](database-tool-window.html#icons-for-data-sources-and-their-elements) [数据源和驱动程序对话框](data-sources-and-drivers-dialog.html)

### 工具 Windows

[数据库工具窗口](database-tool-window.html)

