Sql Server Databases - Update

Dienst:: Arc Data

API-Version:: 2026-01-01

Aktualisiert eine vorhandene Datenbank.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureArcData/sqlServerInstances/{sqlServerInstanceName}/databases/{databaseName}?api-version=2026-01-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Name der Datenbank
resourceGroupName	path	True	string	Der Name der Azure-Ressourcengruppe
sqlServerInstanceName	path	True	string	Name der SQL Server-Instanz
subscriptionId	path	True	string	Die ID des Azure-Abonnements
api-version	query	True	string	Die API-Version, die für die Anfrage verwendet werden soll

Anforderungstext

Name	Typ	Beschreibung
properties	SqlServerDatabaseResourceProperties	Eigenschaften des Datenverantwortlichen
tags	object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	SqlServerDatabaseResource	Die Datenbank wurde erfolgreich aktualisiert.
202 Accepted		Das Ressourcen-Update ist im Gange. Header Location: string
Other Status Codes	ErrorResponse	Fehlerantworten: ***

Name

Typ

Beschreibung

200 OK

SqlServerDatabaseResource

Die Datenbank wurde erfolgreich aktualisiert.

202 Accepted

Das Ressourcen-Update ist im Gange.

Header

Location: string

Other Status Codes

ErrorResponse

Fehlerantworten: ***

Beispiele

Update a database.

Beispielanforderung

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.AzureArcData/sqlServerInstances/testsqlManagedInstance/databases/testdb?api-version=2026-01-01

