Aplicativo SQLLogship

Aplica-se a:SQL Server

O aplicativo sqllogship executa uma operação de backup, cópia ou restauração e tarefas de limpeza associadas para uma configuração de envio de logs. A operação é realizada numa instância específica do SQL Server para uma base de dados específica.

Para obter as convenções de sintaxe, consulte Utilitários de linha de comando SQL (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 ]
[ -connectionoptions "<key_value_pairs>; [ ... ]" ]

Argumentos

-servidor instance_name

Especifica a instância do SQL Server onde a operação é executada. A instância do servidor a ser especificada depende de qual operação de envio de logs 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

Executa uma operação de backup para o banco de dados primário cuja ID primária é especificada pelo primary_id. Você pode obter essa 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. Em seguida, o aplicativo sqllogship limpa todos os arquivos de backup antigos, com base no período de retenção de arquivos. Em seguida, o aplicativo registra o histórico da operação de backup no servidor primário e no servidor monitor. Finalmente, o aplicativo executa sp_cleanup_log_shipping_history, que limpa informações antigas do histórico, com base no período de retenção.

-cópia secondary_id

Executa uma operação de cópia para copiar backups do servidor secundário especificado para o banco de dados secundário, ou bancos de dados, cuja ID secundária é especificada por secondary_id. Você pode obter este ID selecionando-o na tabela log_shipping_secondary do sistema 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. Em seguida, o aplicativo sqllogship registra o histórico da operação de cópia no servidor secundário e no servidor monitor.

-restaurar secondary_id

Executa uma operação de restauração no servidor secundário especificado para o banco de dados secundário, ou bancos de dados, cuja ID secundária é especificada por secondary_id. Você pode obter essa ID usando o sp_help_log_shipping_secondary_database procedimento armazenado.

Todos os arquivos de backup no diretório de destino que foram criados após o ponto de restauração mais recente são restaurados para o banco de dados secundário ou bancos de dados. Em seguida, o aplicativo sqllogship limpa todos os arquivos de backup antigos, com base no período de retenção de arquivos. Em seguida, o aplicativo registra o histórico da operação de restauração no servidor secundário e no servidor monitor. Finalmente, o aplicativo é executado sp_cleanup_log_shipping_history, que limpa informações antigas do histórico, com base no período de retenção.

-nível detalhado

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

-logintimeout

Especifica a quantidade de tempo alocada para tentar entrar na instância do servidor antes que a tentativa atinja o tempo limite. O padrão é 15 segundos. timeout_value é int.

-querytimeout timeout_value

Especifica a quantidade de tempo alocado para iniciar a operação especificada antes que a tentativa atinja o tempo limite. O padrão é nenhum período de tempo limite. timeout_value é int.

-connectionoptions "<key_value_pairs>; [ ... n ] "

Aplica-se a: SQL Server 2025 (17.x) e versões posteriores.

Especifica opções de conectividade adicionais na forma de pares de valores de chave.

A tabela a seguir lista as opções de conectividade disponíveis:

Observações

Use os trabalhos de backup, cópia e restauro para realizar o backup, copiar e restaurar sempre que possível. Para iniciar esses trabalhos a partir de uma operação em lote ou outro aplicativo, chame o procedimento armazenado sp_start_job .

O histórico de envio de logs criado pelo sqllogship é intercalado com o histórico criado por trabalhos de backup, cópia e restauração de envio de logs. Se você planeja usar o sqllogship repetidamente para executar operações de backup, cópia ou restauração para uma configuração de envio de logs, considere desabilitar o trabalho ou trabalhos de envio de logs correspondentes. Para obter mais informações, consulte Desabilitar ou habilitar um trabalho.

O aplicativo sqllogship , SqlLogShip.exe, é instalado no <drive>:\Program Files\Microsoft SQL Server\130\Tools\Binn diretório.

Permissões

sqllogship usa a Autenticação do Windows. A conta de Autenticação do Windows onde o comando é executado requer acesso ao diretório do Windows e permissões do SQL Server. O requisito depende se o comando sqllogship especifica a -backupopção , -copy, ou -restore .

Para descobrir os caminhos dos diretórios de backup e cópia, você pode executar o sp_help_log_shipping_secondary_database procedimento armazenado ou exibir a log_shipping_secondary tabela em msdb. Os caminhos do diretório de backup e do diretório de destino estão nas backup_source_directory colunas e backup_destination_directory , respectivamente.

Conteúdo relacionado

• Sobre o envio de logs (SQL Server)
• log_shipping_primary_databases (Transact-SQL)
• log_shipping_secondary (função 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)