Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op:
SQL ServerAzure SQL Managed Instance
Geeft een resultaatset terug met een lijst van de database en logbestanden die in de back-upset in SQL Server aanwezig zijn.
Note
Voor de beschrijvingen van de argumenten, zie RESTORE Argumenten (Transact-SQL).
Transact-SQL syntaxis-conventies
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 is het formaat dat wordt gebruikt om de locatie en bestandsnaam voor Microsoft Azure Blob Storage aan te geven en wordt ondersteund vanaf SQL Server 2012 (11.x) SP1 CU2. Hoewel Microsoft Azure opslag een dienst is, lijkt de implementatie op schijf en tape om een consistente en naadloze herstelervaring voor alle drie de apparaten mogelijk te maken.
Arguments
Voor beschrijvingen van de RESTORE FILELISTONLY argumenten, zie RESTORE Argumenten (Transact-SQL).
Resultaatsets
Een client kan gebruiken RESTORE FILELISTONLY om een lijst te verkrijgen van de bestanden in een back-upset. Deze informatie wordt teruggegeven als een resultaatset die één rij per bestand bevat.
| Kolomnaam | Gegevenstype | Description |
|---|---|---|
| LogicalName | nvarchar(128) | Logische naam van het bestand. |
| PhysicalName | nvarchar(260) | Fysieke of besturingssysteemnaam van het bestand. |
| Typ | char(1) | Het type bestand, een van: L = Microsoft SQL Server logbestand D = SQL Server databestand F = Volledige Tekstcatalogus S = FileStream, FileTable of In-Memory OLTP-container |
| FileGroupName | Nvarchar(128) NULL | Naam van de bestandsgroep die het bestand bevat. |
| Grootte | numeriek(20,0) | Huidige grootte in bytes. |
| MaxSize | numeriek(20,0) | Maximaal toegestane grootte in bytes. |
| FileID | bigint | Bestandsidentificatie, uniek binnen de database. |
| CreateLSN | numeriek(25,0) | Log-sequentienummer waarop het bestand is aangemaakt. |
| DropLSN | numeriek(25,0) NULL | Het log-sequentienummer waarop het bestand werd verwijderd. Als het bestand niet is verwijderd, is deze waarde NULL. |
| UniqueID | uniqueidentifier | Wereldwijd unieke identificatie van het bestand. |
| ReadOnlyLSN | numeriek(25,0) NULL | Logvolgordenummer waarop de bestandsgroep met het bestand veranderde van lezen-schrijven naar alleen-lezen (de meest recente wijziging). |
| ReadWriteLSN | numeriek(25,0) NULL | Logvolgordenummer waarbij de bestandsgroep met het bestand veranderde van alleen-lezen naar lezen-schrijven (de meest recente wijziging). |
| BackupSizeInBytes | bigint | Grootte van de back-up voor dit bestand in bytes. |
| SourceBlockSize | int | Blokgrootte van het fysieke apparaat dat het bestand bevat in bytes (niet het back-upapparaat). |
| FileGroupID | int | ID van de bestandsgroep. |
| LogGroupGUID | unieke identificatie NULL | NUL. |
| DifferentieelBaseLSN | numeriek(25,0) NULL | Voor differentiële back-ups worden wijzigingen met log-sequentienummers groter dan of gelijk aan DifferentialBaseLSN opgenomen in het differentiaal. Voor andere back-uptypes is de waarde NULL. |
| DifferentialBaseGUID | unieke identificatie NULL | Voor differentiële back-ups is het de unieke identificatie van de differentiële basis. Voor andere back-uptypes is de waarde NULL. |
| IsReadOnly | bit | 1 = Het bestand is alleen-lezen. |
| IsPresent | bit | 1 = Het bestand is aanwezig in de back-up. |
| TDEThumbprint | varbinary(32) NULL | Toont de duimafdruk van de database-encryptiesleutel. De encryptor-duimafdruk is een SHA-1 hash van het certificaat waarmee de sleutel is versleuteld. Voor informatie over database-encryptie, zie Transparent Data Encryption (TDE). |
| SnapshotURL | nvarchar(360) NULL |
Van toepassing op: SQL Server (SQL Server 2016 (13.x) (CU1) tot en met de huidige versie. De URL voor de Azure snapshot van het databasebestand dat in de FILE_SNAPSHOT back-up is opgenomen. Geeft NULL terug als er geen FILE_SNAPSHOT back-up is. |
Security
Een back-upbewerking kan eventueel wachtwoorden opgeven voor een mediaset, een back-upset of beide. Wanneer een wachtwoord is gedefinieerd op een mediaset of back-upset, moet je het juiste wachtwoord of de juiste wachtwoorden in de RESTORE instructie opgeven. Deze wachtwoorden voorkomen ongeautoriseerde hersteloperaties en ongeautoriseerde toevoegingen van back-upsets aan media met behulp van Microsoft SQL Server-tools. Een wachtwoord voorkomt echter niet dat media worden overschreven met de FORMAT-optie van de BACKUP verklaring.
Important
De beveiliging die door dit wachtwoord wordt geboden, is zwak. Het is bedoeld om een onjuiste herstelbewerking te voorkomen met behulp van SQL Server-hulpprogramma's door geautoriseerde of niet-geautoriseerde gebruikers. Het voorkomt niet dat de back-upgegevens op een andere wijze worden gelezen of dat het wachtwoord wordt vervangen. Deze functie wordt verwijderd in een toekomstige versie van SQL Server. Vermijd het gebruik van deze functie in nieuwe ontwikkelwerkzaamheden en plan om toepassingen te wijzigen die momenteel gebruikmaken van deze functie. De aanbevolen procedure voor het beveiligen van back-ups is het opslaan van back-uptapes op een veilige locatie of een back-up maken van schijfbestanden die worden beveiligd door adequate toegangsbeheerlijsten (ACL's). De ACL's moeten worden ingesteld in de hoofdmap van de map waarin back-ups worden gemaakt.
Permissions
Vanaf SQL Server 2008 (10.0.x) vereist het verkrijgen van informatie over een back-upset of back-upapparaat een CREATE DATABASE toestemming. Zie GRANT Databasemachtigingen (Transact-SQL) voor meer informatie.
Examples
Het volgende voorbeeld geeft de informatie terug van een back-upapparaat genaamd AdventureWorksBackups. Het voorbeeld gebruikt de FILE optie om de tweede back-upset op het apparaat aan te geven.
RESTORE FILELISTONLY FROM AdventureWorksBackups
WITH FILE=2;
GO
Zie ook
BACKUP (Transact-SQL)
Mediasets, Mediafamilies en Back-upsets (SQL Server)
RESTORE REWINDONLY (Transact-SQL)
RESTORE VERIFYONLY (Transact-SQL)
RESTORE (Transact-SQL)
Back-upproceduregeschiedenis en kopinformatie (SQL Server)