Aplicativo sqllogship

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 para um banco de dados específico em uma instância específica do SQL Server 2005 ou uma versão posterior.

Ícone de vínculo de tópico Para obter as convenções de sintaxe, consulte Utilitários do prompt de comando.

Sintaxe

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

Argumentos

  • -servidor 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 o -backup, o instance_name deve ser o nome do servidor primário em uma configuração de envio de logs. Para o -copiar ou -restaurar, o 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 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.

  • -copiarsecondary_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.

  • -restaurarsecondary_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.

  • –verboselevellevel
    Especifica o nível das mensagens adicionadas ao histórico do envio de logs. O 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. Este é 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. O timeout_value é de 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. O timeout_value é de 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 Como habilitar ou desabilitar um trabalho (SQL Server Management Studio).

O aplicativo sqllogship, SqlLogShip.exe, está instalado no diretório x:\Program Files\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).

-copiar

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çãoObservaçã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.