Databases - Get

Database

还行

string

资源 ID。

string

数据库类型。 这是用于 Azure 门户体验的元数据。

string

资源位置。

string

资源名称。

string

数据库的排序规则。 如果 createMode 不是默认值，则忽略此值。

integer (int64)

数据库的包含状态。

CreateMode

指定数据库创建模式。

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

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

OnlineSecondary/NonReadableSecondary：将数据库创建为现有数据库的辅助副本（可读或不可读）。 sourceDatabaseId 必须指定为现有主数据库的资源 ID。

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

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

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

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

DataWarehouse 版本不支持 Copy、NonReadableSecondary、OnlineSecondary 和 RestoreLongTermRetentionBackup。

string (date-time)

数据库的创建日期（ISO8601格式）。

string (uuid)

数据库的当前服务级别目标 ID。 这是当前处于活动状态的服务级别目标的 ID。

string (uuid)

数据库的 ID。

string

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

string (date-time)

这会记录此数据库的最早开始日期和时间（ISO8601格式）。

DatabaseEdition

数据库的版本。 DatabaseEditions 枚举包含所有有效版本。 如果 createMode 为 NonReadableSecondary 或 OnlineSecondary，则忽略此值。

SKU 列表可能因区域和支持产品/服务而异。 若要确定 Azure 区域中订阅可用的 SKU（包括 SKU 名称、层/版本、系列和容量），请使用 Capabilities_ListByLocation REST API 或以下命令之一：

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>

string

数据库位于的弹性池的名称。 如果 elasticPoolName 和 requestedServiceObjectiveName 均已更新，则忽略 requestedServiceObjectiveName 的值。 DataWarehouse 版本不支持。

string

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

string

以字节表示的数据库的最大大小。 如果 createMode 不是默认值，则忽略此值。 若要查看可能的值，请查询 operationId 引用的功能 API（/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities）：“Capabilities_ListByLocation”。

ReadScale

有條件的。 如果数据库是异地辅助数据库，readScale 指示是否允许与此数据库建立只读连接。 DataWarehouse 版本不支持。

RecommendedIndex[]

此数据库的建议索引。

string

有條件的。 如果 createMode 为 RestoreLongTermRetentionBackup，则此值是必需的。 指定要从中还原的恢复点的资源 ID。

string (uuid)

数据库的已配置服务级别目标 ID。 这是正在应用于数据库的服务级别目标。 成功更新后，它将匹配 currentServiceObjectiveId 属性的值。 如果同时更新 requestedServiceObjectiveId 和 requestedServiceObjectiveName，则 requestedServiceObjectiveId 的值将替代 requestedServiceObjectiveName 的值。

SKU 列表可能因区域和支持产品/服务而异。 若要确定 Azure 区域中订阅可用的服务目标 ID，请使用 Capabilities_ListByLocation REST API。

ServiceObjectiveName

数据库配置的服务级别目标的名称。 这是正在应用于数据库的服务级别目标。 成功更新后，它将匹配 serviceLevelObjective 属性的值。

SKU 列表可能因区域和支持产品/服务而异。 若要确定 Azure 区域中订阅可用的 SKU（包括 SKU 名称、层/版本、系列和容量），请使用 Capabilities_ListByLocation REST API 或以下命令之一：

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>

string (date-time)

有條件的。 如果 createMode 为 PointInTimeRestore，则此值是必需的。 如果 createMode 为 Restore，则此值是可选的。 指定将还原以创建新数据库的源数据库的时间点（ISO8601格式）。 必须大于或等于源数据库的最早RestoreDate 值。

SampleName

指示创建此数据库时要应用的示例架构的名称。 如果 createMode 不是默认值，则忽略此值。 DataWarehouse 版本不支持。

ServiceObjectiveName

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

ServiceTierAdvisor[]

此数据库的服务层顾问列表。 展开的属性

string (date-time)

有條件的。 如果 createMode 为 Restore，并且 sourceDatabaseId 是已删除的数据库的原始资源 ID（而不是其当前可还原的已删除数据库 ID），则此值是必需的。 指定删除数据库的时间。

string

有條件的。 如果 createMode 为 Copy、NonReadableSecondary、OnlineSecondary、PointInTimeRestore、Recovery 或 Restore，则此值是必需的。 指定源数据库的资源 ID。 如果 createMode 为 NonReadableSecondary 或 OnlineSecondary，则源数据库的名称必须与要创建新数据库的名称相同。

string

数据库的状态。

TransparentDataEncryption[]

此数据库的透明数据加密信息。

boolean

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

object

资源标记。

string

资源类型。

number (double)

对维度的绝对影响。

number (double)

维度的相对影响（如果不适用）

string

影响维度的名称。

string

测量对维度的估计影响单位。

string

资源 ID。

string

资源名称。

RecommendedIndexAction

建议的索引作。 可以创建缺失的索引、删除未使用的索引或重新生成现有索引以提高其性能。

string[]

要在其中生成索引的列

string (date-time)

显示创建此资源的 UTC 日期/时间（ISO8601格式）。

OperationImpact[]

执行建议索引作的估计影响。

string[]

要包含在索引中的列名列表

string

完整的生成索引脚本

RecommendedIndexType

索引的类型（CLUSTERED、NONCLUSTERED、COLUMNSTORE、CLUSTERED COLUMNSTORE）

string (date-time)

上次更改此资源的 UTC 日期/时间（ISO8601格式）。

OperationImpact[]

索引作完成后报告的值。

string

表在其上生成索引的架构

RecommendedIndexState

当前建议状态。

string

要在其中生成索引的表。

string

资源类型。

string

资源 ID。

string

资源名称。

number (double)

适用于服务层顾问的 activeTimeRatio。

number (double)

获取或设置服务层顾问的 avgDtu。

number (double)

获取或设置服务层顾问的置信度。

string

获取或设置服务层顾问的 currentServiceLevelObjective。

string (uuid)

获取或设置服务层顾问的 currentServiceLevelObjectiveId。

string

获取或设置服务层顾问的 databaseSizeBasedRecommendationServiceLevelObjective。

string (uuid)

获取或设置服务层顾问的 databaseSizeBasedRecommendationServiceLevelObjectiveId。

string

获取或设置 service tier advisor 的 disasterPlanBasedRecommendationServiceLevelObjective。

string (uuid)

获取或设置 service tier advisor 的 disasterPlanBasedRecommendationServiceLevelObjectiveId。

number (double)

获取或设置服务层顾问的 maxDtu。

number (double)

获取或设置服务层顾问的 maxSizeInGB。

number (double)

获取或设置服务层顾问的 minDtu。

string (date-time)

观察期开始（ISO8601格式）。

string (date-time)

观察期开始（ISO8601格式）。

string

获取或设置服务层顾问的 overallRecommendationServiceLevelObjective。

string (uuid)

获取或设置服务层顾问的 overallRecommendationServiceLevelObjectiveId。

SloUsageMetric[]

获取或设置服务层顾问的 serviceLevelObjectiveUsageMetrics。

string

获取或设置服务层顾问的 usageBasedRecommendationServiceLevelObjective。

string (uuid)

获取或设置 service tier 顾问的 usageBasedRecommendationServiceLevelObjectiveId。

string

资源类型。

number (double)

获取或设置 SLO 使用情况指标的 inRangeTimeRatio。

ServiceObjectiveName

SLO 使用情况指标的 serviceLevelObjective。

string (uuid)

SLO 使用情况指标的 serviceLevelObjectiveId。

string

资源 ID。

string

资源位置。

string

资源名称。

TransparentDataEncryptionStatus

数据库透明数据加密的状态。

string

资源类型。