Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo descrive come gestire e monitorare i database di SQL Server sottoposti a backup da Backup di Azure tramite l'API REST. È anche possibile usare l'interfaccia della riga di comando di Azure e il portale di Azure per gestire i backup del database SQL.
Per visualizzare gli scenari di backup e ripristino attualmente supportati, vedere la matrice di supporto. Per domande comuni, vedere le domande frequenti.
Monitorare le attività
Il servizio Backup di Azure attiva i processi eseguiti in background. Sono inclusi scenari, ad esempio l'attivazione del backup, le operazioni di ripristino e la disabilitazione del backup. È possibile monitorare questi processi tramite i loro ID. Altre informazioni sulla gestione dei processi di backup e ripristino.
Recuperare informazioni sui lavori dalle operazioni
Un'operazione, come l'attivazione del backup, restituisce un job ID in risposta.
Ad esempio, la risposta finale di un'operazione dell'API REST per attivare il backup è la seguente:
{
"id": "cd2a3b13-d392-4e81-86ac-02ea91cc70b9",
"name": "cd2a3b13-d392-4e81-86ac-02ea91cc70b9",
"status": "Succeeded",
"startTime": "2018-05-28T11:43:21.6516182Z",
"endTime": "2018-05-28T11:43:21.6516182Z",
"properties": {
"objectType": "OperationStatusJobExtendedInfo",
"jobId": "c22eca5d-0c1c-48a0-a40d-69bef708d92a"
}
}
È possibile identificare il processo di backup identificato dal campo jobId e tenere traccia come indicato qui usando una richiesta GET.
Tenere traccia dell'attività
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupJobs/{jobName}?api-version=2016-12-01
{jobName} è il jobId indicato in precedenza. La risposta è 200 (OK) con il campo status che indica lo stato dell'attività. Una volta completato o completatoConAvvisi, la sezione extendedInfo mostra altri dettagli dell'attività.
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/Microsoft.RecoveryServices/vaults/SQLServer2012/backupJobs/c22eca5d-0c1c-48a0-a40d-69bef708d92a?api-version=2016-12-01
Risposta
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 Va bene | JobResource | Ok |
Risposta di esempio
Dopo che l'URI GET è stato inviato, viene restituita una risposta 200.
HTTP/1.1 200 OK
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: e057b496-8ceb-45b6-bd9e-367f7dd73d6d
x-ms-client-request-id: 1ffda117-b2c0-4a80-a9ba-43ba66eaec9b; 1ffda117-b2c0-4a80-a9ba-43ba66eaec9b
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14999
x-ms-correlation-request-id: e057b496-8ceb-45b6-bd9e-367f7dd73d6d
x-ms-routing-request-id: SOUTHINDIA:20180528T115536Z:e057b496-8ceb-45b6-bd9e-367f7dd73d6d
Cache-Control: no-cache
Date: Mon, 28 May 2018 11:55:35 GMT
Server: Microsoft-IIS/8.0
X-Powered-By: ASP.NET
{
"id": "/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/microsoft.recoveryservices/vaults/SQLServer2012/backupJobs/c22eca5d-0c1c-48a0-a40d-69bef708d92a",
"name": "c22eca5d-0c1c-48a0-a40d-69bef708d92a",
"type": "Microsoft.RecoveryServices/vaults/backupJobs",
"properties": {
"jobType": "AzureWorkloadJob",
"workloadType": "SQLDataBase",
"duration": "00:03:13.6439467",
"actionsInfo": [
1
],
"errorDetails": [
{
"errorCode": 510008,
"errorString": "Operation cancelled as a conflicting operation was already running on the same database.",
"errorTitle": "OperationCancelledBecauseConflictingOperationRunningUserError",
"recommendations": [
"Please try again after sometime."
]
}
],
"extendedInfo": {
"tasksList": [
{
"taskId": "Transfer data to vault",
"status": "Failed"
}
],
"propertyBag": {
"Data Transferred (in MB)": "0"
}
},
"entityFriendlyName": "MSSQLSERVER/msDB [sqlserver-0.contoso.com]",
"backupManagementType": "AzureWorkload",
"operation": "Backup (Full)",
"status": "Failed",
"startTime": "2018-05-28T11:43:21.6516182Z",
"endTime": "2018-05-28T11:46:35.2955649Z",
"activityId": "6b033cf6-f875-4c03-8985-9add07ec2845"
}
}
}
Elenca istanze SQL protette e database
Per elencare istanze SQL e i loro database per la protezione degli snapshot a livello di istanza, usa la versione API 2024-01-31-preview. Sostituisci i segnaposto URI con i dettagli del tuo vault. I seguenti esempi mostrano campi di risposta selezionati.
Elenca le istanze SQL protette
Filtra gli elementi protetti per itemType eq 'SQLInstance':
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupProtectedItems?api-version=2024-01-31-preview&$filter=backupManagementType eq 'AzureWorkload' and itemType eq 'SQLInstance'
La risposta contiene un value array. Ogni istanza include il nome dell'elemento protetto, il nome del container, i database figli e lo stato di protezione. Ad esempio:
{
"value": [
{
"name": "SQLInstance;mssqlserver",
"properties": {
"childDBList": ["MSSQLSERVER;testdb", "MSSQLSERVER;testdb1", "MSSQLSERVER;testdb2"],
"instanceProtectionReadiness": "Ready",
"friendlyName": "mssqlserver",
"serverName": "sqlserver-0",
"protectedItemType": "AzureVmWorkloadSQLInstance",
"backupManagementType": "AzureWorkload",
"workloadType": "SQLInstance",
"containerName": "VMAppContainer;Compute;SQLServerPMDemo;sqlserver-0",
"protectionStatus": "Healthy",
"protectionState": "IRPending",
"protectedItemDataSourceId": "2265943933205758867"
}
}
]
}
Salva i nomi del contenitore restituito e dell'elemento protetto per le richieste successive. Per le query di ripristino temporizzato dell'istanza, salvare anche protectedItemDataSourceId.
Elenca database protetti in un'istanza
Elenca gli elementi del database protetti nel vault:
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupProtectedItems?api-version=2024-01-31-preview&$filter=backupManagementType eq 'AzureWorkload' and itemType eq 'SQLDatabase'
Nell'array restituito value , identificare i database con protectionLevel impostato a DatabaseUnderInstance. Usa parentProtectedItem, insieme ai dettagli del container e del server, per identificare l'istanza genitore. Le proprietà di un elemento di database possono includere:
{
"parentProtectedItem": "mssqlserver",
"protectionLevel": "DatabaseUnderInstance",
"friendlyName": "testdb",
"serverName": "sqlserver-0",
"parentName": "MSSQLSERVER",
"protectedItemType": "AzureVmWorkloadSQLDatabase",
"backupManagementType": "AzureWorkload",
"workloadType": "SQLDataBase"
}
Ottieni un'istanza SQL protetta
Per recuperare una singola istanza, usare il contenitore restituito e il nome dell'elemento protetto:
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2024-01-31-preview
Ad esempio, {protectedItemName} può essere SQLInstance;mssqlserver. La risposta include childDBList, instanceProtectionReadiness, e protectionState. Se l'elemento è programmato per la cancellazione differita, ispezionare isScheduledForDeferredDelete, deferredDeleteTimeInUTC, e softDeleteRetentionPeriod anche .
Modifica dei criteri
Per modificare i criteri che proteggono il database, usare lo stesso formato dell'abilitazione della protezione. Fornire comunque il nuovo ID criteri nel corpo della richiesta e inviare la richiesta. Esempio: per modificare i criteri di testVM da HourlyLogPolicy a ProdPolicy, specificare l'ID ProdPolicy nel corpo della richiesta.
{
"properties": {
"backupManagementType": "AzureWorkload",
"workloadType": "SQLDataBase",
"policyId": "/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/microsoft.recoveryservices/vaults/SQLServer2012/backupPolicies/ProdPolicy"
},
"location": "westcentralus"
}
Il formato della risposta è analogo a quello indicato per l'abilitazione della protezione.
Modifica la policy per un'istanza protetta da snapshot
Invia una richiesta PUT per l'elemento protetto dall'istanza e fornisci il nuovo ID della policy snapshot:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2024-01-31-preview
{
"properties": {
"backupManagementType": "AzureWorkload",
"workloadType": "SQLInstance",
"protectedItemType": "AzureVmWorkloadSQLInstance",
"friendlyName": "MSSQLSERVER",
"policyId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupPolicies/{newPolicyName}",
"childDatabaseNameList": ["model"]
}
}
Sostituisci i segnaposto nel corpo JSON così come nell'URI. Usare i nomi dei database selezionati dell'istanza in childDatabaseNameList.
Riprendere il backup di un'istanza SQL
Per riprendere il backup, invia una richiesta PUT all'elemento protetto dall'istanza con l'ID della policy snapshot. Il seguente esempio utilizza un childDatabaseNameList vuoto per l'operazione di ripristino:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2024-01-31-preview
{
"properties": {
"backupManagementType": "AzureWorkload",
"workloadType": "SQLInstance",
"protectedItemType": "AzureVmWorkloadSQLInstance",
"friendlyName": "MSSQLSERVER",
"policyId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupPolicies/SQLInstanceSnapPolicy",
"childDatabaseNameList": []
}
}
Usa il nome dell'oggetto protetto per l'istanza, come SQLInstance;mssqlserver, e sostituisci i segnaposto dell'ID criterio con i dettagli del tuo vault. Monitorare l'operazione e il processo risultante come descritto in Monitorare i processi.
Arrestare la protezione dati e conservare i dati esistenti
Per rimuovere la protezione da un database protetto e conservare i dati già sottoposti a backup, rimuovere i criteri nel corpo della richiesta usato per abilitare il backup e inviare la richiesta. Dopo che l'associazione ai criteri è stata rimossa, i backup non vengono più attivati e non viene creato alcun nuovo punto di ripristino.
{
"properties": {
"protectedItemType": "AzureVmWorkloadSQLDatabase",
"protectionState": "ProtectionStopped",
"sourceResourceId":
"/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerPMDemo/providers/Microsoft.Compute/virtualMachines/sqlserver-0",
"policyId": ""
}
}
Risposta di esempio
L'arresto della protezione per un database è un'operazione asincrona. L'operazione consente di creare un'altra operazione di cui occorre tenere traccia. L'operazione restituisce due risposte: 202 (Accettata) quando viene creata un'altra operazione e 200 quando tale operazione è completata.
Intestazione della risposta quando l'operazione viene accettata correttamente:
Status Code:
OK
Headers:
Pragma : no-cache
X-Content-Type-Options : nosniff
x-ms-request-id : 388c9359-e237-4644-8f6c-38ae5eb0dfcb
x-ms-client-request-id : 5ef896e6-d812-431a-ad58-9d9ee1bb8bb3,5ef896e6-d812-431a-ad58-9d9ee1bb8bb3
Strict-Transport-Security : max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-resource-requests: 107
x-ms-correlation-request-id : 388c9359-e237-4644-8f6c-38ae5eb0dfcb
x-ms-routing-request-id : SOUTHINDIA:20211126T054036Z:388c9359-e237-4644-8f6c-38ae5eb0dfcb
Cache-Control : no-cache
Date : Fri, 26 Nov 2021 05:40:36 GMT
Server : Microsoft-IIS/10.0
X-Powered-By : ASP.NET
Body:
{
"id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"name": "TestOBJ",
"status": "Succeeded",
"startTime": "2021-11-26T05:36:36.5262731Z",
"endTime": "2021-11-26T05:36:36.5262731Z",
"properties": {
"objectType": "OperationStatusJobExtendedInfo",
"jobId": "68178d86-d564-460b-9643-829046aac1b1"
}
}
Tenere quindi traccia dell'operazione risultante usando l'intestazione location o Azure-AsyncOperation con un comando GET:
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupoperations/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2016-12-01
Corpo della risposta
{
"id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"name": "TestOBJ",
"status": "Succeeded",
"startTime": "2021-11-26T05:36:36.5262731Z",
"endTime": "2021-11-26T05:36:36.5262731Z",
"properties": {
"objectType": "OperationStatusJobExtendedInfo",
"jobId": "68178d86-d564-460b-9643-829046aac1b1"
}
}
Interrompere la protezione per un database protetto in un'istanza
Per un database protetto da una policy snapshot di istanza, invia una richiesta PUT all'elemento protetto del database , non all'elemento dell'istanza:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/SQLDatabase;MSSQLSERVER;tdb2?api-version=2024-01-31-preview
Imposta protectionState su ProtectionStopped e includi l'ID della policy snapshot dell'istanza:
{
"properties": {
"backupManagementType": "AzureWorkload",
"workloadType": "SQLDataBase",
"friendlyName": "MSSQLSERVER;tdb2",
"protectedItemType": "AzureVmWorkloadSQLDatabase",
"protectionState": "ProtectionStopped",
"policyId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupPolicies/SQLInstanceSnapPolicy"
}
}
Sostituisci il nome dell'elemento del database di esempio con quello restituito per il tuo database e sostituisci i segnaposto dell'ID del criterio. Questa operazione blocca la protezione pur conservando i dati di backup esistenti. Traccia l'operazione asincrona come descritto in precedenza in questa sezione.
Arrestare la protezione ed eliminare i dati di backup
Per rimuovere la protezione da una condivisione file protetta ed eliminare anche i dati di backup, eseguire un'operazione di eliminazione.
DELETE https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2019-05-13
I parametri containerName e protectedItemName sono impostati nel passaggio di configurazione del backup in questo articolo.
Risposte
La protezione dalla cancellazione è un'operazione asincrona. L'operazione consente di creare un'altra operazione che deve essere registrata separatamente. L'operazione restituisce due risposte: 202 (accettazione) quando viene creata un'altra operazione e 204 (nessun contenuto restituito) quando tale operazione viene completata.
Passaggi successivi
- Informazioni su come risolvere i problemi durante la configurazione del backup per i database di SQL Server.