McoSqlEngine

McoSqlEngine 是大多数 SmartESQL C++ 应用程序的主类。

McoSqlEngine 的一个实例用于打开并连接到 SmartEDB 数据库、执行 SQL 语句和处理查询结果集，以及执行其他数据库操作。

McoSqlEngine 类不是线程安全的，只能从单个线程访问。为防止不当使用，McoSqlEngine 实例会与创建该实例的线程相关联。

如果从其他线程使用引擎，默认情况下 SQL 运行时会引发异常。

有时应用程序可能会选择在多个线程之间共享引擎。为了防止出现问题（包括可能破坏数据库运行时和数据），正确的应用程序级同步是必要的。在这种情况下，为了避免引发异常，应用程序会使用 grab() 方法，该方法将引擎与当前线程关联起来。或者也可以使用 McoMultithreadedSqlEngine 类。

McoSqlEngine 从基类 SqlEngine 继承了许多方法，同时也提供了以下方法：

McoSqlEngine

默认构造函数McoSqlEngine()。

	McoSqlEngine(McoSqlEngine* engine)

复制构造函数。

open

open(params) 使用 McoSqlOpenParameters 参数打开 SQL 引擎。
open(database handle) 使用 SmartEDB 数据库句柄打开 SQL 引擎以进行 SQL 访问。
open(params list) 使用参数列表打开 SQL 引擎。

executeQuery

executeQuery() 执行带有可变参数列表的 SQL 选择语句。
executeQuery(va_list) 执行带有va_list参数的SQL 选择语句，该参数包含一个参数列表或一个Value参数数组。

executeStatement

executeStatement() 执行带有可变参数列表的 SQL 插入、更新或删除语句。
executeStatement(va_list) 执行带有包含参数列表或值参数数组的 va_list 实参的 SQL 插入、更新或删除语句。

beginTransaction

beginTransaction()

启动一个数据库事务，并创建一个Transaction实例。

disconnect

disconnect()

断开数据库连接。

close

close()

关闭数据库。

grab

grab()

将此引擎实例与当前线程相关联。

createConnectionPool

createConnectionPool()

创建并行查询执行所需的连接池。

destroyConnectionPool

destroyConnectionPool()

销毁由 createConnectionPool() 创建的连接池。

connectionPoolSize

connectionPoolSize()

返回连接池大小。

registerExternalTables

registerExternalTables(McoSql::Table** tables, size_t n_tables)

注册外部表（位于其他数据库管理系统或文件中的表）。 xSQL 提供了 McoSql::Table 及其他类的开放实现。

save

save(char const *databaseFile) 将数据库映像保存到指定文件中。
save(void *stream, mco_stream_write streamWriter) 使用流写入器保存数据库映像。

saveClass

saveClass(char const *filePath, char const *className)

将表内容保存到指定的文件中。

loadClass

loadClass()

从指定的文件加载表内容。

saveMetadata

saveMetadata(char const *metadataFile) 将数据库元数据（兼容xSQL）保存到指定的文件中。
saveMetadata(void *stream, mco_stream_write streamWriter) 使用流写入器保存数据库元数据（与xSQL兼容）。