新建 indexedDB 数据库并插入数据
约 1818 字大约 6 分钟
2025-07-30
一、什么叫数据库
DB
的全名是 database
,即数据库。
二、数据库的种类
数据库有两种类型,分别是关系型数据库和非关系型数据库。
- 关系型数据库:Oracle、DB2、MicrosoftSQLServer、MicrosoftAccess、MySQL 等。
- 非关系型数据库:NoSql、Cloudant、MongoDb、redis、HBase 等。
关系型数据库的优点:
- 能够复杂查询:可以用 SQL 句子便捷的在一个表及多个表之间做复杂的数据查询。
- 事务支持性优秀:能够实现对于安全性要求很高的数据访问。
非关系型数据库的优点:
- 性能好:NOSQL 是基于键值对的,可以想象成表中的主键和值的对应关系,并且不用通过 SQL 层的解析,因此性能表现优异。
- 可扩展性好:同样也是基于键值对,数据间耦合度低,因此很容易水平扩展。
SQL (Structured Query Language) 是一种数据库语言 。
IndexedDB
就数据库类型而言,IndexedDB
不属于关系型数据库(不支持 SQL 查询语句),更接近 NoSQL 数据库。
IndexedDB 特点
- 键值对储存。 IndexedDB 内部采用对象仓库(object store)存放数据。所有类型的数据都可以直接存入,包括 JavaScript 对象。对象仓库中,数据以"键值对"的形式保存,每一个数据记录都有对应的主键,主键是独一无二的,不能有重复,否则会抛出一个错误。
- 异步。 IndexedDB 操作时不会锁死浏览器,用户依然可以进行其他操作,这与 LocalStorage 形成对比,后者的操作是同步的。异步设计是为了防止大量数据的读写,拖慢网页的表现。
- 支持事务。 IndexedDB 支持事务(transaction),这意味着一系列操作步骤之中,只要有一步失败,整个事务就都取消,数据库回滚到事务发生之前的状态,不存在只改写一部分数据的情况。
- 同源限制 IndexedDB 受到同源限制,每一个数据库对应创建它的域名。网页只能访问自身域名下的数据库,而不能访问跨域的数据库。
- 储存空间大 IndexedDB 的储存空间比 LocalStorage 大得多,一般来说不少于 250MB,甚至没有上限。
- 支持二进制储存。 IndexedDB 不仅可以储存字符串,还可以储存二进制数据(ArrayBuffer 对象和 Blob 对象)。
提示
- 数据库是一系列相关数据的容器。
- 每个数据库包含若干个对象仓库(object store)。它类似于关系型数据库的表格。
- 对象仓库保存的是数据记录。每条记录类似于关系型数据库的行,但是只有主键和数据体两部分。
- 数据库 > 对象仓库 > 数据记录
操作流程
打开数据库:
indexedDB.open()
var version = 1; var databaseName = "database"; var request = window.indexedDB.open(databaseName, version); //这是一个异步操作,但是会立刻返回一个IDBOpenDBRequest对象。方法返回一个IDBRequest对象。这个对象通过三种事件error、success、upgradeneeded处理打开数据库的操作结果。 var db; /** * 新建数据库与打开数据库是同一个操作。 * 如果要打开的数据库不存在,则会先新建数据库: * 1. 新建数据库时调用 request.onupgradeneeded(因为这时版本从无到有,所以会触发这个事件) * 2. 把数据库版本设为 1 * 3. 此时数据库对象 db = e.target.result; * 新建数据库后,就可以打开数据库了,所以继续调用 request.onsuccess * */ request.onupgradeneeded = function (e) { db = e.target.result; console.log("onupgrageneeded"); // 通常新建数据库以后,第一件事是新建对象仓库(即新建表),并设置主键 var objectStore = db.createObjectStore("person", { keyPath: "id", //设置主键为 id }); }; /** * 如果要打开的数据库存在,则会直接打开该数据库 * 此时数据库对象 db = request.result; * */ request.onsuccess = function (e) { db = request.result; console.log("success"); }; /** * 数据库打开错误时调用此回调函数 * */ request.onerror = function (e) { console.log("error"); };
新建数据库
新建数据库与打开数据库是同一个操作。如果指定的数据库不存在,就会新建。
a. 新建对象仓库(即新建表)。
request.onupgradeneeded = function (e) { db = e.target.result; console.log("onupgrageneeded"); // 通常,新建数据库以后,第一件事是新建对象仓库(即新建表),并设置主键 var objectStore = db.createObjectStore("person", { keyPath: "id", //设置主键为 id }); };
b. 更好的写法是先判断一下,这张表格是否存在,如果不存在再新建。
request.onupgradeneeded = function (e) { db = e.target.result; console.log("onupgrageneeded"); // 通常新建数据库以后,第一件事是新建对象仓库(即新建表),并设置主键 var objectStore; if (!db.objectStoreNames.contains(databaseName)) { //如果这个 对象仓库/表 不存在,就新建 objectStore = db.createObjectStore("person", { keyPath: "id", //设置主键为 id }); } };
c. 如果数据记录里面没有合适作为主键的属性,可以让 IndexedDB 自动生成主键(设置主键)。
var objectStore = db.createObjectStore("person", { autoIncrement: true }); //指定主键为一个递增的整数
d. 新建数据库后可以新建当前数据库的索引,使用索引可以更方便的查询数据。
/** * 新建当前数据库的索引 * 必须在VersionChange监听函数里调用 * objectStore.createIndex(indexName, keyPath, objectParameters) * indexName:索引名 * keyPath:主键 * objectParameters:配置对象(可选) * unique:如果设为 true,将不允许重复的值 * multiEntry:如果设为 true,对于有多个值的主键数组,每个值将在索引里面新建一个条目,否则主键数组对应一个条目。 * * */ objectStore.createIndex("name", "name", { unique: false }); //可以重复 objectStore.createIndex("age", "age", { unique: false }); //可以重复 objectStore.createIndex("email", "email", { unique: true }); //不能重复
使用索引查询代码如下:
useIndex() { var db = this.db; var objectStore = db.transaction("person","readonly").objectStore("person"); var index = objectStore.index("name"); var request = index.get("张三"); //只返回第一个 // var request = index.getAll("张三");//返回所有的 “张三” request.onsuccess = function(e){ var result = e.target.result; if(result){ console.log("result:",result); console.log("索引查询成功"); }else{ console.log("索引查询失败"); } } },
新增数据:
新增数据指的是向对象仓库写入数据记录。这需要通过事务完成。
var obj1 = { id: 1, name: "张三", age: 24, email: "zhangsan@foxmail.com" }; var obj2 = { id: 2, name: "李四", age: 30, email: "lisi@foxmail.com" }; function addRecord(obj) { var request = db .transaction(["person"], "readwrite") //写入数据需要新建一个事务。新建时必须指定表格名称和操作模式(“只读”或“读写”) .objectStore("person") //新建事务以后,通过IDBTransaction.objectStore(name)方法,拿到 IDBObjectStore 对象 .add(obj); //再通过表格对象的add()方法,向表格写入一条记录 request.onsuccess = function (e) { console.log("数据写入成功"); }; request.onerror = function (e) { console.log("数据写入失败"); }; } window.onload = function () { addRecord(obj1); addRecord(obj2); };
注意:不加 window.onload 可能存在异步问题,报 undefined 错误。
执行过代码后如果对象仓库仍是空,刷新一下即可:
:::