百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT技术 > 正文

七爪源码:如何使用 SQLite 数据库在 Flutter 中保存大数据

wptr33 2025-04-26 21:40 30 浏览

SQLite 是一个开源、零配置、自包含、独立的事务关系数据库引擎,旨在嵌入到应用程序中。

sqflite

Flutter 的 SQLite 插件。 支持 iOS、Android 和 MacOS。

  • 支持事务和批处理
  • 打开期间的自动版本管理
  • 插入/查询/更新/删除查询的助手
  • 在 iOS 和 Android 上的后台线程中执行的 DB 操作

其他平台支持:

  • 使用 sqflite_common_ffi 支持 Linux/Windows/DartVM
  • 不支持网络。

使用示例:

  • notepad_sqflite:适用于 iOS/Android/Windows/linux/Mac 的简单颤振记事本


入门

在您的颤振项目中添加依赖项:

dependencies:
  ...
  sqflite:

如需帮助开始使用 Flutter,请查看在线文档。



导入 sqflite.dart

import 'package:sqflite/sqflite.dart';


打开数据库

SQLite 数据库是文件系统中由路径标识的文件。 如果是relative,则该路径是相对于getDatabasesPath()获取的路径,是Android默认的数据库目录,iOS/MacOS默认的documents目录。

var db = await openDatabase('my_db.db');

有一个基本的迁移机制来处理打开期间的架构更改。

许多应用程序使用一个数据库并且永远不需要关闭它(它会在应用程序终止时关闭)。 如果要释放资源,可以关闭数据库。

await db.close();
  • 查看有关打开数据库的更多信息。
  • 完整迁移示例


原始 SQL 查询

执行原始 SQL 查询的演示代码

// Get a location using getDatabasesPath
var databasesPath = await getDatabasesPath();
String path = join(databasesPath, 'demo.db');

// Delete the database
await deleteDatabase(path);

// open the database
Database database = await openDatabase(path, version: 1,
    onCreate: (Database db, int version) async {
  // When creating the db, create the table
  await db.execute(
      'CREATE TABLE Test (id INTEGER PRIMARY KEY, name TEXT, value INTEGER, num REAL)');
});

// Insert some records in a transaction
await database.transaction((txn) async {
  int id1 = await txn.rawInsert(
      'INSERT INTO Test(name, value, num) VALUES("some name", 1234, 456.789)');
  print('inserted1: $id1');
  int id2 = await txn.rawInsert(
      'INSERT INTO Test(name, value, num) VALUES(?, ?, ?)',
      ['another name', 12345678, 3.1416]);
  print('inserted2: $id2');
});

// Update some record
int count = await database.rawUpdate(
    'UPDATE Test SET name = ?, value = ? WHERE name = ?',
    ['updated name', '9876', 'some name']);
print('updated: $count');

// Get the records
List<Map> list = await database.rawQuery('SELECT * FROM Test');
List<Map> expectedList = [
  {'name': 'updated name', 'id': 1, 'value': 9876, 'num': 456.789},
  {'name': 'another name', 'id': 2, 'value': 12345678, 'num': 3.1416}
];
print(list);
print(expectedList);
assert(const DeepCollectionEquality().equals(list, expectedList));

// Count the records
count = Sqflite
    .firstIntValue(await database.rawQuery('SELECT COUNT(*) FROM Test'));
assert(count == 2);

// Delete a record
count = await database
    .rawDelete('DELETE FROM Test WHERE name = ?', ['another name']);
assert(count == 1);

// Close the database
await database.close();

关于 SQL 的基本信息在这里。


SQL 助手

使用助手的示例

final String tableTodo = 'todo';
final String columnId = '_id';
final String columnTitle = 'title';
final String columnDone = 'done';

class Todo {
  int id;
  String title;
  bool done;

  Map<String, Object?> toMap() {
    var map = <String, Object?>{
      columnTitle: title,
      columnDone: done == true ? 1 : 0
    };
    if (id != null) {
      map[columnId] = id;
    }
    return map;
  }

  Todo();

  Todo.fromMap(Map<String, Object?> map) {
    id = map[columnId];
    title = map[columnTitle];
    done = map[columnDone] == 1;
  }
}

class TodoProvider {
  Database db;

  Future open(String path) async {
    db = await openDatabase(path, version: 1,
        onCreate: (Database db, int version) async {
      await db.execute('''
create table $tableTodo ( 
  $columnId integer primary key autoincrement, 
  $columnTitle text not null,
  $columnDone integer not null)
''');
    });
  }

