aplicativo sqllogship

Aplica-se: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 é executada em uma instância específica do SQL Server para um banco de dados específico.

Para 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

- server instance_name

Especifica a instância do SQL Server em que a operação é 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 -restoreinstance_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 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.

-copiar secondary_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.

-restaurar secondary_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. Você pode obter essa ID usando o sp_help_log_shipping_secondary_database procedimento 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 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 é executado sp_cleanup_log_shipping_history, o que limpa as informações do histórico antigo, com base no período de retenção.

-verboselevel nível

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

-logintimeout timeout_value

Especifica o tempo alocado para tentar entrar na instância do servidor antes do tempo limite da tentativa. 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.

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

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

Especifica opções de conectividade extra na forma de pares de valor de chave.

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

Comentários

Use os trabalhos de backup, cópia e restauração para executar o backup, a cópia e a restauração quando 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, veja Desabilitar ou Habilitar um Trabalho.

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

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 se o comando sqllogship especifica a opção ou -backup a -copyopção-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 colunas e backup_source_directory no backup_destination_directory diretório, respectivamente.

Conteúdo relacionado

• Sobre o envio de logs (SQL Server)
• bancos_de_dados_primários_de_envio_de_logs (Transact-SQL)
• log_shipping_secondary (Transact-SQL)
• sp_limpar_historico_envio_de_logs (Transact-SQL)
• sp_help_log_shipping_primary_database (Transact-SQL)
• sp_help_log_shipping_secondary_database (Transact-SQL)
• sp_start_job (Transact-SQL)