SQLite PRAGMA

SQLite 的 pragma命令是一个特殊的命令，SQLite环境内可以用来控制各种环境变量和状态标志。可以读取一个pragma值，也可以根据需求设置。

语法

要查询当前的pragma值，只需要提供该pragma的名字：

PRAGMA pragma_name;

为PRAGMA要设置一个新的值，使用以下语法：

PRAGMA pragma_name = value;

设置模式，可以是名称或等值的整数，但返回的值将始终是一个整数。

auto_vacuum Pragma

auto_vacuum编译指示获取或设置自动真空模式。以下是简单的语法：

PRAGMA [database.]auto_vacuum; PRAGMA [database.]auto_vacuum = mode;

模式可以是以下任何一种：

pragma值	描述
0 or NONE	Auto-vacuum is disabled. This is default mode which means that a database file will never shrink in size unless it is manually vacuumed using the VACUUM command.
1 or FULL	Auto-vacuum is enabled and fully automatic which allows a database file to shrink as data is removed from the database.
2 or INCREMENTAL	Auto-vacuum is enabled but must be manually activated. In this mode the reference data is maintained, but free pages are simply put on the free list. These pages can be recovered using the incremental_vacuum pragmaany time.

cache_size Pragma

将cache_size pragma 可以得到或暂时设置在内存中的页面缓存的最大大小。以下是简单的语法：

PRAGMA [database.]cache_size; PRAGMA [database.]cache_size = pages;

该的页数值表示在缓存中的页面数。内置页面缓存的默认大小2,000页，最小尺寸10页。

case_sensitive_like Pragma

 case_sensitive_like pragma控制的情况下，灵敏度的内置的LIKE表达式。默认情况下，该pragma为false，这意味着，内置的LIKE操作符忽略字母的大小写。以下是简单的语法：

PRAGMA case_sensitive_like = [true|false];

也没有办法查询该pragma的当前状态。

count_changes Pragma

在count_changes pragma获取或设置返回值的数据操作语句，如INSERT，UPDATE和DELETE。以下是简单的语法：

PRAGMA count_changes; PRAGMA count_changes = [true|false];

默认情况下，该pragma为false，这些语句不返回任何东西。如果设置为true，每个所提到的语句将返回一列，一列的表，由一个单一的整数值，表示操作影响的行。

database_list Pragma

database_listpragma 将用于列出了所有的数据库连接。以下是简单的语法：

PRAGMA database_list;

该pragma将返回与开放或附加的数据库，数据库中的序列号，它的名字和文件相关的一列，每一个三列的表。

encoding Pragma

编码pragma指示控制如何将字符串编码并存储在数据库中的文件。以下是简单的语法：

PRAGMA encoding; PRAGMA encoding = format;

格式值可以是UTF-8，UTF-16LE或UTF-16BE之一。

freelist_count Pragma

 freelist_count pragma返回一个整数表明有多少个数据库页当前标记为自由和可用。以下是简单的语法：

PRAGMA [database.]freelist_count;

格式值可以是UTF-8，UTF-16LE或UTF-16BE之一。

index_info Pragma

index_info pragma将返回关于数据库索引的信息。以下是简单的语法：

PRAGMA [database.]index_info( index_name );

结果集将包含一行出栏序列表和列名，列索引在索引中包含每一列。

index_list Pragma

index_list pragma列出所有与表相关联的索引。以下是简单的语法：

PRAGMA [database.]index_list( table_name );

结果集将包含每个索引一行指数序列，索引名和标志，指示是否索引是否唯一。

journal_mode Pragma

journal_mode pragma获取或设置控制日志文件如何存储和处理的日志模式。以下是简单的语法：

PRAGMA journal_mode; PRAGMA journal_mode = mode; PRAGMA database.journal_mode; PRAGMA database.journal_mode = mode;

支持journal 模式有五种：

Pragma 值	描述
DELETE	This is default mode. Here at the conclusion of a transaction, the journal file is deleted.
TRUNCATE	The journal file is truncated to a length of zero bytes.
PERSIST	The journal file is left in place, but the header is overwritten to indicate the journal is no longer valid.
MEMORY	The journal record is held in memory, rather than on disk.
OFF	No journal record is kept.

