Skip to content

Latest commit

 

History

History
47 lines (35 loc) · 2.17 KB

sys-fn-db-backup-file-snapshots-transact-sql.md

File metadata and controls

47 lines (35 loc) · 2.17 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic dev_langs
sys.fn_db_backup_file_snapshots (Transact-SQL)
sys.fn_db_backup_file_snapshots (Transact-SQL)
rwestMSFT
randolphwest
06/03/2015
sql
system-objects
reference
TSQL

sys.fn_db_backup_file_snapshots (Transact-SQL)

[!INCLUDE sqlserver2016]

Returns Azure snapshots associated with the database files. If the specified database is not found or if the database files are not stored in the Microsoft Azure Blob Storage, no rows are returned. Use this system function in conjunction with the sys.sp_delete_backup_file_snapshot system stored procedure to identify and delete orphaned backup snapshots. For more information, see File-Snapshot Backups for Database Files in Azure.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

  
sys.fn_db_backup_file_snapshots   
   [ ( database_name ) ]  

Arguments

Database_name
The name of the database being queried. If NULL, this function is executed in the current database scope.

Table Returned

Column name Data type Description
file_id int The File ID for the database. Is not nullable.
snapshot_time nvarchar(260) The timestamp of the snapshot as it is returned by the REST API. Returns NULL if no snapshot exists.
snapshot_url nvarchar(360) The full URL to the file snapshot. Returns NULL if no snapshot exist.

Permissions

Requires VIEW DATABASE STATE permission on the database.

See Also

sp_delete_backup_file_snapshot (Transact-SQL)
sp_delete_backup (Transact-SQL)