跳到主要内容

数据库

createCollection

1. 接口描述

接口功能:该接口可创建集合

接口声明:

createCollection(collectionName: string): Promise<Object>

createCollectionIfNotExists(collectionName: string): Promise<Object>

2. 输入参数

字段必填类型说明
CollectionNameString集合名

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}

let { database } = new CloudBase(cloudbaseConfig)

async function test() {
let result = await database.createCollection('collectionName')
console.log(result)
}

test()

checkCollectionExists

1. 接口描述

接口功能:检查集合是否存在

接口声明:checkCollectionExists(collectionName: string): Promise<Object>

2. 输入参数

字段必填类型说明
-String集合名

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识
MsgString错误信息
ExistsBoolean集合是否已经存在

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}

let { database } = new CloudBase(cloudbaseConfig)

async function test() {
let result = await database.checkCollectionExists('collectionAlreadyExists')
if (result.Exists) {
// 集合存在
} else {
// 集合不存在
}
}

test()

deleteCollection

1. 接口描述

接口功能:删除集合

接口声明:deleteCollection(collectionName: string): Promise<Object>

2. 输入参数

字段必填类型说明
CollectionNameString集合名

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识
ExistsBoolean存在不返回该字段,不存在则返回 false

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}

let { database } = new CloudBase(cloudbaseConfig)
async function test() {
let result = await database.deleteCollection('collectionAlreadyExists')
if (result.Exists === false) {
// 集合不存在
}
}

test()

updateCollection

1. 接口描述

接口功能:更新集合

接口声明:updateCollection(collectionName: string, options: array): Promise<Object>

该接口可更新集合,但目前支持更新索引。

⚠️ 目前该接口只能更新索引,包括创建和删除。

  • 索引创建时如果已经存在,则会先删除再创建索引。
  • 因为一次接口调用可同时创建多个索引,所以可能部分索引创建失败,部分创建成功,接口报异常。

2. 输入参数

字段必填类型说明
collectionNameString集合名
optionsArray<Option>配置选项

Option

字段必填类型说明
CreateIndexesArray<CreateIndex>需要创建的索引列表
DropIndexesArray<DropIndex>需要删除的索引列表

CreateIndex

字段必填类型说明
IndexNameString索引名称
MgoKeySchemaArray<MgoKeySchema>索引规则

MgoKeySchema

字段必填类型说明
MgoIsUniqueboolean是否唯一
MgoIndexKeysArray<MgoIndexKey>索引包含的字段列表

MgoIndexKey

字段必填类型说明
NameString索引名称
DirectionString索引方向,1:ASC,-1:DESC,2d:双向,如果有 2d,2d 必须放最前面,注:地理位置索引应设置该值为 "2dsphere"

DropIndex

字段必填类型说明
IndexNameString索引名称

更新索引支持的两种方式,创建与删除,相互独立,不可在 options 同时传入 CreateIndexes,DropIndexes

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识

4. 示例代码

创建新索引

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}

let { database } = new CloudBase(cloudbaseConfig)
async function test() {
let result = await database.updateCollection('collectionAlreadyExists', {
CreateIndexes: [
{
IndexName: 'index_a',
MgoKeySchema: {
MgoIndexKeys: [
// 2d要放最前面
{ Name: 'a_2d', Direction: '2d' },
{ Name: 'a_1', Direction: '1' },
{ Name: 'a_-1', Direction: '-1' }
],
MgoIsUnique: false
}
},
{
IndexName: 'index_b',
MgoKeySchema: {
MgoIndexKeys: [{ Name: 'b_1', Direction: '2d' }],
MgoIsUnique: true
}
},
{
IndexName: 'index_to_be_delete',
MgoKeySchema: {
MgoIndexKeys: [{ Name: 'xxx', Direction: '2d' }],
MgoIsUnique: true
}
}
]
})
console.log(result)
}

test()

删除索引

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}

let { database } = new CloudBase(cloudbaseConfig)

async function test() {
let result = await database.updateCollection('collectionAlreadyExists', {
DropIndexes: [{ IndexName: 'index_to_be_delete' }]
})
console.log(result)
}

test()

describeCollection

1. 接口描述

接口功能:查询集合详细信息

接口声明:describeCollection(collectionName: string): Promise<Object>

2. 输入参数

