RESTORE Výroky - FILELISTONLY (Transact-SQL)

Platí na:SQL ServerAzureSQL Managed Instance

Vrátí sadu výsledků obsahující seznam databázových a logovacích souborů obsažených v záložní sadě v SQL Server.

Note

Popisy argumentů viz RESTORE Argumenty (Transact-SQL).

Transact-SQL konvence syntaxe

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 je formát používaný k určení umístění a názvu souboru Microsoft Azure Blob Storage a je podporován od SQL Server 2012 (11.x) SP1 CU2. Ačkoliv je Microsoft Azure úložiště služba, implementace je podobná disku a pásce, což umožňuje konzistentní a bezproblémový proces obnovy pro všechna tři zařízení.

Arguments

Popisy argumentů RESTORE FILELISTONLY viz RESTORE Argumenty (Transact-SQL).

Sady výsledků

Klient může použít k RESTORE FILELISTONLY získání seznamu souborů obsažených v záložní sadě. Tato informace se vrací jako sada výsledků obsahující jeden řádek pro každý soubor.

Název sloupce Datový typ Description
Logický název nvarchar(128) Logický název souboru.
PhysicalName nvarchar(260) Fyzický nebo operační systém názvu souboru.
Typ char(1) Typ souboru, jeden z:

L = Microsoft SQL Server log file

D = datový soubor SQL Server

F = Katalog s plným textem

S = FileStream, FileTable nebo In-Memory OLTP kontejner
FileGroupName nvarchar(128) NULL Název souborové skupiny, která soubor obsahuje.
Velikost numeric(20;0) Aktuální velikost v bajtech.
Maximální velikost numeric(20;0) Maximální povolená velikost v bajtech.
ID souboru bigint Identifikátor souboru, jedinečný v databázi.
CreateLSN čísel(25 0) Záznamové pořadové číslo, ve kterém byl soubor vytvořen.
DropLSN numerické(25,0) NULL Logové sekvenční číslo, při kterém byl soubor vyřazen. Pokud soubor nebyl vyřazen, tato hodnota je NULL.
Uniqueid uniqueidentifier Globálně unikátní identifikátor souboru.
ReadOnlyLSN numeric(25,0) NULL Logové sekvenční číslo, při kterém se soubor souboru změnil z read-write na pouze pro čtení (nejnovější změna).
ReadWriteLSN numerické(25,0) NULL Logové sekvenční číslo, při kterém se soubor souborů změnil z režimu pouze pro čtení na čtení (nejnovější změna).
BackupSizeInBytes bigint Velikost zálohy pro tento soubor v bajtech.
SourceBlockSize int Velikost bloku fyzického zařízení obsahujícího soubor v bajtech (nikoli záložního zařízení).
FileGroupID int ID souborové skupiny.
LogGroupGUID uniqueidentifier NULL NULA.
DifferentialBaseLSN numerické(25,0) NULL Pro diferenciální zálohy jsou do diferenciálu zahrnuty změny s logaritmickými sekvenčními čísly většími nebo rovnými DifferentialBaseLSN .

Pro jiné typy záloh je hodnota NULL.
DifferentialBaseGUID uniqueidentifier NULL Pro diferenciální zálohy jedinečný identifikátor diferenciální báze.

Pro jiné typy záloh je hodnota NULL.
Je pouze pro čtení bit 1 = Soubor je pouze pro čtení.
IsPresent bit 1 = Soubor je přítomen v záloze.
TDEThumbprint varbinary(32) NULL Zobrazuje otisk palce šifrovacího klíče databáze. Otisk palce šifrátoru je SHA-1 hash certifikátu, kterým je klíč zašifrován. Pro informace o šifrování databáze viz transparentní šifrování dat (TDE).
SnapshotURL nvarchar(360) NULL Platí na: SQL Server (SQL Server 2016 (13.x) (CU1) až po aktuální verzi.

URL pro Azure snímek databázového souboru obsaženého v FILE_SNAPSHOT zálohě. Pokud není FILE_SNAPSHOT záloha, vrací NULL.

Zabezpečení

Operace zálohování může volitelně zadat hesla pro sadu médií, zálohovací sadu nebo obojí. Když je heslo definováno na mediální sadě nebo záložní sadě, musíte v příkazu RESTORE zadat správné heslo nebo hesla. Tato hesla zabraňují neoprávněným obnovovacím operacím a neoprávněnému přidávání zálohovacích sad na média pomocí nástrojů Microsoft SQL Server. Heslo však nebrání přepsání médií pomocí možnosti FORMÁT ve výpisu BACKUP .

Important

Ochrana poskytovaná tímto heslem je slabá. Účelem je zabránit nesprávnému obnovení pomocí nástrojů SQL Serveru autorizovanými nebo neoprávněnými uživateli. Nezabrání čtení zálohovaných dat jinými prostředky ani nahrazení hesla. Tato funkce bude odebrána v budoucí verzi SQL Serveru. Nepoužívejte tuto funkci v nové vývojové práci a naplánujte úpravu aplikací, které tuto funkci aktuálně používají. Osvědčeným postupem pro ochranu záloh je ukládání záložních pásek do zabezpečeného umístění nebo zálohování na diskové soubory, které jsou chráněné odpovídajícími seznamy řízení přístupu (ACL). Seznamy ACL by měly být nastavené v kořenovém adresáři, pod kterým se vytvářejí zálohy.

Permissions

Od SQL Server 2008 (10.0.x) vyžaduje získání informací o záložní sadě nebo záložním zařízení CREATE DATABASE povolení. Další informace naleznete v tématu GRANT Oprávnění databáze (Transact-SQL).

Examples

Následující příklad vrací informace ze záložního zařízení nazvaného AdventureWorksBackups. Příklad využívá FILE možnost zadat druhou zálohovací sadu na zařízení.

RESTORE FILELISTONLY FROM AdventureWorksBackups   
   WITH FILE=2;  
GO  

Viz také

BACKUP (Transact-SQL)
Sady médií, rodiny médií a zálohovací sady (SQL Server)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Historie zálohování a informace o hlavičce (SQL Server)