Copiar backups de logs de transações

Para copiar um conjunto de backups de logs de transações disponíveis para um banco de dados individual em seu bucket do Amazon S3, chame o procedimento armazenado rds_tlog_backup_copy_to_S3. O procedimento armazenado rds_tlog_backup_copy_to_S3 iniciará uma nova tarefa para copiar os backups de logs de transações.

nota

O procedimento armazenado rds_tlog_backup_copy_to_S3 copiará os backups de logs de transações sem validação em relação ao atributo is_log_chain_broken. Por esse motivo, você deve confirmar manualmente uma cadeia de logs ininterrupta antes de executar o procedimento armazenado rds_tlog_backup_copy_to_S3. Para obter mais explicações, consulte Validar a cadeia de logs de backup de logs de transações.

exemplo uso do procedimento armazenado rds_tlog_backup_copy_to_S3

exec msdb.dbo.rds_tlog_backup_copy_to_S3
	@db_name='mydatabasename',
	[@kms_key_arn='arn:aws:kms:region:account-id:key/key-id'],	
	[@backup_file_start_time='2022-09-01 01:00:15'],
	[@backup_file_end_time='2022-09-01 21:30:45'],
	[@starting_lsn=149000000112100001],
	[@ending_lsn=149000000120400001],
	[@rds_backup_starting_seq_id=5],
	[@rds_backup_ending_seq_id=10];
	

Os seguintes parâmetros de entrada estão disponíveis:

Parâmetro	Descrição
@db_name	O nome do banco de dados do qual copiar backups de logs de transações
@kms_key_arn	Uma chave do KMS gerenciada pelo cliente. Se você criptografar a instância de banco de dados com uma chave do KMS gerenciada pela AWS, será necessário criar uma chave gerenciada pelo cliente. Se criptografar a instância de banco de dados com uma chave gerenciada pelo cliente, você poderá usar o mesmo ARN da chave do KMS.
@backup_file_start_time	O carimbo de data e hora UTC conforme fornecido na coluna [backup_file_time_utc] da função rds_fn_list_tlog_backup_metadata.
@backup_file_end_time	O carimbo de data e hora UTC conforme fornecido na coluna [backup_file_time_utc] da função rds_fn_list_tlog_backup_metadata.
@starting_lsn	O número de sequência de logs (LSN) conforme fornecido na coluna [starting_lsn] da função rds_fn_list_tlog_backup_metadata
@ending_lsn	O número de sequência de logs (LSN) conforme fornecido na coluna [ending_lsn] da função rds_fn_list_tlog_backup_metadata.
@rds_backup_starting_seq_id	O ID de sequência conforme fornecido na coluna [rds_backup_seq_id] da função rds_fn_list_tlog_backup_metadata.
@rds_backup_ending_seq_id	O ID de sequência conforme fornecido na coluna [rds_backup_seq_id] da função rds_fn_list_tlog_backup_metadata.

Você pode especificar um conjunto de parâmetros de hora, LSN ou ID de sequência. Somente um conjunto de parâmetros é necessário.

Você também pode especificar apenas um único parâmetro em qualquer um dos conjuntos. Por exemplo, ao fornecer um valor somente para o parâmetro backup_file_end_time, todos os arquivos de backup de logs de transações disponíveis antes desse período dentro do limite de sete dias serão copiados em seu bucket do Amazon S3.

Veja a seguir as combinações válidas de parâmetros de entrada para o procedimento armazenado rds_tlog_backup_copy_to_S3.

