RESTORE-instructies - Argumenten (Transact-SQL)

Van toepassing op:SQL Server

In deze artikelen worden de argumenten vastgelegd die worden beschreven in de secties Syntaxis van de FUNCTIE HERSTELLEN {DATABASE|LOG} instructie en van de bijbehorende set hulpinstructies: RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY, RESTORE REWINDONLY en RESTORE VERIFYONLY. De meeste argumenten worden ondersteund door slechts een subset van deze zes instructies. De ondersteuning voor elk argument wordt aangegeven in de beschrijving van het argument.

Transact-SQL syntaxis-conventies

Syntaxis

Zie de volgende artikelen voor syntaxis:

• RESTORE (Transact-SQL)

• RESTORE FILELISTONLY (Transact-SQL)

• RESTORE HEADERONLY (Transact-SQL)

• RESTORE LABELONLY (Transact-SQL)

• RESTORE REWINDONLY (Transact-SQL)

• VERIFYONLY (Transact-SQL) herstellen

Argumenten

DATABASE

Ondersteund door:RESTORE

Hiermee geeft u de doeldatabase. Als er een lijst met bestanden en bestandsgroepen is opgegeven, worden alleen die bestanden en bestandsgroepen hersteld.

Voor een database die gebruikmaakt van het volledige of bulksgewijs vastgelegde herstelmodel, vereist SQL Server in de meeste gevallen een back-up van het logboek voordat u de database herstelt. Als u een database herstelt zonder eerst een back-up van de staart van het logboek te maken, treedt er een fout op, tenzij de instructie RESTORE DATABASE de COMPONENT WITH REPLACE of THE STOPAT bevat, die een tijd of transactie moet opgeven die is opgetreden na het einde van de gegevensback-up. Zie Tail-Log Back-ups (SQL Server)voor meer informatie over back-ups van tail-logboeken.

LOG

Ondersteund door:RESTORE

Hiermee geeft u op dat een back-up van transactielogboeken moet worden toegepast op deze database. Transactielogboeken moeten in opeenvolgende volgorde worden toegepast. SQL Server controleert het transactielogboek waarvan een back-up is gemaakt om ervoor te zorgen dat de transacties in de juiste database en in de juiste volgorde worden geladen. Als u meerdere transactielogboeken wilt toepassen, gebruikt u de optie NORECOVERY voor alle herstelbewerkingen, behalve de laatste.

Zie Back-ups van transactielogboeken (SQL Server) toepassenvoor meer informatie.

{ database_name | @database_name_var }

Ondersteund door:RESTORE

Is de database waarnaar het logboek of de volledige database is hersteld. Als deze naam wordt opgegeven als een variabele (@database_name_var), kan deze naam worden opgegeven als een tekenreeksconstante (@database_name_var = databasenaam) of als een variabele van het gegevenstype tekenreeks, met uitzondering van de gegevenstypen ntekst of tekst.

< > file_or_filegroup_or_page [ ,... n ]

Ondersteund door:RESTORE

Hiermee geeft u de naam op van een logisch bestand of een logische bestandsgroep of pagina die moet worden opgenomen in een RESTORE DATABASE- of RESTORE LOG-instructie. U kunt een lijst met bestanden of bestandsgroepen opgeven.

Voor een database die gebruikmaakt van het eenvoudige herstelmodel, zijn de opties FILE en FILEGROUP alleen toegestaan als de doelbestanden of bestandsgroepen alleen-lezen zijn, of als dit een GEDEELTELIJKE herstelbewerking is (wat resulteert in een defunct-bestandsgroep).

Voor een database die gebruikmaakt van het volledige of bulksgewijs vastgelegde herstelmodel, moet u na het gebruik van RESTORE DATABASE een of meer bestanden, bestandsgroepen en/of pagina's herstellen, het transactielogboek toepassen op de bestanden met de herstelde gegevens; door het logboek toe te passen, worden deze bestanden consistent met de rest van de database. De uitzonderingen hierop zijn als volgt:

• Als de bestanden die worden hersteld, alleen-lezen waren voordat er voor het laatst een back-up van werd gemaakt, hoeft er geen transactielogboek te worden toegepast en wordt u in de RESTORE-instructie geïnformeerd over deze situatie.

• Als de back-up de primaire bestandsgroep bevat en er een gedeeltelijke herstelbewerking wordt uitgevoerd. In dit geval is het herstellogboek niet nodig omdat het logboek automatisch wordt hersteld vanuit de back-upset.

FILE = { logical_file_name_in_backup | @logical_file_name_in_backup_var }

Noemt een bestand dat moet worden opgenomen in het herstellen van de database.

FILEGROUP = { logical_filegroup_name | @logical_filegroup_name_var }

Noemt een bestandsgroep die moet worden opgenomen in het databaseherstel.

FILEGROUP is alleen toegestaan in een eenvoudig herstelmodel als de opgegeven bestandsgroep alleen-lezen is en dit een gedeeltelijke herstelbewerking is (dat wil gezegd, als WITH PARTIAL wordt gebruikt). Onbeperkte lees-/schrijfbestandsgroepen worden gemarkeerd als defunct en kunnen vervolgens niet worden hersteld in de resulterende database.

READ_WRITE_FILEGROUPS

Hiermee selecteert u alle lees- en schrijfbestandsgroepen. Deze optie is met name handig wanneer u alleen-lezen bestandsgroepen hebt die u wilt herstellen na lees-/schrijfbestandsgroepen vóór de alleen-lezen bestandsgroepen.

PAGE = 'file:page [ ,... n ]'

Hiermee geeft u een lijst op van een of meer pagina's voor een paginaherstel (die alleen wordt ondersteund voor databases met behulp van de volledige of bulksgewijs vastgelegde herstelmodellen). De waarden zijn als volgt:

