Pernyataan RESTORE - FILELISTONLY (Transact-SQL)
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).
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)