Bagikan melalui


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).

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)