关于本地 SQL 数据库

AIR 本地 SQL 数据库功能可以用于将应用程序数据存储在用户的本地计算机上的任何目的。Adobe AIR 包括在本地存储数据的几种机制，各机制具有不同的优点。以下是本地 SQL 数据库在 AIR 应用程序中的一些可能用途：

• 对于面向数据的应用程序（例如通讯簿），数据库可以用于存储主应用程序数据。

• 对于面向文档的应用程序（用户创建要保存并可能共享的文档），可以在用户指定的位置将每个文档另存为数据库文件。（不过请注意，除非加密了数据库，否则任何 AIR 应用程序都可以打开该数据库文件。对于可能存在敏感信息的文档，建议使用加密。）

• 对于支持网络的应用程序，数据库可以用于存储应用程序数据的本地缓存，或者在网络连接不可用时暂时存储数据。可以创建一种将本地数据库与网络数据存储同步的机制。

• 对于任何应用程序，数据库都可以用于存储单个用户的应用程序设置，例如用户选项或应用程序信息（如窗口大小和位置）。

单个 Adobe AIR 本地 SQL 数据库作为单个文件存储在计算机的文件系统中。运行时包括 SQL 数据库引擎，该引擎管理数据库文件的创建和结构化以及操作和检索数据库文件中的数据。运行时不指定在文件系统上存储数据库数据的方式或位置；相反，每个数据库完全存储在单个文件中。您指定在文件系统中存储数据库文件的位置。单个 AIR 应用程序可以访问一个或多个单独的数据库（即单独的数据库文件）。由于运行时将每个数据库作为单个文件存储在文件系统上，因此可以在需要时按照应用程序的设计和操作系统的文件访问约束查找您的数据库。每个用户都可以具有其特定数据的单独数据库文件，或者数据库文件可以由在单个计算机上共享数据的所有应用程序用户访问。由于数据对单个计算机是本地的，因此在不同计算机上的用户之间并不自动共享数据。本地 SQL 数据库引擎未提供对远程数据库或基于服务器的数据库执行 SQL 语句的任何功能。

关系数据库是一种在计算机上存储（和检索）数据的机制。数据被组织到表中：行表示记录或项目，而列（有时称为“字段”）将每个记录分到各个值中。例如，通讯簿应用程序可能包含“朋友”表。表中的每个行都表示存储在数据库中的单个朋友。表的列表示名字、姓氏、出生日期等数据。对于表中的每个朋友行，数据库为每个列存储一个单独的值。

关系数据库设计用于存储复杂数据，其中一个项目与其他类型的项目关联或相关。在关系数据库中，应该将具有一对多关系（其中单个记录可以与不同类型的多个记录相关）的任何数据分到不同的表中。例如，假定您希望通讯簿应用程序为每个朋友存储多个电话号码；这就是一对多关系。“朋友”表包含每个朋友的所有个人信息。单独的“电话号码”表包含所有朋友的所有电话号码。

除了存储有关朋友和电话号码的数据外，每个表都需要一段数据来跟踪这两个表之间的关系，以便使单个朋友记录与其电话号码匹配。该数据称为主键 — 将一个表中的每个行与该表中的其他行区分开的唯一标识符。主键可以是“自然键”，这意味着它是自然区分表中每个记录的数据项目之一。在“朋友”表中，如果您知道朋友的出生日期都是不同的，则可以将出生日期列用作“朋友”表的主键（自然键）。如果没有自然键，则应单独创建一个主键列，如“朋友 id”（应用程序用于区分各行的人工值）。

使用主键，可以设置多个表之间的关系。例如，假定“朋友”表有一个“朋友 id”列，其中包含每行（每个朋友）的唯一编号。 可以用以下两列来构建相关的“电话号码”表：一个列包含电话号码所属的朋友的“朋友 id”，另一列包含实际的电话号码。这样，不管单个朋友具有多少个电话号码，都可以将它们全部存储在“电话号码”表中，并可以使用“朋友 id”主键将其链接到相关的朋友。在相关表中使用一个表的主键指定记录之间的联系时，相关表中的值称为外键。与许多数据库不同，AIR 本地数据库引擎不允许您创建外键约束（即自动检查插入的或更新的外键值在主键表中是否具有对应行的约束）。然而，外键关系是关系数据库结构的重要部分，而且在数据库的表之间创建关系时应该使用外键。

结构化查询语言 (SQL) 用于关系数据库以操作和检索数据。SQL 是一种描述性语言，而不是一种过程语言。SQL 语句描述您所需的一组数据，而不是提供有关它应该如何检索数据的计算机指令。数据库引擎确定如何检索该数据。

SQL 语言已由美国国家标准协会 (ANSI) 进行了标准化。Adobe AIR 本地 SQL 数据库支持 SQL-92 标准的大部分内容。

有关 Adobe AIR 中支持的 SQL 语言的特定说明，请参阅 本地数据库中的 SQL 支持 。

要在 JavaScript 中使用本地 SQL 数据库，请使用以下类的实例。（请注意，需要在 HTML 文档中加载文件 AIRAliases.js 才能使用这些类的 air.* 别名）：

若要获取描述数据库结构的架构信息，请使用以下类：

以下类提供用于 SQLConnection 类的常数：

此外，以下类表示所用的事件（和支持常数）：

最后，以下类提供有关数据库操作错误的信息：

编写代码以处理本地 SQL 数据库时，会指定以两种执行模式之一执行数据库操作：异步或同步执行模式。通常，代码示例说明如何以这两种方式执行每个操作，以便您可以使用最适合您需求的示例。

在异步执行模式中，为运行时提供一个指令，运行时将在请求的操作完成或失败时调度事件。首先，通知数据库引擎执行操作。在应用程序继续运行的同时，数据库引擎在后台工作。最后，完成操作时（或者它失败时），数据库引擎调度事件。由事件触发的代码执行后续操作。此方法具有一个重要的优点：运行时在后台执行数据库操作，同时主应用程序代码继续执行。如果数据库操作花费大量的时间，则应用程序继续运行。最重要的是，用户可以继续与其交互，而屏幕不会冻结。但是，与其他代码相比，编写异步操作代码可能更加复杂。在必须将多个相关的操作分配给各个事件侦听器方法的情况下，通常会出现此复杂性。

从概念上说，将操作作为单个步骤序列（一组同步操作，而不是分到几个事件侦听器方法中的一组操作）进行编码更为简单。除了异步数据库操作外，Adobe AIR 还允许您同步执行数据库操作。在同步执行模式中，操作不在后台运行。相反，它们以与所有其他应用程序代码相同的执行序列运行。通知数据库引擎执行操作。然后，代码在数据库引擎工作时暂停。完成操作后，继续执行下一行代码。

异步还是同步执行操作是在 SQLConnection 级别上设置的。使用单个数据库连接，无法同步执行某些操作或语句，同时异步执行其他操作或语句。通过调用 SQLConnection 方法打开数据库，可以指定 SQLConnection 是在同步还是异步执行模式下操作。如果调用 SQLConnection.open() ，则连接在同步执行模式下操作；如果调用 SQLConnection.openAsync() ，则连接在异步执行模式下操作。使用 open() 或 openAsync() 将 SQLConnection 实例连接到数据库后，除非先关闭再重新打开到数据库的连接，否则该实例将固定为同步或异步执行模式。

每种执行模式各有其优点。虽然每种模式的大多数方面是类似的，但是在每种模式下工作时要牢记一些差异。有关这些主题的详细信息以及在每种模式下工作的建议，请参阅 使用同步和异步数据库操作 。