RESTORE İfadeler - FILELISTONLY (Transact-SQL)

Şunlar için geçerlidir: SQL Server Azure SQL Yönetilen Örneği

SQL Server'daki yedekleme setinde bulunan veritabanı ve log dosyalarının listesini içeren bir sonuç kümesini döndürür.

Note

Argümanların açıklamaları için bkz. RESTORE Argümanlar (Transact-SQL).

Transact-SQL söz dizimi kuralları

Syntax

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 }   
}  

Note

URL, Microsoft Azure Blob Depolama için konum ve dosya adını belirtmek için kullanılan formattır ve SQL Server 2012 (11.x) SP1 CU2 ile desteklenmektedir. Microsoft Azure depolama bir hizmet olsa da, uygulama disk ve bant ile benzer, böylece üç cihaz için tutarlı ve sorunsuz bir geri yükleme deneyimi sağlanır.

Arguments

Argümanların açıklamaları RESTORE FILELISTONLY için bkz.RESTORE Argümanlar (Transact-SQL) bölüm.

Sonuç Setleri

Bir istemci, yedekleme setinde bulunan dosyaların listesini elde etmek için kullanabilir RESTORE FILELISTONLY . Bu bilgi, her dosya için bir satır içeren sonuç kümesi olarak döner.

Sütun adı Veri türü Description
LogicalName nvarchar(128) Dosyanın mantıksal adı.
PhysicalName Nıvarçar(260) Dosyanın fiziksel veya işletim sistemi adı.
Type char(1) Dosya türü, şunlardan biri:

L = Microsoft SQL Server log file

D = SQL Server veri dosyası

F = Tam Metin Kataloğu

S = FileStream, FileTable veya In-Memory OLTP konteyneri
FileGroupName nvarchar(128) NULL Dosyayı içeren dosya grubunun adı.
Size sayısal(20,0) Mevcut boyut bayt cinsinden.
MaxSize sayısal(20,0) Maksimum izin verilen boyut bayt cinsinden.
Dosya Kimliği bigint Dosya tanımlayıcısı, veritabanı içinde benzersiz.
CreateLSN sayısal (25,0) Dosyanın oluşturulduğu log dizi numarası.
DropLSN numeric(25,0) NULL Dosyanın bırakıldığı log dizisi numarası. Dosya düşürülmediyse, bu değer NULL'dur.
Uniqueıd uniqueidentifier Dosyanın küresel benzersiz tanımlayıcısı.
ReadOnlyLSN numeric(25,0) NULL Dosyayı içeren dosya grubunun okuma-yazmadan sadece okunabilir hale geçtiği log dizisi numarası (en son değişiklik).
ReadWriteLSN numeric(25,0) NULL Dosyayı içeren dosya grubunun yalnızca okunmadan okuma-yazma sistemine geçtiği log dizisi numarası (en son değişiklik).
BackupSizeInBytes bigint Bu dosyanın yedek boyutunun bayt cinsinden.
SourceBlockSize int Dosyayı bayt cinsinden içeren fiziksel cihazın blok boyutu (yedek cihaz değil).
FileGroupID int Dosya grubunun kimliği.
LogGroupGUID uniqueidentifier NULL NULL
DifferentialBaseLSN numeric(25,0) NULL Diferansiyel yedeklemeler için, DifferensialBaseLSN'den büyük veya eşit logluk dizi numaralarına sahip değişiklikler diferansiyele dahil edilir.

Diğer yedekleme türleri için değer NULL'dur.
DifferentialBaseGUID uniqueidentifier NULL Diferansiyel yedeklemeler için, diferansiyel tabanın benzersiz tanımlayıcısıdır.

Diğer yedekleme türleri için değer NULL'dur.
IsReadOnly bit 1 = Dosya yalnızca okunabilir.
IsPresent bit 1 = Dosya yedekte mevcut.
TDEThumbprint varbinary(32) NULL Veritabanı Şifreleme Anahtarı'nın parmak izini gösterir. Şifreleyici parmak izi, anahtarın şifrelendiği sertifikanın SHA-1 hash'idir. Veritabanı şifrelemesi hakkında bilgi için bkz. Saydam Veri Şifrelemesi (TDE) sayfası.
SnapshotURL nvarchar(360) NULL Geçerlidir: SQL Server (SQL Server 2016 (13.x) (CU1) ve mevcut sürüme kadar.

FILE_SNAPSHOT yedeklemesinde bulunan veritabanı dosyasının Azure anlık görüntüsünün URL'si. Yedek FILE_SNAPSHOT yoksa NULL döndürür.

Security

Yedekleme işlemi isteğe bağlı olarak bir medya kümesi, yedekleme kümesi veya her ikisi için parola belirtebilir. Bir medya setinde veya yedek setinde bir şifre tanımlandığında, ifadede doğru şifre veya şifreleri RESTORE belirtmelisiniz. Bu şifreler, Microsoft SQL Server araçlarıyla yetkisiz geri yükleme işlemlerini ve yedek setlerinin medyaya izinsiz eklenmesini engeller. Ancak, bir şifre, bildirimin BACKUP FORMAT seçeneğiyle medyanın üzerine yazılmasını engellemez.

Important

Bu parola tarafından sağlanan koruma zayıftır. Yetkili veya yetkisiz kullanıcıların SQL Server araçlarını kullanarak yanlış geri yüklemeyi önlemeye yöneliktir. Yedekleme verilerinin başka yollarla okunmasını veya parolanın değiştirilmesini engellemez. Bu özellik, SQL Server'ın gelecek bir sürümünde kaldırılacaktır. Bu özelliği yeni geliştirme çalışmalarında kullanmaktan kaçının ve şu anda bu özelliği kullanan uygulamaları değiştirmeyi planlayın. Yedeklemeleri korumak için en iyi yöntem, yedekleme bantlarını güvenli bir konumda depolamak veya yeterli erişim denetim listeleri (ACL' ler) tarafından korunan disk dosyalarına yedeklemektir. ACL'ler, yedeklemelerin oluşturulduğu dizin kökünde ayarlanmalıdır.

Permissions

SQL Server 2008 (10.0.x) sürümünden itibaren, bir yedek seti veya yedek cihazı hakkında bilgi edinmek için izin gereklidirCREATE DATABASE. Daha fazla bilgi için bkz GRANT . Veritabanı İzinleri (Transact-SQL).

Examples

Aşağıdaki örnek, 'de bir yedek AdventureWorksBackupscihazdan gelen bilgileri geri döndürür. Örnek, cihazda ikinci yedekleme setini belirtme seçeneğini kullanır FILE .

RESTORE FILELISTONLY FROM AdventureWorksBackups   
   WITH FILE=2;  
GO