max_page_count Pragma

max_page_count pragma获取或设置为数据库允许的最大页面数。以下是简单的语法：

PRAGMA [database.]max_page_count; PRAGMA [database.]max_page_count = max_page;

默认值为1,073,741,823这是一个千兆的页面这意味着如果默认1 KB的页面大小，这使得数据库中增长起来的一个terabyte。

page_count Pragma

page_count pragma 返回当前数据库中的网页数量。以下是简单的语法：

PRAGMA [database.]page_count;

数据库文件的大小应该是 page_count * page_size.

page_size Pragma

page_size pragma 获取或设置数据库页面的大小。以下是简单的语法：

PRAGMA [database.]page_size; PRAGMA [database.]page_size = bytes;

默认情况下，允许的尺寸是512，1024，2048，4096，8192，16384，32768字节。只有这样，才能改变现有的数据库页面大小设置页面大小，然后立即用数据库的VACUUM 。

parser_trace Pragma

parser_trace pragma控制打印的调试状态，因为它解析SQL命令。以下是简单的语法：

PRAGMA parser_trace = [true|false];

默认情况下，它被设置为false，但启用其设置为true时，SQL解析器会打印出它的状态，因为它解析SQL命令。

recursive_triggers Pragma

recursive_triggers pragma获取或设置的递归触发器功能。如果未启用递归触发器，触发动作将不会触发另一个触发。以下是简单的语法：

PRAGMA recursive_triggers; PRAGMA recursive_triggers = [true|false];

schema_version Pragma

schema_version pragma 获取或设置值存储在数据库头的架构版本。以下是简单的语法：

PRAGMA [database.]schema_version; PRAGMA [database.]schema_version = number;

这是一个32位有符号整数，跟踪模式的变化。每当一个模式改变命令的执行（比如，CREATE或DROP），这个值是递增。

secure_delete Pragma

secure_delete pragma 用来控制内容是如何从数据库中删除。以下是简单的语法：

PRAGMA secure_delete; PRAGMA secure_delete = [true|false]; PRAGMA database.secure_delete; PRAGMA database.secure_delete = [true|false];

安全删除标志的默认值通常是关闭的，但是这是可以改变的SQLITE_SECURE_DELETE构建选项。

sql_trace Pragma

sql_trace pragma 用于转储到屏幕上SQL跟踪结果。以下是简单的语法：

PRAGMA sql_trace; PRAGMA sql_trace = [true|false];

SQLite必须编译 SQLITE_DEBUG指令被列入该pragma。

synchronous Pragma

synchronous pragma 获取或设置当前磁盘的同步模式，控制如何积极SQLite将数据写入物理存储。以下是简单的语法：

PRAGMA [database.]synchronous; PRAGMA [database.]synchronous = mode;

SQLite支持下同步模式：

Pragma 值	描述
0 or OFF	No syncs at all
1 or NORMAL	Sync after each sequence of critical disk operations
2 or FULL	Sync after each critical disk operation

temp_store Pragma

temp_store pragma 获取或设置临时数据库文件所使用的存储模式。以下是简单的语法：

PRAGMA temp_store; PRAGMA temp_store = mode;

SQLite支持以下存储模式：

Pragma 值	描述
0 or DEFAULT	Use compile-time default. Normally FILE.
1 or FILE	Use file-based storage.
2 or MEMORY	Use memory-based storage.

temp_store_directory Pragma

 temp_store_directory pragma 获取或设置用于临时数据库文件的位置。以下是简单的语法：

PRAGMA temp_store_directory; PRAGMA temp_store_directory = 'directory_path';

user_version Pragma

user_version pragma 获取或设置用户定义的版本值存储在数据库头。以下是简单的语法：

PRAGMA [database.]user_version; PRAGMA [database.]user_version = number;

这是一个32位有符号整数的值可以设置由开发人员的版本跟踪目的。

writable_schema Pragma

writable_schema pragma 获取或设置能够修改系统表。以下是简单的语法：

PRAGMA writable_schema; PRAGMA writable_schema = [true|false];

pragma设置，表开始sqlite_的可以创建和修改，包括SQLITE_MASTER表。使用pragma时要小心，因为它可能导致完成数据库损坏。