Arguments RESTORE (Transact-SQL)

Ces options affectent le comportement de l'opération de restauration.

• MOVE 'logical_file_name_in_backup' TO 'operating_system_file_name' [ ...n ]
  Pris en charge par : RESTORE et RESTORE VERIFYONLY

  Indique que le fichier de données ou journal dont le nom logique est spécifié par logical_file_name_in_backup doit être déplacé par le biais d'une restauration dans l'emplacement défini par operating_system_file_name. Le nom de fichier logique d'un fichier de données ou journal dans un jeu de sauvegarde correspond au nom logique qu'il portait dans la base de données au moment de la création du jeu de sauvegarde.

  n est un espace réservé indiquant que vous pouvez spécifier des instructions MOVE supplémentaires. Spécifiez une instruction MOVE pour chaque fichier logique à restaurer à partir du jeu de sauvegarde dans un nouvel emplacement. Par défaut, le fichier logical_file_name_in_backup est restauré dans son emplacement d'origine.

  [!REMARQUE]

  Utilisez RESTORE FILELISTONLY pour obtenir une liste des fichiers logiques contenus dans le jeu de sauvegarde.

  Si une instruction RESTORE est utilisée pour déplacer une base de données sur le même serveur ou la copier sur un serveur différent, l'option MOVE peut s'avérer nécessaire afin de déplacer les fichiers de la base et d'éviter toute collision avec des fichiers existants.

  Utilisée avec RESTORE LOG, l'option MOVE ne peut servir qu'à déplacer les fichiers qui ont été ajoutés au cours de l'intervalle couvert par le journal en cours de restauration. Si, par exemple, la sauvegarde du journal contient une opération d'ajout de fichier pour le fichier file23, ce fichier peut être déplacé à 'laide de l'option MOVE sur RESTORE LOG.

  Si une instruction RESTORE VERIFYONLY est utilisée lorsque vous prévoyez de déplacer une base de données sur le même serveur ou de la copier sur un serveur différent, l'option MOVE peut s'avérer nécessaire afin de vérifier que l'espace disponible est nécessaire sur la cible et d'identifier les collisions éventuelles avec des fichiers existants.

  Pour plus d'informations, consultez Copie de bases de données avec la sauvegarde et la restauration.

• REPLACE
  Pris en charge par : RESTORE

  Indique que SQL Server doit créer la base de données spécifiée et ses fichiers même s'il en existe une autre de même nom. En pareil cas, la base existante est supprimée. Lorsque l'option REPLACE n'est pas précisée, une vérification a lieu. Celle-ci évite le remplacement accidentel d'une autre base de données. Cette vérification garantit que l'instruction RESTORE DATABASE ne restaure pas la base de données sur le serveur courant si les deux conditions suivantes existent :

  • la base de données nommée dans l'instruction RESTORE existe déjà sur le serveur en cours, et

  • le nom de la base est différent du nom enregistré dans le jeu de sauvegarde.

  REPLACE permet également à RESTORE de remplacer un fichier existant dont il est impossible de vérifier qu'il appartient à la base de données en cours de restauration. Normalement, RESTORE refuse de remplacer les fichiers existants. WITH REPLACE peut aussi être utilisé de la même manière que l'option RESTORE LOG.

  REPLACE supplante également la nécessité de sauvegarder la fin du journal avant la restauration de la base de données.

  Pour plus d'informations, consultez Utilisation de l'option REPLACE.

• RESTART
  Pris en charge par : RESTORE

  Indique que SQL Server doit redémarrer une restauration qui a été interrompue. RESTART relance la restauration au point de son interruption.

• RESTRICTED_USER
  Pris en charge par : RESTORE.

  Restreint l'accès à la base de données restaurée aux membres des rôles db_owner, dbcreator ou sysadmin. RESTRICTED_USER remplace l'option DBO_ONLY. L'option DBO_ONLY a été supprimée dans SQL Server 2008.

  Utilisez avec l'option RECOVERY.

  Pour plus d'informations, consultez Définition des options de base de données.