字段必填类型说明
CollectionNameString集合名

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识
IndexNumNumber索引个数
IndexesArray索引列表
Indexes[N].NameString索引名称
Indexes[N].SizeString索引大小,单位: 字节
Indexes[N].UniqueString是否为唯一索引
Indexes[N].KeysArray索引键值
Indexes[N].Keys[N].NameString键名
Indexes[N].Keys[N].DirectionString索引方向,1: ASC, -1: DESC, 2d:双向
Indexes[N].AccessesArray索引使用信息
Indexes[N].Accesses[N].OpsNumber索引命中次数
Indexes[N].Accesses[N].SinceString命中次数从何时开始计数

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}

let { database } = new CloudBase(cloudbaseConfig)

async function test() {
let result = await database.describeCollection('collectionAlreadyExists')
const { Indexes } = result
for (let index in Indexes) {
console.log(index) // 遍历全部索引
}
}

test()

listCollections

1. 接口描述

接口功能:查询集合详细信息

接口声明:listCollections(options: object): Promise<Object>

2. 输入参数

字段必填类型说明
MgoOffsetNumber可选,偏移量
MgoLimitNumber可选,数量限制

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识
CollectionsArray集合列表
Collections[N].CollectionNameString集合名称
Collections[N].CountNumber集合中文档数量
Collections[N].SizeNumber集合占用空间大小,字节
Collections[N].IndexCountNumber集合中索引个数
Collections[N].IndexSizeNumber集合中索引占用空间大小,字节
PagerObject本次查询分页信息
Pager.OffsetNumber偏移量
Pager.LimitNumber限制数量
Pager.TotalNumber集合数量

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}

let { database } = new CloudBase(cloudbaseConfig)

async function test() {
let result = await database.listCollections({
MgoOffset: 100,
MgoLimit: 10
})
const { Collections } = result
for (let collection in Collections) {
console.log(collection) // 遍历全部collection
}
}

checkIndexExists

1. 接口描述

接口功能:检查索引是否存在

接口声明:checkIndexExists(collectionName: string, indexName: string): Promise<Object>

2. 输入参数

字段必填类型说明
collectionNameString集合名
indexNameString索引名

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识
ExistsBoolean索引是否存在

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}

let { database } = new CloudBase(cloudbaseConfig)
async function test() {
let result = await database.checkIndexExists(
'collectionAlreadyExists',
'index_to_be_delete'
)
const { Exists } = result
if (Exists === true) {
//索引存在
}
}
test()

import

1. 接口描述

接口功能:导入数据

接口声明:import(collectionName: string, file: object, options: object): Promise<Object>

注意:

  • 该接口立即返回,迁移状态(成功|失败)可通过 migrateStatus 查询。
  • 导入数据需要先将文件上传到该环境(同一个 EnvId)下的对象存储中,所以会在对象存储中创建对象。
  • 因为该函数成功返回只意味着上传成功,导入操作在上传后开始,该接口无法判断导入是否完成,所以该对象用完后需要手动删除。

2. 输入参数

字段必填类型说明
collectionNameString集合名
fileArray数据,以下方式必选一种
⁃ FilePathString本地数据文件路径
⁃ ObjectKeyString本环境下对象存储 Key
optionsArray可选参数
⁃ ObjectKeyPrefixString对象存储 Key 前缀,默认 tmp/db-imports/
⁃ FileTypeString文件类型:csv 或 json,如果为传递此参数,默认为文件后缀名,注意使用正确的后缀名。
⁃ StopOnErrorBoolean遇到错误时是否停止导入。
⁃ ConflictModeString冲突处理方式:insert 或 upsert

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识
JobIdNumber任务 ID,用于在 migrateStatus 接口查询迁移状态

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}

let { database } = new CloudBase(cloudbaseConfig)

async function test() {
let res = await database.import(
'collectionAlreadyExists',
{
ObjectKey: 'data.csv'
},
{
// "FileType" : "csv",
StopOnError: true,
ConflictMode: 'upsert'
}
)

const { JobId } = res
console.log(JobId)
}

test()

export

1. 接口描述

接口功能:导出数据,迁移状态(成功|失败)可通过 migrateStatus 查询。

接口声明:export(collectionName: string, file: object, options: object): Promise<Object>

2. 输入参数

字段必填类型说明
collectionNameString集合名
fileArray数据,以下方式必选一种
⁃ ObjectKeyString本环境下对象存储 Key
optionsArray可选参数
⁃ FileTypeString文件类型:csv 或 json,如果为传递此参数,默认为文件后缀名,注意使用正确的后缀名
⁃ QueryStringJSON 字符串,支持 mongo 指令。例如:'{ a: { gte: 3 } }'。与 mongodb 查询语法兼容
⁃ SkipNumber偏移量
⁃ LimitNumber限制数目
⁃ SortNumberJSON 字符串,如果有索引则不支持排序,数据集的长度必须少于 32 兆
⁃ FieldsString字符串,字段以逗号分割。FileType=csv 时必填

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识
JobIdNumber任务 ID,用于在 migrateStatus 接口查询迁移状态

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}