  Future<Todo> insert(Todo todo) async {
    todo.id = await db.insert(tableTodo, todo.toMap());
    return todo;
  }

  Future<Todo> getTodo(int id) async {
    List<Map> maps = await db.query(tableTodo,
        columns: [columnId, columnDone, columnTitle],
        where: '$columnId = ?',
        whereArgs: [id]);
    if (maps.length > 0) {
      return Todo.fromMap(maps.first);
    }
    return null;
  }

  Future<int> delete(int id) async {
    return await db.delete(tableTodo, where: '$columnId = ?', whereArgs: [id]);
  }

  Future<int> update(Todo todo) async {
    return await db.update(tableTodo, todo.toMap(),
        where: '$columnId = ?', whereArgs: [todo.id]);
  }

  Future close() async => db.close();
}


阅读结果

假设读取结果如下:

List<Map<String, Object?>> records = await db.query('my_table');

生成的地图项是只读的

// get the first record
Map<String, Object?> mapRead = records.first;
// Update it in memory...this will throw an exception
mapRead['my_column'] = 1;
// Crash... `mapRead` is read-only

如果要在内存中修改它,则需要创建一个新映射:

// get the first record
Map<String, Object?> map = Map<String, Object?>.from(mapRead);
// Update it in memory now
map['my_column'] = 1;


交易

不使用数据库,只使用事务中的 Transaction 对象来访问数据库。 请记住,回调 onCreate onUpgrade onDowngrade 已在内部包装在事务中,因此无需将您的语句包装在这些回调中的事务中。

await database.transaction((txn) async {
  // Ok
  await txn.execute('CREATE TABLE Test1 (id INTEGER PRIMARY KEY)');
  
  // DON'T  use the database object in a transaction
  // this will deadlock!
  await database.execute('CREATE TABLE Test2 (id INTEGER PRIMARY KEY)');
});

如果回调没有抛出错误,则提交事务。 如果抛出错误,则取消事务。 因此,回滚事务的一种方法是抛出异常。


Batch 支持

为了避免 dart 和本机代码之间的乒乓,您可以使用 Batch:

batch = db.batch();
batch.insert('Test', {'name': 'item'});
batch.update('Test', {'name': 'new_item'}, where: 'name = ?', whereArgs: ['item']);
batch.delete('Test', where: 'name = ?', whereArgs: ['item']);
results = await batch.commit();

获取每个操作的结果是有代价的(插入的 id 以及更新和删除的更改次数),尤其是在执行额外 SQL 请求的 Android 上。 如果您不关心结果并担心大批量的性能,您可以使用

await batch.commit(noResult: true);

警告,在事务期间,直到事务提交后才会提交批处理

await database.transaction((txn) async {
  var batch = txn.batch();
  
  // ...
  
  // commit but the actual commit will happen when the transaction is committed
  // however the data is available in this transaction
  await batch.commit();
  
  //  ...
});

默认情况下,批处理一旦遇到错误就会停止(这通常会还原未提交的更改)。 您可以忽略错误,以便运行并提交每个成功的操作,即使一个操作失败:

await batch.commit(continueOnError: true);


表名和列名

一般来说,最好避免对实体名称使用 SQLite 关键字。 如果使用以下任何名称:

"add","all","alter","and","as","autoincrement","between","case","check","collate","commit","constraint","create","default","deferrable","delete","distinct","drop","else","escape","except","exists","foreign","from","group","having","if","in","index","insert","intersect","into","is","isnull","join","limit","not","notnull","null","on","or","order","primary","references","select","set","table","then","to","transaction","union","unique","update","using","values","when","where"

助手将转义名称,即

db.query('table')

将相当于手动在表名周围添加双引号(这里命名为表令人困惑)

db.rawQuery('SELECT * FROM "table"');

但是,在任何其他原始语句(包括 orderBy、where、groupBy)中,请确保使用双引号正确转义名称。 例如,请参见下面的列名组未在 columns 参数中转义,但在 where 参数中转义。

db.query('table', columns: ['group'], where: '"group" = ?', whereArgs: ['my_group']);


支持的 SQLite 类型

尚未对值进行有效性检查,因此请避免不支持的类型
https://www.sqlite.org/datatype3.html

DateTime 不是受支持的 SQLite 类型。我个人将它们存储为 int (millisSinceEpoch) 或 string (iso8601)

bool 不是受支持的 SQLite 类型。使用 INTEGER 和 0 和 1 值。

有关支持的类型的更多信息,请点击此处。

整数

  • 飞镖类型:int
  • 支持的值:从 -2^63 到 2^63 - 1

