PyCharm 2026.1 Help

在不同操作系统中使用 Kerberos 创建 Microsoft SQL Server 数据源

启用 数据库工具和 SQL 插件

此功能依赖 数据库工具和 SQL 插件,默认随 PyCharm 一起提供并启用。 如果相关功能不可用,请确保没有禁用该插件。

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

  2. 打开 已安装 选项卡,找到 数据库工具和 SQL 插件,并选中其名称旁边的复选框。

  • 有关 Microsoft SQL Server 的完整信息,请参阅 官方文档

  • 要下载 Microsoft SQL Server 数据库软件,请参阅 官方软件下载

本主题提供从 PyCharm 为 Microsoft SQL Server 创建数据源的示例。 其中介绍了在 WindowsmacOSLinux 上配置 PyCharm 的方法。

请注意, 使用 Windows 域身份验证 复选框仅在 Windows 上可用。 要在 macOS 和 Linux 上配置 Windows 域身份验证,请参阅 使用 Windows 域身份验证进行连接

必需设置

Microsoft SQL Server 在专用端口上接受 TCP/IP 连接。 默认情况下为端口 1433 ,并且该端口被 Microsoft Windows 防火墙关闭。 通过端口进行连接时,请确保防火墙未关闭您使用的端口。

如果已启用 SQL Server Browser ,也可以使用 Microsoft SQL Server 实例名称建立 TCP/IP 连接。

启用并配置 TCP/IP 连接

  • 按照 官方说明 启用协议、检查并分配端口号。 验证其他正在运行的应用程序未使用相同的端口。

    Microsoft SQL Server 实例的名称为 MSSQLSERVER。 默认端口为 1433

使用 Kerberos 进行连接

在使用 Kerberos 身份验证与 Microsoft SQL Server 数据库建立连接之前,请在命令提示符或 终端 中运行 Kerberos 命令,确保您拥有身份验证票证。

  • 如果您的计算机上存在票据缓存文件且 useTicketCache 设置为 true ,请运行 klist 命令。 请确保在缓存的票据中列出了您的票据。

  • 如果您的计算机未启用票据缓存,请执行以下操作:

    1. 运行 klist 命令,并确保列表中包含您的票据。

    2. 如果您的身份验证票证未在列表中,请使用您的用户名运行 kinit 命令以从服务器获取票证: kinit sqlsrvkrb。 将 sqlsrvkrb 替换为您的用户名。 出现提示时,输入您的密码。