PAGE
Geeft een lijst met een of meer bestanden en pagina's aan.

bestand
Is de bestands-id van het bestand met een specifieke pagina die moet worden hersteld.

Pagina
Is de pagina-id van de pagina die moet worden hersteld in het bestand.

n
Is een tijdelijke aanduiding die aangeeft dat er meerdere pagina's kunnen worden opgegeven.

Het maximum aantal pagina's dat in één bestand in een herstelvolgorde kan worden hersteld, is 1000. Als u echter meer dan een klein aantal beschadigde pagina's in een bestand hebt, kunt u overwegen het hele bestand te herstellen in plaats van de pagina's.

Zie Restore Pages (SQL Server) voor meer informatie over paginaherstel.

[ ,... n ]
Is een tijdelijke aanduiding die aangeeft dat meerdere bestanden en bestandsgroepen en pagina's kunnen worden opgegeven in een door komma's gescheiden lijst. Het getal is onbeperkt.

FROM { <backup_device [ ,...>n ] | <> database_snapshot }

Hiermee geeft u doorgaans de back-upapparaten op waaruit de back-up moet worden hersteld. In een RESTORE DATABASE-instructie kan de FROM-component ook de naam opgeven van een momentopname van een database waarnaar u de database terugzet. In dat geval is er geen WITH-component toegestaan.

Als de FROM-component wordt weggelaten, vindt het herstellen van een back-up niet plaats. In plaats daarvan wordt de database hersteld. Hiermee kunt u een database herstellen die is hersteld met de optie NORECOVERY of overschakelen naar een stand-byserver. Als de FROM-component wordt weggelaten, moet NORECOVERY, RECOVERY of STAND-BY worden opgegeven in de WITH-component.

< > backup_device [ ,... n ]

Hiermee geeft u de logische of fysieke back-upapparaten die moeten worden gebruikt voor de herstelbewerking.

Ondersteund door:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY, RESTORE REWINDONLY en RESTORE VERIFYONLY.

< >backup_device::= Hiermee geeft u als volgt een logisch of fysiek back-upapparaat op dat moet worden gebruikt voor de back-upbewerking:

{ logical_backup_device_name | @logical_backup_device_name_var }
Is de logische naam, die moet voldoen aan de regels voor id's, van de back-upapparaten die zijn gemaakt door sp_addumpdevice waaruit de database wordt hersteld. Als deze wordt opgegeven als een variabele (@logical_backup_device_name_var), kan de naam van het back-upapparaat worden opgegeven als een tekenreeksconstante (@logical_backup_device_name_var = logical_backup_device_name) of als een variabele van het gegevenstype tekenreeks, met uitzondering van de gegevenstypen ntekst of tekst .

{DISK | TAPE } = { 'physical_backup_device_name'physical_backup_device_name_var | @ }
Hiermee kunnen back-ups worden hersteld vanaf de benoemde schijf of tapeapparaat. De apparaattypen schijf en tape moeten worden opgegeven met de werkelijke naam (bijvoorbeeld het volledige pad en de bestandsnaam) van het apparaat: DISK ='Z:\SQLServerBackups\AdventureWorks.bak' of TAPE ='\\\\.\TAPE0'. Als deze is opgegeven als een variabele (@physical_backup_device_name_var), kan de apparaatnaam worden opgegeven als een tekenreeksconstante (@physical_backup_device_name_var = 'physical_backup_device_name') of als een variabele van het gegevenstype tekenreeks, met uitzondering van de gegevenstypen ntekst of tekst .

Als u een netwerkserver gebruikt met een UNC-naam (die computernaam moet bevatten), geeft u een apparaattype van de schijf op. Zie Backup Devices (SQL Server) voor meer informatie over het gebruik van UNC-namen.

Het account waaronder u SQL Server uitvoert, moet leestoegang hebben tot de externe computer of netwerkserver om een HERSTELbewerking uit te voeren.

n
Is een tijdelijke aanduiding die aangeeft dat maximaal 64 back-upapparaten kunnen worden opgegeven in een door komma's gescheiden lijst.

Of voor een herstelreeks zoveel back-upapparaten zijn vereist als voor het maken van de mediaset waartoe de back-ups behoren, is afhankelijk van of het herstellen offline of online is, als volgt:

• Met offline terugzetten kan een back-up worden hersteld met minder apparaten dan is gebruikt om de back-up te maken.

• Voor online herstel zijn alle back-upapparaten van de back-up vereist. Een poging om te herstellen met minder apparaten mislukt.

Denk bijvoorbeeld aan een geval waarin een back-up van een database is gemaakt tot vier tapestations die zijn verbonden met de server. Een online herstel vereist dat u vier stations hebt verbonden met de server; Met een offline herstel kunt u de back-up herstellen als er minder dan vier stations op de computer zijn.

< >database_snapshot::=

Ondersteund door:RESTORE DATABASE

= DATABASE_SNAPSHOT database_snapshot_name
Hiermee wordt de database teruggezet naar de momentopname van de database die is opgegeven door database_snapshot_name. De optie DATABASE_SNAPSHOT is alleen beschikbaar voor een volledig databaseherstel. Bij een terugdraaibewerking maakt de momentopname van de database de plaats van een volledige databaseback-up.

Voor een herstelbewerking is vereist dat de opgegeven momentopname van de database de enige is in de database. Tijdens de terugdraaibewerking worden de momentopname van de database en de doeldatabase gemarkeerd als In restore. Zie de sectie Opmerkingen in RESTORE DATABASE voor meer informatie.

MET opties

Hiermee geeft u de opties die moeten worden gebruikt door een herstelbewerking. Zie 'Overzicht van ondersteuning voor WITH-opties' verderop in dit artikel voor een overzicht van welke instructies elke optie gebruiken.

