Procedimentos armazenados para bancos de dados do RDS para Db2 - Amazon Relational Database Service
rdsadmin.create_databaserdsadmin.drop_databaserdsadmin.update_db_paramrdsadmin.set_configurationrdsadmin.show_configurationrdsadmin.restore_databaserdsadmin.rollforward_databaserdsadmin.complete_rollforwardrdsadmin.db2pd_commandrdsadmin.force_applicationrdsadmin.set_archive_log_retentionrdsadmin.show_archive_log_retention

Procedimentos armazenados para bancos de dados do RDS para Db2

Os procedimentos armazenados a seguir gerenciam bancos de dados do Amazon RDS para Db2. Para executar esses procedimentos, o usuário principal deve primeiro se conectar ao banco de dados rdsadmin.

rdsadmin.create_database

Cria um banco de dados.

Sintaxe

db2 "call rdsadmin.create_database('database_name')"

Parâmetros

nota

Esse procedimento armazenado não valida a combinação dos parâmetros obrigatórios. Ao chamar rdsadmin.get_task_status, a função definida pelo usuário pode exibir um erro devido a uma combinação inválida de database_codeset, database_territory e database_collation. Para ter mais informações, consulte Choosing the code page, territory, and collation for your database na documentação do IBM Db2.

O seguinte parâmetro é obrigatório:

database_name

O nome do banco de dados a ser criado. O tipo de dados é varchar.

Os seguintes parâmetros são opcionais:

database_page_size

O tamanho padrão da página do banco de dados. Valores válidos: 4096, 8192, 16384, 32768. O tipo de dados é integer. O padrão é 8192.

Importante

O Amazon RDS é compatível com a atomicidade de gravação para páginas de 4 KiB, 8 KiB e 16 KiB. Por outro lado, páginas de 32 KiB correm o risco de interromper gravações ou de dados parciais serem gravados na mesa. Se estiver usando páginas de 32 KiB, recomendamos habilitar a recuperação para um ponto no tempo e os backups automatizados. Caso contrário, você corre o risco de não conseguir se recuperar de páginas interrompidas. Para ter mais informações, consulte Introdução aos backups e Restaurar uma instância de banco de dados para um momento especificado no Amazon RDS.

database_code_set

O conjunto de códigos do banco de dados. O tipo de dados é varchar. O padrão é UTF-8.

database_territory

O código de duas letras do país para o banco de dados. O tipo de dados é varchar. O padrão é US.

database_collation

A sequência de agrupamentos determina como as strings de caracteres armazenadas no banco de dados são classificadas e comparadas. O tipo de dados é varchar.

Valores válidos:

  • COMPATIBILITY: uma sequência de agrupamento do IBM Db2 Versão 2.

  • EBCDIC_819_037: página de código ISO Latin, agrupamento; CCSID 037 (inglês dos EUA EBCDIC).

  • EBCDIC_819_500: página de código ISO Latin, agrupamento; CCSID 500 (EBCDIC internacional).

  • EBCDIC_850_037: página de código ASCII Latin, agrupamento; CCSID 037 (inglês dos EUA EBCDIC).

  • EBCDIC_850_500: página de código ASCII Latin, agrupamento; CCSID 500 (EBCDIC internacional).

  • EBCDIC_932_5026: página de código ASCII Japanese, agrupamento; CCSID 037 (inglês dos EUA EBCDIC).

  • EBCDIC_932_5035: página de código ASCII Japanese, agrupamento; CCSID 500 (EBCDIC internacional).

  • EBCDIC_1252_037: página de código Windows Latin, agrupamento; CCSID 037 (inglês dos EUA EBCDIC).

  • EBCDIC_1252_500: página de código Windows Latin, agrupamento; CCSID 500 (EBCDIC internacional).

  • IDENTITY: agrupamento padrão. As strings são comparadas byte por byte.

  • IDENTITY_16BIT: o esquema de codificação de compatibilidade para UTF-16: sequência de agrupamento de 8 bits (CESU-8). Para ter mais informações, consulte o Unicode Technical Report #26 do site do Unicode Consortium.

  • NLSCHAR: somente para uso com a página de código Thai (CP874).

  • SYSTEM: se você usar SYSTEM, o banco de dados usará a sequência de agrupamento automaticamente para database_codeset e database_territory.

