3.2.8 备份功能_MySQL NDB Cluster API 开发人员指南

ndb_mgm_start_backup()

描述

此功能用于启动 NDB Cluster 的备份。

签名

int ndb_mgm_start_backup
    (
      NdbMgmHandle          handle,
      int                   wait,
      unsigned int*         id,
      struct ndb_mgm_reply* reply
    )

参数

此函数需要此处列出的四个参数：

管理服务器 handle(an NdbMgmHandle)。
一个wait标志，具有以下可能的值：
- 0：不要等待备份确认。
- 1：等待备份开始。
- 2：等待备份完成。
创建具有备份 ID 的备份 id。（这也是函数的返回值。）

如果设置为 0， id则不返回任何备份。wait
指向 ndb_mgm_reply 结构的指针以容纳 reply.

返回值

成功时，备份 ID ( id)。如果失败，该函数返回-1。

ndb_mgm_start_backup2()

描述

此功能用于启动 NDB Cluster 的备份。它与相同 ndb_mgm_start_backup()，不同之处在于它额外指定了一个用于下一次备份的值。

签名

int ndb_mgm_start_backup
    (
      NdbMgmHandle          handle,
      int                   wait,
      unsigned int*         id,
      struct ndb_mgm_reply* reply,
      unsigned int          nextBackupId
    )

参数

此函数需要此处列出的五个参数：

管理服务器 handle(an NdbMgmHandle)。
一个wait标志，具有以下可能的值：
- 0：不要等待备份确认。
- 1：等待备份开始。
- 2：等待备份完成。
创建具有备份 ID 的备份 id。（这也是函数的返回值。）

如果设置为 0， id则不返回任何备份。wait
指向 ndb_mgm_reply 结构的指针以容纳 reply.
下一次备份的 ID 设置为的值nextBackupID + 1。

返回值

成功时，备份 ID 作为 id. 否则，函数返回-1。

ndb_mgm_start_backup3()

描述

此功能用于启动 NDB Cluster 的备份。它与相同 ndb_mgm_start_backup2()，但增加了一个参数，用于指定备份开始时或完成时备份的状态是否与集群的状态匹配。

签名

int ndb_mgm_start_backup
    (
      NdbMgmHandle          handle,
      int                   wait,
      unsigned int*         id,
      struct ndb_mgm_reply* reply,
      unsigned int          nextBackupId,
      unsigned int          backupPoint
    )

参数

此函数需要此处列出的六个参数：

管理服务器 handle(an NdbMgmHandle)。
一个wait标志，具有以下可能的值：
- 0：不要等待备份确认。
- 1：等待备份开始。
- 2：等待备份完成。
创建具有备份 ID 的备份 id。（这也是函数的返回值。）

如果设置为 0， id则不返回任何备份。wait
指向 ndb_mgm_reply 结构的指针以容纳 reply.
下一次备份的 ID 设置为的值nextBackupID + 1。
backupPoint如果备份状态应反映集群在备份开始时的状态，则为 1，如果其状态应反映集群在备份完成时的状态，则为 0。使用 1 相当于调用ndb_mgm客户端 START BACKUP 命令SNAPSHOTSTART；0 相当于用调用命令 SNAPSHOTEND。

返回值

成功时，备份 ID 作为 id. 否则，函数返回-1。

ndb_mgm_start_backup4()

描述

此功能用于启动 NDB Cluster 的备份。它与相同 ndb_mgm_start_backup3()，不同之处在于它使用提供的指定长度的密码生成加密备份。

这个函数是在 NDB 8.0.22 中添加的。

签名

int ndb_mgm_start_backup
    (
      NdbMgmHandle          handle,
      int                   wait,
      unsigned int*         id,
      struct ndb_mgm_reply* reply,
      unsigned int          nextBackupId,
      unsigned int          backupPoint,
      const char*           password,
      unsigned int          password_length
    )

参数

此函数需要此处列出的八个参数：

管理服务器 handle(an NdbMgmHandle)。
一个wait标志，具有以下可能的值：
- 0：不要等待备份确认。
- 1：等待备份开始。
- 2：等待备份完成。
创建具有备份 ID 的备份 id。（这也是函数的返回值。）

如果设置为 0， id则不返回任何备份。wait
指向 ndb_mgm_reply 结构的指针以容纳 reply.
下一次备份的 ID 设置为的值nextBackupID + 1。
backupPoint如果备份状态应反映集群在备份开始时的状态，则为 1，如果其状态应反映集群在备份完成时的状态，则为 0。使用 1 相当于调用ndb_mgm客户端 START BACKUP 命令SNAPSHOTSTART；0 相当于用调用命令 SNAPSHOTEND。
用于保护加密备份的密码。这是一个长度最多为 256 个字符的字符串；密码字符串中可以使用任何可打印的 ASCII 字符，但 !, ', ", $, %,\和除外^。
密码的长度。

可以指定空密码，但不建议这样做。

返回值

成功时，备份 ID 作为 id. 否则，函数返回-1。

ndb_mgm_abort_backup()

描述

此功能用于停止 NDB Cluster 备份。

签名

int ndb_mgm_abort_backup
    (
      NdbMgmHandle          handle,
      unsigned int          id,
      struct ndb_mgm_reply* reply)

参数

这个函数有 3 个参数：

一个NdbMgmHandle。
id要中止的备份的。
指向 ndb_mgm_reply 结构的指针。

返回值

如果出现错误，此函数将返回 -1。