有关 Kerberos 票据的更多信息,请参阅 Kerberos 网站

    创建数据源

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

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

      • 在主菜单中,转到 文件(F) | 新建(N) | 数据源 ,然后选择 Microsoft SQL Server

      • 数据库 工具窗口 ,点击工具栏上的 “新建”图标新建。 导航到 数据源 并选择 Microsoft SQL Server

      创建新数据源
    2. 点击 驱动程序 链接,并选择用于您连接的驱动程序。

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

      下载缺少的驱动程序文件链接

      下载的 JDBC 驱动程序位于 PyCharm 配置目录

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

      如果没有 下载缺失的驱动文件 链接,则表明您已拥有所需的驱动程序。

    4. 指定数据库连接详细信息。 或者,将 JDBC URL 粘贴到 URL 字段。

      • 主机实例端口 字段中,指定您的连接详细信息。

      • 身份验证 列表中,选择 Kerberos.

      • 用户密码 字段中输入您的用户凭据。

        如无需使用密码,请将 密码 字段留空。

        要删除先前输入的密码,右键点击 密码 字段并选择 设为空

        设为空上下文菜单项
      • 数据库 字段中输入要连接的数据库名称。

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

      测试连接的链接

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

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

      数据源和驱动程序对话框的“架构”选项卡
    7. 点击 确定 创建数据源。

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

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

      • 有关在 PyCharm 中使用数据库对象的更多信息,请参见 数据库对象

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

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

    使用 Kerberos 进行连接

    Windows

    使用 SQL Server 身份验证进行连接

    1. 数据库 工具窗口(视图(V) | 工具窗口 | 数据库 )中,点击 数据源属性 图标 数据源属性图标。 或者,按 Ctrl+Alt+Shift+S

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

    3. 点击 驱动程序 链接,然后选择 Microsoft SQL Server (jTds)

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

      下载缺少的驱动程序文件链接

      下载的 JDBC 驱动程序位于 PyCharm 配置目录

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

      如果没有 下载缺失的驱动文件 链接,则表明您已拥有所需的驱动程序。

    5. 主机实例端口 字段中,指定您的连接详细信息。 如果服务器名称(例如, DESKTOP )不起作用,请将其替换为服务器 IP 地址。

    6. 身份验证 列表中,选择 用户与密码.

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

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

      测试连接的链接

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

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

      数据源和驱动程序对话框的“架构”选项卡
    10. 点击 确定 创建数据源。

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

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

      • 有关在 PyCharm 中使用数据库对象的更多信息,请参见 数据库对象

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

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

    使用 SQL Server 身份验证进行连接

    使用 Microsoft SQL Server 单点登录进行连接

    如果您在与 Microsoft SQL Server 数据库相同的域中的 Windows 上运行 PyCharm,您可以使用单点登录(SSO)。

    1. 数据库 工具窗口(视图(V) | 工具窗口 | 数据库 )中,点击 数据源属性 图标 数据源属性图标。 或者,按 Ctrl+Alt+Shift+S

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

    3. 点击 驱动程序 链接,然后选择 Microsoft SQL Server (jTds)

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

      下载缺少的驱动程序文件链接

      下载的 JDBC 驱动程序位于 PyCharm 配置目录

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

      如果没有 下载缺失的驱动文件 链接,则表明您已拥有所需的驱动程序。

    5. 主机实例端口 字段中,指定您的连接详细信息。 如果服务器名称(例如, DESKTOP )不起作用,请将其替换为服务器 IP 地址。

    6. 身份验证 列表中,选择 Windows 凭据 (仅在 Windows 上可用)。

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

      测试连接的链接

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

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

      数据源和驱动程序对话框的“架构”选项卡
    9. 点击 确定 创建数据源。

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

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

      • 有关在 PyCharm 中使用数据库对象的更多信息,请参见 数据库对象

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

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

    使用 SQL Server 身份验证进行连接

    使用 Windows 域身份验证进行连接

    1. 数据库 工具窗口(视图(V) | 工具窗口 | 数据库 )中,点击 数据源属性 图标 数据源属性图标。 或者,按 Ctrl+Alt+Shift+S

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

    3. 点击 驱动程序 链接,然后选择 Microsoft SQL Server (jTds)

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

      下载缺少的驱动程序文件链接

      下载的 JDBC 驱动程序位于 PyCharm 配置目录

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

      如果没有 下载缺失的驱动文件 链接,则表明您已拥有所需的驱动程序。

    5. 主机实例端口 字段中,指定您的连接详细信息。 如果服务器名称(例如, DESKTOP )不起作用,请将其替换为服务器 IP 地址。

    6. 身份验证 列表中,选择 域凭据.

    7. 字段中,指定域(例如, DEVELOPMENT)。

    8. 用户密码 字段中,指定您的域凭据。 在 用户 字段中,输入不带域前缀的域用户(例如,用 John.Smith 替代 DOMAIN\John.Smith)。

      或者,在 常规 选项卡上,指定连接字符串。 考虑以下完整连接字符串示例:

      jdbc:jtds:sqlserver://DESKTOP:1433;domain=DEVELOPMENT;instance=MSSQLSERVER;databaseName=guest;
    9. 确保可以使用提供的详细信息建立数据库连接。 为此,请点击连接详细信息部分底部的 测试连接 链接。

      测试连接的链接

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

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

      数据源和驱动程序对话框的“架构”选项卡
    11. 点击 确定 创建数据源。

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

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

      • 有关在 PyCharm 中使用数据库对象的更多信息,请参见 数据库对象

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

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

    使用 SQL Server 身份验证进行连接

    macOS 和 Linux

    使用 SQL Server 身份验证进行连接

    1. 数据库 工具窗口(视图(V) | 工具窗口 | 数据库 )中,点击 数据源属性 图标 数据源属性图标。 或者,按 ⌘ ;

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

    3. 点击 驱动程序 链接,然后选择 Microsoft SQL Server (jTds)

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

      下载缺少的驱动程序文件链接

      下载的 JDBC 驱动程序位于 PyCharm 配置目录

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

      如果没有 下载缺失的驱动文件 链接,则表明您已拥有所需的驱动程序。

    5. 主机实例端口 字段中,指定您的连接详细信息。 如果服务器名称(例如, DESKTOP )不起作用,请将其替换为服务器 IP 地址。

    6. 身份验证 列表中,选择 用户与密码.

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

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

      测试连接的链接

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

    9. (可选) 默认情况下,仅内省默认数据库和架构并可用于处理。 如果您还希望处理其他数据库和架构,请在 架构 选项卡中选择它们进行内省。

      数据源和驱动程序对话框的“架构”选项卡
    10. 点击 确定 创建数据源。

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

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

      • 有关在 PyCharm 中使用数据库对象的更多信息,请参见 数据库对象

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

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

    使用 SQL Server 身份验证进行连接

    使用 Windows 域身份验证进行连接

    1. 数据库 工具窗口(视图(V) | 工具窗口 | 数据库 )中,点击 数据源属性 图标 数据源属性图标。 或者,按 ⌘ ;

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

    3. 点击 驱动程序 链接,然后选择 Microsoft SQL Server (jTds)

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

      下载缺少的驱动程序文件链接

      下载的 JDBC 驱动程序位于 PyCharm 配置目录

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

      如果没有 下载缺失的驱动文件 链接,则表明您已拥有所需的驱动程序。

    5. 主机实例端口 字段中,指定您的连接详细信息。 如果服务器名称(例如, DESKTOP )不起作用,请将其替换为服务器 IP 地址。

    6. 身份验证 列表中,选择 域凭据.

    7. 字段中,指定域(例如, DEVELOPMENT)。

    8. 用户密码 字段中,指定您的域凭据。 在 用户 字段中,输入不带域前缀的域用户(例如,用 John.Smith 替代 DOMAIN\John.Smith)。

      或者,在 常规 选项卡上,指定连接字符串。 考虑以下完整连接字符串示例:

      jdbc:jtds:sqlserver://DESKTOP:1433;domain=DEVELOPMENT;instance=MSSQLSERVER;databaseName=guest;
    9. 确保可以使用提供的详细信息建立数据库连接。 为此,请点击连接详细信息部分底部的 测试连接 链接。

      测试连接的链接

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

    10. (可选) 默认情况下,仅内省默认数据库和架构并可用于处理。 如果您还希望处理其他数据库和架构,请在 架构 选项卡中选择它们进行内省。

      数据源和驱动程序对话框的“架构”选项卡
    11. 点击 确定 创建数据源。

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

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

      • 有关在 PyCharm 中使用数据库对象的更多信息,请参见 数据库对象

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

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

    使用 SQL Server 身份验证进行连接
    2026年 3月 24日