let { database } = new CloudBase(cloudbaseConfig)

async function test() {
let result = await database.export(
'users',
{
ObjectKey: 'users.json'
},
{
Fields: '_id,name',
Query: '{"name":{"$exists":true}}',
Sort: '{"name": -1}',
Skip: 0,
Limit: 1000
}
)
const { JobId } = res
console.log(JobId)
}

test()

migrateStatus

1. 接口描述

接口功能:该接口可查询迁移(导入|导出)状态。

接口声明:migrateStatus(jobId: number): Promise<Object>

2. 输入参数

字段必填类型说明
jobIdInteger任务 ID,import 和 export 接口返回的 JobId

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识
StatusString任务状态。可能值:waiting:等待中,reading:读,writing:写,migrating:转移中,success:成功,fail:失败
RecordSuccessInteger迁移成功的数据条数
RecordFailInteger迁移失败的数据条数
ErrorMsgString迁移失败的原因
FileUrlString文件下载链接,仅在数据库导出中有效

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}

let { database } = new CloudBase(cloudbaseConfig)

async function test() {
let result = await database.migrateStatus(100093275)
console.log(result.Status) // 打印迁移状态
}

test()

distribution

1. 接口描述

接口功能:查询数据分布

接口声明:distribution(): Promise<Object>

2. 输入参数

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识
CollectionsArray集合列表
Collections[N].CollectionNameString集合名称
Collections[N].DocCountNumber文档数量

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}
let { database } = new CloudBase(cloudbaseConfig)

async function test() {
let result = await database.distribution()
const { Collections } = result
for (let collection in Collections) {
console.log(collection)
}
}

test()

插入文档

1. 接口描述

接口功能:该接口用于向数据库中插入数据

接口声明:manager.commonService('flexdb').call(option): Promise<Object>

2. 输入参数

字段必填类型说明
ActionString接口名称
ParamObject接口参数

Param 字段说明

字段必填类型说明
TableNameString表名
MgoDocsArray<String>待插入文档
TagStringmongo 实例 ID, 可通过 envInfo 接口获取

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识
InsertedIdsArray<String>插入成功的数据集合主键_id

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}
const manager = new CloudBase(cloudBaseConfig)

const data = JSON.stringify({
a: 1
})

// 获取数据库实例ID
const { EnvInfo } = await manager.env.getEnvInfo()

const { Databases } = EnvInfo
console.log('Databases:', Databases)
const { InsertedIds } = await manager.commonService('flexdb').call({
Action: 'PutItem',
Param: {
TableName: 'coll-1',
MgoDocs: [data],
Tag: Databases[0].InstanceId
}
})
console.log('InsertedIds:', InsertedIds)

查询文档

1. 接口描述

接口功能:该接口用于查询数据库文档

接口声明:manager.commonService('flexdb').call(option): Promise<Object>

2. 输入参数

字段必填类型说明
ActionString接口名称
ParamObject接口参数

Param 字段说明

字段必填类型说明
TableNameString表名
MgoLimitNumber查询返回结果 limit 数
MgoProjectionString投影条件,为一个 json 串,如{ item: 1, status: 1 }表示结果中返回 item 和 status 两个列;{ item: 0}表示不返回 item 列
TagStringmongo 实例 ID, 可通过 envInfo 接口获取
MgoQueryString查询条件,查询条件为一个 json 串,如{"test":1}
MgoOffsetNumber查询结果从 offset 条开始返回
MgoSortString排序条件,排序条件为一个 json 串

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识
PagerPager分页信息
DataArray<String>满足查询条件的数据集合
字段必填类型说明
OffsetNumber分页偏移量
LimitNumber每页返回记录数

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}
const manager = new CloudBase(cloudBaseConfig)

// 获取数据库实例ID
const { EnvInfo } = await manager.env.getEnvInfo()

const { Databases } = EnvInfo
console.log('Databases:', Databases)
const { Data } = await manager.commonService('flexdb').call({
Action: 'Query',
Param: {
TableName: 'coll-1',
MgoQuery: JSON.stringify({ a: 1 }),
Tag: Databases[0].InstanceId,
MgoLimit: 20
}
})
console.log('Data:', Data)

