# 使用 unix sockets 创建 MySQL 数据源

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

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

此功能依赖于 数据库工具和 SQL 插件，该插件在 CLion 中默认捆绑并启用。 如果相关功能不可用，请确保您未禁用该插件。

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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

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

在 Unix 上，您可以通过两种不同的方式连接到 mysqld 服务器：一种是通过 Unix 套接字文件（例如，  `/var/run/mysqld/mysqld.sock` ），另一种是通过 TCP/IP（例如，  `127.0.0.1:3306` ）。 使用 Unix 套接字文件创建的连接比 TCP/IP 更快，但只能在连接到同一台计算机上的服务器时使用。 当您使用 Unix socket 文件时，可以在连接字符串中省略主机名和端口。

## 先决条件

* 仅限 Linux

* Junixsocket JAR 文件： [the junixsocket repository at github.com](https://github.com/kohlschutter/junixsocket/releases)

* CLion 必须位于服务器运行的主机上（ [MySQL 8.0 Reference Manual at dev.mysql.com](https://dev.mysql.com/doc/refman/8.0/en/can-not-connect-to-server.html)）。

## 步骤 1。 查找 Unix 套接字文件

Procedure:

1. 在服务器主机的命令行中，运行以下命令：

```CONSOLE
mysql -u root -p -h 127.0.0.1 -e "select @@socket"
```

2. 请输入 您的  `root`  用户的密码，然后按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

![查找 Unix 套接字文件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_tutorial_unix_sockets_check_sockets.png)

## 步骤 2。 从命令行检查 Unix socket 连接

Procedure:

1. 在命令行中，运行以下命令：  `mysql -u root -p -S /var/run/mysqld/mysql.sock` 。

2. 请输入 您的  `root`  用户的密码，然后按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

![从命令行检查 Unix socket 连接](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_tutorial_unix_sockets_check_connection.png)

## 步骤 3。 下载第三方库

Connector/J 驱动程序本身不支持通过 Unix 域套接字与 MySQL 服务器建立连接。 要启用套接字连接，您需要下载第三方库。 有关此限制的更多信息，请参阅 [Connecting Using Unix Domain Sockets at dev.mysql.com](https://dev.mysql.com/doc/connector-j/8.0/en/connector-j-unix-socket.html)。

Procedure:

1. 从 [github.com 上的 junixsocket 仓库](https://github.com/kohlschutter/junixsocket/releases)下载最新版本（例如，  `junixsocket-dist-2.3.2-bin.tar.gz` ）。

2. 解压缩下载的档案。 您需要将  `lib`  目录中的以下文件添加到 MySQL 驱动程序的 CLion：

* `junixsocket-mysql-2.3.2.jar`

* `junixsocket-native-common-2.3.2.jar` ，如果您有自定义架构，请尝试 `junixsocket-native-custom-2.3.2.jar`

* `junixsocket-core-2.3.2.jar`

* `junixsocket-common-2.3.2.jar`

## 步骤 4。 在 CLion 中配置 MySQL 驱动程序

Procedure:

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

* 在 数据库 工具窗口工具栏上，点击 ![数据源图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) 数据源 。

* 请按 `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)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) .

![打开数据源和驱动程序对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png)

2. 在   驱动程序  部分，点击   MySQL  驱动程序并点击   重复  按钮 ![重复按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.copy.svg)。 或者按 `Ctrl+D` (Windows), `⌘ D` (macOS), `⌘ D` (IntelliJ IDEA Classic (macOS)), `⌘ D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Meta+D` (Emacs), `Ctrl+Shift+D` (Sublime Text), `⌘ ⇧ D` (Sublime Text (macOS)), `⌘ D` (Xcode), `Ctrl+D` (Visual Studio), `⌘ D` (Visual Studio (macOS)), `Ctrl+D` (ReSharper), `⌘ D` (ReSharper (macOS)), `Ctrl+D` (QtCreator), `⌘ D` (QtCreator (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Eclipse), `Ctrl+D` (Eclipse (macOS))。

3. 将重复的驱动程序名称更改为其他名称（例如，   MySQL 套接字  ）。

4. 在   通用  选项卡上，点击   Add  按钮（ ![添加按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)），然后选择   自定义 JARs  。

5. 在文件浏览器中，导航到包含第三方库的文件夹（请参阅 [第 3 步](#step-3-download-third-party-libraries)）。 按住 `Ctrl` (Windows), `Ctrl` (macOS), `Ctrl` (IntelliJ IDEA Classic (macOS)), `Ctrl` (macOS System Shortcuts), `Ctrl` (XWin), `Ctrl` (GNOME), `Ctrl` (KDE), `Ctrl` (Emacs), `Ctrl` (Sublime Text), `Ctrl` (Sublime Text (macOS)), `Ctrl` (Xcode), `Ctrl` (Visual Studio), `Ctrl` (Visual Studio (macOS)), `Ctrl` (ReSharper), `Ctrl` (ReSharper (macOS)), `Ctrl` (QtCreator), `Ctrl` (QtCreator (macOS)), `Ctrl` (NetBeans), `Ctrl` (Eclipse), `Ctrl` (Eclipse (macOS))，选择以下文件：

* `junixsocket-mysql-2.3.2.jar`

* `junixsocket-native-common-2.3.2.jar` ，如果您有自定义架构，请尝试 `junixsocket-native-custom-2.3.2.jar`

* `junixsocket-core-2.3.2.jar`

* `junixsocket-common-2.3.2.jar`

6. 点击   确定  。

7. 在   高级  选项卡上，找到   socketFactory  属性，双击   Value  单元格，并将值更改为  `org.newsclub.net.mysql.AFUNIXDatabaseSocketFactory` 。

![更改 socketFactory 属性](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_tutorial_unix_sockets_socketfactory.png)

8. 请向下滚动到属性列表的末尾，双击   <用户定义>>  单元格并输入  `junixsocket.file` 。 双击   Value   单元格并输入您的 socket 文件路径（请参阅 [步骤 1](#step-1-locate-a-unix-socket-file)）。

![添加 junixsocket.file 属性](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_tutorial_unix_sockets_junixsocket_file.png)

9. 点击   Apply  。

## 步骤 5。 创建与 MySQL 服务器的连接

Procedure:

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

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

* 在主菜单中，前往 `文件｜新建｜数据源​` 并选择 MySQL 。

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

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

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

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

下载的 JDBC 驱动程序的位置是 [CLion 配置目录](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)。

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

3. 在   高级  选项卡上，从选项列表中找到  `serverTimezone` 参数。 双击   Value  单元格并输入您的服务器时区（例如，  `UTC` ）。

4. 点击   通用  选项卡。

5. 从   驱动程序   列表中，选择您之前创建的驱动程序（请参阅 [步骤 4](#step-4-configure-the-mysql-driver-in-ide)）。

6. 在   用户   和   密码   字段中，指定您的用户凭据。

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

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

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

8. （可选）默认情况下，仅检查默认架构并可供使用。 如果您还想使用其他架构，请在   架构   选项卡中选择它们以进行检查。

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

9. 点击   确定   创建数据源。

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

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

* 有关在 CLion 中使用数据库对象的更多信息，请参阅 [数据库对象](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)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))，以打开默认的 [查询控制台](query-consoles.html)。

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

## See also

### 参考

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

### 工具窗口

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