Ces options se rapportent au jeu de sauvegarde qui contient la sauvegarde à restaurer.

• FILE ={ backup_set_file_number | **@**backup_set_file_number }
  Pris en charge par : RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY et RESTORE VERIFYONLY.

  Identifie le jeu de sauvegardes à restaurer. Ainsi, la valeur 1 de backup_set_file_number peut indiquer le premier jeu de sauvegarde sur le support, et la valeur 2 le second jeu. Vous pouvez obtenir le backup_set_file_number d'un jeu de sauvegarde en utilisant l'instruction RESTORE HEADERONLY.

  Lorsque la valeur n'est pas spécifiée, celle par défaut est 1, sauf pour RESTORE HEADERONLY auquel cas tous les jeux de sauvegarde dans le support de sauvegarde sont traités. Pour plus d'informations, consultez « Spécification d'un jeu de sauvegarde » plus loin dans cette rubrique.

  Important

  Cette option FILE n'a pas de rapport avec l'option FILE permettant de spécifier un fichier de base de données (FILE = { logical_file_name_in_backup | @logical_file_name_in_backup_var }).

• PASSWORD = { password | **@**password_variable }
  Pris en charge par : RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY et RESTORE VERIFYONLY.

  Fournit le mot de passe du jeu de sauvegarde. Un mot de passe de jeu de sauvegarde est une chaîne de caractères.

  [!REMARQUE]

  Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

  Si un mot de passe a été spécifié lors de la création du jeu de sauvegarde, il est requis lors de chaque opération de restauration à partir du jeu de sauvegarde. La spécification d'un mot de passe incorrect ou d'un mot de passe pour un jeu de sauvegarde qui n'en possède pas constitue une erreur.

  Important

  Ce mot de passe fournit uniquement une protection faible pour le support de sauvegarde. Pour plus d'informations, consultez la section « Autorisations » pour la rubrique adéquate.

Ces options s'appliquent au support de sauvegarde dans son ensemble.

• MEDIANAME = { media_name | **@**media_name_variable}
  Pris en charge par : RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY et RESTORE VERIFYONLY.

  Indique le nom du support. S'il est fourni, le nom du support doit correspondre au nom des volumes de sauvegarde ; sinon, l'opération de restauration prend fin. En l'absence de nom de support dans l'instruction RESTORE, aucun contrôle n'a lieu pour vérifier la correspondance des noms de support sur les volumes de sauvegarde.

  Important

  L'emploi cohérent de noms de support dans les opérations de sauvegarde et de restauration offre une garantie supplémentaire de sécurité lors du choix des supports de restauration.

• MEDIAPASSWORD = { mediapassword | **@**mediapassword_variable }
  Pris en charge par : RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY et RESTORE VERIFYONLY.

  Fournit le mot de passe du support de sauvegarde. Un mot de passe de jeu de supports est une chaîne de caractères.

  [!REMARQUE]

  Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

  Si un mot de passe a été fourni lors du formatage du support de sauvegarde, il est requis pour accéder à tout jeu de sauvegarde sur le jeu de supports. La spécification d'un mot de passe incorrect ou d'un mot de passe pour un support de sauvegarde qui n'en possède pas constitue une erreur.

  Important

  Ce mot de passe fournit uniquement une protection faible pour le support de sauvegarde. Pour plus d'informations, consultez la section « Autorisations » pour la rubrique adéquate.

