你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

DatabaseUpdate 类

数据库资源。

变量仅由服务器填充，在发送请求时将被忽略。

继承

Model

DatabaseUpdate

构造函数

DatabaseUpdate(*, sku: Sku | None = None, tags: Dict[str, str] | None = None, create_mode: str | CreateMode | None = None, collation: str | None = None, max_size_bytes: int | None = None, sample_name: str | SampleName | None = None, elastic_pool_id: str | None = None, source_database_id: str | None = None, restore_point_in_time: datetime | None = None, source_database_deletion_date: datetime | None = None, recovery_services_recovery_point_id: str | None = None, long_term_retention_backup_resource_id: str | None = None, recoverable_database_id: str | None = None, restorable_dropped_database_id: str | None = None, catalog_collation: str | CatalogCollationType | None = None, zone_redundant: bool | None = None, license_type: str | DatabaseLicenseType | None = None, read_scale: str | DatabaseReadScale | None = None, high_availability_replica_count: int | None = None, secondary_type: str | SecondaryType | None = None, auto_pause_delay: int | None = None, requested_backup_storage_redundancy: str | RequestedBackupStorageRedundancy | None = None, min_capacity: float | None = None, maintenance_configuration_id: str | None = None, is_ledger_on: bool | None = None, **kwargs)

参数

sku

Sku

必需

SKU 的名称和层。

tags

dict[str, str]

必需

一组标记。 资源标记。

create_mode

str 或 CreateMode

必需

指定数据库创建模式。

默认值：常规数据库创建。

复制：将数据库创建为现有数据库的副本。 sourceDatabaseId 必须指定为源数据库的资源 ID。

辅助数据库：将数据库创建为现有数据库的辅助副本。 sourceDatabaseId 必须指定为现有主数据库的资源 ID。

PointInTimeRestore：通过还原现有数据库的时间点备份来创建数据库。 sourceDatabaseId 必须指定为现有数据库的资源 ID，并且必须指定 restorePointInTime。

恢复：通过还原异地复制的备份来创建数据库。 sourceDatabaseId 必须指定为要还原的可恢复数据库资源 ID。

还原：通过还原已删除数据库的备份来创建数据库。 必须指定 sourceDatabaseId。 如果 sourceDatabaseId 是数据库的原始资源 ID，则必须指定 sourceDatabaseDeletionDate。 否则，sourceDatabaseId 必须是可还原的已删除数据库资源 ID，并且 sourceDatabaseDeletionDate 将被忽略。 还可以指定 restorePointInTime 从较早的时间点还原。

RestoreLongTermRetentionBackup：通过从长期保留保管库还原来创建数据库。 recoveryServicesRecoveryPointResourceId 必须指定为恢复点资源 ID。

DataWarehouse 版本不支持 Copy、Secondary 和 RestoreLongTermRetentionBackup。 可能的值包括：“Default”、“Copy”、“Secondary”、“PointInTimeRestore”、“Restore”、“Recovery”、“RestoreExternalBackup”、“RestoreExternalBackupSecondary”、“RestoreLongTermRetentionBackup”、“OnlineSecondary”。

collation

str

必需

数据库的排序规则。

max_size_bytes

<xref:long>

必需

以字节表示的数据库的最大大小。

sample_name

str 或 SampleName

必需

创建此数据库时要应用的示例架构的名称。 可能的值包括：“AdventureWorksLT”、“WideWorldImportersStd”、“WideWorldImportersFull”。

elastic_pool_id

str

必需

包含此数据库的弹性池的资源标识符。

source_database_id

str

必需

与此数据库的创建操作关联的源数据库的资源标识符。

restore_point_in_time

datetime

必需

指定要还原以创建新数据库的源数据库的时间点 (ISO8601 格式) 。

source_database_deletion_date

datetime

必需

指定数据库被删除的时间。

recovery_services_recovery_point_id

str

必需

与此数据库的创建操作关联的恢复点的资源标识符。