O padrão é IDENTITY.

Além disso, o RDS para Db2 é compatível com os seguintes grupos de agrupamentos: language-aware-collation e locale-sensitive-collation. Para ter mais informações, consulte Choosing a collation for a Unicode database na documentação do IBM Db2.

database_autoconfigure_str

A sintaxe do comando AUTOCONFIGURE, por exemplo, 'AUTOCONFIGURE APPLY DB'. O tipo de dados é varchar. O padrão é uma string vazia ou nula.

Para ter mais informações, consulte AUTOCONFIGURE command na documentação do IBM Db2.

Observações de uso

Será possível criar um banco de dados chamando rdsadmin.create_database se não tiver especificado o nome do banco de dados ao criar a instância de banco de dados do RDS para Db2 usando o console do Amazon RDS ou a AWS CLI. Para ter mais informações, consulte Criar uma instância de banco de dados.

Considerações especiais:

  • O comando CREATE DATABASE enviado à instância do Db2 usa a opção RESTRICTIVE.

  • O RDS para Db2 usa somente AUTOMATIC STORAGE.

  • O RDS para Db2 usa os valores padrão para NUMSEGS e DFT_EXTENT_SZ.

  • O RDS para Db2 usa criptografia de armazenamento e não comporta a criptografia de banco de dados.

Para ter mais informações sobre essas considerações, consulte CREATE DATABASE command na documentação do IBM Db2.

Antes de chamar rdsadmin.create_database, é necessário se conectar ao banco de dados rdsadmin. No seguinte exemplo, substitua master_username e master_password pelas informações da instância de banco de dados do RDS para Db2:

db2 connect to rdsadmin user master_username using master_password

Para ter informações sobre como conferir o status de criação de um banco de dados, consulte rdsadmin.get_task_status.

Exemplos

O seguinte exemplo cria um banco de dados chamado TESTJP com uma combinação correta dos parâmetros database_code_set, database_territory e database_collation para o Japão:

db2 "call rdsadmin.create_database('TESTJP', 4096, 'IBM-437', 'JP', 'SYSTEM')"

rdsadmin.drop_database

Remove um banco de dados.

Sintaxe

db2 "call rdsadmin.drop_database('database_name')"

Parâmetros

O seguinte parâmetro é obrigatório:

database_name

O nome do banco de dados a ser descartado. O tipo de dados é varchar.

Observações de uso

Será possível descartar um banco de dados chamando rdsadmin.drop_database somente se as seguintes condições forem atendidas:

  • Você não especificou o nome do banco de dados ao criar a instância de banco de dados do RDS para Db2 usando o console do Amazon RDS ou a AWS CLI. Para ter mais informações, consulte Criar uma instância de banco de dados.

  • Você criou o banco de dados chamando o procedimento armazenado rdsadmin.create_database.

  • Você restaurou o banco de dados por meio de uma imagem off-line ou de backup chamando o procedimento armazenado rdsadmin.restore_database.

Antes de chamar rdsadmin.drop_database, é necessário se conectar ao banco de dados rdsadmin. No seguinte exemplo, substitua master_username e master_password pelas informações da instância de banco de dados do RDS para Db2:

db2 connect to rdsadmin user master_username using master_password

Para ter informações sobre como conferir o status de descarte de um banco de dados, consulte rdsadmin.get_task_status.

Exemplos

O seguinte exemplo descarta um banco de dados chamado TESTDB:

db2 "call rdsadmin.drop_database('TESTDB')"

Exemplos de resposta

Se você transmitir um nome de banco de dados incorreto, o procedimento armazenado exibirá o seguinte exemplo de resposta:

SQL0438N Application raised error or warning with diagnostic text: "Cannot
drop database. Database with provided name does not exist". SQLSTATE=99993

Se você tiver criado o banco de dados usando o console do Amazon RDS ou a AWS CLI, o procedimento armazenado exibirá o seguinte exemplo de resposta:

Return Status = 0

Depois de receber Return Status = 0, chame o procedimento armazenado rdsadmin.get_task_status. Uma resposta semelhante ao seguinte exemplo explica o status:

1 ERROR DROP_DATABASE RDSDB 2023-10-10-16.33.03.744122 2023-10-10-16.33.30.143797 - 2023-10-10-16.33.30.098857 Task execution has started.
2023-10-10-16.33.30.143797 Caught exception during executing task id 1, Aborting task. 
Reason Dropping database created via rds CreateDBInstance api is not allowed. 
Only database created using rdsadmin.create_database can be dropped

rdsadmin.update_db_param

Atualiza parâmetros do banco de dados.

Sintaxe

db2 "call rdsadmin.update_db_param(
    'database_name', 
    'parameter_to_modify', 
    'changed_value)"

Parâmetros

Os seguintes parâmetros são obrigatórios:

database_name

O nome do banco de dados para o qual executar a tarefa. O tipo de dados é varchar.

parameter_to_modify

O nome do parâmetro a ser modificado. O tipo de dados é varchar. Para ter mais informações, consulte Parâmetros do Amazon RDS para Db2.

changed_value

O valor para o qual o valor de parâmetro será alterado. O tipo de dados é varchar.

Observações de uso

Para ter informações sobre como conferir o status de atualização dos parâmetros do banco de dados, consulte rdsadmin.get_task_status.

Exemplos

O seguinte exemplo atualiza o parâmetro archretrydelay para 100 para um banco de dados chamado TESTDB:

db2 "call rdsadmin.update_db_param(
    'TESTDB', 
    'archretrydelay', 
    '100')"

O seguinte exemplo adia a validação de objetos criados em um banco de dados chamado TESTDB para evitar a verificação de dependências:

db2 "call rdsadmin.update_db_param(
    'TESTDB', 
    'auto_reval', 
    'deferred_force')"

Exemplos de resposta

Se você tentar modificar um parâmetro de configuração de banco de dados não compatível ou modificável, o procedimento armazenado exibirá o seguinte exemplo de resposta:

SQL0438N Application raised error or warning with diagnostic text: "Parameter
is either not supported or not modifiable to customers". SQLSTATE=99993

rdsadmin.set_configuration

Define configurações específicas do banco de dados.

Sintaxe

db2 "call rdsadmin.set_configuration(
    'name',  
    'value')"

Parâmetros

Os seguintes parâmetros são obrigatórios:

name

O nome do ajuste de configurações. O tipo de dados é varchar.

value

O valor da configuração. O tipo de dados é varchar.

Observações de uso

A tabela a seguir mostra as configurações que podem ser controladas com rdsadmin.set_configuration.

Nome Descrição

RESTORE_DATABASE_NUM_BUFFERS

O número de buffers a serem criados durante uma operação de restauração. Esse valor deve ser menor que o tamanho total de memória da classe de instância de banco de dados. Se essa configuração não estiver definida, o Db2 determinará o valor a ser usado durante a operação de restauração. Para obter mais informações, consulte a documentação do IBM Db2.

RESTORE_DATABASE_PARALLELISM

O número de manipuladores de buffer a serem criados durante uma operação de restauração. Esse valor deve ser menor que o dobro do número de vCPUs da instância de banco de dados. Se essa configuração não estiver definida, o Db2 determinará o valor a ser usado durante a operação de restauração. Para obter mais informações, consulte a documentação do IBM Db2.

Exemplos

O exemplo a seguir define a configuração RESTORE_DATABASE_PARALLELISM como 8.

db2 "call rdsadmin.set_configuration(
    'RESTORE_DATABASE_PARALLELISM', 
    '8')"

O exemplo a seguir define a configuração RESTORE_DATABASE_NUM_BUFFERS como 150.

db2 "call rdsadmin.set_configuration(
    'RESTORE_DATABASE_NUM_BUFFERS', 
    '150')"

rdsadmin.show_configuration

Exibe as configurações atuais que você pode definir usando o procedimento armazenado rdsadmin.set_configuration.

Sintaxe

db2 "call rdsadmin.show_configuration(
    'name')"

Parâmetros

O seguinte parâmetro é opcional:

name

O nome da configuração sobre a qual exibir informações. O tipo de dados é varchar.