更新文档

1. 接口描述

接口功能:该接口用于更新数据库文档

接口声明:manager.commonService('flexdb').call(option): Promise<Object>

2. 输入参数

字段必填类型说明
ActionString接口名称
ParamObject接口参数

Param 字段说明

字段必填类型说明
TagStringmongo 实例 ID, 可通过 envInfo 接口获取
MgoQueryString查询条件,查询条件为一个 json 串,如{"test":1}
MgoUpdateString更新内容
TableNameString表名
MgoIsMultiBoolean是否更新多条
MgoUpsertBoolean是否使用 upsert 模式

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识
UpsertedIdString插入的数据_id
ModifiedNumNumber已经修改的行数
MatchedNumNumber更新条件匹配到的结果数

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}
const manager = new CloudBase(cloudBaseConfig)

// 获取数据库实例ID
const { EnvInfo } = await manager.env.getEnvInfo()

const { Databases } = EnvInfo
console.log('Databases:', Databases)
const { ModifiedNum } = await manager.commonService('flexdb').call({
Action: 'UpdateItem',
Param: {
TableName: 'coll-1',
MgoUpdate: JSON.stringify({ a: 2 }),
MgoQuery: JSON.stringify({ a: 1 }),
Tag: Databases[0].InstanceId
}
})
console.log('ModifiedNum:', ModifiedNum)

删除文档

1. 接口描述

接口功能:该接口用于删除数据库文档

接口声明:manager.commonService('flexdb').call(option): Promise<Object>

2. 输入参数

字段必填类型说明
ActionString接口名称
ParamObject接口参数

Param 字段说明

字段必填类型说明
TagStringmongo 实例 ID, 可通过 envInfo 接口获取
MgoQueryString查询条件,查询条件为一个 json 串,如{"test":1}
TableNameString表名
MgoIsMultiBoolean是否更新多条

3. 返回结果

字段必填类型说明
RequestIdString请求唯一标识
DeletedNumber删除数据的条数

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}
const manager = new CloudBase(cloudBaseConfig)

// 获取数据库实例ID
const { EnvInfo } = await manager.env.getEnvInfo()

const { Databases } = EnvInfo
console.log('Databases:', Databases)
const { Deleted } = await manager.commonService('flexdb').call({
Action: 'DeleteItem',
Param: {
TableName: 'coll-1',
MgoQuery: JSON.stringify({ a: 2 }),
Tag: Databases[0].InstanceId
}
})
console.log('Deleted:', Deleted)

查询可回档时间

1. 接口描述

接口功能:获取所选表格可回档时间的交集

接口声明:manager.commonService('flexdb').call(option): Promise<Object>

2. 输入参数

字段必填类型说明
ActionString接口名称
ParamObject接口参数

Param 字段说明

字段必填类型说明
InstanceIdStringmongo 实例 ID, 可通过 envInfo 接口获取

3. 返回结果

字段必填类型说明
RestoreTimesArray<String>可回档时间列表
RequestIdString请求唯一标识

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}
const manager = new CloudBase(cloudBaseConfig)

// 获取数据库实例ID
const { EnvInfo } = await manager.env.getEnvInfo()

const { Databases } = EnvInfo

// 查询可回档时间
const { RestoreTimes } = await manager.commonService('flexdb').call({
Action: 'DescribeRestoreTime',
Param: {
InstanceId: Databases[0].InstanceId
}
})

console.log(RestoreTimes)

获取可回档表格

1. 接口描述

接口功能:获取可回档表格

接口声明:manager.commonService('flexdb').call(option): Promise<Object>

2. 输入参数

字段必填类型说明
ActionString接口名称
ParamObject接口参数

Param 字段说明

字段必填类型说明
InstanceIdStringmongo 实例 ID, 可通过 envInfo 接口获取
TimeString可回档时间

3. 返回结果

字段必填类型说明
TablesArray<String>可回档表格列表
RequestIdString请求唯一标识

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}
const manager = new CloudBase(cloudBaseConfig)

// 获取数据库实例ID
const { EnvInfo } = await manager.env.getEnvInfo()

const { Databases } = EnvInfo

// 查询可回档时间
const { RestoreTimes } = await manager.commonService('flexdb').call({
Action: 'DescribeRestoreTime',
Param: {
InstanceId: Databases[0].InstanceId
}
})

console.log(RestoreTimes)