long_term_retention_backup_resource_id

str

必需

与此数据库的创建操作关联的长期保留备份的资源标识符。

recoverable_database_id

str

必需

与此数据库的创建操作关联的可恢复数据库的资源标识符。

restorable_dropped_database_id

str

必需

与此数据库的创建操作关联的可还原删除数据库的资源标识符。

catalog_collation

str 或 CatalogCollationType

必需

元数据目录的排序规则。 可能的值包括：“DATABASE_DEFAULT”、“SQL_Latin1_General_CP1_CI_AS”。

zone_redundant

bool

必需

此数据库是否为区域冗余，这意味着此数据库的副本将分布在多个可用性区域。

license_type

str 或 DatabaseLicenseType

必需

要为此数据库申请的许可证类型。 LicenseIncluded如果需要许可证，或者BasePrice如果你有许可证并且有资格获得Azure 混合权益。 可能的值包括：“LicenseIncluded”、“BasePrice”。

read_scale

str 或 DatabaseReadScale

必需

只读路由的状态。 如果启用，其连接字符串中应用程序意向设置为只读的连接可能会路由到同一区域中的只读次要副本。 可能的值包括：“Enabled”、“Disabled”。

high_availability_replica_count

int

必需

与数据库关联的用于提供高可用性的辅助副本数。

secondary_type

str 或 SecondaryType

必需

数据库的辅助类型（如果它是辅助数据库）。 有效值为 Geo 和 Named。 可能的值包括：“Geo”、“Named”。

auto_pause_delay

int

必需

数据库自动暂停的时间（分钟）。 值为 -1 表示禁用自动暂停。

requested_backup_storage_redundancy

str 或 RequestedBackupStorageRedundancy

必需

用于存储此数据库的备份的存储帐户类型。 可能的值包括：“Geo”、“Local”、“Zone”。

min_capacity

float

必需

数据库始终分配的最小容量（如果未暂停）。

maintenance_configuration_id

str

必需

分配给数据库的维护配置 ID。 此配置定义将发生维护更新的时间段。

is_ledger_on

bool

必需

此数据库是否为账本数据库，这意味着数据库中的所有表都是账本表。 注意：创建数据库后，无法更改此属性的值。

变量

status

str 或 DatabaseStatus

数据库的状态。 可能的值包括：“Online”、“Restoring”、“RecoveryPending”、“Recoverying”、 “Suspect”、“Offline”、“Standby”、“Shutdown”、“EmergencyMode”、“AutoClosed”、“复制”、“创建”、“不可访问”、“OfflineSecondary”、“暂停”、“Paused”、“Resuming”、“Scaling”、“OfflineChangingDwPerformanceTiers”、“OnlineChangingDwPerformanceTiers”、“Disabled”。

database_id

str

数据库的 ID。

creation_date

datetime

数据库的创建日期 (ISO8601 格式) 。

current_service_objective_name

str

数据库的当前服务级别目标名称。

requested_service_objective_name

str

数据库请求的服务级别目标名称。

default_secondary_location

str

此数据库的默认次要区域。

failover_group_id

str

此数据库所属的故障转移组资源标识符。

max_log_size_bytes

<xref:long>

此数据库的最大日志大小。

earliest_restore_date

datetime

这将记录此数据库最早的开始日期和时间， (ISO8601 格式) 。

current_sku

Sku

SKU 的名称和层。

current_backup_storage_redundancy

str 或 CurrentBackupStorageRedundancy

用于存储此数据库的备份的存储帐户类型。 可能的值包括：“Geo”、“Local”、“Zone”。

paused_date

datetime

用户配置或操作暂停数据库的日期 (ISO8601 格式) 。 如果数据库已准备就绪，则为 Null。

resumed_date

datetime

用户操作或数据库登录恢复数据库的日期 (ISO8601 格式) 。 如果数据库已暂停，则为 Null。

is_infra_encryption_enabled

bool

为此数据库启用了基础结构加密。