Aplicativo sqllogship

Aplica-se a:SQL Server

O aplicativo sqllogship realiza uma operação de backup, cópia ou restauração e as tarefas de limpeza associadas de uma configuração de envio de logs. A operação é realizada em uma instância específica do Microsoft SQL Server para um banco de dados específico.

Para obter as convenções de sintaxe, confira Referência de utilitários de prompt de comando (Mecanismo de Banco de Dados).

Sintaxe

  
sqllogship -server instance_name { -backup primary_id | -copy secondary_id | -restore secondary_id } [ -verboselevel level ] [ -logintimeout timeout_value ] [ -querytimeout timeout_value ]  

Argumentos

-serverinstance_name
Especifica a instância da SQL Server onde a operação será executada. A instância do servidor a especificar depende da operação de envio de logs que está sendo especificada. Para -backup, instance_name deve ser o nome do servidor primário em uma configuração de envio de logs. Para -copy ou -restore, instance_name deve ser o nome de um servidor secundário em uma configuração de envio de logs.

-backupprimary_id
Realiza uma operação de backup do banco de dados primário cuja ID primária é especificada por primary_id. É possível obter esta ID selecionando-a na tabela do sistema log_shipping_primary_databases ou usando o procedimento armazenado sp_help_log_shipping_primary_database .

A operação de backup cria o backup de log no diretório de backup. O aplicativo sqllogship limpa os arquivos de backup antigos, com base no período de retenção dos arquivos. Em seguida, o aplicativo registra o histórico da operação de backup no servidor primário e o servidor monitor. Por fim, o aplicativo executa sp_cleanup_log_shipping_history, que limpa as informações do histórico antigo, com base no período de retenção.

-copysecondary_id
Executa uma operação para copiar os backups de um servidor secundário especificado do banco de dados secundário, ou bancos de dados, cuja ID secundária é especificada por secondary_id. É possível obter esta ID selecionando-a na tabela do sistema log_shipping_secondary ou usando o procedimento armazenado sp_help_log_shipping_secondary_database .

A operação copia os arquivos de backup do diretório de backup para o diretório de destino. O aplicativo sqllogship registra o histórico da operação de cópia no servidor secundário e no servidor do monitor.

-restoresecondary_id
Realiza uma operação de restauração no servidor secundário especificado do banco de dados, ou bancos de dados secundários, cuja ID secundária é especificada por secondary_id. É possível obter esta ID usando o procedimento armazenado sp_help_log_shipping_secondary_database .

Qualquer arquivo de backup no diretório de destino criado após o ponto de restauração mais recente é restaurado no banco de dados ou bancos de dados secundários. O aplicativo sqllogship limpa os arquivos de backup antigos, com base no período de retenção dos arquivos. Em seguida, o aplicativo registra o histórico da operação de backup no servidor primário e o servidor monitor. Por fim, o aplicativo executa sp_cleanup_log_shipping_history, que limpa as informações do histórico antigo, com base no período de retenção.

-verboselevellevel
Especifica o nível das mensagens adicionadas ao histórico do envio de logs. level é um dos seguintes inteiros:

Nível	Descrição
0	Não emite nenhuma mensagem de rastreamento ou de depuração.
1	Emite mensagens para tratamento de erros.
2	Emite mensagens para tratamento de erros e avisos.
3	Emite mensagens informativas, avisos e mensagens de tratamento de erros. Esse é o valor padrão.
4	Emite todas as mensagens de depuração e de rastreamento.

-logintimeouttimeout_value
Especifica o tempo designado para tentar efetuar o login à instância do servidor antes da tentativa expirar. O padrão é 15 segundos. timeout_value é int.

-querytimeouttimeout_value
Especifica o tempo designado para iniciar a operação especificada antes da tentativa expirar. O padrão é sem período de expiração. timeout_value é int.

Comentários

Recomendamos a utilização das opções de backup, copiar e restaurar para realizar as tarefas de backup, copiar e restaurar quando for possível. Para iniciar esses trabalhos em uma operação em lote ou em outro aplicativo, chame o procedimento armazenado sp_start_job .

O histórico do envio de logs criado por sqllogship é intercalado com o histórico criado pelos trabalhos de backup, cópia e restauração do envio de logs. Se você pretende usar sqllogship repetidamente para realizar as operações de backup, cópia ou restauração de uma configuração de envio de logs, considere desabilitar o(s) trabalho(s) de envio de logs correspondente(s). Para obter mais informações, consulte Disable or Enable a Job.

O aplicativo sqllogship , SqlLogShip.exe, é instalado no diretório x:\Arquivos de Programas\Microsoft SQL Server\130\Tools\Binn.

Permissões

sqllogship usa a Autenticação do Windows. A conta Autenticação do Windows onde o comando é executado requer acesso ao diretório e às permissões SQL Server do Windows O requisito depende de qual opção é especificada pelo comando sqllogship : -backup, -copyou -restore .

Opção	Acesso ao diretório	Permissões
-backup	Requer o acesso leitura/gravação ao diretório de backup.	Requer as mesmas permissões da instrução BACKUP. Para obter mais informações, confira BACKUP (Transact-SQL).
-copy	Requer o acesso leitura ao diretório de backup e o acesso gravação ao diretório copiar	Exige as mesmas permissões do procedimento armazenado sp_help_log_shipping_secondary_database .
-restore	Requer o acesso leitura/gravação ao diretório copiar.	Requer as mesmas permissões da instrução RESTORE. Para obter mais informações, confira RESTORE (Transact-SQL).

Observação

Para encontrar os caminhos dos diretórios de backup e cópia, execute o procedimento armazenado sp_help_log_shipping_secondary_database ou exiba a tabela log_shipping_secondary no msdb. Os caminhos dos diretórios de backup e de destino estão nas colunas backup_source_directory e backup_destination_directory , respectivamente.

Consulte Também

Sobre o envio de logs (SQL Server)
log_shipping_primary_databases (Transact-SQL)
log_shipping_secondary (Transact-SQL)
sp_cleanup_log_shipping_history (Transact-SQL)
sp_help_log_shipping_primary_database (Transact-SQL)
sp_help_log_shipping_secondary_database (Transact-SQL)
sp_start_job (Transact-SQL)