{
  "tags": {
    "mytag": "myval1"
  }
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.AzureArcData/testSqlServerInstance/testsqlManagedInstance/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.AzureArcData/sqlServerInstances/databases",
  "properties": {
    "collationName": "SQL_Latin1_General_CP1_CI_AS",
    "databaseCreationDate": "2022-04-05T16:26:33.883Z",
    "compatibilityLevel": 150,
    "state": "Online",
    "isReadOnly": true,
    "recoveryMode": "Full",
    "sizeMB": 150,
    "spaceAvailableMB": 100,
    "logFileSizeMB": 70,
    "dataFileSizeMB": 80,
    "databaseOptions": {
      "isAutoCloseOn": true,
      "isAutoShrinkOn": true,
      "isAutoCreateStatsOn": true,
      "isAutoUpdateStatsOn": true,
      "isMemoryOptimizationEnabled": true,
      "isRemoteDataArchiveEnabled": true,
      "isEncrypted": true,
      "isTrustworthyOn": true,
      "isHekatonFilesOn": true
    },
    "backupInformation": {
      "lastFullBackup": "2022-05-05T16:26:33.883Z",
      "lastLogBackup": "2022-05-10T16:26:33.883Z"
    },
    "backupPolicy": {
      "retentionPeriodDays": 1,
      "fullBackupDays": 1,
      "differentialBackupHours": 12,
      "transactionLogBackupMinutes": 30
    },
    "migration": {
      "assessment": {
        "assessmentUploadTime": "2024-03-15T00:14:52.0000000Z",
        "databaseAssessments": [
          {
            "appliesToMigrationTargetPlatform": "AzureSqlDatabase",
            "featureId": "ServiceBroker",
            "issueCategory": "Issue",
            "moreInformation": ""
          }
        ],
        "targetReadiness": {
          "azureSqlDatabase": {
            "numOfBlockerIssues": 0,
            "recommendationStatus": "Ready"
          },
          "azureSqlManagedInstance": {
            "numOfBlockerIssues": 0,
            "recommendationStatus": "Ready"
          },
          "azureSqlVirtualMachine": {
            "numOfBlockerIssues": 0,
            "recommendationStatus": "Ready"
          }
        }
      }
    },
    "earliestRestoreDate": "2022-05-10T16:26:33.883Z",
    "createMode": "PointInTimeRestore",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.AzureArcData/testSqlServerInstance/testsqlManagedInstance/databases/MyDatabase",
    "vmId": "12345678-1234-1234-1234-123456789123",
    "restorePointInTime": "2022-05-05T16:26:33.883Z",
    "lastDatabaseUploadTime": "2023-03-29T14:13:12Z"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "tags": {
    "mytag": "myval1"
  }
}

Statuscode:: 202

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.AzureArcData/operationResults/id1

Definitionen

Name	Beschreibung
BackupInformation
BackupPolicy	Das Sicherungsprofil für den SQL-Server.
Category
CostTypeValues	Die monatlichen Kosten der jeweiligen SKU.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DatabaseAssessments	Probleme und Warnungen, die die Migration der Datenbank zu einem bestimmten Azure-Migrationsziel betreffen.
DatabaseCreateMode	Datenbankerstellungsmodus. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitsicherung einer vorhandenen Datenbank wiederherstellen. sourceDatabaseId und restorePointInTime müssen angegeben werden.
DataBaseMigration	Migrationsbezogene Konfiguration.
DataBaseMigrationAssessment	Die Konfiguration der migrationsbezogenen Bewertung.
DatabaseOptions	Liste der Features, die für die Datenbank aktiviert sind
DatabaseState	Status der Datenbank.
differentialBackupHours	Das differenzielle Sicherungsintervall in Stunden.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
ImpactedObjectsInfo	Zusammenfassungsinformationen zur inkompatiblen Feature-ID, Anzahl der betroffenen Objekte und zur Problemkategorie (Warnung/Fehler)
recommendationStatus	Der Status der Zielempfehlung für diese Datenbank.
RecoveryMode	Status der Datenbank.
SkuRecommendationResultsMonthlyCost	Die monatlichen Kosten der jeweiligen SKU.
SkuRecommendationResultsMonthlyCostOptionItem	Die monatlichen Kostenwerte für diese Sparoption-Kombination für die jeweilige SKU.
SkuRecommendationSummary	Die Zusammenfassung der SKU-Empfehlung.
SqlServerDatabaseResource	Arc SQL Server Datenbank
SqlServerDatabaseResourceProperties	Die Eigenschaften der Arc SQL Server Datenbankressource
SqlServerDatabaseUpdate	Ein Update der Datenbankressource.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
TargetReadiness	Die Zielbereitschaft für die Migration dieser Datenbank.
TargetSku

BackupInformation

Objekt

Name	Typ	Beschreibung
lastFullBackup	string (date-time)	Datum der letzten vollständigen Sicherung.
lastLogBackup	string (date-time)	Datum der letzten Protokollsicherung.

BackupPolicy

Objekt

Das Sicherungsprofil für den SQL-Server.

Name	Typ	Beschreibung
differentialBackupHours	differentialBackupHours (int32)	Das differenzielle Sicherungsintervall in Stunden.
fullBackupDays	integer (int32) minimum: 0 maximum: 7	Der Wert, der Tage zwischen vollständigen Sicherungen angibt.
retentionPeriodDays	integer (int32) minimum: 0 maximum: 35	Der Aufbewahrungszeitraum für alle Datenbanken in dieser verwalteten Instanz.
transactionLogBackupMinutes	integer (int32) minimum: 0 maximum: 60	Der Wert, der Minuten zwischen Transaktionsprotokollsicherungen angibt.

Name	Typ	Beschreibung
computeTier	string	Die Rechenebene der Ziel-SKU.
hardwareType	string	Der Hardwaretyp der Ziel-SKU.
sqlPurchasingModel	string	Das SQL-Kaufmodell der Ziel-SKU.
sqlServiceTier	string	Das SQL-Service-Tier der Ziel-SKU.
zoneRedundancyAvailable	boolean	Zeigt an, ob für die Ziel-SKU Zonenredundanz verfügbar ist.

CostTypeValues

Objekt

Die monatlichen Kosten der jeweiligen SKU.

Name	Typ	Beschreibung
computeCost	number (float)	stellt die Berechnungskosten dar.
iopsCost	number (float)	Stellt die Kosten von IOPS dar.
storageCost	number (float)	Stellt die Kosten für die Lagerung dar.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

DatabaseAssessments

Objekt

Probleme und Warnungen, die die Migration der Datenbank zu einem bestimmten Azure-Migrationsziel betreffen.

Name	Typ	Beschreibung
appliesToMigrationTargetPlatform	string
featureId	string
issueCategory	string
moreInformation	string

DatabaseCreateMode

Enumeration

Datenbankerstellungsmodus. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitsicherung einer vorhandenen Datenbank wiederherstellen. sourceDatabaseId und restorePointInTime müssen angegeben werden.

Wert	Beschreibung
Default
PointInTimeRestore

DataBaseMigration

Objekt

Migrationsbezogene Konfiguration.

Name	Typ	Beschreibung
assessment	DataBaseMigrationAssessment	Migrationsbewertungen im Zusammenhang mit der Konfiguration.

DataBaseMigrationAssessment

Objekt

Die Konfiguration der migrationsbezogenen Bewertung.

Name	Typ	Beschreibung
assessmentUploadTime	string (date-time)	Die Zeit, als der Upload des Migration Assessment Report zuletzt durchgeführt wurde.
databaseAssessments	DatabaseAssessments[]	Probleme und Warnungen, die die Migration der Datenbank zu einem bestimmten Azure-Migrationsziel betreffen.
targetReadiness	TargetReadiness	Die Zielbereitschaft für die Migration dieser Datenbank.

DatabaseOptions

Objekt

Liste der Features, die für die Datenbank aktiviert sind

Name	Typ	Beschreibung
isAutoCloseOn	boolean
isAutoCreateStatsOn	boolean
isAutoShrinkOn	boolean
isAutoUpdateStatsOn	boolean
isEncrypted	boolean
isHekatonFilesOn	boolean	Gibt an, ob die Datenbank die In-Memory OLTP-Funktion zum Speichern von In-Memory-Objekten verwendet.
isMemoryOptimizationEnabled	boolean
isRemoteDataArchiveEnabled	boolean
isTrustworthyOn	boolean
numberOfHekatonFiles	number (int32)	Wie viele Hekaton-Dateien die Datenbank auf der Festplatte hat, wenn sie In-Memory-OLTP-Objekte verwendet.

DatabaseState

Enumeration

Status der Datenbank.

Wert	Beschreibung
Online
Restoring
Recovering
RecoveryPending
Suspect
Emergency
Offline
Copying
OfflineSecondary

differentialBackupHours

Enumeration

Das differenzielle Sicherungsintervall in Stunden.

Wert	Beschreibung
12
24

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ImpactedObjectsInfo

Objekt

Zusammenfassungsinformationen zur inkompatiblen Feature-ID, Anzahl der betroffenen Objekte und zur Problemkategorie (Warnung/Fehler)

Name	Typ	Beschreibung
featureId	string	Repräsentiert die Merkmals-ID aus https://learn.microsoft.com/en-us/data-migration/sql-server/database/assessment-rules?view=azuresql. ODER https://learn.microsoft.com/en-us/data-migration/sql-server/managed-instance/assessment-rules?view=azuresql
issueCategory	string	Problem oder Warnung
numberImpacted	number (int32)	Stellt die Anzahl der Probleme/Warnungen dar.

recommendationStatus

Enumeration

Der Status der Zielempfehlung für diese Datenbank.

Wert	Beschreibung
NotReady
Ready
ReadyWithConditions
Unknown

RecoveryMode

Enumeration

Status der Datenbank.

Wert	Beschreibung
Full
Bulk-logged
Simple

SkuRecommendationResultsMonthlyCost

Objekt

Die monatlichen Kosten der jeweiligen SKU.

Name	Typ	Beschreibung
computeCost	number (float)	stellt die Berechnungskosten dar.
iopsCost	number (float)	Stellt die Kosten von IOPS dar.
sqlLicenseCost	number (float)	Stellt die Kosten der SQL-Lizenz dar.
storageCost	number (float)	Stellt die Kosten für die Lagerung dar.
totalCost	number (float)	Stellt die Gesamtkosten dar.
windowsLicenseCost	number (float)	Stellt die Kosten der Windows-Lizenz dar.

SkuRecommendationResultsMonthlyCostOptionItem

Objekt

Die monatlichen Kostenwerte für diese Sparoption-Kombination für die jeweilige SKU.

Name	Typ	Beschreibung
keyName	string	Die einzigartige Kombination von Sparoptionen zu einem Preis, z. B. With1YearASPAndProd.
keyValue	CostTypeValues	Die monatlichen Kosten der jeweiligen SKU.

SkuRecommendationSummary

Objekt

Die Zusammenfassung der SKU-Empfehlung.

Name	Typ	Beschreibung
impactedObjectsSummary	ImpactedObjectsInfo[]	Zusammenfassungsinformationen zur inkompatiblen Feature-ID, Anzahl der betroffenen Objekte und zur Problemkategorie (Warnung/Fehler)
monthlyCost	SkuRecommendationResultsMonthlyCost	Die monatlichen Kosten der jeweiligen SKU.
monthlyCostOptions	SkuRecommendationResultsMonthlyCostOptionItem[]	Die monatlichen Kosten für alle verschiedenen Sparoptionen, die für die jeweilige SKU gelten.
numOfBlockerIssues	integer (int32)	Anzahl der Blocker-Probleme, die vor der Migration dieser Datenbank auf die Zielplattform behoben werden müssen.
recommendationStatus	recommendationStatus	Der Status der Zielempfehlung für diese Datenbank.
targetSku	TargetSku

SqlServerDatabaseResource

Objekt

Arc SQL Server Datenbank

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Zum Beispiel - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties	SqlServerDatabaseResourceProperties	Eigenschaften der Arc Sql Server-Datenbank
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

SqlServerDatabaseResourceProperties

Objekt

Die Eigenschaften der Arc SQL Server Datenbankressource

Name	Typ	Beschreibung
backupInformation	BackupInformation
backupPolicy	BackupPolicy	Das Sicherungsprofil für den SQL-Server.
collationName	string	Sortierung der Datenbank.
compatibilityLevel	integer (int32) minimum: 80 maximum: 200	Kompatibilitätsebene der Datenbank
createMode	DatabaseCreateMode	Datenbankerstellungsmodus. PointInTimeRestore: Erstellen Sie eine Datenbank, indem Sie eine Zeitsicherung einer vorhandenen Datenbank wiederherstellen. sourceDatabaseId und restorePointInTime müssen angegeben werden.
dataFileSizeMB	number (float)	Gesamtgröße in MB für die Datendateien (mdf und ndf) für diese Datenbank.
databaseCreationDate	string (date-time)	Erstellungsdatum der Datenbank.
databaseOptions	DatabaseOptions	Liste der Features, die für die Datenbank aktiviert sind
earliestRestoreDate	string (date-time)	Dadurch wird das früheste Startdatum und die früheste Wiederherstellungszeit für diese Datenbank (ISO8601 Format) aufgezeichnet.
isReadOnly	boolean	Gibt an, ob die Datenbank schreibgeschützt ist oder nicht.
lastDatabaseUploadTime	string (date-time)	Die Zeit, in der der letzte erfolgreiche Datenbank-Upload durchgeführt wurde.
logFileSizeMB	number (float)	Gesamtgröße in MB für die Protokolldateien (ldf) für diese Datenbank.
migration	DataBaseMigration	Migrationsbezogene Konfiguration.
provisioningState	string	Der Bereitstellungszustand der Arc-fähigen SQL Server-Datenbankressource.
recoveryMode	RecoveryMode	Status der Datenbank.
restorePointInTime	string (date-time)	Konditional. Wenn createMode PointInTimeRestore ist, ist dieser Wert erforderlich. Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen.
sizeMB	number (float)	Größe der Datenbank
sourceDatabaseId	string	Der Name der Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.
spaceAvailableMB	number (float)	Leerraum links der Datenbank.
state	DatabaseState	Status der Datenbank.
vmId	string	Die eindeutige ID der Hybrid-Maschine, zu der diese Ressource gehört.

SqlServerDatabaseUpdate

Objekt

Ein Update der Datenbankressource.

Name	Typ	Beschreibung
properties	SqlServerDatabaseResourceProperties	Eigenschaften des Datenverantwortlichen
tags	object	Ressourcentags.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

TargetReadiness

Objekt

Die Zielbereitschaft für die Migration dieser Datenbank.

Name	Typ	Beschreibung
azureSqlDatabase	SkuRecommendationSummary	Die Zusammenfassung der SKU-Empfehlung.
azureSqlManagedInstance	SkuRecommendationSummary	Die Zusammenfassung der SKU-Empfehlung.
azureSqlVirtualMachine	SkuRecommendationSummary	Die Zusammenfassung der SKU-Empfehlung.

TargetSku

Objekt

Name	Typ	Beschreibung
category	Category
computeSize	number (int32)	Berechenungsgröße in vCores.
maxStorageIops	number (float)	Die maximale Speicher-IOPS in Azure SQL beeinflusst die Abrechnungskosten.
maxThroughputMBps	number (float)	Der maximale Durchsatz in Azure SQL beeinflusst die Abrechnungskosten.
predictedDataSizeInMb	number (float)	Die vorhergesagte Datengröße in MB in Azure SQL beeinflusst die Abrechnungskosten.
predictedLogSizeInMb	number (float)	Die prognostizierte Loggröße in MB in Azure SQL beeinflusst die Abrechnungskosten.
storageMaxSizeInMb	number (float)	maximal Speicherplatz für diese spezielle SKU, in MB.