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

Databases - Upgrade Data Warehouse

升级数据仓库。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/upgradeDataWarehouse?api-version=2021-11-01

URI 参数

Name In Required Type Description
databaseName
path True
  • string

要升级的数据库的名称。

resourceGroupName
path True
  • string

包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。

serverName
path True
  • string

服务器的名称。

subscriptionId
path True
  • string

用于标识 Azure 订阅的订阅 ID。

api-version
query True
  • string

要用于请求的 API 版本。

响应

Name Type Description
200 OK

已成功升级数据仓库。

202 Accepted

正在升级数据仓库。

Other Status Codes

错误响应: ***

  • 400 InvalidStandbyGeoReadScale - 用户尝试在不支持它的备用异地数据库上启用读取缩放。

  • 400 PerDatabaseCMKKeyRotationAttemptedWhileOldThumbprintInUse - 数据库级别的 TDE 保护程序的密钥轮换被阻止,因为活动事务将持有使用旧密钥加密的日志。 有关解决此问题的可能策略,请参阅 aka.ms/azuresqldbkeyrotation。

  • 400 TierChangeUnsupportedDueToMemoryOptimizedObject - 数据库无法更新其 SKU,因为它具有内存优化的对象。

  • 在数据库上启用长期备份保留时,不支持 400 PerDBCMKNotSupportedWithLTR - 数据库级 CMK。

  • 400 SourceServerNotFound - CreateDatabaseAsCopy API 调用中提供的源数据库 ID 的服务器部分不会映射到现有服务器。

  • 400 ElasticPoolOverStorageUsage - 尝试在达到弹性池的存储限制时将数据写入数据库。

  • 400 InvalidDatabaseCreateMode - 创建数据库的请求无效。

  • 400 MissingAsymmetricKeyOnTargetServer - 目标服务器无权访问非对称密钥。

  • 400 MismatchingSubscriptionWithUrl - 提供的订阅与 URL 中的订阅不匹配。

  • 400 MultipleDroppedDatabasesWithTheSameName - 在服务器上找到了多个具有相同名称的已删除数据库。

  • 400 InvalidAddSecondaryPermission - 用户没有足够的权限在指定服务器上添加辅助数据库。

  • 400 AzureKeyVaultClientError - Azure 密钥保管库客户端遇到错误。

  • 400 UnsupportedServiceName - 指定的名称是无效名称,因为它包含一个或多个不支持的 unicode 字符。

  • 400 AzureKeyVaultClientInfoError - 获取 Azure 密钥保管库 客户端信息时出错。

  • 400 CurrentDatabaseLogSizeExceedsMaxSize - 用户尝试将数据库更改为最大日志大小低于当前使用情况的 SKU。

  • 400 IsLedgerDatabaseIsNotSupportedOnResourceType - 此资源类型不支持更改账本属性。

  • 400 InvalidBackupStorageAccountType - 用户在数据库创建/更新期间传递了 zrs/lrs,但由于客户未列入允许列表或 zrs 在指定区域中不可用,因此失败。

  • 400 CannotUpdateToFreeDatabase - 不支持将数据库更新到免费 SKU。

  • 400 DatabaseInvalidSkuPropertyCombination - 请求的 SKU 的属性不一致。 请检查是否指定了有效的组合。 有关详细信息,请参阅 https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability

  • 400 DatabaseNamedReplicaPerDatabaseLimitExceeded - 用户尝试创建一个命名副本,该副本将超过每个主数据库允许的数字

  • 400 UnsupportedBackupStorageRedundancyForEdition - 版本不支持请求的备份存储冗余

  • 400 DatabaseIsCurrentlyPinned - Microsoft 已将数据库固定到SQL Server引擎版本。 为了确保数据库未遇到生产问题,在数据库未固定之前,将阻止数据库的任何将来缩放操作。 请联系 Microsoft 支持部门获取有关缩放的帮助。

  • 400 RestoreTargetEditionSizeInsufficient - 用户尝试将数据库还原到小于源当前分配大小的版本。

  • 400 InvalidSku - 用户指定了无效 SKU。

  • 400 InvalidTierSkuCombination - 指定的层不支持指定的 SKU。

  • 400 ServerNotFound - 找不到请求的服务器。

  • 400 UnsupportedBackupStorageRedundancy - 目标区域中不支持指定的备份存储冗余。

  • 400 InvalidIdentityId - 提供的一个或多个标识 ID () 提供的 ARM 资源 ID (s) 无效。 请输入有效 ID (s) ,然后重试。

  • 400 LTRSterlingToVldbMigrationNotSupported - 无法将数据库的服务目标更改为“超大规模”,因为超大规模尚不支持长期保留。 请在数据库上禁用长期保留,然后重试。

  • 400 TokenTooLong - 提供的令牌太长。

  • 400 FeatureDisabledOnSelectedEdition - 用户尝试使用当前数据库版本上禁用的功能。

  • 400 OfferDisabledOnSubscription - 订阅套餐类型受到限制,无法预配请求的资源。

  • 400 UnableToCreateGeoChain - 用户尝试创建辅助数据库 (链接) 即使配置了自动上传账本摘要

  • 400 InvalidNumberOfIdentities - 数据库级别仅支持一个用户分配的托管标识。

  • 400 DatabaseNamedReplicaChainingNotAllowed - 用户尝试创建不允许的命名副本的命名副本。

  • 400 DatabaseNamedReplicaInvalidOperation - 用户尝试对命名副本执行不受支持的操作。

  • 400 DatabaseNamedReplicaInvalidSourceDatabase - 用户尝试在与源数据库不同的订阅或区域中创建命名副本。

  • 400 InvalidTargetSubregion - 不可读辅助数据库的目标服务器不在 DR 配对的 Azure 区域中。

  • 400 CannotAssignIdentityToMaster - 无法向系统数据库分配标识。 无法将数据库标识分配给“master”、“model”、“tempdb”、“msdb”或“resource”数据库。

  • 400 PerDatabaseCMKDWNotSupported - Datawarehouse 版本不支持预览版中的数据库级 CMK。

  • 400 DatabaseCreationBlockedForNonActivatedCMKServer - 在激活工作区之前,已启用 CMK 的工作区会阻止 SQL 池创建。 首先,启用清除保护,并在工作区密钥的 Azure 密钥保管库上向工作区托管标识授予获取、包装密钥、解包密钥) 所需的 (权限。 接下来,在授予访问权限后激活工作区。

  • 400 PartnerServerNotCompatible - 用户尝试将数据库从 SAWA V1 服务器复制到斯特林服务器,反之亦然。

  • 400 错误ReplicationLinkState - 该操作要求数据库在复制链接上处于预期状态。

  • 400 TargetElasticPoolDoesNotExist - 服务器上不存在弹性池。

  • 400 ElasticPoolSkuCombinationInvalid - 仅当 SKU 指定为“ElasticPool”时,才能一起指定弹性池和 sku。

  • 400 ElasticPoolTierCombinationInvalid - 数据库层不同于弹性池服务层。

  • 400 ElasticPoolNameRequired - 用户尝试创建或更新数据库到弹性池服务目标,而无需指定弹性池的名称。

  • 400 MissingThumbprintCrm - CRM 数据库的还原操作失败,因为缺少所需的 TDE 证书。 请重试到现有弹性池的还原操作。

  • 400 ElasticPoolOverStorage - 尝试在达到弹性池的存储限制时将数据写入数据库。

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings - 尝试为超过弹性池请求的 DTU 的数据库提供 DTU 最小值。

  • 400 RestoreTargetEditionSizeInsufficientV2 - 用户尝试将数据库还原到小于已还原数据库分配大小的版本。

  • 400 TierChangeUnsupportedDueToCDCEnabledDatabase - 数据库无法更新其 SKU,因为它已启用 CDC。

  • 400 ElasticPoolDatabaseCountOverLimit - 尝试在达到弹性池的数据库计数限制时创建或添加弹性池。

  • 400 ResourcePoolStorageLimitHitDuringRestore - 由于池中剩余的存储容量,还原的数据库无法还原到资源池中。

  • 400 CannotChangeToOrFromDataWarehouseTier - 用户尝试将数据库的 SKU 从 DataWarehouse 层更改为非 DataWarehouse 层,反之亦然。

  • 400 CurrentDatabaseSizeExceedsMaxSize - 用户尝试将数据库的最大大小减小为小于当前使用情况的大小。

  • 400 PerDatabaseCMKRestoreNotSupported - 在预览版中配置数据库级 CMK 时不支持数据库还原。

  • 400 PerDatabaseCMKHSNotSupported - 超大规模版本不支持预览版中的数据库级 CMK。

  • 400 AzureKeyVaultKeyDisabled - 无法在服务器上完成该操作,因为 Azure 密钥保管库 密钥已禁用。

  • 400 PerDatabaseCMKGeoReplicationNotSupported - 在预览版中配置数据库级 CMK 时,不支持异地复制和数据库复制。

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage - 尝试降低弹性池的存储限制低于其存储使用量。

  • 400 AzureKeyVaultInvalidExpirationDate - 操作无法完成,因为 Azure 密钥保管库密钥过期日期无效。

  • 400 InvalidStandbyGeoEdition - 用户尝试创建基于 DTU 的备用地理位置。

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty - 操作无法完成,因为 Azure 密钥保管库 Uri 为 null 或空。

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings - 每个数据库的数据库数和 VCore 最小值不能超过弹性池请求的 VCore 数。

  • 400 UpdateNotAllowedOnPausedDatabase - 用户尝试对暂停的数据库执行更新。

  • 400 GeoRestoreBackupStorageTypeNotSupported - 针对未配置为使用异地冗余备份存储的数据库发出数据库恢复请求无效。

  • 400 RestoreHyperscaleToNonHyperscale - 不支持将超大规模数据库备份还原到非超大规模服务层级,反之亦然。

  • 400 SubscriptionDoesNotHaveAccessToServer - 订阅无权访问指定的服务器 (s)

  • 400 RecoveryPointDoesNotExist - 指定的恢复点不存在或无效。

  • 400 AzureKeyVaultNoServerIdentity - 服务器标识未正确配置。

  • 400 InvalidMaxSizeTierCombination - 指定的层不支持指定的数据库最大大小。

  • 400 LtrBackupNotFound - 指定的长期保留备份不存在。

  • 400 AzureKeyVaultInvalidUri - 来自 Azure 密钥保管库的无效响应。 请使用有效的 Azure 密钥保管库 URI。

  • 400 InvalidPointInTime - 指定的时间点对数据库无效。

  • 400 AzureKeyVaultMissingPermissions - 服务器缺少对 Azure 密钥保管库所需的权限。

  • 400 GeoRestoreCannotResolveTargetCluster - 无法解析服务器的目标群集

  • 400 InvalidReadScaleEdition - 用户尝试对不支持它的数据库类型启用读取缩放。

  • 400 CannotSpecifyEditionOrSloWhenRestoringToPool - 还原到弹性池时不支持指定目标服务级别目标或版本。

  • 400 InvalidReadScaleUnits - 用户尝试提供不支持的读取缩放值。

  • 当前配置为异地辅助数据库的数据库不支持 400 RestoreNotSupportedForGeoDrSecondary - 时间点还原和数据库恢复操作。

  • 400 SecurityAzureKeyVaultInvalidKeyName - 由于服务器密钥名称无效,无法完成该操作。

  • 400 RegionDoesNotSupportVersion - 用户尝试在不支持该服务器版本的位置创建指定版本的服务器。

  • 400 GeoSecondaryMaxSizeUpdateFailed - 异地辅助数据库是不支持所请求的最大值或异地辅助数据库位于不受支持的区域中的 SLO,或者异地辅助数据库上的更新操作已在进行中。

  • 400 AdalGenericError - 由于遇到 Azure Active Directory 错误,无法完成该操作。

  • 400 AdalServicePrincipalNotFound - 操作无法完成,因为遇到 Azure Active Directory 库服务主体找不到错误。

  • 400 InvalidTier - 用户指定了无效层。

  • 400 AzureKeyVaultMalformedVaultUri - 提供的密钥保管库 uri 无效。

  • 400 CannotUseReservedDatabaseName - 不能在此操作中使用保留的数据库名称。

  • 400 RequestedDatabaseSizeRequiresShrink - 用户尝试 ALTER DATABASE MODIFY MAXSIZE 以将数据库的 MAXSIZE 修改为较小的大小,然后修改当前大小。

  • 400 CurrentDatabaseSizeExceedsDbMaxSize - 用户尝试将数据库的最大大小减小到小于当前使用情况的大小。

  • 400 InvalidServerName - 指定的服务器名称无效。

  • 400 CannotUseTrailingWhitespacesInDatabaseName - 数据库名称验证失败。

  • 400 SourceDatabaseEditionCouldNotBeUpgraded - 源数据库的版本不能高于目标数据库。

  • 400 SecurityAdalPrincipalCertExpiredError - 操作无法完成,因为 Azure 密钥保管库主体证书已过期。

  • 400 TargetDatabaseEditionCouldNotBeDowngraded - 目标数据库的版本不能低于源数据库。

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - 由于服务器“上数据库”{0}{1}“的副本或故障转移操作当前正在进行中,因此不允许该操作。

  • 400 InvalidCollation - 服务器无法识别排序规则。

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel - 提供的密钥保管库 uri 无效。

  • 400 KeyMaterialNotFoundOnRemoteServer - 远程服务器无权访问用作 TDE 保护程序的密钥材料。

  • 400 AzureKeyVaultRsaKeyNotSupported - 提供的密钥保管库使用不支持的 RSA 密钥大小或密钥类型。 支持的 RSA 密钥大小为 2048 或 3072,密钥类型为 RSA 或 RSA-HSM。

  • 400 SameKeyMaterialNotFoundOnRemoteServer - 辅助服务器没有主服务器的加密保护程序的密钥材料。

  • 400 ElasticPoolOverFileSpace - 弹性池中的文件空间不足。

  • 400 PartnerDBNotCompatibleForSGXEnclave - 仅当两个数据库都在 DC 系列硬件上运行时,才支持为已启用 enclave 的数据库设置 GeoDR 链接或更新 SLO。

  • 400 UpdateNotAllowedInCurrentReplicationState - 该操作在其当前复制状态下不允许对数据库执行操作。

  • 400 InvalidLicenseType - 用户尝试使用不支持的许可证类型创建或更新数据库或弹性池。

  • 400 GeoReplicaLimitReached - 达到每个副本复制限制。

  • 400 UnsupportedCapacity - 用户尝试使用不支持的容量创建或更新数据库。

  • 400 ReplicationSourceAndTargetMustHaveSameName - 复制源和目标数据库必须具有相同的名称。

  • 400 ProvisioningDisabled - 按原样显示资源操作授权者的错误消息,无需更改

  • 400 ReplicationSourceAndTargetMustBeInDifferentServers - 复制源和目标数据库必须位于不同的逻辑服务器中。

  • 400 CannotUpdateIsLedgerDatabase - 无法更新现有数据库的账本属性。

  • 400 UnableToResolveRemoteServer - 由于服务器名称或 DNS 连接问题无效,无法解决远程合作伙伴服务器名称。

  • 400 RemoteDatabaseCopyPermission - 用户没有足够的权限在指定服务器上创建数据库副本。

  • 400 CannotMoveOrDropSyncMetadataDatabase - 无法删除用作同步元数据数据库的数据库。

  • 400 SecurityAzureKeyVaultGeoChainError - 使用 Azure 密钥保管库 (BYOK) 启用透明数据加密时,不支持创建辅助 (称为链接) 的进程。

  • 400 RestoreToFreeEditionNotSupported - 还原和 GeoRestore 目标不能为免费数据库。

  • 400 CannotMoveOrDropJobAccountDatabase - 无法删除与作业帐户关联的数据库。

  • 免费数据库不支持 400 RestoreNotSupportedForFreeEdition - 还原和 GeoRestore。

  • 400 JobAgentDatabaseEditionUnsupported - 不支持指定数据库的服务级别目标用作作业代理数据库。

  • 400 InvalidDroppedDatabase - 源数据库在受支持的恢复期内不存在于服务器上。

  • 400 InvalidLiveDatabase - 源数据库在受支持的恢复期内不存在于服务器上。 如果还原已删除的数据库,请指定其删除日期。

  • 400 InvalidVldbRecoverySlo - 超大规模版本恢复要求源数据库和目标数据库都使用超大规模服务级别目标。

  • 400 SourceDatabaseNotFound - 源数据库不存在。

  • 400 InvalidVldbRestoreSlo - 超大规模版本时间点还原要求源数据库和目标数据库都使用超大规模服务级别目标。

  • 400 CannotSpecifyPoolOrSlo - 不支持指定弹性池和/或更改服务级别目标或版本。

  • 400 InvalidPublicMaintenanceConfiguration - 用户尝试指定无法转换为内部 ID 的公共维护配置, (格式不正确或错误的区域) 。

  • 400 MaintenanceWindowNotSupportedForNamedReplica - 用户尝试使用不支持的非默认维护时段创建或更新命名副本。

  • 400 ChangeUnsupportedOnEntity - 用户尝试对给定实体执行不受支持的创建/更新/删除操作。

  • 400 UpgradeOnlyAllowedOnDataWarehouseInstances - 用户尝试升级非数据仓库实例。

  • 404 OperationIdNotFound - ID 操作不存在。

  • 404 DatabaseDoesNotExist - 用户已指定此服务器实例上不存在的数据库名称。

  • 404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。

  • 404 SubscriptionNotFound - 找不到请求的订阅。

  • 404 ServerNotInSubscription - 指定的服务器在指定的订阅上不存在。

  • 404 CannotFindObject - 找不到对象,因为它不存在或您没有权限

  • 405 UnsupportedReplicationOperation - 数据库上启动了不受支持的复制操作。

  • 409 OperationCancelled - 操作已被用户取消。

  • 409 OperationInterrupted - 无法完成资源上的操作,因为它被同一资源上的另一个操作中断。

  • 409 FreeDbAlreadyExists - 每个区域的订阅只能存在一个免费数据库。

  • 409 ConflictingServerOperation - 服务器当前正在进行操作。

  • 409 SubscriptionDisabled - 已禁用订阅。

  • 409 ConflictingSystemOperationInProgress - 数据库上正在进行系统维护操作,后续操作需要等待,直到完成。

  • 409 ConflictRequestToUpdateBackupRedundancy - 更改备份存储冗余的冲突请求仍在进行中。

  • 409 SkuAssignmentInProgress - 无法处理当前分配请求,因为以前的请求尚未完成。

  • 409 DatabaseElasticPoolMaintenanceConflict - 用户尝试使用与数据库的弹性池冲突的指定维护配置创建或更新数据库。

  • 409 ServerDtuQuotaExceeded - 无法执行该操作,因为服务器将超过允许的数据库吞吐量单位配额。

  • 409 UnableToAlterDatabaseInReplication - 复制关系中数据库上的用户更改版本。

  • 409 SubscriptionVcoreQuotaExceeded - 无法执行操作,因为订阅将超过允许的 vCore 配额。

  • 409 CurrentMemoryUsageExceedsSkuQuota - 用户尝试了由于资源消耗较高而无法完成的 SKU 更新操作。

  • 409 ServerKeyNameAlreadyExists - 服务器上已存在服务器密钥。

  • 409 ServerKeyUriAlreadyExists - 服务器上已存在服务器密钥 URI。

  • 409 ServerKeyDoesNotExists - 服务器密钥不存在。

  • 409 UpdateSloInProgress - 用户在进行 SLO 更新时尝试启动不兼容的操作。

  • 409 UpdateSloFailedDatabaseTooBusy - 更新 SLO 操作无法完成,因为数据库太忙。

  • 409 ElasticPoolBusy - 在忙于弹性池上尝试管理操作。

  • 409 AzureKeyVaultKeyNameNotFound - 操作无法完成,因为 Azure 密钥保管库密钥名称不存在。

  • 409 AzureKeyVaultKeyInUse - 服务器当前正在使用密钥。

  • 409 ServerDisabled - 服务器已禁用。

  • 409 ConflictingDatabaseOperation - 数据库上已有一些操作,当前操作应等到操作完成。

  • 409 SimultaneousSkuChangeNotAllowed - 服务目标更改操作不能同时在复制关系的两个数据库上运行。

  • 409 TargetElasticPoolBeingUpdated - 无法启动弹性池的更新,因为此弹性池中的某个数据库正在进行复制操作

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship - 对已在复制关系中的数据库执行复制种子设定操作。

  • 409 InvalidOperationForDatabaseInReplicationRelationship - 对已在复制关系中的数据库执行复制种子设定操作。

  • 409 DuplicateGeoDrRelation - 数据库已处于复制关系中。 这是重复的请求。

  • 409 DatabaseCopyLimitPerReplicaReached - 用户达到了并发数据库副本的限制。

  • 409 RemoteDatabaseExists - 目标服务器上已存在目标数据库名称。

  • 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。

  • 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。

  • 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。

  • 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。

  • 500 OperationTimedOut - 操作超时并自动回滚。 请重试该操作。

  • 500 ActivateOrDeactivateWorkflowThrottling - 激活或停用工作流失败,因为并发工作流过多

  • 503 TooManyRequests - 请求超出可用资源可处理的最大请求数。

  • 503 TooManyRequests - 请求超出可用资源可处理的最大请求数。

  • 503 AzureKeyVaultConnectionFailed - 无法完成该操作,因为尝试连接到 Azure 密钥保管库失败

  • 503 AzureKeyVaultGenericConnectionError - 操作无法完成,因为尝试检索密钥保管库信息时遇到错误。

  • 503 DatabaseUnavailable - 操作失败,因为数据库不可用。

  • 504 RequestTimeout - 服务请求超出了允许的超时。

示例

Upgrades a data warehouse.

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdwdb/upgradeDataWarehouse?api-version=2021-11-01

Sample Response