• BLOCKSIZE = { blocksize | **@**blocksize_variable }
  Pris en charge par : RESTORE

  Indique, en octets, la taille maximale de bloc. Les tailles prises en charge sont 512, 1024, 2048, 4096, 8192, 16384, 32768 et 65536 (64 Ko) octets. La valeur par défaut est 65536 pour les périphériques à bandes, 512 sinon. En règle générale, cette option est superflue car RESTORE sélectionne automatiquement une taille de bloc appropriée pour le périphérique. Si vous spécifiez explicitement une taille de bloc, la sélection automatique est annulée et remplacée.

  Si vous restaurez une sauvegarde à partir d'un CD-ROM, spécifiez BLOCKSIZE=2048.

  [!REMARQUE]

  En règle générale, cette option n'affecte les performances que si les données sont lues sur des périphériques à bandes.

Ces options vous permettent d'optimiser le transfert de données à partir de l'unité de sauvegarde.

• BUFFERCOUNT = { buffercount | **@**buffercount_variable }
  Pris en charge par : RESTORE

  Spécifie le nombre total de tampons d'E/S à utiliser pour l'opération de restauration. Vous pouvez spécifier n'importe quel entier positif ; toutefois, un nombre élevé de tampons peut provoquer des erreurs liées à une insuffisance de mémoire. En effet, l'espace d'adressage virtuel peut s'avérer inapproprié dans la tâche Sqlservr.exe.

  L'espace total utilisé par les tampons est déterminé par : buffercount*****maxtransfersize.

• MAXTRANSFERSIZE = { maxtransfersize | **@**maxtransfersize_variable }
  Pris en charge par : RESTORE

  Spécifie, en octets, la plus grande unité de transfert à utiliser entre SQL Server et le support de sauvegarde. Les valeurs possibles sont les multiples de 65536 octets (64 Ko), dans la limite de 4194304 octets (4 Mo).

Ces options vous permettent de déterminer si les sommes de contrôle de sauvegarde sont activées pour l'opération de restauration et si l'opération doit s'arrêter en présence d'une erreur.

• { CHECKSUM | NO_CHECKSUM }
  Pris en charge par : RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY et RESTORE VERIFYONLY.

  Le comportement par défaut consiste à vérifier des sommes de contrôle si elles sont présentes et à poursuivre sans vérification si elles ne le sont pas.

  • CHECKSUM
    Spécifie que des sommes de contrôle de sauvegarde doivent être vérifiées et, si la sauvegarde manque de sommes de contrôle de sauvegarde, entraîne l'échec de l'opération de restauration avec un message indiquant que des sommes de contrôle ne sont pas présentes.

    [!REMARQUE]

    Les sommes de contrôle de page sont pertinentes pour les opérations de sauvegarde uniquement si les sommes de contrôle de sauvegarde sont utilisées.

    Par défaut, lors de la détection d'une somme de contrôle incorrecte, RESTORE signale une erreur de somme de contrôle et s'arrête. Cependant, si vous spécifiez CONTINUE_AFTER_ERROR, RESTORE continue après le renvoi d'une erreur de somme de contrôle et du numéro de la page contenant la somme de contrôle incorrecte, si la corruption le permet.

    Pour plus d'informations sur l'utilisation des sommes de contrôle de sauvegarde, consultez Détection et gestion des erreurs de support aux cours d'opérations de sauvegarde et de restauration.

  • NO_CHECKSUM
    Désactive explicitement la validation de sommes de contrôle par l'opération de restauration.

• { STOP_ON_ERROR | CONTINUE_AFTER_ERROR }
  Pris en charge par : RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY et RESTORE VERIFYONLY.

  • STOP_ON_ERROR
    Spécifie que l'opération de restauration s'arrête à la première erreur rencontrée. Il s'agit du comportement par défaut pour RESTORE, sauf pour VERIFYONLY qui possède CONTINUE_AFTER_ERROR par défaut.

  • CONTINUE_AFTER_ERROR
    Spécifie que l'opération de restauration doit continuer après la détection d'une erreur.

    Pour plus d'informations sur la continuation malgré des erreurs, consultez Réponse aux erreurs de restauration SQL Server provoquées par des sauvegardes endommagées.

    Si une sauvegarde contient des pages endommagées, il est préférable de répéter l'opération de restauration en utilisant une autre sauvegarde qui ne contient pas ces erreurs (par exemple, une sauvegarde effectuée avant que les pages aient été endommagées). Toutefois, en dernier ressort, vous pouvez restaurer une sauvegarde endommagée à l'aide de l'option CONTINUE_AFTER_ERROR de l'instruction RESTORE et essayer de sauver les données.