Os seguintes nomes de configuração são válidos:

  • RESTORE_DATABASE_NUM_BUFFERS: o número de buffers a serem criados durante uma operação de restauração.

  • RESTORE_DATABASE_PARALLELISM: o número de manipuladores de buffer a serem criados durante uma operação de restauração.

Observações de uso

Se você não especificar o nome de uma configuração, rdsadmin.show_configuration exibirá as informações de todas as configurações que você pode definir usando o procedimento armazenado rdsadmin.set_configuration.

Exemplos

O exemplo a seguir exibe informações sobre a configuração RESTORE_DATABASE_PARALLELISM atual.

db2 "call rdsadmin.show_configuration(
    'RESTORE_DATABASE_PARALLELISM')"

rdsadmin.restore_database

Restaura um banco de dados.

Sintaxe

db2 "call rdsadmin.restore_database(
    ?,
    'database_name', 
    's3_bucket_name', 
    's3_prefix', 
    restore_timestamp, 
    'backup_type')"

Parâmetros

O seguinte parâmetro de saída é obrigatório:

?

Um marcador de parâmetro que gera uma mensagem de erro. Esse parâmetro aceita apenas ?.

Os seguintes parâmetros de entrada são obrigatórios:

database_name

O nome do banco de dados a ser restaurado. Esse nome deve corresponder ao nome do banco de dados na imagem de backup. O tipo de dados é varchar.

s3_bucket_name

O nome do bucket do Amazon S3 onde reside o backup. O tipo de dados é varchar.

s3_prefix

O prefixo a ser usado para correspondência de arquivos durante o download. O tipo de dados é varchar.

Se esse parâmetro estiver vazio, todos os arquivos no bucket do Amazon S3 serão baixados. Veja a seguir um exemplo de prefixo:

backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101
restore_timestamp

O carimbo de data e hora da imagem de backup do banco de dados. O tipo de dados é varchar.

O carimbo de data e hora está incluído no nome do arquivo de backup. Por exemplo, 20230615010101 é o carimbo de data e hora do nome do arquivo. SAMPLE.0.rdsdb.DBPART000.20230615010101.001.

backup_type

O tipo de backup. O tipo de dados é varchar. Valores válidos: OFFLINE, ONLINE.

Use ONLINE para migrações com tempo de inatividade quase zero. Para ter mais informações, consulte Migrar do Linux para Linux com quase zero tempo de inatividade para o Amazon RDS para Db2.

Observações de uso

Antes de chamar o procedimento armazenado, examine estas considerações:

  • Só será possível restaurar um banco de dados chamando rdsadmin.restore_database se você não especificar o nome do banco de dados ao criar a instância de banco de dados do RDS para Db2 usando o console ou a AWS CLI do Amazon RDS. Para ter mais informações, consulte Criar uma instância de banco de dados.

  • Antes de restaurar um banco de dados, é necessário provisionar espaço de armazenamento para a instância de banco de dados do RDS para Db2 igual ou maior que a soma do tamanho do backup, e o banco de dados do Db2 original no disco. Para ter mais informações, consulte Insufficient disk space.

  • Ao restaurar o backup, o Amazon RDS extrai o arquivo de backup na instância de banco de dados do RDS para Db2. Cada arquivo de backup deve ter 5 TB ou menos. Se um arquivo de backup exceder 5 TB, você deverá dividi o arquivo de backup em arquivos menores.

  • Para restaurar todos os arquivos usando o procedimento armazenado rdsadmin.restore_database, não inclua o sufixo do número do arquivo após o carimbo de data e hora nos nomes dos arquivos. Por exemplo, o s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101 restaura os seguintes arquivos:

    SAMPLE.0.rdsdb.DBPART000.20230615010101.001
SAMPLE.0.rdsdb.DBPART000.20230615010101.002
SAMPLE.0.rdsdb.DBPART000.20230615010101.003
SAMPLE.0.rdsdb.DBPART000.20230615010101.004
SAMPLE.0.rdsdb.DBPART000.20230615010101.005

  • O RDS para Db2 não permite armazenamento não automático. Para ter mais informações, consulte Tablespaces not restored.

  • O RDS para Db2 não permite rotinas não protegidas. Para ter mais informações, consulte Non-fenced routines not allowed.

  • Para melhorar a performance das operações de restauração do banco de dados, é possível configurar o número de buffers e manipuladores de buffer a serem usados pelo RDS. Para conferir a configuração atual, use rdsadmin.show_configuration. Para alterar a configuração, use rdsadmin.set_configuration.