GEDEELTELIJK

Ondersteund door:RESTORE DATABASE

Hiermee geeft u een gedeeltelijke herstelbewerking op waarmee de primaire bestandsgroep en eventuele opgegeven secundaire bestandsgroepen worden hersteld. De optie GEDEELTELIJK selecteert impliciet de primaire bestandsgroep; het opgeven van FILEGROUP = 'PRIMARY' is overbodig. Als u een secundaire bestandsgroep wilt herstellen, moet u expliciet de bestandsgroep opgeven met behulp van de optie FILE of FILEGROUP.

De optie GEDEELTELIJK is niet toegestaan voor DE INSTRUCTIES VOOR HET HERSTELLEN VAN LOGBOEKen.

Met de optie GEDEELTELIJK wordt de eerste fase van een stukje terugzetten gestart, waardoor resterende bestandsgroepen op een later tijdstip kunnen worden hersteld. Zie Piecemeal Restores (SQL Server) voor meer informatie.

[ HERSTEL | NORECOVERY | STAND-BY ]

Ondersteund door:RESTORE

HERSTEL
Hiermee wordt de herstelbewerking geïnstrueerd om eventuele niet-doorgevoerde transacties terug te draaien. Na het herstelproces is de database klaar voor gebruik. Als noch NORECOVERY, RECOVERY of STAND-BY is opgegeven, is RECOVERY de standaardinstelling.

Als volgende HERSTELbewerkingen (RESTORE LOG of RESTORE DATABASE from differentiële) zijn gepland, moet NORECOVERY of STAND-BY worden opgegeven.

Wanneer u back-upsets herstelt vanuit een eerdere versie van SQL Server, is mogelijk een database-upgrade vereist. Deze upgrade wordt automatisch uitgevoerd wanneer WITH RECOVERY is opgegeven. Zie Back-ups van transactielogboeken (SQL Server) toepassenvoor meer informatie.

NORECOVERY

Hiermee wordt de herstelbewerking geïnstrueerd om niet-doorgevoerde transacties niet terug te draaien. Als een ander transactielogboek later moet worden toegepast, geeft u de optie NORECOVERY of STAND-BY op. Als noch NORECOVERY, RECOVERY of STAND-BY is opgegeven, is RECOVERY de standaardinstelling. Tijdens een offline herstelbewerking met de optie NORECOVERY is de database niet bruikbaar.

Voor het herstellen van een databaseback-up en een of meer transactielogboeken of wanneer er meerdere RESTORE-instructies nodig zijn (bijvoorbeeld wanneer u een volledige databaseback-up herstelt, gevolgd door een differentiële databaseback-up), vereist RESTORE de optie WITH NORECOVERY op alle behalve de definitieve RESTORE-instructie. Een best practice is om WITH NORECOVERY te gebruiken voor ALLE instructies in een herstelvolgorde met meerdere stappen totdat het gewenste herstelpunt is bereikt en vervolgens een afzonderlijke RESTORE WITH RECOVERY-instructie te gebruiken voor herstel.

Wanneer de database wordt gebruikt met een bestands- of bestandsgroepsherstelbewerking, dwingt NORECOVERY de herstelstatus na de herstelbewerking te behouden. Dit is handig in een van deze situaties:

• Er wordt een herstelscript uitgevoerd en het logboek wordt altijd toegepast.

• Er wordt een reeks bestandsherstelbewerkingen gebruikt en de database is niet bedoeld voor gebruik tussen twee van de herstelbewerkingen.

In sommige gevallen rolt RESTORE WITH NORECOVERY de roll forward zo ver dat deze consistent is met de database. In dergelijke gevallen wordt terugdraaien niet uitgevoerd en blijven de gegevens offline, zoals verwacht met deze optie. De Database Engine echter een informatief bericht geeft aan dat de roll-forward set nu kan worden hersteld met behulp van de optie HERSTEL.

STAND-BY = standby_file_name

Hiermee geeft u een stand-bybestand op waarmee de hersteleffecten ongedaan kunnen worden gemaakt. De STAND-BY-optie is toegestaan voor offline herstellen (inclusief gedeeltelijke herstelbewerking). De optie is niet toegestaan voor online herstellen. Als u de STAND-BY-optie voor een online herstelbewerking probeert op te geven, mislukt de herstelbewerking. STAND-BY is ook niet toegestaan wanneer een database-upgrade nodig is.

Het stand-bybestand wordt gebruikt om een 'copy-on-write'-pre-image te bewaren voor pagina's die zijn gewijzigd tijdens het ongedaan maken van een HERSTELBEWERKING MET STAND-BY. Met het stand-bybestand kan een database worden opgehaald voor alleen-lezentoegang tussen herstelbewerkingen van transactielogboeken en kan worden gebruikt met warme stand-byserversituaties of speciale herstelsituaties waarin het handig is om de database tussen logboekherstelbewerkingen te inspecteren. Na een RESTORE WITH STANDBY-bewerking wordt het bestand automatisch verwijderd door de volgende RESTORE-bewerking. Als dit stand-bybestand handmatig wordt verwijderd voor de volgende HERSTELbewerking, moet de hele database opnieuw worden hersteld. Terwijl de database de stand-BY-status heeft, moet u dit stand-bybestand met dezelfde zorg behandelen als elk ander databasebestand. In tegenstelling tot andere databasebestanden wordt dit bestand alleen geopend gehouden door de Database Engine tijdens actieve herstelbewerkingen.

De standby_file_name geeft een stand-bybestand op waarvan de locatie is opgeslagen in het logboek van de database. Als een bestaand bestand de opgegeven naam gebruikt, wordt het bestand overschreven; anders maakt de Database Engine het bestand.