Parâmetros fornecidos	Resultado esperado
exec msdb.dbo.rds_tlog_backup_copy_to_S3 @db_name = 'testdb1', @backup_file_start_time='2022-08-23 00:00:00', @backup_file_end_time='2022-08-30 00:00:00';	Copia os backups de logs de transações dos últimos sete dias e existentes entre o intervalo fornecido debackup_file_start_time e backup_file_end_time. Neste exemplo, o procedimento armazenado copiará os backups de logs de transações que foram gerados entre “2022-08-23 00:00:00” e “2022-08-30 00:00:00”.
exec msdb.dbo.rds_tlog_backup_copy_to_S3 @db_name = 'testdb1', @backup_file_start_time='2022-08-23 00:00:00';	Copia os backups de logs de transações dos últimos sete dias e a partir do backup_file_start_time fornecido. Neste exemplo, o procedimento armazenado copiará os backups de logs de transações de “2022-08-23 00:00:00” até o último backup de logs de transações.
exec msdb.dbo.rds_tlog_backup_copy_to_S3 @db_name = 'testdb1', @backup_file_end_time='2022-08-30 00:00:00';	Copia os backups de logs de transações dos últimos sete dias até o backup_file_end_time fornecido. Neste exemplo, o procedimento armazenado copiará os backups de logs de transações que foram gerados de “2022-08-23 00:00:00” até “2022-08-30 00:00:00”.
exec msdb.dbo.rds_tlog_backup_copy_to_S3 @db_name='testdb1', @starting_lsn =1490000000040007, @ending_lsn = 1490000000050009;	Copia os backups de logs de transações disponíveis dos últimos sete dias e entre o intervalo fornecido do starting_lsn e ending_lsn. Neste exemplo, o procedimento armazenado copiará backups de logs de transações dos últimos sete dias com um intervalo de LSN entre 1490000000040007 e 1490000000050009.
exec msdb.dbo.rds_tlog_backup_copy_to_S3 @db_name='testdb1', @starting_lsn =1490000000040007;	Copia os backups de logs de transações disponíveis dos últimos sete dias, a partir do starting_lsn fornecido. Neste exemplo, o procedimento armazenado copiará os backups de logs de transações do LSN 1490000000040007 até o último backup de logs de transações.
exec msdb.dbo.rds_tlog_backup_copy_to_S3 @db_name='testdb1', @ending_lsn =1490000000050009;	Copia os backups de logs de transações disponíveis dos últimos sete dias, até o ending_lsn fornecido. Neste exemplo, o procedimento armazenado copiará backups de logs de transações a partir dos últimos sete dias até o lsn 1490000000050009.
exec msdb.dbo.rds_tlog_backup_copy_to_S3 @db_name='testdb1', @rds_backup_starting_seq_id= 2000, @rds_backup_ending_seq_id= 5000;	Copia os backups de logs de transações disponíveis dos últimos sete dias e existentes entre o intervalo fornecido de rds_backup_starting_seq_id e rds_backup_ending_seq_id. Neste exemplo, o procedimento armazenado copiará os backups de logs de transações dos últimos sete dias e dentro do intervalo de ID da sequência de backup do rds fornecido, começando de seq_id 2000 até seq_id 5000.
exec msdb.dbo.rds_tlog_backup_copy_to_S3 @db_name='testdb1', @rds_backup_starting_seq_id= 2000;	Copia os backups de logs de transações disponíveis dos últimos sete dias, a partir do rds_backup_starting_seq_id fornecido. Neste exemplo, o procedimento armazenado copiará os backups de logs de transações de seq_id 2000 até o último backup de logs de transações.
exec msdb.dbo.rds_tlog_backup_copy_to_S3 @db_name='testdb1', @rds_backup_ending_seq_id= 5000;	Copia os backups de logs de transações disponíveis dos últimos sete dias, até o rds_backup_ending_seq_id fornecido. Neste exemplo, o procedimento armazenado copiará backups de logs de transações a partir dos últimos sete dias, até seq_id 5000.
exec msdb.dbo.rds_tlog_backup_copy_to_S3 @db_name='testdb1', @rds_backup_starting_seq_id= 2000; @rds_backup_ending_seq_id= 2000;	Copia um único backup de logs de transações com o rds_backup_starting_seq_id fornecido, se disponível nos últimos sete dias. Neste exemplo, o procedimento armazenado copiará um único backup de logs de transações que tenha um seq_id de 2000, se houver nos últimos sete dias.

Validar a cadeia de logs de backup de logs de transações

Os bancos de dados configurados para acesso aos backups de logs de transações devem ter a retenção automatizada de backup ativada. A retenção automatizada de backup define os bancos de dados na instância de banco de dados de acordo com o modelo de recuperação FULL. Para ser compatível com a restauração a um ponto anterior no tempo de um banco de dados, evite alterar o modelo de recuperação do banco de dados, o que pode ocasionar uma cadeia de registros interrompida. Recomendamos manter o banco de dados definido como o modelo de recuperação FULL.

Para validar manualmente a cadeia de logs antes de copiar os backups de logs de transações, chame a função rds_fn_list_tlog_backup_metadata e revise os valores na coluna is_log_chain_broken. Um valor de “1" indica que a cadeia de logs foi interrompida entre o backup de logs atual e o backup de logs anterior.

O exemplo a seguir mostra uma cadeia de logs interrompida na saída do procedimento armazenado rds_fn_list_tlog_backup_metadata.

Em uma cadeia de logs normal, o valor do número de sequência de log (LSN) para first_lsn para determinado rds_sequence_id deve corresponder ao valor de last_lsn no rds_sequence_id anterior. Na imagem, o rds_sequence_id de 45 tem um valor first_lsn 90987, que não corresponde ao valor last_lsn de 90985 do rds_sequence_id 44 anterior.

Para ter mais informações sobre a arquitetura de logs de transações e os números de sequência de log do SQL Server, consulte Transaction Log Logical Architecture (Arquitetura lógica do log de transações) na documentação do Microsoft SQL Server.