JetBrains Rider 2026.2 Help

使用 unix sockets 创建 MySQL 数据源

启用 Database Tools and SQL 插件

此功能依赖于 Database Tools and SQL 插件,该插件在 JetBrains Rider 中默认捆绑并启用。 如果相关功能不可用,请确保没有禁用该插件。

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 插件。

  2. 打开 已安装 选项卡,找到 Database Tools and SQL插件,然后选中插件名称旁边的复选框。

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

前提

第 1 步. 查找 Unix 套接字文件

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

    mysql -u root -p -h 127.0.0.1 -e "select @@socket"
  2. 为您的 root 用户输入密码,然后按 Enter。

    查找 Unix 套接字文件

第 2 步. 从命令行检查 Unix socket 连接

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

  2. 为您的 root 用户输入密码,然后按 Enter。

    从命令行检查 Unix socket 连接

第 3 步. 下载第三方库

Connector/J 驱动程序本身不支持通过 Unix 域套接字与 MySQL 服务器建立连接。 要启用套接字连接,您需要下载第三方库。 有关此限制的更多信息,请参阅 Connecting Using Unix Domain Sockets at dev.mysql.com。

  1. 从 github.com 上的 junixsocket 仓库下载最新版本(例如, junixsocket-dist-2.3.2-bin.tar.gz )。

  2. 解压缩已下载的归档。 您需要将 lib 目录中的以下文件添加到 MySQL 驱动程序的 JetBrains Rider:

    • 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。 在 JetBrains Rider 中配置 MySQL 驱动程序

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

    • 在 数据库 工具窗口工具栏上,点击 数据源图标数据源。

    • 请按 Shift+Enter.

    打开数据源和驱动程序对话框
  2. 在 驱动程序 部分,点击 %mysql% 驱动程序并点击 复制 按钮 重复按钮。 或者按 Ctrl+D。

  3. 将重复的驱动程序名称更改为其他名称(例如, %mysql% 套接字)。

  4. 在 通用 选项卡上,点击 添加 按钮("添加"按钮 ),然后选择 自定义 JARs。

  5. 在文件浏览器中,导航到包含第三方库的文件夹(请参阅 第 3 步)。 按住 Ctrl ,选择以下文件:

    • 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 属性,双击 值 单元格,并将值更改为 org.newsclub.net.mysql.AFUNIXDatabaseSocketFactory。

    更改 socketFactory 属性
  8. 请向下滚动到属性列表的末尾,双击 <user defined> 单元格并输入 junixsocket.file。 双击 值 单元格并输入您的 socket 文件路径(请参阅 步骤 1)。

    添加 junixsocket.file 属性
  9. 单击 Apply。

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

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

  1. 在 数据库 工具窗口中,点击 新图标新建 并选择 连接到数据库。

  2. 如果您的解决方案或其他地方定义了数据库的连接字符串,请保持 使用连接字符串 选项选中,并在 数据库类型 选择器中选择 %mysql%。

    使用 字符串 选择器从您的解决方案中选择所需的连接字符串,或手动输入,然后点击 连接。

  3. 您还可以选择 手动添加数据源 ,点击 下一步 并在 数据库源 选择器中选择 %mysql%。 按照向导步骤,通过配置各个选项来形成连接字符串。

  4. 要访问新数据库连接的所有可用选项,请在 数据库 窗口中点击 ,然后点击 新图标新建 并选择 %mysql%。

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

    下载缺失的驱动文件链接

    下载的 JDBC 驱动程序的位置是 JetBrains Rider 配置目录。

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

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

  6. 在 高级 选项卡的选项列表中找到 serverTimezone 参数。 双击 值 单元格并输入您的服务器时区(例如, UTC)。

  7. 点击 通用 选项卡。

  8. 从 驱动程序 列表中,选择您之前创建的驱动程序(请参阅 步骤 4)。

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

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

    测试连接链接

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

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

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

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

    • 有关 数据库 工具窗口的更多信息,请参阅相应的 参考主题。

    • 有关在 JetBrains Rider 中处理数据库对象的更多信息,请参阅 数据库对象。

    • 要编写和运行查询,请点击数据源并按下 F4 键,打开默认的 一个select查询。

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

2026年 8月 5日