Pernyataan RESTORE - FILELISTONLY (Transact-SQL)

Artikel
03/13/2024

Berlaku untuk:SQL Server Azure SQL Managed Instance

Mengembalikan kumpulan hasil yang berisi daftar database dan file log yang terkandung dalam kumpulan cadangan di SQL Server.

Catatan

Untuk deskripsi argumen, lihat RESTORE Arguments (Transact-SQL).

Konvensi sintaks transact-SQL

Sintaksis

RESTORE FILELISTONLY   
FROM <backup_device>   
[ WITH   
 {  
--Backup Set Options  
   FILE = { backup_set_file_number | @backup_set_file_number }   
 | PASSWORD = { password | @password_variable }   
 | [ METADATA_ONLY | SNAPSHOT ] [ DBNAME = { database_name | @database_name_variable } ]
  
--Media Set Options  
 | MEDIANAME = { media_name | @media_name_variable }   
 | MEDIAPASSWORD = { mediapassword | @mediapassword_variable }  
  
--Error Management Options  
 | { CHECKSUM | NO_CHECKSUM }   
 | { STOP_ON_ERROR | CONTINUE_AFTER_ERROR }  
  
--Tape Options  
 | { REWIND | NOREWIND }   
 | { UNLOAD | NOUNLOAD }    
 } [ ,...n ]  
]  
[;]  
  
<backup_device> ::=  
{   
   { logical_backup_device_name |  
      @logical_backup_device_name_var }  
   | { DISK | TAPE | URL } = { 'physical_backup_device_name' |  
       @physical_backup_device_name_var }   
}

Catatan

URL adalah format yang digunakan untuk menentukan lokasi dan nama file untuk Microsoft Azure Blob Storage dan didukung dimulai dengan SQL Server 2012 (11.x) SP1 CU2. Meskipun penyimpanan Microsoft Azure adalah layanan, implementasinya mirip dengan disk dan pita untuk memungkinkan pengalaman pemulihan yang konsisten dan mulus untuk ketiga perangkat tersebut.

Argumen

Untuk deskripsi argumen RESTORE FILELISTONLY, lihat RESTORE Arguments (Transact-SQL).

Tataan Hasil

Klien dapat menggunakan RESTORE FILELISTONLY untuk mendapatkan daftar file yang terkandung dalam kumpulan cadangan. Informasi ini dikembalikan sebagai kumpulan hasil yang berisi satu baris untuk setiap file.

