Instruções RESTORE – REWINDONLY (Transact-SQL)

Artigo
10/16/2024

Aplica-se: SQL Server

Retrocede e fecha os dispositivos de fita especificados deixados abertos pelas instruções BACKUP ou RESTORE com a opção NOREWIND. Só há suporte para este comando em dispositivos de fita.

Convenções de sintaxe de Transact-SQL

Sintaxe

  
RESTORE REWINDONLY   
FROM <backup_device> [ ,...n ]  
[ WITH {UNLOAD | NOUNLOAD}]  
}   
[;]  
  
<backup_device> ::=  
{   
   { logical_backup_device_name |  
      @logical_backup_device_name_var }  
   | TAPE = { 'physical_backup_device_name' |  
       @physical_backup_device_name_var }   
}

Argumentos

<backup_device> ::=

Especifica os dispositivos de backup lógicos ou físicos a serem usados na operação de restauração.

{ logical_backup_device_name | @logical_backup_device_name_var }
É o nome lógico que deve seguir as regras para identificadores dos dispositivos de backup criados por sp_addumpdevice dos quais o banco de dados é restaurado. Se for fornecido como uma variável (@logical_backup_device_name_var), o nome do dispositivo de backup poderá ser especificado como uma constante de cadeia de caracteres (@logical_backup_device_name_var = logical_backup_device_name) ou como uma variável do tipo de dados de cadeia de caracteres, exceto os tipos de dados ntext ou text.

{DISK | TAPE } = { 'physical_backup_device_name' | @physical_backup_device_name_var }
Permite restaurar backups do disco nomeado ou dispositivo de fita. Os tipos de dispositivo de disco e de fita devem ser especificados com o nome real (por exemplo, o caminho e o nome do arquivo completos) do dispositivo: DISK = 'C:\Program Files\Microsoft SQL Server\MSSQL\BACKUP\Mybackup.bak' ou TAPE = '\\ \TAPE0'. Se for especificado como uma variável (@physical_backup_device_name_var), o nome do dispositivo poderá ser especificado como uma constante de cadeia de caracteres (@physical_backup_device_name_var = 'physcial_backup_device_name') ou como uma variável do tipo de dados de cadeia de caracteres, exceto para os tipos de dados ntext ou text.

Se usando um servidor de rede com um nome de UNC (que deve conter o nome de máquina), especifique um tipo de dispositivo de disco. Para obter mais informações de como usar os nomes UNC, confira Dispositivos de backup (SQL Server).

A conta com a qual você está executando o Microsoft SQL Server precisa ter acesso READ ao computador remoto ou ao servidor de rede para executar uma operação RESTORE.

n
É um espaço reservado que indica vários dispositivos de backup e dispositivos de backup lógicos podem ser especificados. O número máximo de dispositivos de backup ou de dispositivos de backup lógicos é 64.

Se uma sequência de restauração irá requerer tantos dispositivos de backup quantos foram usados para criar o conjunto de mídia ao qual o backup pertence depende de se a restauração é off-line ou on-line. A restauração off-line permite que um backup seja restaurado usando menos dispositivos que os usados para criar o backup. A restauração on-line requer todos os dispositivos de backup. Uma tentativa de restaurar com menos dispositivos falhará.

Para obter mais informações, confira Dispositivos de backup (SQL Server).

Observação

Ao restaurar um backup de um conjunto de mídia espelhado, você pode especificar apenas um único espelho para cada família de mídia. Na presença de erros, entretanto, ter os outros espelhos permite a solução rápida de alguns problemas de restauração. Você pode substituir um volume de mídia danificado pelo volume correspondente de outro espelho. Observe que, para restaurações off-line, você pode restaurar a partir de menos dispositivos que as famílias de mídia, mas cada família é processada apenas uma vez.

Opções WITH

UNLOAD
Especifica que a fita é retrocedida e descarregada automaticamente quando RESTORE for concluído. UNLOAD é definido por padrão quando uma nova sessão de usuário é iniciada. Ele permanece definido até que NOUNLOAD seja especificado. Esta opção só é usada para dispositivos de fita. Se um dispositivo que não seja de fita estiver sendo usado para RESTORE, esta opção será ignorada.

NOUNLOAD
Especifica que a fita não descarregada automaticamente da unidade de fita após RESTORE. NOUNLOAD permanece definido até que UNLOAD seja especificado.

Comentários gerais

RESTORE REWINDONLY é uma alternativa a RESTORE LABELONLY FROM TAPE = <nome> WITH REWIND. Você pode obter uma lista de unidades de fita abertas na exibição de gerenciamento dinâmico sys.dm_io_backup_tapes.

Segurança

Permissões

Qualquer usuário pode usar RESTORE REWINDONLY.

Consulte Também

BACKUP (Transact-SQL)
Conjuntos de mídias, famílias de mídia e conjuntos de backup (SQL Server)
RESTORE (Transact-SQL)
Informações de histórico e cabeçalho de backup (SQL Server)

Partilhar via