managed_backup.fn_available_backups (Transact-SQL)

  • Articolo

Si applica a: SQL Server 2016 (13.x) e versioni successive

Restituisce una tabella di 0, una o più righe dei file di backup disponibili per il database specificato. I file di backup restituiti sono backup creati da Backup gestito di SQL Server in Microsoft Azure.

Convenzioni di sintassi Transact-SQL

Sintassi

managed_backup.fn_available_backups ([@database_name = ] 'database name')

Argomenti

@database_name
Nome del database. @database_name è NVARCHAR(512).

Tabella restituita

Alla tabella viene applicato un vincolo cluster univoco (database_guid, backup_start_date e first_lsn, backup_type).
Se un database viene eliminato e quindi ricreato, vengono restituiti i set di backup per tutti i database. L'output viene ordinato in base a database_guid, che identifica in modo univoco ogni database.
Se sono presenti gap in LSN significa che è presente un'interruzione nella catena di log; la tabella conterrà una riga speciale per ogni segmento LSN mancante.

Nome colonna Tipo di dati Descrizione
Backup_path NVARCHAR(260) COLLATE Latin1_General_CI_AS_KS_WS URL del file di backup.
backup_type NVARCHAR(6) 'DB' per il backup del database 'LOG' per il backup del log
expiration_date DATETIME Data in cui si prevede l'eliminazione di questo file. Viene impostata in base alla capacità di recuperare il database fino a un punto nel tempo nel periodo di memorizzazione specificato.
database_guid UNIQUEIDENTIFIER Valore GUID per il database specificato. Il GUID identifica in modo univoco un database.
first_lsn NUMERIC(25, 0) Numero di sequenza del file di log del primo record, ovvero del record di log meno recente nel set di backup. Può essere NULL.
last_lsn NUMERIC(25, 0) Numero di sequenza del file di log (LSN) del record di log successivo dopo il set di backup. Può essere NULL.
backup_start_date DATETIME Data e ora in cui è stata avviata l'operazione di backup.
backup_finish_date NVARCHAR(128) Data e ora in cui è terminata l'operazione di backup.
machine_name NVARCHAR(128) Nome del computer in cui è installata l'istanza di SQL Server ed esegue backup gestito di SQL Server in Microsoft Azure.
last_recovery_fork_id UNIQUEIDENTIFIER Numero di identificazione per il fork di recupero finale.
first_recovery_fork_id UNIQUEIDENTIFIER ID del fork di recupero iniziale. Per i backup di dati, first_recovery_fork_guid è uguale a last_recovery_fork_guid.
fork_point_lsn NUMERIC(25, 0) Se first_recovery_fork_id è diverso da last_recovery_fork_id, è il numero di sequenza del file di log (LSN) del punto di fork. Negli altri casi il valore è NULL.
availability_group_guid UNIQUEIDENTIFIER Se un database è un database Always On, si tratta del GUID del gruppo di disponibilità. Negli altri casi il valore è NULL.

Valore del codice restituito

0 (esito positivo) o 1 (esito negativo)

Sicurezza

Autorizzazioni

Richiede autorizzazioni SELECT per questa funzione.

Esempi

L'esempio seguente elenca tutti i backup disponibili di cui è stato eseguito il backup tramite backup gestito di SQL Server in Microsoft Azure per il database "MyDB"

SELECT *   
FROM msdb.managed_backup.fn_available_backups ('MyDB')

Vedi anche

Backup gestito di SQL Server in Microsoft Azure
Ripristino da backup archiviati in Microsoft Azure