managed_backup.fn_available_backups (Transact-SQL)
適用対象: 
SQL Server 2016 (13.x) 以降のバージョン
指定されたデータベースに使用可能なバックアップ ファイルの 0 行、1 行、または複数の行から成るテーブルを返します。 返されるバックアップ ファイルは、Microsoft Azure への SQL Server マネージド バックアップによって作成されたバックアップです。
構文
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 セグメントごとに特別な行が含まれます。
| 列名 | データ型 | 説明 |
|---|---|---|
| Backup_path | NVARCHAR(260) COLLATE Latin1_General_CI_AS_KS_WS | バックアップ ファイルの URL。 |
| backup_type | NVARCHAR(6) | ログ バックアップ用のデータベース バックアップ 'LOG' の 'DB' |
| 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 インスタンスがインストールされ、Microsoft Azure への SQL Server マネージド バックアップを実行しているコンピューターの名前。 |
| last_recovery_fork_id | UNIQUEIDENTIFIER | 終了復旧フォークの識別番号。 |
| first_recovery_fork_id | UNIQUEIDENTIFIER | 最初の復旧分岐の ID。 データ バックアップの場合、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 | データベースが Always On データベースの場合、これは可用性グループの GUID です。 それ以外の場合、この値は NULL です。 |
リターン コード値
0 (成功) または 1 (失敗)。
セキュリティ
アクセス許可
この関数 SELECT アクセス許可が必要です。
例
次の例では、データベース 'MyDB' の Microsoft Azure への SQL Server マネージド バックアップを使用してバックアップできるすべてのバックアップの一覧を示します。
SELECT *
FROM msdb.managed_backup.fn_available_backups ('MyDB')
参照
Microsoft Azure への SQL Server マネージド バックアップ
Microsoft Azure に格納されたバックアップからの復元