PyCharm 2025.3 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 drivers 页面。

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

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

      您也可以使用您自己的数据库驱动程序替代提供的驱动程序。 有关连接到数据库并使用您自己的驱动程序的更多信息,请参阅 Add a user driver to an existing connection

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

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

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

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

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

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

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

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

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

      测试连接链接

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

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

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

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

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

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

      • 要编写并运行查询,请点击数据源并按 F4 打开默认的 查询文件

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

    使用 Kerberos 进行连接

    Windows

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

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

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

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

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

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

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

      您也可以使用您自己的数据库驱动程序替代提供的驱动程序。 有关连接到数据库并使用您自己的驱动程序的更多信息,请参阅 Add a user driver to an existing connection

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

    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. 数据源和驱动程序 对话框中,点击 添加 图标 (添加图标) 并选择 Microsoft SQL Server

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

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

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

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

      您也可以使用您自己的数据库驱动程序替代提供的驱动程序。 有关连接到数据库并使用您自己的驱动程序的更多信息,请参阅 Add a user driver to an existing connection

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

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

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

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

      测试连接链接

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

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

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

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

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

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

      • 要编写并运行查询,请点击数据源并按 F4 打开默认的 查询文件

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

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

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

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

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

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

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

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

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

      您也可以使用您自己的数据库驱动程序替代提供的驱动程序。 有关连接到数据库并使用您自己的驱动程序的更多信息,请参阅 Add a user driver to an existing connection

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

    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. 数据源和驱动程序 对话框中,点击 添加 图标 (添加图标) 并选择 Microsoft SQL Server

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

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

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

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

      您也可以使用您自己的数据库驱动程序替代提供的驱动程序。 有关连接到数据库并使用您自己的驱动程序的更多信息,请参阅 Add a user driver to an existing connection

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

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

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

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

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

      测试连接链接

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

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

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

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

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

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

      • 要编写并运行查询,请点击数据源并按 F4 打开默认的 查询文件

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

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

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

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

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

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

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

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

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

      您也可以使用您自己的数据库驱动程序替代提供的驱动程序。 有关连接到数据库并使用您自己的驱动程序的更多信息,请参阅 Add a user driver to an existing connection

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

    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 身份验证进行连接
    最后修改日期: 2025年 12月 2日