Ces options vous permettent de surveiller le transfert des données à partir de l'unité de sauvegarde.

• STATS [ = percentage ]
  Pris en charge par : RESTORE et RESTORE VERIFYONLY

  Affiche un message à chaque fois qu'un autre pourcentage se termine et sert à évaluer l'état d'avancement de l'opération. Si percentage est omis, SQL Server affiche un message à chaque incrément de 10 pour cent (approximativement).

  L'option STATS indique le pourcentage d'achèvement en tant que seuil pour indiquer l'intervalle suivant. Cela se situe approximativement au pourcentage spécifié ; par exemple, avec STATS=10, le moteur de base de données SQL Server 2005 crée un rapport à cet intervalle environ ; par exemple, au lieu d'afficher précisément 40 %, l'option peut afficher 43 %. Pour les jeux de sauvegarde volumineux, cela n'est pas un problème car le pourcentage d'achèvement progresse très lentement entre les appels d'E/S terminés.

Ces options sont utilisées uniquement pour les périphériques À BANDES. Si vous n'utilisez pas un périphérique à bandes, ces options sont ignorées.

• { REWIND | NOREWIND }
  Ces options sont utilisées uniquement pour les périphériques À BANDES. Si vous n'utilisez pas un périphérique à bandes, ces options sont ignorées.

  • REWIND
    Pris en charge par : RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY et RESTORE VERIFYONLY.

    Indique que SQL Server libère et rembobine la bande. REWIND est le paramètre par défaut.

  • NOREWIND
    Pris en charge par : RESTORE et RESTORE VERIFYONLY

    La spécification de NOREWIND dans n'importe quel autre argument de restauration génère une erreur.

    Indique que SQL Server maintient la bande ouverte après l'opération de sauvegarde. Cette option vous permet d'améliorer les performances lorsque vous effectuez plusieurs opérations de sauvegarde sur une bande.

    NOREWIND implique NOUNLOAD, et ces options sont incompatibles dans une instruction RESTORE unique.

    [!REMARQUE]

    Si vous utilisez NOREWIND, l'instance de SQL Server conserve la propriété du lecteur de bande jusqu'à ce qu'une instruction BACKUP ou RESTORE s'exécutant dans le même processus utilise l'option REWIND ou UNLOAD, ou jusqu'à l'arrêt de l'instance du serveur. Le fait de maintenir la bande ouverte empêche les autres processus d'y accéder. Pour plus d'informations sur l'affichage de la liste des bandes ouvertes et sur leur fermeture, consultez Unités de sauvegarde.

• { UNLOAD | NOUNLOAD }
  Pris en charge par : RESTORE, RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE LABELONLY, RESTORE REWINDONLY et RESTORE VERIFYONLY.

  Ces options sont utilisées uniquement pour les périphériques À BANDES. Si vous n'utilisez pas un périphérique à bandes, ces options sont ignorées.

  [!REMARQUE]

  UNLOAD/NOUNLOAD est un paramètre de session qui reste en vigueur jusqu'à la fin de la session ou tant qu'il n'est pas réinitialisé par le choix de l'option opposée à celle en cours d'utilisation.

  • UNLOAD
    Indique que la bande est automatiquement rembobinée et démontée lorsque la sauvegarde est terminée. UNLOAD est l'option par défaut au démarrage d'une session.

  • NOUNLOAD
    Indique qu'au terme de l'opération RESTORE la bande demeurera chargée dans le lecteur de bande.