当前位置：首页 > 问答 > 正文

Android里数据库怎么建表，语句写法和注意点全解析分享

符海莹
问答
2026-01-06 10:13:25
17

在Android应用里,如果你想在本地存储一些结构化的数据，比如用户的笔记、收藏的物品列表等，使用数据库是一个非常常见和高效的方法，Android系统内置了SQLite数据库，它是一个轻量级的、不需要单独服务器就能工作的数据库，要把数据存进去，第一步也是最关键的一步就是创建表格，下面我就把建表的语句写法和需要注意的地方详细说一下。

核心：SQL的CREATE TABLE语句

建表最核心的就是一句SQL代码,别看它只是一行字，它决定了你的数据怎么存放，最基本的格式长这样：

Android里数据库怎么建表，语句写法和注意点全解析分享

CREATE TABLE 表名称 (
    列名称1 数据类型 约束条件,
    列名称2 数据类型 约束条件,
    ...
);

我们来拆开看每一个部分是什么意思：

表名称：就是你给这个“数据表格”起的名字，notes（笔记表）、users（用户表），名字最好简单明了，能看出是干什么的。
列名称：就是表格里的“栏目”，比如一个笔记表，可能有 _id、title）、content）、create_time（创建时间）这些列。
数据类型：这个特别重要，它规定了这一列里只能存什么类型的数据，SQLite的数据类型比较灵活，但常用的就这几种：
- INTEGER：整数，比如ID、数量、年龄等。
- TEXT：文本字符串，比如标题、内容、名字等。
- REAL：浮点数（带小数点的数字），比如价格、评分等。
- BLOB：二进制数据，可以用来存图片、文件等，但一般不建议直接存进数据库，最好存文件路径。
- NULL：空值。
- （根据SQLite官方文档，它支持的类型亲和性（Type Affinity）概念，但上面这五种是基础分类，足够理解和使用了。）
约束条件：这是给列加的“规矩”，用来保证数据的正确性和完整性，常用的有：
- PRIMARY KEY：主键，你可以把它想象成每一行数据的唯一身份证号，绝对不允许重复，也不能是空的，如果主键是INTEGER类型，我们通常会加上AUTOINCREMENT，这样每次插入新数据时，数据库会自动给这个ID+1，我们就不用自己操心了。在Android里，为了方便适配器（Adapter）使用，通常会有一个叫 _id 的整数主键，这算是一个约定俗成的做法。
- NOT NULL：非空，规定这一列必须填内容，不能是空的。
- UNIQUE：唯一，规定这一列里的每一个值都不能重复，比如用户的邮箱号。
- DEFAULT：默认值，如果插入数据时没给这一列赋值，它就自动用这个默认值。DEFAULT 0 或 DEFAULT '未知'。

在Android项目中具体怎么操作

Android里数据库怎么建表，语句写法和注意点全解析分享

在Android里,我们不会直接去执行SQL语句，而是通过一个叫 SQLiteOpenHelper 的帮助类来管理数据库的创建和版本升级，建表的代码就写在这个类的 onCreate 方法里。

举个例子,我们要创建一个简单的笔记表：

// 根据Android开发者文档中SQLiteOpenHelper的用法示例
public class MyDatabaseHelper extends SQLiteOpenHelper {
    // 数据库名字
    private static final String DATABASE_NAME = "MyNotes.db";
    // 数据库版本号，以后要升级数据库时，把这个数字改大就行
    private static final int DATABASE_VERSION = 1;
    // 定义表名和列名为常量，这样不容易写错
    public static final String TABLE_NOTES = "notes";
    public static final String COLUMN_ID = "_id";
    public static final String COLUMN_TITLE = "title";
    public static final String COLUMN_CONTENT = "content";
    public static final String COLUMN_TIME = "create_time";
    // 拼写CREATE TABLE的SQL语句
    private static final String SQL_CREATE_TABLE =
            "CREATE TABLE " + TABLE_NOTES + " (" +
                    COLUMN_ID + " INTEGER PRIMARY KEY AUTOINCREMENT, " +
                    COLUMN_TITLE + " TEXT NOT NULL, " +
                    COLUMN_CONTENT + " TEXT, " + // 内容允许为空
                    COLUMN_TIME + " INTEGER NOT NULL);"; // 时间用整数存储时间戳
    public MyDatabaseHelper(Context context) {
        super(context, DATABASE_NAME, null, DATABASE_VERSION);
    }
    @Override
    public void onCreate(SQLiteDatabase db) {
        // 当数据库第一次被创建时，执行这条SQL语句
        db.execSQL(SQL_CREATE_TABLE);
    }
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        // 当数据库需要升级时，这里处理旧表迁移等，初学者可以先简单删除旧表
        db.execSQL("DROP TABLE IF EXISTS " + TABLE_NOTES);
        onCreate(db);
    }
}

建表时需要注意的几个关键点

主键的选择：强烈建议使用一个没有业务意义的整数作为主键（比如_id），并且加上AUTOINCREMENT，不要用姓名、手机号这种可能有重复或者会变化的业务字段当主键，否则后患无穷。
思考列是否允许为空（NULL）：在设计每个列的时候，就要想好“这一列是不是必须填？”，比如标题（title）可能要求NOT NULL（content）也许允许暂时为空，这取决于你的业务逻辑。
关于日期时间的存储：SQLite没有专门的日期类型，通常有两种存法：一是存INTEGER类型的时间戳（从1970年1月1日到现在的毫秒数），方便计算和排序；二是存TEXT类型的格式化字符串（如"YYYY-MM-DD HH:MM:SS"），方便直接看，推荐存时间戳，更通用。
SQL语句的格式和拼写：拼写SQL字符串的时候要非常小心，逗号、空格、分号一个都不能错，这就是为什么要把表名、列名定义为常量，然后用号连接，能大大减少拼写错误，写完最好多检查几遍。
数据库升级（onUpgrade）：上面的例子中，在onUpgrade里直接删表重建是非常粗暴的做法，这会导致用户更新App后之前的所有数据都没了。在实际项目中，这是绝对要避免的，正确的做法应该是判断旧版本号，通过ALTER TABLE语句来增加列或修改表结构，并保留原有数据，但对于初学者来说，可以先理解建表，升级是个更复杂的话题。
索引：如果你的数据量很大，经常需要根据某个列（比如create_time）来查询或排序，那么可以后期考虑为这个列创建索引（CREATE INDEX），能大幅提高查询速度，但索引不是建得越多越好，因为它会降低数据插入和更新的速度。