Para colocar o banco de dados on-line e aplicar logs de transações adicionais após a restauração do banco de dados, consulte rdsadmin.rollforward_database.

Para ter informações sobre como conferir o status de restauração de um banco de dados, consulte rdsadmin.get_task_status.

Exemplos

O seguinte exemplo restaura um backup off-line com um ou vários arquivos que têm o s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101:

db2 "call rdsadmin.restore_database(
    ?,
    'SAMPLE',
    'amzn-s3-demo-bucket',
    'backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101',
    20230615010101,
    'OFFLINE')"

rdsadmin.rollforward_database

Coloca o banco de dados on-line e aplica logs de transações adicionais depois de restaurar um banco de dados chamando rdsadmin.restore_database.

Sintaxe

db2 "call rdsadmin.rollforward_database(
    ?,
    'database_name',
    's3_bucket_name', 
    s3_prefix, 
    'rollfoward_to_option', 
    'complete_rollforward')"

Parâmetros

O seguinte parâmetro de saída é obrigatório:

?

Um marcador de parâmetro que gera uma mensagem de erro. Esse parâmetro aceita apenas ?.

Os seguintes parâmetros de entrada são obrigatórios:

database_name

O nome do banco de dados no qual a operação deve ser realizada. O tipo de dados é varchar.

s3_bucket_name

O nome do bucket do Amazon S3 onde reside o backup. O tipo de dados é varchar.

s3_prefix

O prefixo a ser usado para correspondência de arquivos durante o download. O tipo de dados é varchar.

Se esse parâmetro estiver vazio, todos os arquivos no bucket do S3 serão baixados. O seguinte exemplo é de um prefixo:

backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101

Os seguintes parâmetros de entrada são opcionais:

rollforward_to_option

O ponto até o qual você pretende efetuar roll forward. O tipo de dados é varchar. Valores válidos: END_OF_LOGS, END_OF_BACKUP. O padrão é END OF LOGS.

complete_rollforward

Especifica se o processo de efetuar roll forward deve ser concluído. O tipo de dados é varchar. O padrão é TRUE.

Se TRUE, após a conclusão, o banco de dados estará on-line e acessível. Se FALSE, o banco de dados permanecerá em um estado ROLL-FORWARD PENDING.

Observações de uso

Depois de chamar rdsadmin.restore_database, será necessário chamar rollforward_database para aplicar os logs de arquivamento de um bucket do S3. Também é possível usar esse procedimento armazenado para restaurar logs de transações adicionais depois de chamar rdsadmin.restore_database.

Se você definir complete_rollforward como FALSE, o banco de dados estará em um estado ROLL-FORWARD PENDING e off-line. Para colocar o banco de dados on-line, é necessário chamar rdsadmin.complete_rollforward.

Para ter informações sobre como conferir o status da realização de roll forward do banco de dados, consulte rdsadmin.get_task_status.

Exemplos

O seguinte exemplo efetua roll forward em um backup on-line do banco de dados com logs de transações e, depois, coloca o banco de dados on-line:

db2 "call rdsadmin.rollforward_database(
    ?,
    null,
    null,
    'END_OF_LOGS',
    'TRUE')"

O seguinte exemplo avança para um backup on-line do banco de dados sem logs de transações e, depois, coloca o banco de dados on-line:

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    'amzn-s3-demo-bucket',
    'logsfolder/,
    'END_OF_BACKUP',
    'TRUE')"

O seguinte exemplo efetua roll forward em um backup on-line do banco de dados com logs de transações e, depois, não coloca o banco de dados on-line:

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    null,
    'onlinebackup/TESTDB',
    'END_OF_LOGS',
    'FALSE')"

O seguinte exemplo efetua roll forward em um backup on-line do banco de dados com logs de transações adicionais e, depois, não coloca o banco de dados on-line.

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    'amzn-s3-demo-bucket',
    'logsfolder/S0000155.LOG',
    'END_OF_LOGS',
    'FALSE')"