真实的

  • 飞镖类型:num

文本

  • 飞镖类型:字符串

斑点

  • 飞镖类型:Uint8List


目前的问题

由于事务在 SQLite(线程)中的工作方式,不支持并发读写事务。当前所有调用都是同步的,事务块是独占的。我认为支持并发访问的基本方法是多次打开数据库,但它仅适用于 iOS,因为 Android 重用相同的数据库对象。我还认为本机线程可能是未来潜在的解决方案,但是在 android 上访问另一个线程中的数据库在事务中被阻止......


关注七爪网,获取更多APP/小程序/网站源码资源!

相关推荐

MySQL进阶五之自动读写分离mysql-proxy

自动读写分离目前,大量现网用户的业务场景中存在读多写少、业务负载无法预测等情况,在有大量读请求的应用场景下,单个实例可能无法承受读取压力,甚至会对业务产生影响。为了实现读取能力的弹性扩展,分担数据库压...

Postgres vs MySQL_vs2022连接mysql数据库

...

3分钟短文 | Laravel SQL筛选两个日期之间的记录,怎么写?

引言今天说一个细分的需求,在模型中,或者使用laravel提供的EloquentORM功能,构造查询语句时,返回位于两个指定的日期之间的条目。应该怎么写?本文通过几个例子,为大家梳理一下。学习时...

一文由浅入深带你完全掌握MySQL的锁机制原理与应用

本文将跟大家聊聊InnoDB的锁。本文比较长,包括一条SQL是如何加锁的,一些加锁规则、如何分析和解决死锁问题等内容,建议耐心读完,肯定对大家有帮助的。为什么需要加锁呢?...

验证Mysql中联合索引的最左匹配原则

后端面试中一定是必问mysql的,在以往的面试中好几个面试官都反馈我Mysql基础不行,今天来着重复习一下自己的弱点知识。在Mysql调优中索引优化又是非常重要的方法,不管公司的大小只要后端项目中用到...

MySQL索引解析(联合索引/最左前缀/覆盖索引/索引下推)

目录1.索引基础...

你会看 MySQL 的执行计划(EXPLAIN)吗?

SQL执行太慢怎么办?我们通常会使用EXPLAIN命令来查看SQL的执行计划,然后根据执行计划找出问题所在并进行优化。用法简介...

MySQL 从入门到精通(四)之索引结构

索引概述索引(index),是帮助MySQL高效获取数据的数据结构(有序),在数据之外,数据库系统还维护者满足特定查询算法的数据结构,这些数据结构以某种方式引用(指向)数据,这样就可以在这些数据结构...

mysql总结——面试中最常问到的知识点

mysql作为开源数据库中的榜一大哥,一直是面试官们考察的重中之重。今天,我们来总结一下mysql的知识点,供大家复习参照,看完这些知识点,再加上一些边角细节,基本上能够应付大多mysql相关面试了(...

mysql总结——面试中最常问到的知识点(2)

首先我们回顾一下上篇内容,主要复习了索引,事务,锁,以及SQL优化的工具。本篇文章接着写后面的内容。性能优化索引优化,SQL中索引的相关优化主要有以下几个方面:最好是全匹配。如果是联合索引的话,遵循最...

MySQL基础全知全解!超详细无废话!轻松上手~

本期内容提醒:全篇2300+字,篇幅较长,可搭配饭菜一同“食”用,全篇无废话(除了这句),干货满满,可收藏供后期反复观看。注:MySQL中语法不区分大小写,本篇中...

深入剖析 MySQL 中的锁机制原理_mysql 锁详解

在互联网软件开发领域,MySQL作为一款广泛应用的关系型数据库管理系统,其锁机制在保障数据一致性和实现并发控制方面扮演着举足轻重的角色。对于互联网软件开发人员而言,深入理解MySQL的锁机制原理...

Java 与 MySQL 性能优化:MySQL分区表设计与性能优化全解析

引言在数据库管理领域,随着数据量的不断增长,如何高效地管理和操作数据成为了一个关键问题。MySQL分区表作为一种有效的数据管理技术,能够将大型表划分为多个更小、更易管理的分区,从而提升数据库的性能和可...

MySQL基础篇:DQL数据查询操作_mysql 查

一、基础查询DQL基础查询语法SELECT字段列表FROM表名列表WHERE条件列表GROUPBY分组字段列表HAVING分组后条件列表ORDERBY排序字段列表LIMIT...

MySql:索引的基本使用_mysql索引的使用和原理

一、索引基础概念1.什么是索引?索引是数据库表的特殊数据结构(通常是B+树),用于...