配置 Spanner 实例

Spanner 是一项全代管式关键任务数据库服务，整合了关系型、图表、键值对和搜索数据库。Spanner 可提供全球范围的事务一致性、自动同步复制功能（实现高可用性），并支持以下 SQL 方言：

• GoogleSQL
• PostgreSQL

如需了解详情，请参阅实例概览。

本文档介绍了使用 App Design Center 创建 Spanner 实例时可以配置的连接和参数。配置参数基于 terraform-google-cloud-spanner Terraform 模块。

组件连接

下表列出了可以连接到 Spanner 实例的组件，以及对应用及其生成的 Terraform 代码的相应更新。

连接的组件	应用更新	背景信息
Compute Engine 实例模板	Compute Engine 实例可以在 Spanner 实例中读取和写入数据。 roles/spanner.databaseAdmin 角色已添加到 Compute Engine 实例模板服务帐号。 Compute Engine 服务帐号已作为 IAM 用户添加到 Spanner 实例。	在虚拟机实例中使用 Spanner
服务账号	服务帐号有权访问 Spanner 实例。 服务帐号已作为 IAM 用户添加到 Spanner 实例。	使用服务账号配置实例
Cloud Run	Cloud Run 服务可以管理 Spanner 实例。 Spanner 连接详细信息已添加到 Cloud Run 环境变量。 roles/spanner.databaseAdmin 角色已添加到 Cloud Run 服务帐号。 Cloud Run 服务帐号 IAM 信息已添加到 Spanner 实例。	连接到 Google Cloud 服务

必需的配置参数

如果您的模板包含 Spanner 组件，则必须先配置以下参数，然后才能进行部署。

参数名称	说明和限制条件	背景信息
项目 ID	要在其中部署 Spanner 实例的项目。	配置组件
实例名称	实例的唯一标识符，实例创建后无法更改。名称的长度必须介于 6 到 30 个字符之间。	name
实例配置	config	实例配置

可选配置参数

以下参数是可选的。如需显示高级参数，请在配置 区域中选择显示高级字段 。

功能	参数名称	说明和限制条件信息	背景信息
实例大小	节点数	nodeCount	计算容量、节点和处理单元
	处理单元	processingUnits	计算容量、节点和处理单元
	实例显示名称	displayName	更改显示名称
	创建实例	默认情况下，系统会创建一个新的 Spanner 实例。如需使用现有实例，请取消选中该复选框。	创建和管理实例
	启用自动扩缩	选择此选项可在 Spanner 实例上启用自动扩缩。	自动扩缩概览
	实例 IAM	实例的权限逗号分隔列表。例如：user:[e-mail]=>roles/spanner.databaseAdmin, user:[e-mail]=>roles/spanner.databaseAdmin	IAM 概览
实例标签	键	labels	为实例添加标签
	值	labels	为实例添加标签
数据库配置	键	database_config 地图对象的键。	database_config
	版本保留期限	versionRetentionPeriod	时间点恢复 (PITR) 概览
	DDL	ddl	GoogleSQL 或 PostgreSQL
	KMS 密钥名称	kmsKeyName	客户管理的加密密钥 (CMEK) 概览
	删除防护	选择此选项可防止 Terraform 删除数据库。	deletion_protection
	数据库 IAM	数据库的权限列表，以英文逗号分隔。例如：user:[e-mail]=>roles/spanner.databaseAdmin, user:[e-mail]=>roles/spanner.databaseAdmin	IAM 概览
	启用备份	默认情况下，系统会自动创建数据库备份。如果您不想要备份，请取消选中该复选框。	备份概览
	备份保留	retentionDuration	增量备份
	创建数据库	默认情况下，系统会创建一个数据库。如果您不想要数据库，请取消选中该复选框。	数据库概览
	Cron 规范文本	文本	创建和管理备份时间表
	处理单元下限	minProcessingUnits	托管式自动扩缩器
	处理单元上限	maxProcessingUnits	托管式自动扩缩器
	节点数下限	minNodes	托管式自动扩缩器
	节点数上限	maxNodes	托管式自动扩缩器
	高优先级 CPU 利用率百分比	highPriorityCpuUtilizationPercent	托管式自动扩缩器
	存储空间利用率百分比	storageUtilizationPercent	托管式自动扩缩器
	副本位置	location	非对称只读自动扩缩
	替换节点数下限	AutoscalingConfigOverrides	托管式自动扩缩器参数
	替换节点数上限	AutoscalingConfigOverrides	托管式自动扩缩器参数
	版本	版本	Spanner 版本概览
	默认备份时间表类型	defaultBackupScheduleType	默认备份时间表
	强制销毁	选择此选项可在删除 Spanner 实例时删除备份。	force_destroy
	使用完整备份规范	fullBackupSpec	备份时间表
	使用增量备份规范	incrementalBackupSpec	增量备份