De groottevereiste van een bepaald stand-bybestand is afhankelijk van het volume van ongedaan maken acties die het gevolg zijn van niet-doorgevoerde transacties tijdens de herstelbewerking.

Zie de sectie 'Opmerkingen' in RESTORE voor een vergelijking van RECOVERY en NORECOVERY.

LOADHISTORY

Ondersteund door:RESTORE VERIFYONLY

Hiermee geeft u op dat de herstelbewerking de informatie in de msdb geschiedenistabellen laadt. De optie LOADHISTORY laadt informatie voor de enkele back-upset die wordt geverifieerd, over SQL Server back-ups die zijn opgeslagen op de media die zijn ingesteld op de back-up- en herstelgeschiedenistabellen in de msdb-database. Zie System Tables (Transact-SQL) voor meer informatie over geschiedenistabellen.

Houd er rekening mee dat het gebruik van LOADHISTORY voor back-ups die al in de msdb geschiedenistabellen bestaan, dezelfde informatie toevoegt met een nieuwe backup_set_id. Als u LOADHISTORY gebruikt om de back-upgeschiedenis msdbopnieuw te maken op een andere server of nadat deze van de oorspronkelijke server is verwijderd, is het raadzaam om de herstelopdrachten voor de back-ups uit te voeren in de volgorde waarin ze zijn gemaakt. Dit zorgt ervoor dat de LSN-keten intact blijft en de SSMS-herstelwizard de back-upgeschiedenis correct leest om de juiste herstelvolgorde te genereren. Het gebruik van LOADHISTORY met back-upgeschiedenis die buiten de volgorde is gemaakt, kan leiden tot een fout bij het herstellen ('Kan herstelplan niet maken vanwege onderbreking in de LSN-keten. (Microsoft. SqlServer.SmoExtended)").

< > general_WITH_options [ ,... n ]

De volgende algemene WITH-opties worden allemaal ondersteund in de instructies RESTORE DATABASE en RESTORE LOG. Sommige van deze opties worden ook ondersteund door een of meer hulpinstructies, zoals vermeld.

Opties voor herstelbewerking

Deze opties zijn van invloed op het gedrag van de herstelbewerking.

LOGICAL_FILE_NAME_IN_BACKUP VERPLAATSEN NAAR 'operating_system_file_name' [ ,... n ]

Ondersteund door:RESTORE and RESTORE VERIFYONLY

Hiermee geeft u op dat de gegevens of het logboekbestand waarvan de logische naam is opgegeven door logical_file_name_in_backup moet worden verplaatst door het te herstellen naar de locatie die is opgegeven door operating_system_file_name. De naam van een logisch bestand van een gegevens- of logboekbestand in een back-upset komt overeen met de logische naam in de database toen de back-upset werd gemaakt.

n is een tijdelijke aanduiding die aangeeft dat u aanvullende MOVE-instructies kunt opgeven. Geef een MOVE-instructie op voor elk logisch bestand dat u wilt herstellen van de back-upset naar een nieuwe locatie. Standaard wordt het logical_file_name_in_backup-bestand teruggezet naar de oorspronkelijke locatie.

Als een RESTORE-instructie wordt gebruikt om een database op dezelfde server te verplaatsen of naar een andere server te kopiëren, kan de optie MOVE nodig zijn om de databasebestanden te verplaatsen en conflicten met bestaande bestanden te voorkomen.

Wanneer deze wordt gebruikt met HET HERSTELLOGBOEK, kan de optie VERPLAATSEN alleen worden gebruikt om bestanden te verplaatsen die zijn toegevoegd tijdens het interval dat wordt gedekt door het logboek dat wordt hersteld. Als de logboekback-up bijvoorbeeld een bestandsbewerking voor file23het bestand bevat, kan dit bestand worden verplaatst met behulp van de optie VERPLAATSEN in HET LOGBOEK HERSTELLEN.

Wanneer deze wordt gebruikt met SQL Server Momentopnameback-up, kan de optie VERPLAATSEN alleen worden gebruikt om bestanden te verplaatsen naar een Azure blob binnen hetzelfde opslagaccount als de oorspronkelijke blob. De optie MOVE kan niet worden gebruikt om de back-up van de momentopname te herstellen naar een lokaal bestand of naar een ander opslagaccount.

Als een RESTORE VERIFYONLY-instructie wordt gebruikt wanneer u van plan bent om een database op dezelfde server te verplaatsen of naar een andere server te kopiëren, kan de optie MOVE nodig zijn om te controleren of er voldoende ruimte beschikbaar is in het doel en mogelijke conflicten met bestaande bestanden te identificeren.

Zie Databases kopiëren met back-up en herstel voor meer informatie.

CREDENTIAL

Ondersteund door:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY en RESTORE VERIFYONLY.

Applies aan: SQL Server 2012 (11.x) SP1 CU2 en hoger

Alleen gebruikt bij het herstellen van een back-up vanuit de Microsoft Azure Blob Storage.

REPLACE

Ondersteund door:RESTORE

Hiermee geeft u op dat SQL Server de opgegeven database en de bijbehorende bestanden moet maken, zelfs als er al een andere database met dezelfde naam bestaat. In dat geval wordt de bestaande database verwijderd. Wanneer de optie VERVANGEN niet is opgegeven, wordt er een veiligheidscontrole uitgevoerd. Dit voorkomt dat een andere database per ongeluk wordt overschreven. De veiligheidscontrole zorgt ervoor dat de instructie RESTORE DATABASE de database niet herstelt naar de huidige server als de volgende voorwaarden beide bestaan:

• De database met de naam in de INSTRUCTIE RESTORE bestaat al op de huidige server en

• De databasenaam verschilt van de databasenaam die is vastgelegd in de back-upset.

MET REPLACE kan RESTORE ook een bestaand bestand overschrijven dat niet kan worden geverifieerd als behorend tot de database die wordt hersteld. Normaal gesproken weigert RESTORE pre-bestaande bestanden te overschrijven. MET REPLACE kan ook op dezelfde manier worden gebruikt voor de optie RESTORE LOG.

REPLACE overschrijft ook de vereiste dat u een back-up van het logboek maakt voordat u de database herstelt.

Zie RESTORE (Transact-SQL) voor meer informatie over de impact van het gebruik van de optie VERVANGEN.

HERSTARTEN

Ondersteund door:RESTORE

Hiermee geeft u op dat SQL Server een herstelbewerking opnieuw moet starten die is onderbroken. OPNIEUW OPSTARTEN start de herstelbewerking opnieuw op het moment dat deze is onderbroken.

RESTRICTED_USER

Ondersteund door:RESTORE.

Hiermee beperkt u de toegang voor de zojuist herstelde database tot leden van de rollen db_owner, dbcreator of sysadmin . RESTRICTED_USER vervangt de optie DBO_ONLY. DBO_ONLY is stopgezet met SQL Server 2008 (10.0.x).

Gebruik deze optie met de optie HERSTEL.

Opties voor back-upset

Deze opties werken op de back-upset die de back-up bevat die moet worden hersteld.

FILE = { backup_set_file_number | @backup_set_file_number }

Ondersteund door:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY en RESTORE VERIFYONLY.

Identificeert de back-upset die moet worden hersteld. Een backup_set_file_number van 1 geeft bijvoorbeeld de eerste back-upset op het back-upmedium aan en een backup_set_file_number van 2 geeft de tweede back-upset aan. U kunt de backup_set_file_number van een back-upset verkrijgen met behulp van de INSTRUCTIE RESTORE HEADERONLY .

Wanneer deze niet is opgegeven, is de standaardwaarde 1, met uitzondering van RESTORE HEADERONLY. In dat geval worden alle back-upsets in de mediaset verwerkt. Zie Een back-upset opgeven voor meer informatie.

PASSWORD = { password | @password_variable }

Ondersteund door:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY en RESTORE VERIFYONLY.

Hiermee wordt het wachtwoord van de back-upset opgegeven. Een wachtwoord voor een back-upset is een tekenreeks.

Als er een wachtwoord is opgegeven toen de back-upset werd gemaakt, is dat wachtwoord vereist voor het uitvoeren van een herstelbewerking vanuit de back-upset. Het is een fout om het verkeerde wachtwoord op te geven of om een wachtwoord op te geven als de back-upset geen wachtwoord heeft.

[ METADATA_ONLY | SNAPSHOT ] [ DBNAME = { <database_name> | @database_name_variable } ]

Geïntroduceerd in SQL Server 2022 (16.x).

Vereist om te herstellen vanuit back-up van momentopnamen. BACKUP SERVER of BACKUP GROUP... Zie Maak een back-up van een Transact-SQL momentopname.

METADATA_ONLY staat voor SNAPSHOT. VDI (Virtual Device Interface) maakt gebruik van SNAPSHOT. Zie VDI-verwijzing (Virtual Device Interface)voor meer informatie over VDI.

Opties voor mediaset

Deze opties werken op de mediaset als geheel.

MEDIANAME = { media_name | @media_name_variable }

Ondersteund door:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY en RESTORE VERIFYONLY.

Hiermee geeft u de naam voor de media. Indien opgegeven, moet de medianaam overeenkomen met de medianaam op de back-upvolumes; anders wordt de herstelbewerking beëindigd. Als er geen medianaam wordt opgegeven in de instructie RESTORE, wordt de controle op een overeenkomende medianaam op de back-upvolumes niet uitgevoerd.

MEDIAPASSWORD = { mediapassword | @mediapassword_variable }

Ondersteund door:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY en RESTORE VERIFYONLY.

Hiermee wordt het wachtwoord van de mediaset opgegeven. Een wachtwoord voor een mediaset is een tekenreeks.

Als er een wachtwoord is opgegeven toen de mediaset werd opgemaakt, is dat wachtwoord vereist voor toegang tot een back-upset op de mediaset. Het is een fout om het verkeerde wachtwoord op te geven of om een wachtwoord op te geven als de mediaset geen wachtwoord heeft.

BLOCKSIZE = { blocksize | @blocksize_variable }

Ondersteund door:RESTORE

Hiermee geeft u de fysieke blokgrootte, in bytes. De ondersteunde grootten zijn 512, 1024, 2048, 4096, 8192, 16384, 32768 en 65536 (64 KB) bytes. De standaardwaarde is 65536 voor tapeapparaten en 512 anders. Deze optie is doorgaans niet nodig omdat RESTORE automatisch een blokgrootte selecteert die geschikt is voor het apparaat. Expliciet aangeven dat een blokgrootte de automatische selectie van blokgrootte overschrijft.

Als u een back-up herstelt vanaf een cd-rom, geeft u BLOCKSIZE=2048 op.

Opties voor gegevensoverdracht

Met de opties kunt u gegevensoverdracht optimaliseren vanaf het back-upapparaat.

BUFFERCOUNT = { buffercount | @buffercount_variable }

Ondersteund door:RESTORE

Hiermee geeft u het totale aantal I/O-buffers dat moet worden gebruikt voor de herstelbewerking. U kunt elk positief geheel getal opgeven; Grote aantallen buffers kunnen echter 'onvoldoende geheugen'-fouten veroorzaken vanwege onvoldoende virtuele adresruimte in het Sqlservr.exe proces.

De totale ruimte die door de buffers wordt gebruikt, wordt bepaald door: bufferaantal****maxtransfersize.

MAXTRANSFERSIZE = { maxtransfersize | @maxtransfersize_variable }

Ondersteund door:RESTORE

Hiermee geeft u de grootste overdrachtseenheid in bytes die moet worden gebruikt tussen de back-upmedia en SQL Server. De mogelijke waarden zijn veelvouden van 65536 bytes (64 kB) tot 4194304 bytes (4 MB).

Opties voor foutbeheer

Met deze opties kunt u bepalen of back-upcontrolesommen zijn ingeschakeld voor de herstelbewerking en of de bewerking stopt bij het optreden van een fout.

{ CONTROLESOM | NO_CHECKSUM }

Ondersteund door:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY en RESTORE VERIFYONLY.

Het standaardgedrag is om controlesommen te controleren als ze aanwezig zijn en zonder verificatie verder te gaan als ze niet aanwezig zijn.

CHECKSUM
Hiermee geeft u op dat back-upcontrolesommen moeten worden geverifieerd en, als de back-up geen controlesommen voor back-ups bevat, de herstelbewerking mislukt met een bericht dat aangeeft dat er geen controlesommen aanwezig zijn.

Bij het tegenkomen van een ongeldige controlesom rapporteert RESTORE standaard een controlesomfout en stopt deze. Als u echter CONTINUE_AFTER_ERROR opgeeft, wordt RESTORE voortgezet na het retourneren van een controlesomfout en het nummer van de pagina met de ongeldige controlesom, als de beschadiging toestaat.

Zie Possible Media Errors During Backup and Restore (SQL Server) voor meer informatie over het werken met back-upcontrolesommen.

NO_CHECKSUM
Hiermee wordt de validatie van controlesommen expliciet uitgeschakeld door de herstelbewerking.

{ STOP_ON_ERROR | CONTINUE_AFTER_ERROR }

Ondersteund door:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY en RESTORE VERIFYONLY.

STOP_ON_ERROR
Hiermee geeft u op dat de herstelbewerking stopt met de eerste fout die is opgetreden. Dit is het standaardgedrag voor HERSTELLEN, met uitzondering van VERIFYONLY, dat CONTINUE_AFTER_ERROR als de standaardwaarde heeft.

CONTINUE_AFTER_ERROR
Hiermee geeft u op dat de herstelbewerking moet worden voortgezet nadat er een fout is opgetreden.

Als een back-up beschadigde pagina's bevat, kunt u de herstelbewerking het beste herhalen met behulp van een alternatieve back-up die niet de fouten bevat, bijvoorbeeld een back-up die is gemaakt voordat de pagina's zijn beschadigd. Als laatste redmiddel kunt u echter een beschadigde back-up herstellen met behulp van de CONTINUE_AFTER_ERROR optie van de herstelinstructie en proberen de gegevens te herstellen.

FILESTREAM-opties

FILESTREAM ( DIRECTORY_NAME =directory_name )

Ondersteund door:RESTORE and RESTORE VERIFYONLY

Van toepassing op: SQL Server 2012 (11.x) en later

Een windows-compatibele mapnaam. Deze naam moet uniek zijn voor alle bestandsstream-mapnamen op databaseniveau in het SQL Server exemplaar. Vergelijking van uniekheid wordt gedaan op een niet-hoofdlettergevoelige manier, ongeacht SQL Server sorteringsinstellingen.

Bewakingsopties

Met deze opties kunt u de overdracht van gegevensoverdracht vanaf het back-upapparaat bewaken.

STATISTIEKEN [ = percentage ]

Ondersteund door:RESTORE and RESTORE VERIFYONLY

Geeft een bericht weer telkens wanneer een ander percentage is voltooid en wordt gebruikt om de voortgang te meten. Als percentage wordt weggelaten, wordt SQL Server een bericht weergegeven nadat elke 10 procent is voltooid (ongeveer).

De optie STATS rapporteert het percentage voltooid vanaf de drempelwaarde voor het rapporteren van het volgende interval. Dit is ongeveer het opgegeven percentage; Bijvoorbeeld, met STATS=10, de Database Engine rapporteert ongeveer dat interval; in plaats van bijvoorbeeld precies 40%weer te geven, kan de optie 43%weergeven. Voor grote back-upsets is dit geen probleem omdat het percentage voltooid zeer langzaam wordt verplaatst tussen voltooide I/O-aanroepen.

Tapeopties

Deze opties worden alleen gebruikt voor TAPE-apparaten. Als er een niet-tape-apparaat wordt gebruikt, worden deze opties genegeerd.

{ TERUGSPOELEN | NOREWIND }

Deze opties worden alleen gebruikt voor TAPE-apparaten. Als er een niet-tapeapparaat wordt gebruikt, worden deze opties genegeerd.

TERUGSPOELEN
Ondersteund door:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY en RESTORE VERIFYONLY.

Hiermee geeft u op dat SQL Server loslaat en de tape terugspoelen. REWIND is de standaardinstelling.

NOREWIND
Ondersteund door:RESTORE and RESTORE VERIFYONLY

Als u NOREWIND opgeeft in een andere herstelinstructie, wordt er een fout gegenereerd.

Hiermee geeft u op dat SQL Server de tape geopend houdt na de back-upbewerking. U kunt deze optie gebruiken om de prestaties te verbeteren bij het uitvoeren van meerdere back-upbewerkingen op een tape.

NOREWIND impliceert NOUNLOAD en deze opties zijn niet compatibel binnen één RESTORE-instructie.

{ UNLOAD | NOUNLOAD }

Ondersteund door:RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY, RESTORE REWINDONLY en RESTORE VERIFYONLY.

Deze opties worden alleen gebruikt voor TAPE-apparaten. Als er een niet-tapeapparaat wordt gebruikt, worden deze opties genegeerd.

UITLADEN
Hiermee geeft u op dat de tape automatisch opnieuw wordt opgestart en wordt verwijderd wanneer de back-up is voltooid. UNLOAD is de standaardinstelling wanneer een sessie begint.

NOUNLOAD
Hiermee geeft u op dat na de HERSTELbewerking de tape op het tapestation geladen blijft.

<replication_WITH_option>

Deze optie is alleen relevant als de database is gerepliceerd toen de back-up werd gemaakt.

KEEP_REPLICATION
Ondersteund door:RESTORE

Gebruik KEEP_REPLICATION bij het instellen van replicatie om te werken met logboekverzending. Hiermee voorkomt u dat replicatie-instellingen worden verwijderd wanneer een databaseback-up of logboekback-up wordt hersteld op een warme stand-byserver en de database wordt hersteld. Het opgeven van deze optie bij het herstellen van een back-up met de optie NORECOVERY is niet toegestaan. Om ervoor te zorgen dat replicatie correct functioneert na het herstellen:

• De msdb databases op master de warme stand-byserver moeten gesynchroniseerd zijn met de msdb en master databases op de primaire server.

• De naam van de warme stand-byserver moet worden gewijzigd om dezelfde naam te gebruiken als de primaire server.

<change_data_capture_WITH_option>

Deze optie is alleen relevant als de database is ingeschakeld voor het vastleggen van wijzigingsgegevens toen de back-up werd gemaakt.

KEEP_CDC

Ondersteund door:RESTORE

KEEP_CDC moet worden gebruikt om te voorkomen dat instellingen voor het vastleggen van gegevens worden verwijderd wanneer een back-up van een database of logboekback-up op een andere server wordt hersteld en de database wordt hersteld. Het opgeven van deze optie bij het herstellen van een back-up met de optie NORECOVERY is niet toegestaan.

Als u de database met KEEP_CDC herstelt, worden de taken voor het vastleggen van wijzigingengegevens niet gemaakt. Als u wijzigingen uit het logboek wilt extraheren nadat u de database hebt hersteld, maakt u de opnameprocestaak en de opschoontaak voor de herstelde database opnieuw. Zie sys.sp_cdc_add_job (Transact-SQL) voor meer informatie.

Zie Change Data Capture and Other SQL Server Features voor informatie over het gebruik van wijzigingsgegevensopname met databasespiegeling.

<service_broker_WITH_options>

Hiermee schakelt u de bezorging van Service Broker-berichten in of uit of stelt u een nieuwe Service Broker-id in. Deze optie is alleen relevant als Service Broker is ingeschakeld (geactiveerd) voor de database toen de back-up werd gemaakt.

{ ENABLE_BROKER | ERROR_BROKER_CONVERSATIONS | NEW_BROKER }

Ondersteund door:RESTORE DATABASE

ENABLE_BROKER
Hiermee geeft u op dat de bezorging van Service Broker-berichten aan het einde van het herstel is ingeschakeld, zodat berichten onmiddellijk kunnen worden verzonden. Standaard wordt de bezorging van Service Broker-berichten uitgeschakeld tijdens een herstelbewerking. De database behoudt de bestaande Service Broker-id.

ERROR_BROKER_CONVERSATIONS
Hiermee worden alle gesprekken beëindigd met een fout die aangeeft dat de database is gekoppeld of hersteld. Hierdoor kunnen uw toepassingen regelmatig opschonen voor bestaande gesprekken. Service Broker-berichtbezorging is uitgeschakeld totdat deze bewerking is voltooid en vervolgens is ingeschakeld. De database behoudt de bestaande Service Broker-id.

NEW_BROKER
Hiermee geeft u op dat aan de database een nieuwe Service Broker-id wordt toegewezen. Omdat de database wordt beschouwd als een nieuwe Service Broker, worden bestaande gesprekken in de database onmiddellijk verwijderd zonder dialoogvensterberichten te produceren. Elke route die verwijst naar de oude Service Broker-id, moet opnieuw worden gemaakt met de nieuwe id.

<point_in_time_WITH_options>

Ondersteund door:RESTORE {DATABASE|LOG} en alleen voor de volledige of bulksgewijs vastgelegde herstelmodellen.

U kunt een database herstellen naar een bepaald tijdstip of een specifieke transactie door het doelherstelpunt op te geven in een STOPAT-, STOPATMARK- of STOPBEFOREMARK-component. Een opgegeven tijd of transactie wordt altijd hersteld vanuit een logboekback-up. In elke INSTRUCTIE RESTORE LOG van de herstelvolgorde moet u uw doeltijd of transactie opgeven in een identieke STOPAT-, STOPATMARK- of STOPBEFOREMARK-component.

Als vereiste voor herstel naar een bepaald tijdstip moet u eerst een volledige databaseback-up herstellen waarvan het eindpunt eerder is dan het doelherstelpunt. Om u te helpen bepalen welke databaseback-up u wilt herstellen, kunt u desgewenst de component WITH STOPAT, STOPATMARK of STOPBEFOREMARK opgeven in een RESTORE DATABASE-instructie om een fout te genereren als een gegevensback-up te recent is voor de opgegeven doeltijd. Maar de volledige gegevensback-up wordt altijd hersteld, zelfs als deze de doeltijd bevat.

{ STOPAT | STOPATMARK | STOPBEFOREMARK }

STOPAT = { 'datetime' | @_datetime_var* }
Hiermee geeft u op dat de database moet worden hersteld naar de status waarin deze zich bevond vanaf de datum en tijd die is opgegeven door de parameter datetime of @datetime_var . Zie Date- en tijdgegevenstypen en -functies (Transact-SQL) voor informatie over het opgeven van een datum en tijd.

Als een variabele wordt gebruikt voor STOPAT, moet de variabele varchar, char, smalldatetime of datetime-gegevenstype zijn. Alleen transactielogboekrecords die vóór de opgegeven datum en tijd zijn geschreven, worden toegepast op de database.

Zie Een SQL Server-database herstellen naar een bepaald tijdstip (volledig herstelmodel)voor meer informatie.

STOPATMARK = { 'mark_name'lsn | :lsn_number' } [ NA 'datum/tijd' ]
Hiermee geeft u herstel naar een opgegeven herstelpunt. De opgegeven transactie wordt opgenomen in het herstel, maar wordt alleen doorgevoerd als deze oorspronkelijk is doorgevoerd toen de transactie daadwerkelijk werd gegenereerd.

Zowel RESTORE DATABASE als RESTORE LOG ondersteunen de parameter lsn_number . Met deze parameter geeft u een logboekreeksnummer op.

De parameter mark_name wordt alleen ondersteund door de instructie RESTORE LOG. Deze parameter identificeert een transactiemarkering in de logboekback-up.

Als na datum/tijd wordt weggelaten in een RESTORE LOG-instructie, stopt het herstel bij de eerste markering met de opgegeven naam. Als NA datum/tijd is opgegeven, stopt het herstel bij de eerste markering met de opgegeven naam precies op of na datum/tijd.

Zie Gebruik gemarkeerde transacties om gerelateerde databases consistent te herstellen (Full Recovery Model) en Herstel naar een logboekreeksnummer (SQL Server) voor meer informatie.

STOPBEFOREMARK = { 'mark_name'lsn | :lsn_number' } [ NA 'datum/tijd' ]
Hiermee geeft u herstel tot een opgegeven herstelpunt. De opgegeven transactie is niet opgenomen in het herstel en wordt teruggedraaid wanneer WITH RECOVERY wordt gebruikt.

Zowel RESTORE DATABASE als RESTORE LOG ondersteunen de parameter lsn_number . Met deze parameter geeft u een logboekreeksnummer op.

De parameter mark_name wordt alleen ondersteund door de instructie RESTORE LOG. Deze parameter identificeert een transactiemarkering in de logboekback-up.

Als na datum/tijd wordt weggelaten in een RESTORE LOG-instructie, stopt het herstel vlak voor de eerste markering met de opgegeven naam. Als NA datum/tijd is opgegeven, stopt het herstel vlak voor de eerste markering met de opgegeven naam precies op of na datum/tijd.

Resultatensets

Zie de volgende artikelen voor resultatensets:

• RESTORE FILELISTONLY (Transact-SQL)

• RESTORE HEADERONLY (Transact-SQL)

• RESTORE LABELONLY (Transact-SQL)

Opmerkingen

Zie de volgende artikelen voor aanvullende opmerkingen:

• RESTORE (Transact-SQL)

• RESTORE HEADERONLY (Transact-SQL)

• RESTORE LABELONLY (Transact-SQL)

• RESTORE REWINDONLY (Transact-SQL)

• VERIFYONLY (Transact-SQL) herstellen

Een back-upset opgeven

Een back-upset bevat de back-up van één geslaagde back-upbewerking. DE instructies RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY en RESTORE VERIFYONLY werken op één back-upset binnen de mediaset op het opgegeven back-upapparaat of -apparaten. U moet de back-up opgeven die u nodig hebt vanuit de mediaset. U kunt de backup_set_file_number van een back-upset verkrijgen met behulp van de INSTRUCTIE RESTORE HEADERONLY .

De optie voor het opgeven van de back-upset die moet worden hersteld, is:

BESTAND ={ backup_set_file_number backup_set_file_number | @ }

Waar backup_set_file_number de positie van de back-up in de mediaset aangeeft. Een backup_set_file_number van 1 (FILE = 1) geeft de eerste back-upset op het back-upmedium aan en een backup_set_file_number van 2 (FILE = 2) geeft de tweede back-upset aan, enzovoort.

Het gedrag van deze optie is afhankelijk van de instructie, zoals beschreven in de volgende tabel:

Overzicht van ondersteuning voor WITH-opties

De volgende WITH-opties worden alleen ondersteund door de INSTRUCTIE RESTORE: BLOCKSIZE, BUFFERCOUNT, MAXTRANSFERSIZE, PARTIAL, KEEP_REPLICATION, { RECOVERY | NORECOVERY | STAND-BY }, VERVANGEN, OPNIEUW OPSTARTEN, RESTRICTED_USER en { STOPAT | STOPATMARK | STOPBEFOREMARK }

De volgende tabel bevat de WITH-opties die worden gebruikt door een of meer instructies en geeft aan welke instructies elke optie ondersteunen. Een vinkje (√) geeft aan dat een optie wordt ondersteund; een streepje (-) geeft aan dat een optie niet wordt ondersteund.

¹ BESTAND =backup_set_file_number, dat verschilt van {FILE | FILEGROUP}.

Permissions

Zie de volgende artikelen voor machtigingen:

• RESTORE (Transact-SQL)

• RESTORE FILELISTONLY (Transact-SQL)

• RESTORE HEADERONLY (Transact-SQL)

• RESTORE LABELONLY (Transact-SQL)

• RESTORE REWINDONLY (Transact-SQL)

• VERIFYONLY (Transact-SQL) herstellen

Examples

Zie de volgende artikelen voor voorbeelden:

• RESTORE (Transact-SQL)

• RESTORE FILELISTONLY (Transact-SQL)

• RESTORE HEADERONLY (Transact-SQL)

Volgende stappen 

• BACKUP (Transact-SQL)
• RESTORE (Transact-SQL)
• RESTORE FILELISTONLY (Transact-SQL)
• RESTORE HEADERONLY (Transact-SQL)
• RESTORE LABELONLY (Transact-SQL)
• RESTORE REWINDONLY (Transact-SQL)
• VERIFYONLY (Transact-SQL) herstellen
• back-up maken en herstellen van SQL Server-databases
• filestream (SQL Server)