managed_backup.fn_available_backups (Transact-SQL)

  • Artigo

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 onde 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 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