rdsadmin.complete_rollforward

Coloca o banco de dados on-line de um estado ROLL-FORWARD PENDING.

Sintaxe

db2 "call rdsadmin.complete_rollforward(
    ?,
    'database_name')"

Parâmetros

O seguinte parâmetro de saída é obrigatório:

?

Um marcador de parâmetro que gera uma mensagem de erro. Esse parâmetro aceita apenas ?.

O seguinte parâmetro de entrada é obrigatório:

database_name

O nome do banco de dados que você deseja colocar on-line. O tipo de dados é varchar.

Observações de uso

Se você chamou rdsadmin.rollforward_database com complete_rollforward definido como FALSE, o banco de dados está em um estado ROLL-FORWARD PENDING e offline. Para concluir o processo de roll forward e colocar o banco de dados on-line, chame rdsadmin.complete_rollforward.

Para ter informações sobre como conferir o status da realização de roll forward, consulte rdsadmin.get_task_status.

Exemplos

O seguinte exemplo coloca o banco de dados TESTDB on-line:

db2 "call rdsadmin.complete_rollfoward(
    ?,
    'TESTDB')"

rdsadmin.db2pd_command

Coleta informações sobre um banco de dados do RDS para Db2.

Sintaxe

db2 "call rdsadmin.db2pd_command('db2pd_cmd')"

Parâmetros

O seguinte parâmetro de entrada é obrigatório:

db2pd_cmd

O nome do comando db2pd que você deseja executar. O tipo de dados é varchar.

O parâmetro deve começar com um hífen. Para ver uma lista de parâmetros, consulte db2pd - Monitor and troubleshoot Db2 database command na documentação do .

As seguintes opções não são compatíveis:

  • -addnode

  • -alldatabases

  • -alldbp

  • -alldbs

  • -allmembers

  • -alm_in_memory

  • -cfinfo

  • -cfpool

  • -command

  • -dbpartitionnum

  • -debug

  • -dump

  • -everything

  • -file | -o

  • -ha

  • -interactive

  • -member

  • -pages

    nota

    O -pages summary é compatível.

  • -pdcollection

  • -repeat

  • -stack

  • -totalmem

A subopção file não é compatível; por exemplo, db2pd -db testdb -tcbstats file=tcbstat.out.

O uso de stacks não é compatível; por exemplo, db2pd -edus interval=5 top=10 stacks.

Observações de uso

Esse procedimento armazenado reúne informações que podem ajudar no monitoramento e na solução de problemas de bancos de dados do RDS para Db2.

O procedimento armazenado usa o utilitário db2pd da IBM para executar vários comandos. O utilitário db2pd exige a autorização SYSADM, que o usuário principal do RDS para Db2 não tem. No entanto, com o procedimento armazenado do Amazon RDS, o usuário principal pode usar o utilitário para executar vários comandos. Para ter mais informações sobre o utilitário, consulte db2pd - Monitor and troubleshoot Db2 database command na documentação do IBM Db2.

A saída é restrita a no máximo 2 GB.

Para ter informações sobre como conferir o status da coleta de informações sobre o banco de dados, consulte rdsadmin.get_task_status.

Exemplos

O seguinte exemplo exibe o tempo de atividade de uma instância de banco de dados do RDS para Db2:

db2 "call rdsadmin.db2pd_command('-')"

O seguinte exemplo exibe o tempo de atividade de um banco de dados chamado TESTDB:

db2 "call rdsadmin.db2pd_command('-db TESTDB -')"

O seguinte exemplo exibe o uso de memória de uma instância de banco de dados do RDS para Db2:

db2 "call rdsadmin.db2pd_command('-dbptnmem')"

O seguinte exemplo exibe os conjuntos de memória de uma instância de banco de dados do RDS para Db2 e um banco de dados denominado TESTDB:

db2 "call rdsadmin.db2pd_command('-inst -db TESTDB -memsets')"

rdsadmin.force_application

Força a retirada das aplicações de um banco de dados do RDS para Db2.

Sintaxe

db2 "call rdsadmin.force_application(
    ?,
    'applications')"

Parâmetros

O seguinte parâmetro de saída é obrigatório:

