managed_backup.fn_available_backups (Transact-SQL)

  • Статья

Область применения: SQL Server 2016 (13.x) и более поздних версий

Возвращает таблицу, где нуль, одна или несколько строк, для доступных файлов резервных копий для указанной базы данных. Возвращенные файлы резервного копирования — это резервные копии, созданные управляемым резервным копированием SQL Server в Microsoft Azure.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

@database_name
Имя базы данных. Это @database_name NVARCHAR(512).

Возвращаемая таблица

Таблица имеет уникальное кластеризованное ограничение в (database_guid, backup_start_date и first_lsn, backup_type).
Если база данных удалена, затем создана повторно, возвращаются резервные наборы данных для всех баз данных. Выходные данные упорядочиваются по database_guid, уникально идентифицирующим каждую базу данных.
Если в LSN имеются разрывы, означающие разрыв в цепочке журналов, таблица будет содержать отдельную строку для каждого пропущенного сегмента номера LSN.

Имя столбца Тип данных Description
Backup_path NVARCHAR(260) COLLATE Latin1_General_CI_AS_KS_WS URL-адрес файла резервной копии.
backup_type NVARCHAR(6) Db для резервного копирования базы данных LOG для резервного копирования журналов
expiration_date DATETIME Дата, в которую ожидается удаление этого файла. Эта настройка основывается на возможности восстановить базу данных до определенного момента времени внутри заданного срока хранения.
database_guid UNIQUEIDENTIFIER Значение GUID для указанной базы данных. GUID однозначно определяет базу данных.
first_lsn NUMERIC(25, 0) Регистрационный номер транзакции в журнале для первой или самой ранней записи журнала в резервном наборе данных. Может иметь значение NULL.
last_lsn NUMERIC(25, 0) Регистрационный номер транзакции в журнале для следующей записи журнала после резервного набора данных. Может иметь значение NULL.
backup_start_date DATETIME Дата и время начала операции резервного копирования.
backup_finish_date NVARCHAR(128) Дата и время окончания операции резервного копирования.
machine_name NVARCHAR(128) Имя компьютера, на котором установлен экземпляр SQL Server и выполняется управляемое резервное копирование SQL Server в Microsoft Azure.
last_recovery_fork_id UNIQUEIDENTIFIER Идентификационный номер для конечной вилки восстановления.
first_recovery_fork_id UNIQUEIDENTIFIER Идентификатор начальной вилки восстановления. Для резервного копирования данных параметр first_recovery_fork_guid равен last_recovery_fork_guid.
fork_point_lsn NUMERIC(25, 0) Если значение first_recovery_fork_id не равно значению last_recovery_fork_id, данный параметр представляет собой регистрационный номер транзакции в журнале для вилки. В противном случае - значение NULL.
availability_group_guid UNIQUEIDENTIFIER Если база данных является базой данных AlwaysOn, это GUID группы доступности. В противном случае — значение NULL.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Безопасность

Разрешения

Требуется разрешение SELECT для этой функции.

Примеры

В следующем примере перечислены все доступные резервные копии, резервные копии с помощью управляемого резервного копирования SQL Server в Microsoft Azure для базы данных MyDB.

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

См. также

Управляемое резервное копирование SQL Server в Microsoft Azure
Восстановление из резервных копий в Microsoft Azure