managed_backup.fn_available_backups (Transact-SQL)
Aplica-se a: 
SQL Server 2016 (13.x) e versões posteriores
Retorna uma tabela de 0, uma ou mais linhas dos arquivos de backup disponíveis para o banco de dados especificado. Os arquivos de backup retornados são backups criados pelo backup gerenciado do SQL Server no Microsoft Azure.
Convenções de sintaxe de Transact-SQL
Sintaxe
managed_backup.fn_available_backups ([@database_name = ] 'database name')
Argumentos
@database_name
O nome do banco de dados. O @database_name é NVARCHAR(512).
Tabela retornada
A tabela tem uma restrição clusterizada exclusiva em (database_guid, backup_start_date e first_lsn, backup_type).
Se um banco de dados for ignorado e, em seguida, recriado, os conjuntos de backup para todos os bancos de dados serão retornados. A saída é ordenada pelo database_guid, que identifica exclusivamente cada banco de dados.
Se houver lacunas no LSN, significando que há uma quebra na cadeia de logs, a tabela conterá uma linha especial para cada segmento ausente do LSN.
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
| Backup_path | NVARCHAR(260) COLLATE Latin1_General_CI_AS_KS_WS | A URL do arquivo de backup. |
| backup_type | NVARCHAR(6) | 'DB' para backup de banco de dados 'LOG' para backup de log |
| expiration_date | DATETIME | A data em que este arquivo deve ser excluído. Isso é definido com base na capacidade de recuperar o banco de dados para um ponto no tempo dentro do período de retenção especificado. |
| database_guid | UNIQUEIDENTIFIER | O valor de GUID para o banco de dados especificado. A GUID identifica um banco de dados com exclusividade. |
| first_lsn | NUMERIC(25, 0) | Número de sequência de log do primeiro ou mais antigo registro de log no conjunto de backup. Pode ser NULL. |
| last_lsn | NUMERIC(25, 0) | Número de sequência de log do próximo registro de log após o conjunto de backup. Pode ser NULL. |
| backup_start_date | DATETIME | Data e hora em que a operação de backup foi iniciada. |
| backup_finish_date | NVARCHAR(128) | Data e hora em que a operação de backup foi concluída. |
| machine_name | NVARCHAR(128) | Nome do computador em que a instância do SQL Server está instalada e executando o backup gerenciado do SQL Server no Microsoft Azure. |
| last_recovery_fork_id | UNIQUEIDENTIFIER | Número de identificação para a bifurcação de recuperação final. |
| first_recovery_fork_id | UNIQUEIDENTIFIER | ID da bifurcação de recuperação inicial. Para backups de dados, first_recovery_fork_guid é igual a last_recovery_fork_guid. |
| fork_point_lsn | NUMERIC(25, 0) | Se first_recovery_fork_id não for igual a last_recovery_fork_id, esse será o número de sequência de log do ponto de bifurcação. Caso contrário, esse valor será NULL. |
| availability_group_guid | UNIQUEIDENTIFIER | Se um banco de dados for um banco de dados Always On, esse será o GUID do grupo de disponibilidade. Caso contrário, esse valor será NULL. |
Valor do código de retorno
0 (êxito) ou 1 (falha).
Segurança
Permissões
Requer permissões SELECT nesta função.
Exemplos
O exemplo a seguir lista todos os backups disponíveis com backup gerenciado por meio do backup gerenciado do SQL Server no Microsoft Azure para o banco de dados 'MyDB'
SELECT *
FROM msdb.managed_backup.fn_available_backups ('MyDB')
Confira também
Backup Gerenciado do SQL Server para o Microsoft Azure
Restaurando de backups armazenados no Microsoft Azure