怎么在cmd命令行里用指定端口号连接远程数据库？

在系统管理、开发调试或自动化脚本编写中，通过命令行界面（CMD）直接连接到数据库是一项非常实用且高效的技能，它绕过了图形化界面的繁琐，提供了更直接、更底层的交互方式，当数据库服务并非运行在默认端口时，如何在连接命令中正确指定端口，就成了一个关键问题，本文将详细介绍如何使用CMD连接到运行在指定端口上的不同类型数据库，并提供必要的故障排查思路。

连接前的基本要素

无论连接哪种数据库,通常都需要准备以下几个核心信息：

• 主机地址：数据库服务器所在的IP地址或域名，如果是本地数据库，通常使用 localhost 或 0.0.1。
• 端口号：数据库服务监听的特定网络端口，这是本文的重点，MySQL默认为3306，PostgreSQL默认为5432，SQL Server默认为1433，如果管理员修改了这些默认值，就必须在连接时明确指定。
• 用户名：拥有数据库访问权限的账户。
• 密码：对应用户名的密码。
• 数据库名称：连接后默认进入的数据库（可选，但通常是必需的）。

常见数据库的连接命令示例

不同的数据库系统提供了各自的命令行客户端工具,以下将分别介绍MySQL、PostgreSQL和SQL Server的连接方法。

连接 MySQL 数据库

MySQL的命令行客户端是 mysql.exe，指定端口需要使用大写的 -P 参数（注意，不是小写的 -p，-p 用于指定密码）。

命令格式：

mysql -h <主机地址> -P <端口号> -u <用户名> -p

参数解释：

• -h 或 --host: 指定数据库主机地址。
• -P 或 --port: 指定数据库端口号。
• -u 或 --user: 指定用户名。
• -p 或 --password: 提示输入密码，为了安全，建议不在命令中直接写明密码，而是在执行命令后根据提示输入。

实际示例：
假设要连接到IP地址为 168.1.100 的服务器上，端口为 3307（非默认）的MySQL数据库，用户名为 admin。

在CMD中执行：

mysql -h 192.168.1.100 -P 3307 -u admin -p

按下回车后,系统会提示 Enter password:，此时输入密码即可完成连接。

连接 PostgreSQL 数据库

PostgreSQL的命令行客户端是 psql.exe，指定端口使用小写的 -p 参数。

命令格式：

psql -h <主机地址> -p <端口号> -U <用户名> -d <数据库名称>

参数解释：

• -h 或 --host: 指定主机地址。
• -p 或 --port: 指定端口号。
• -U 或 --username: 指定用户名。
• -d 或 --dbname: 指定要连接的数据库名称。

实际示例：
假设要连接到IP地址为 0.0.5 的服务器上，端口为 5433（非默认）的PostgreSQL数据库，用户名为 postgres，数据库名为 testdb。

在CMD中执行：

psql -h 10.0.0.5 -p 5433 -U postgres -d testdb

按下回车后,系统会提示输入 postgres 用户的密码。

连接 SQL Server 数据库

SQL Server的命令行客户端是 sqlcmd.exe，它的语法稍有不同，主机和端口通过 -S 参数一起指定，中间用逗号隔开。

命令格式：

sqlcmd -S <主机地址>,<端口号> -U <用户名> -P <密码>

参数解释：

• -S: 指定服务器实例，格式为 主机地址,端口号。
• -U: 指定用户名（使用SQL Server身份验证）。
• -P: 指定密码，与MySQL不同，sqlcmd可以直接在命令中提供密码，但这有安全风险。

实际示例：
假设要连接到IP地址为 16.0.20 的服务器上，端口为 1533（非默认）的SQL Server，用户名为 sa，密码为 YourPassword123。

在CMD中执行：

sqlcmd -S 172.16.0.20,1533 -U sa -P YourPassword123

连接成功后,会出现 1> 提示符，可以输入T-SQL语句。

为了更直观地对比,下表小编总结了这三种数据库的连接方式：

连接前的测试与故障排查

如果直接使用客户端工具连接失败,可以先使用 telnet 工具测试网络连通性。

使用 telnet 测试端口：
telnet 是一个简单的网络协议工具，可以用来测试目标主机的某个端口是否开放。

命令格式：

telnet <主机地址> <端口号>

示例：
测试 168.1.100 的 3307 端口是否可达。

telnet 192.168.1.100 3307

• 如果屏幕变黑或显示连接成功信息,说明端口是开放的，网络层面是通的。
• 如果提示“连接失败”或“无法打开到主机的连接”，则可能是防火墙阻止、地址错误、服务未启动或端口配置错误。

常见错误及解决方法：

1. “’mysql’/’psql’/’sqlcmd’ 不是内部或外部命令…”
   • 原因：数据库的 bin 目录没有被添加到系统的 PATH 环境变量中。
   • 解决：找到客户端工具的完整路径（如 C:Program FilesMySQLMySQL Server 8.0binmysql.exe）并执行，或者将该路径添加到系统环境变量 PATH 中。
2. “Access denied for user ‘user’@’host’”
   • 原因：用户名或密码错误，或者该用户没有从你的IP地址（host）登录的权限。
   • 解决：核对凭据，并联系数据库管理员检查用户权限。
3. “Can’t connect to MySQL server on ‘host’ (10061)” 或类似连接超时错误
   • 原因：网络不通、防火墙阻拦、数据库服务未运行，或者端口/主机地址配置错误。
   • 解决：使用 telnet 测试，检查服务器防火墙规则，确认数据库服务状态和配置。

相关问答FAQs

Q1：为什么我需要指定端口？直接连接不行吗？
A1： 数据库服务运行在服务器的一个特定端口上，就像店铺需要一个具体的门牌号一样，客户端必须知道这个“门牌号”才能准确地找到并与之通信，虽然每种数据库都有一个默认端口（如MySQL的3306），但在实际生产环境中，出于安全考虑（避免被自动化工具扫描）、避免端口冲突或需要在一台服务器上运行多个数据库实例等原因，管理员经常会修改默认端口，当数据库未使用默认端口时，就必须在连接命令中明确指定。

Q2：使用 telnet 连接成功，但使用数据库客户端工具（如 mysql）却失败，这是什么原因？
A2： 这恰恰说明了问题所在。telnet 成功证明了你的电脑到数据库服务器的网络链路是通的，并且服务器的指定端口是开放的，防火墙也允许了这次连接，数据库客户端工具连接失败，问题就出在数据库层面，而非网络层面，最常见的原因包括：① 提供的用户名或密码不正确；② 该用户没有被授予从你的客户端IP地址登录的权限；③ 你尝试连接的数据库实例本身有问题，这时应重点核对认证信息和用户权限。