MariaDB 教程 / 从命令行连接并用 SOURCE 执行 SQL 文件

先在操作系统终端启动 MariaDB 客户端连接,再在已连接的客户端中输入 SQL。运行已保存的 UTF-8 SQL 文件,可以使用客户端的 SOURCE 命令;它读取的是运行客户端的电脑上的文件路径,而不是数据库服务器上的路径。把终端、客户端命令和 SQL 的执行位置分清楚,可以避免许多看似语法正确却无法执行的问题。

准备服务器、账号和 SQL 文件

先完成 Windows 安装与连接验证或 Ubuntu 安装与认证验证,确认服务器正在运行。本教程使用下面的练习账号和连接参数;如果实例选择了其他端口,应替换相应参数。服务器与客户端的区别也适用于读取 SQL 文件的场景:文件由客户端读取,其中的 SQL 再交给服务器执行。

项目 值或检查方法
协议与主机 通过 TCP 连接 127.0.0.1
端口 通常为 3306,实际实例使用其他端口时替换
账号 course_user,以及创建时自己选择的密码
连接字符集 utf8mb4
SQL 文件 UTF-8 纯文本,扩展名为 .sql,而不是 .sql.txt

终端启动 mariadb 客户端,SOURCE 读取客户端电脑上的 SQL 文件,服务器执行语句后由客户端显示结果

终端启动 mariadb 程序;连接成功后,客户端向服务器发送 SQL。SOURCE 则由客户端解释,用来读取本机文件并发送其中的语句。保存文件本身不会建立数据库连接,也不会执行文件内容。

从终端连接并检查实际身份

在操作系统终端中运行下面的命令,不要把它输入到已有的 MariaDB 连接里:

mariadb --protocol=tcp --host=127.0.0.1 --port=3306 --user=course_user --password --default-character-set=utf8mb4 --abort-source-on-error
选项 作用
--protocol=tcp 明确使用 TCP,而不是本机套接字
--host 与 --port 确定要连接的服务器地址与端口
--user 指定 MariaDB 用户名
--password 交互输入密码,避免把密码写入命令
--default-character-set=utf8mb4 设置客户端连接字符集
--abort-source-on-error SOURCE 遇到错误时停止剩余输入

在 Windows 上,如果终端找不到 mariadb,可以使用安装附带的 MariaDB Command Prompt,或使用安装教程中的完整可执行文件路径。看到 MariaDB [(none)]> 这类提示符,表示当前连接没有选定默认数据库,并不表示登录失败。下列查询不依赖数据库或表,可以直接执行:

SELECT VERSION() AS server_version;
SELECT USER() AS connection_user,
       CURRENT_USER() AS privilege_account;
SELECT 2 + 3 AS total, 'Hello, café' AS greeting;

服务器应返回实际版本、账号信息,以及 total 为 5、greeting 为 Hello, café 的结果。带重音的 é 也能帮助检查编码是否正常。USER() 描述连接身份,CURRENT_USER() 显示用于权限检查的账号,两者不应仅凭名字推断总是相同。参数和客户端命令的定义可查看官方 mariadb 命令行客户端参考。

完成、取消或竖排显示语句

SQL 可以跨多行输入,客户端会等待语句结束,通常以分号作为结束标志:

SELECT
  10 + 20 AS total;

预期 total 为 30。如果正在输入尚未完成的语句,想丢弃当前输入,可使用下面的客户端命令:

\c

例如输入了不完整的 SELECT 后,再输入这个命令,就能清空待执行内容,不必补成一条有效查询。它用于取消当前输入,不能撤销已经在服务器上执行成功的操作。

希望将结果按字段逐行竖排显示时,可以用客户端终止符 \G 替代分号:

SELECT VERSION() AS server_version\G

\c 和 \G 是 mariadb 客户端约定,不是所有数据库接口都接受的通用 SQL 语法。结束交互式连接可输入 EXIT;。断开连接不会停止 MariaDB 服务器,也不会删除数据;它与操作系统中的停止服务是不同操作。

保存完整的 UTF-8 SQL 文件

用文本编辑器创建 lesson04-check.sql,将下面的完整内容保存进去:

SELECT VERSION() AS server_version;
SELECT USER() AS connection_user,
       CURRENT_USER() AS privilege_account;
SELECT 2 + 3 AS total, 'Hello, café' AS greeting;

选择编辑器的 UTF-8 编码,并核对实际扩展名。Windows 隐藏已知扩展名时,文件可能实际叫 lesson04-check.sql.txt。使用自己有权限管理的目录,例如 Windows 的 C:\mariadb-course\,或 Ubuntu 的 /home/yourname/mariadb-course/,其中 yourname 必须替换为真实目录名。

这个文件保存的是待执行的指令,并不是数据库备份。保存文件之后还需要连接客户端并执行它。文件路径属于客户端电脑的文件系统,而 127.0.0.1:3306 是服务器连接地址,这两种位置不能互相替代。

用 SOURCE 执行文件并核对结果

连接客户端后,Windows 示例采用正斜杠路径:

SOURCE C:/mariadb-course/lesson04-check.sql;

Ubuntu 则使用自己实际的完整路径:

SOURCE /home/yourname/mariadb-course/lesson04-check.sql;

以上是两种环境的替代写法,不是要求连续执行的两条步骤。成功时应显示与直接输入相同的三组查询结果,包括 total 为 5、完整显示的 Hello, café,以及实际服务器和账号信息。本文文件只读取表达式和连接信息,重复执行不会增加或删除表中的行。

即使客户端运行在自己的电脑、服务器运行在另一台电脑上,SOURCE 仍读取自己电脑上的文件。若文件放在服务器上而客户端电脑没有该文件,不能仅靠填写服务器文件路径让 SOURCE 找到它。

连接时启用 --abort-source-on-error,遇到错误就停止剩余的 SOURCE 输入。但这不是自动回滚:此前成功的语句可能已经产生结果或提交数据,建表等操作也不会因此变成可以回滚的操作。重新执行会改变数据的文件前,应先核对哪些语句已经成功,避免重复插入或误删。

排查路径、编码和 SQL 错误

  • 找不到文件:检查完整路径、拼写、客户端文件访问权限以及真实扩展名。
  • 文字乱码:依次检查文件是否为 UTF-8、连接字符集和终端显示编码。
  • Access denied:核对数据库账号和权限;它不同于本机文件不存在。
  • 文件执行到一半报错:阅读错误位置并核对此前成功的修改,再决定从何处重试。

在 Windows 上,如果问题来自终端显示代码页,先退出 MariaDB 客户端,在操作系统终端运行下面的命令,再带 UTF-8 连接选项重新连接:

chcp 65001

需要检查连接的字符集时,在客户端执行:

SHOW VARIABLES LIKE 'character_set_%';

留意 character_set_client、character_set_connection 和 character_set_results 等变量。调整连接参数不会自动修复过去已错误保存的文本,应先确认问题发生在文件、连接、存储还是显示环节,再处理已有数据。始终将终端命令、客户端命令和服务器 SQL 放在正确的位置执行。