Aplicativo sqllogship

Artigo
08/01/2012

O aplicativo sqllogship executa a operação de backup, copiar ou restaurar e as tarefas de limpeza associadas para uma configuração de envio de logs. A operação é realizada em uma instância específica de Microsoft SQL Server 2005 para um banco de dados específico.

Ícone de vínculo de tópico Para obter as convenções da sintaxe, consulte 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

-server instance_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.
-backup primary_id
Realiza uma operação de backup do banco de dados primário cujo ID primário está especificado por primary_id. Você pode obter este ID selecionando-o a partir da tabela do sistema log_shipping_primary_databases ou usando o procedimento sp_help_log_shipping_primary_database armazenado.

A operação de backup cria o backup de log no diretório de backup. O aplicativo sqllogship limpa então 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. Finalmente, o aplicativo executa um sp_cleanup_log_shipping_history, que limpa as informações do histórico antigo, com base no período de retenção.
-copy secondary_id
Executa uma operação para copiar o backup de um servidor secundário especificado no banco de dados ou bancos de dados secundários, cujo ID secundário é especificado pelo secondary_id. Você pode obter este ID selecionando-o a partir da tabela do sistema log_shipping_secondary_databases ou usando o procedimento sp_help_log_shipping_secondary _database armazenado.

A operação copia os arquivos de backup do diretório de backup para o diretório de destino. O aplicativo sqllogship registra então o histórico da operação de cópia no servidor secundário e no servidor do monitor.
-restore secondary_id
Realiza uma operação de restauração no servidor secundário especificado do banco de dados ou bancos de dados secundários, cujo ID secundário é especificado pelo secondary_id. Você pode obter este ID usando o procedimento sp_help_log_shipping_secondary_database armazenado.

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 então 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. Finalmente, o aplicativo executa um sp_cleanup_log_shipping_history, que limpa as informações do histórico antigo, com base no período de retenção.

–verboselevel level
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.

–logintimeout timeout_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.
-querytimeout timeout_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 essas tarefas a partir de uma operação em lote ou outro aplicativo, chame o procedimento sp_start_job armazenado.

O histórico do envio de logs criado pelo sqllogship é intercalado com o histórico criado pelas tarefas de backup, copiar e restaurar de envio de logs. Se você planeja usar o sqllogship repetidamente para realizar as operações de backup, copiar ou restaurar para uma configuração de envio de logs, considere desabilitar a tarefa ou tarefas de envio de logs correspondentes. Para obter mais informações, consulte Desabilitar ou habilitar um trabalho.

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

Permissões

O 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õesSQL Server do Windows O requisito depende do comando sqllogship especificar ou não a opção -backup, -copy ou -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, consulte BACKUP (Transact-SQL).
-copy	Requer o acesso leitura ao diretório de backup e o acesso gravação ao diretório copiar	Requer as mesmas permissões do procedimento sp_help_log_shipping_secondary_database armazenado.
-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, consulte RESTORE (Transact-SQL).

Observação
Para localizar os caminhos dos diretórios backup e copiar, execute o procedimento sp_help_log_shipping_secondary_database armazenado ou exiba a tabela log_shipping_secondary no msdb. Os caminhos do diretório de backup e o diretório de destino está nas colunas backup_source_directory e backup_destination_directory respectivamente.