# 创建和获取分布式数据库 >![](../../public_sys-resources/icon-note.gif) **说明:** >从 API Version 7 开始支持。 ## 导入模块 ``` import factory from '@ohos.data.distributeddata'; ``` ## 权限 无 ## createKVManager\(config: KVManagerConfig, callback: AsyncCallback\): void 创建分布式数据库管理对象。 此方法为异步callback方法。 - 参数: 参数名 类型 说明 config KVManagerConfig 用于配置管理对象,包括用户信息和应用包名。 callback AsyncCallback<KVManager> 回调函数,获取数据库管理对象实例。 - 返回值: 无 - 示例: ``` factory.createKVManager(config, function (err, manager) { kvManager = manager; }); ``` ## createKVManager\(config: KVManagerConfig\): Promise 创建分布式数据库管理对象。 此方法为异步promise方法。 - 参数: 参数名 类型 说明 config KVManagerConfig 用于配置管理对象,包括用户信息和应用包名。 - 返回值: 参数名 类型 Promise<KVManager> promise实例,用于获取异步返回结果。 - 示例: ``` const promise = factory.createKVManager(config); promise.then((manager) => { kvManager = manager; }).catch((err) => { }); ``` ## KVManager 提供管理分布式数据库的接口。 ### getKVStore\(storeId: string, options: Options\): Promise 创建或获取数据库实例。需要先通过[createKVManager](#zh-cn_topic_0000001179090937_section192192415554)创建或获取KVStore实例。 此方法为异步promise方法。 - 参数: 参数名 类型 说明 storeId string 用于标识数据库。同一应用下该参数值必须唯一且长度应小于1KB。 options Options 数据库实例的配置信息。 - 返回值: 参数名 类型 Promise<T> promise实例,用于获取异步返回结果。 - 示例: ``` const promise = kvManager.getKVStore(options); promise.then((store) => { kvStore = store; }).catch((err) => { }); ``` ### getKVStore\(storeId: string, options: Options, callback: AsyncCallback\): void 创建并获取数据库实例。 此方法为异步callback方法。 - 参数: 参数名 类型 说明 storeId string 用于标识数据库。同一应用下该参数值必须唯一且长度应小于1KB。 options Options 数据库实例的配置信息。 callback AsyncCallback<T> 回调函数,获取数据库实例。 - 返回值: 无 - 示例: ``` kvManager.getKVStore('storeId', options, function(err, store){ kvStore = store; }); ```
参数名
类型
说明
config
KVManagerConfig
用于配置管理对象,包括用户信息和应用包名。
callback
AsyncCallback<KVManager>
回调函数,获取数据库管理对象实例。
Promise<KVManager>
promise实例,用于获取异步返回结果。
storeId
string
用于标识数据库。同一应用下该参数值必须唯一且长度应小于1KB。
options
Options
数据库实例的配置信息。
Promise<T>
AsyncCallback<T>
回调函数,获取数据库实例。