本页面介绍了如何在 Spanner 上创建备份。 如需详细了解备份,请参阅备份概览。 您可以使用以下方式备份数据库:
准备工作
-
如需获取创建备份所需的权限, 请让管理员授予您 实例上的以下 IAM 角色:
-
创建、查看、更新和删除备份:
Cloud Spanner Backup Admin (
roles/spanner.backupAdmin
) -
创建和查看备份:
Cloud Spanner Backup Writer (
roles/spanner.backupWriter
)
-
创建、查看、更新和删除备份:
Cloud Spanner Backup Admin (
此页面上的 gcloud CLI 示例做出了以下假设:
- 您已将 gcloud CLI 设置为与 Spanner。如果您不熟悉如何通过 Spanner,请参阅 Spanner 使用入门 使用 gcloud CLI
您已为项目配置了 gcloud CLI。例如:
gcloud config set core/project PROJECT_ID
创建备份
控制台
在 Google Cloud 控制台中,转到 Spanner 实例页面。
点击包含要备份的数据库的实例。
点击数据库。
在导航窗格中,点击备份/恢复。
在备份标签页中,点击创建备份。
填写表单,然后点击创建。
如需查看备份操作的进度,请参阅 检查操作进度。
gcloud
在使用下面的命令数据之前,请先进行以下替换:
- INSTANCE_ID:Spanner 实例 ID。
- DATABASE_ID:Spanner 数据库 ID。
- BACKUP_NAME:Spanner 备份名称。
执行以下命令:
Linux、macOS 或 Cloud Shell
gcloud spanner backups create BACKUP_NAME --instance=INSTANCE_ID --database=DATABASE_ID --retention-period=1y --async
Windows (PowerShell)
gcloud spanner backups create BACKUP_NAME --instance=INSTANCE_ID --database=DATABASE_ID --retention-period=1y --async
Windows (cmd.exe)
gcloud spanner backups create BACKUP_NAME --instance=INSTANCE_ID --database=DATABASE_ID --retention-period=1y --async
您应该会收到类似如下所示的响应:
Create request issued for: BACKUP_NAME Check operation [projects/PROJECT_ID/instances/INSTANCE_ID/backups/BACKUP_NAME/operations/_auto_op_234567] for status.
以下是一些使用说明:
- 要设置备份的到期日期,请指定
--retention-period
或--expiration-date
标志。如需了解日期语法,请参阅gcloud topic datetimes
。 - 备份的名称在实例中必须是唯一的。
- 由于
--async
标志,该命令会立即返回。如果没有此标志,该命令将等待备份操作完成。 - 请指定
--help
标志以获取有关任何命令的帮助。
如需查看备份操作的进度,请参阅 检查操作进度。
客户端库
以下代码示例可在特定 version_time
创建备份
然后等待它完成完成后,它会验证备份是否
并检索其相关信息,如名称、大小和
创建时间。
C++
C#
Go
Java
<ph type="x-smartling-placeholder">
Node.js
<ph type="x-smartling-placeholder">
PHP
<ph type="x-smartling-placeholder">
Python
<ph type="x-smartling-placeholder">
Ruby