Nama kolom	Jenis data	Deskripsi
LogicalName	nvarchar(128)	Nama logis file.
PhysicalName	nvarchar(260)	Nama fisik atau sistem operasi file.
Jenis	karakter(1)	Jenis file, salah satu dari: L = File log Microsoft SQL Server D = File data SQL Server F = Katalog Teks Lengkap S = FileStream, FileTable, atau kontainer OLTP Dalam Memori
FileGroupName	nvarchar(128) NULL	Nama grup file yang berisi file.
Ukuran	numerik(20,0)	Ukuran saat ini dalam byte.
MaxSize	numerik(20,0)	Ukuran maksimum yang diizinkan dalam byte.
FileID	bigint	Pengidentifikasi file, unik dalam database.
CreateLSN	numerik(25,0)	Nomor urutan log tempat file dibuat.
DropLSN	numerik(25,0) NULL	Nomor urutan log tempat file dihilangkan. Jika file belum dihilangkan, nilai ini adalah NULL.
UniqueID	pengidentifikasi unik	Pengidentifikasi file yang unik secara global.
ReadOnlyLSN	numerik(25,0) NULL	Nomor urutan log di mana grup file yang berisi file diubah dari baca-tulis menjadi baca-saja (perubahan terbaru).
ReadWriteLSN	numerik(25,0) NULL	Nomor urutan log di mana grup file yang berisi file berubah dari baca-saja ke baca-tulis (perubahan terbaru).
BackupSizeInBytes	bigint	Ukuran cadangan untuk file ini dalam byte.
SourceBlockSize	int	Ukuran blok perangkat fisik yang berisi file dalam byte (bukan perangkat cadangan).
FileGroupID	int	ID grup file.
LogGroupGUID	uniqueidentifier NULL	NULL.
DifferentialBaseLSN	numerik(25,0) NULL	Untuk pencadangan diferensial, perubahan dengan nomor urutan log yang lebih besar dari atau sama dengan DifferentialBaseLSN disertakan dalam diferensial. Untuk jenis cadangan lainnya, nilainya adalah NULL.
DifferentialBaseGUID	uniqueidentifier NULL	Untuk cadangan diferensial, pengidentifikasi unik dari basis diferensial. Untuk jenis cadangan lainnya, nilainya adalah NULL.
IsReadOnly	bit	1 = File bersifat baca-saja.
IsPresent	bit	1 = File ada dalam cadangan.
TDEThumbprint	varbinary(32) NULL	Memperlihatkan thumbprint Kunci Enkripsi Database. Thumbprint enkripsi adalah hash SHA-1 dari sertifikat tempat kunci dienkripsi. Untuk informasi tentang enkripsi database, lihat Enkripsi Data Transparan (TDE).
SnapshotURL	nvarchar(360) NULL	Berlaku untuk: SQL Server (SQL Server 2016 (13.x) (CU1) melalui versi saat ini. URL untuk rekam jepret Azure dari file database yang terkandung dalam cadangan FILE_SNAPSHOT. Mengembalikan NULL jika tidak ada cadangan FILE_SNAPSHOT.

Keamanan

Operasi pencadangan dapat secara opsional menentukan kata sandi untuk set media, set cadangan, atau keduanya. Ketika kata sandi telah ditentukan pada set media atau set cadangan, Anda harus menentukan kata sandi atau kata sandi yang benar dalam pernyataan RESTORE. Kata sandi ini mencegah operasi pemulihan yang tidak sah dan tambahan set cadangan yang tidak sah ke media menggunakan alat Microsoft SQL Server. Namun, kata sandi tidak mencegah timpa media menggunakan opsi FORMAT pernyataan BACKUP.

Penting

Perlindungan yang diberikan oleh kata sandi ini lemah. Ini dimaksudkan untuk mencegah pemulihan yang salah menggunakan alat SQL Server oleh pengguna yang berwenang atau tidak sah. Ini tidak mencegah pembacaan data cadangan dengan cara lain atau penggantian kata sandi. Fitur ini akan dihapus dalam versi SQL Server yang akan datang. Hindari menggunakan fitur ini dalam pekerjaan pengembangan baru, dan rencanakan untuk memodifikasi aplikasi yang saat ini menggunakan fitur ini. Praktik terbaik untuk melindungi cadangan adalah menyimpan pita cadangan di lokasi yang aman atau mencadangkan ke file disk yang dilindungi oleh daftar kontrol akses (ACL) yang memadai. ACL harus diatur pada akar direktori tempat cadangan dibuat.

Izin

Dimulai di SQL Server 2008 (10.0.x), mendapatkan informasi tentang set cadangan atau perangkat cadangan memerlukan izin CREATE DATABASE. Untuk informasi selengkapnya, lihat IZIN GRANT Database (Transact-SQL).

Contoh

Contoh berikut mengembalikan informasi dari perangkat cadangan bernama AdventureWorksBackups. Contoh menggunakan FILE opsi untuk menentukan kumpulan cadangan kedua pada perangkat.

RESTORE FILELISTONLY FROM AdventureWorksBackups   
   WITH FILE=2;  
GO

Lihat Juga

BACKUP (Transact-SQL)
Set Media, Keluarga Media, dan Kumpulan Cadangan (SQL Server)
PULIHKAN REWINDONLY (Transact-SQL)
PULIHKAN SECARA VERIFIKASI (Transact-SQL)
RESTORE (Transact-SQL)
Riwayat Pencadangan dan Informasi Header (SQL Server)