MariaDB 教程 / 使用 CREATE TABLE 定义表结构

CREATE TABLE 定义新表的列、数据类型、约束和键。语句成功执行后,还应使用 DESCRIBE 与 SHOW CREATE TABLE 检查实际保存的结构,再核对一条已写入的记录。表存在并不代表它的结构一定符合本次声明,尤其不能把 IF NOT EXISTS 当作修改旧表的方法。

先确定每一列表示什么

表结构(schema)描述数据如何组织。在商品示例中,一行代表一件商品,分别用列保存编号、名称、分类、价格和库存。如果将所有信息拼成一个文本字段,计算、排序和校验就需要先解析文本,给本来清楚的结构增加不必要的工作。

数据 列定义 选择原因
商品编号 product_id INT;主键;自增 即使名称相同,也能区分记录
商品名称 product_name VARCHAR(100) NOT NULL 保存变长名称,要求提供非 NULL 值
分类 category VARCHAR(30) NOT NULL 保存本例的简单分类标签
价格 price DECIMAL(10,2) NOT NULL 保存两位小数的精确十进制金额
库存 stock INT NOT NULL DEFAULT 0 省略时取零;拒绝负数仍需其他规则

字符串长度应来自实际输入和业务要求,100 个字符只是本例的选择,不是所有商品系统都必须采用的长度。数值类型也不等于业务规则:一个合法的有符号整数可能是负数,NOT NULL 也不排除空字符串。设计时应分别决定类型、缺失值、默认值与有效范围,不能只看到声明了类型就认为所有错误输入都会被拒绝。

检查连接和已有表名

使用安装教程创建的 course_user 连接练习服务器,并确认 shopcourse 已可用。命令行客户端与 SOURCE 文件执行教程说明了如何连接和运行保存的 SQL。下列语句在 MariaDB 连接内执行,不是在操作系统终端执行:

SELECT VERSION() AS server_version, DATABASE() AS selected_database;
USE shopcourse;
SELECT DATABASE() AS selected_database;

最后的 selected_database 应为 shopcourse。可以将完整正常示例保存为 UTF-8 的 .sql 文件,使用 SOURCE 和实际本机路径执行。故意制造错误的测试语句应单独运行,避免中途报错使文件剩余内容停止。使用专用学习实例,不要连接包含业务数据的环境进行重置练习。

保留前一次练习的 products 表。本篇使用另一个名字 products_schema_lab,先检查它是否存在:

SHOW TABLES LIKE 'products_schema_lab';

首次创建前预期为空结果。如果已存在,先检查结构和数据,再判断是否需要重置。表名统一使用小写和下划线,避免保留字,可以减少操作系统或服务器名称处理差异造成的混淆。标识符命名与字符串值的写法不同,本例字符串仍使用单引号。

运行完整的建表与验证示例

USE shopcourse;
CREATE TABLE products_schema_lab (
  product_id INT NOT NULL AUTO_INCREMENT,
  product_name VARCHAR(100) NOT NULL,
  category VARCHAR(30) NOT NULL,
  price DECIMAL(10,2) NOT NULL,
  stock INT NOT NULL DEFAULT 0,
  PRIMARY KEY (product_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO products_schema_lab (product_name, category, price)
VALUES ('Notebook', 'Stationery', 3500.00);
SHOW TABLES LIKE 'products_schema_lab';
DESCRIBE products_schema_lab;
SHOW CREATE TABLE products_schema_lab;
SELECT product_id, product_name, price, stock FROM products_schema_lab;

CREATE TABLE 的圆括号内用逗号分隔列定义及表级规则,最后一项之后不再加逗号。PRIMARY KEY (product_id) 指定行标识;AUTO_INCREMENT 则在插入时省略编号的情况下生成数字。这两个功能相关,但职责不同,不能把“自动生成”当成“任何字段都自然唯一”。

存储引擎是实际保存和处理表数据的实现。本例明确选择 InnoDB,以便使用事务行为并衔接关系练习。utf8mb4 字符集和 utf8mb4_unicode_ci 排序规则也被明确指定;这不是要求所有应用采用相同的文本比较策略。

INSERT 只提供商品名称、分类和价格,省略自增编号与库存。在全新表中,第一条记录的编号为 1,stock 取默认值 0。Notebook 与 Stationery 是保留的英文练习数据,分别表示笔记本和文具。将示例保存到文件时,应保留所有分号,不能仅保存 CREATE TABLE 而漏掉后面的插入与验证。

读取实际定义与第一条记录

检查方式 核对内容
DESCRIBE Field、Type、Null、Key、Default、Extra,特别是主键与 auto_increment
SHOW CREATE TABLE 完整表定义、存储引擎、字符集和排序规则
SELECT product_id 为 1,product_name 为 Notebook,price 为 3500.00,stock 为 0

DESCRIBE 应显示五个商品列。product_id 的 Key 为 PRI,Extra 包含 auto_increment;price 应是 decimal(10,2);stock 不允许 NULL,默认值为 0。若结果与预期不同,先检查是否正在查看旧表或错误数据库,而不是直接删除重建。

服务器可能将整数显示成 int(11),其中的数字不表示整数范围扩大,也不是以字节计的存储大小。可参照 INT 类型官方说明理解其属性。不同版本或 SQL 模式可能规范化输出格式,应比较定义含义,不必要求文本完全相同。

SHOW CREATE TABLE 适合检查或记录结构,但输出不包含表内记录,因此不等于备份数据。创建语法、默认值与相关选项可查看 CREATE TABLE 官方参考。

观察 IF NOT EXISTS 保留了什么

直接再次创建同名表,通常会产生“表已存在”的错误。IF NOT EXISTS 可以跳过创建,却不会将旧表改成新声明的结构。在正常示例完成后,单独执行下面的比较:

CREATE TABLE IF NOT EXISTS products_schema_lab (only_column INT);
SHOW WARNINGS;
DESCRIBE products_schema_lab;

SHOW WARNINGS 会报告表已存在的提示,DESCRIBE 仍显示原来的五个商品列,不会变成一个 only_column,原来的商品记录也会保留。这个操作改变了请求的声明,但已有对象并没有按它迁移。

真正修改结构需要合适的迁移方法,例如 ALTER TABLE,以及数据保留与验证计划。不能因为结构不一致,就直接删除业务表。CREATE OR REPLACE TABLE 具有替换现有结构的作用,同样不适合作为随意消除重名错误的捷径。

定位错误并限定重做范围

现象 检查方法
No database selected 执行 USE shopcourse,再用 DATABASE() 确认
Table already exists 读取现有定义和行,确认对象用途
Syntax error 检查逗号、末尾多余逗号、括号和分号
权限错误 核对账号、连接主机与 shopcourse 范围的授权

重做前使用 SELECT DATABASE(),并对实际目标执行 SHOW CREATE TABLE products_schema_lab,确认它确实是本文创建、可以丢弃的练习表。需要保留的数据应先备份。确认范围后,才删除这个对象:

DROP TABLE shopcourse.products_schema_lab;

它会移除这张表及其记录,普通 ROLLBACK 不能撤销这类 DROP TABLE。然后可以重新运行完整正常示例。首次商品练习中的 products 表不属于本篇重置范围;同一数据库内存在其他表,不是一起删除它们的理由。