// 获取可回档表格
const { Tables } = await manager.commonService('flexdb').call({
Action: 'DescribeRestoreTables',
Param: {
InstanceId: Databases[0].InstanceId,
Time: RestoreTimes[0]
}
})

console.log(Tables)

实例表格回档

1. 接口描述

接口功能:实例表格回档

接口声明:manager.commonService('flexdb').call(option): Promise<Object>

2. 输入参数

字段必填类型说明
ActionString接口名称
ParamObject接口参数

Param 字段说明

字段必填类型说明
InstanceIdStringmongo 实例 ID, 可通过 envInfo 接口获取
TimeString可回档时间
ModifyTableNamesInfoArray<ModifyTableNamesInfoItem>回档表格信息

ModifyTableNamesInfoItem

字段必填类型说明
OldTableNameString原表名
NewTableNameString新表名(新表名一定不能与原表名相同!)

3. 返回结果

字段必填类型说明
FlowIdString流程 ID
RequestIdString请求唯一标识

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}
const manager = new CloudBase(cloudBaseConfig)

// 获取数据库实例ID
const { EnvInfo } = await manager.env.getEnvInfo()

const { Databases } = EnvInfo

// 查询可回档时间
const { RestoreTimes } = await manager.commonService('flexdb').call({
Action: 'DescribeRestoreTime',
Param: {
InstanceId: Databases[0].InstanceId
}
})

console.log(RestoreTimes)

// 获取可回档表格
const { Tables } = await manager.commonService('flexdb').call({
Action: 'DescribeRestoreTables',
Param: {
InstanceId: Databases[0].InstanceId,
Time: RestoreTimes[0]
}
})

console.log(Tables)

const { FlowId } = await manager.commonService('flexdb').call({
Action: 'RestoreTCBTables',
Param: {
InstanceId: Databases[0].InstanceId,
Time: RestoreTimes[0],
ModifyTableNamesInfo: [
{
OldTableName: 'coll-1',
NewTableName: 'coll-1_bak'
}
]
}
})

console.log('FlowId:', FlowId)

获取回档任务

1. 接口描述

接口功能:获取回档任务

接口声明:manager.commonService('flexdb').call(option): Promise<Object>

2. 输入参数

字段必填类型说明
ActionString接口名称
ParamObject接口参数

Param 字段说明

字段必填类型说明
InstanceIdStringmongo 实例 ID, 可通过 envInfo 接口获取

3. 返回结果

字段必填类型说明
TasksArray<RestoreTask>可回档表格列表
RequestIdString请求唯一标识

RestoreTask

字段必填类型说明
TablesArray<[ModifyTableNamesInfoItem](#ModifyTableNamesInfoItem)>回档任务涉及表格
CreateTimeString任务创建时间
StatusNumber当前任务状态(0-待执行,1-运行中,2-已完成)
EndTimeString任务完成时间
RestoreTimeString回档时间点

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}
const manager = new CloudBase(cloudBaseConfig)

// 获取数据库实例ID
const { EnvInfo } = await manager.env.getEnvInfo()

const { Databases } = EnvInfo

const { Tasks } = await manager.commonService('flexdb').call({
Action: 'DescribeRestoreTask',
Param: {
InstanceId: Databases[0].InstanceId
}
})

console.log('Tasks:', Tasks)

修改表名

1. 接口描述

接口功能:修改表名

接口声明:manager.commonService('flexdb').call(option): Promise<Object>

2. 输入参数

字段必填类型说明
ActionString接口名称
ParamObject接口参数

Param 字段说明

字段必填类型说明
TagStringmongo 实例 ID, 可通过 envInfo 接口获取
ModifyTableInfoArray<[ModifyTableNamesInfoItem](#ModifyTableNamesInfoItem)>修改表名信息

3. 返回结果

字段必填类型说明
FlowIdString流程 ID
RequestIdString请求唯一标识

4. 示例代码

const cloudbaseConfig = {
secretId: 'Your SecretId',
secretKey: 'Your SecretKey',
envId: 'Your envId' // 云开发环境ID,可在腾讯云云开发控制台获取
}
const manager = new CloudBase(cloudBaseConfig)

// 获取数据库实例ID
const { EnvInfo } = await manager.env.getEnvInfo()

const { Databases } = EnvInfo

const { FlowId } = await manager.commonService('flexdb').call({
Action: 'ModifyNameSpace',
Param: {
Tag: Databases[0].InstanceId,
ModifyTableInfo: [
{
OldTableName: 'coll-1_bak',
NewTableName: 'coll-1_bak_modify'
}
]
}
})

console.log('FlowId:', FlowId)