?

Um marcador de parâmetro que gera uma mensagem de erro. Esse parâmetro aceita apenas ?.

O seguinte parâmetro de entrada é obrigatório:

applications

As aplicações cuja retirada de um banco de dados do RDS para Db2 você deseja forçar. O tipo de dados é varchar. Valores válidos: ALL ou application_handle.

Separe os nomes de várias aplicações com vírgulas. Exemplo: “application_handle_1, application_handle_2”.

Observações de uso

Esse procedimento armazenado força a retirada de todas as aplicações de um banco de dados para que você possa realizar a manutenção.

O procedimento armazenado usa o comando FORCE APPLICATION da IBM. O comando FORCE APPLICATION exige autorização SYSADM, SYSMAINT ou SYSCTRL, que o usuário principal do RDS para Db2 não tem. No entanto, com o procedimento armazenado do Amazon RDS, o usuário principal pode usar o comando. Para ter mais informações, consulte FORCE APPLICATION command na documentação do IBM Db2.

Para ter informações sobre como conferir o status da retirada forçada de aplicações de um banco de dados, consulte rdsadmin.get_task_status.

Exemplos

O seguinte exemplo força a retirada de todas as aplicações de um banco de dados do RDS para Db2:

db2 "call rdsadmin.force_application(
    ?,
    'ALL')"

O seguinte exemplo força a retirada de todos os manipuladores de aplicações 9991, 8891 e 1192 de um banco de dados do RDS para Db2:

db2 "call rdsadmin.force_application(
    ?,
    '9991, 8891, 1192')"

rdsadmin.set_archive_log_retention

Configura o intervalo de tempo (em horas) para retenção dos arquivos de log do banco de dados do RDS para Db2 especificado.

Sintaxe

db2 "call rdsadmin.set_archive_log_retention(
    ?,            
    'database_name',  
    'archive_log_retention_hours')"

Parâmetros

O seguinte parâmetro de saída é obrigatório:

?

Um marcador de parâmetro que gera uma mensagem de erro. Esse parâmetro aceita apenas ?.

Os seguintes parâmetros de entrada são obrigatórios:

database_name

O nome do banco de dados cuja retenção de logs será configurada. O tipo de dados é varchar.

archive_log_retention_hours

O número de horas de retenção dos arquivos de log. O tipo de dados é smallint. O padrão é 0 e o máximo é 168 (sete dias).

Se o valor for 0, o Amazon RDS não reterá os arquivos de log.

Observações de uso

Por padrão, o RDS para Db2 retém os logs por cinco minutos. Recomendamos que, se você usar ferramentas de replicação, como o AWS DMSpara captura de dados de alteração (CDC) ou IBM Q Replication, defina a retenção de logs nessas ferramentas como mais de cinco minutos.

É possível visualizar a configuração atual de retenção de logs chamando rdsadmin.show_archive_log_retention.

Não é possível definir a configuração de retenção de logs no banco de dados rdsadmin.

Exemplos

O exemplo a seguir define o tempo de retenção de logs de um banco de dados chamado TESTDB como 24 horas.

db2 "call rdsadmin.set_archive_log_retention(
    ?,
    'TESTDB', 
    '24')"

O exemplo a seguir desativa o tempo de retenção de logs de um banco de dados chamado TESTDB.

db2 "call rdsadmin.set_archive_log_retention(
    ?,
    'TESTDB', 
    '0')"

rdsadmin.show_archive_log_retention

Exibe a configuração atual de retenção de logs do banco de dados especificado.

Sintaxe

db2 "call rdsadmin.show_archive_log_retention(
    ?,
    'database_name')"

Parâmetros

O seguinte parâmetro de saída é obrigatório:

?

Um marcador de parâmetro que gera uma mensagem de erro. Esse parâmetro aceita apenas ?.

O seguinte parâmetro de entrada é obrigatório:

database_name

O nome do banco de dados cuja configuração de retenção de logs será mostrada. O tipo de dados é varchar.

Exemplos

O exemplo a seguir mostra a configuração de tempo de retenção de logs de um banco de dados chamado TESTDB.

db2 "call rdsadmin.show_archive_log_retention(
    ?
    'TESTDB')"