Procedimentos armazenados para bancos de dados do RDS para Db2

Os procedimentos integrados armazenados descritos neste tópico 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.

Esses procedimentos armazenados são usados em diversas tarefas. Essa lista não é exaustiva.

Consulte os seguintes procedimentos integrados armazenados para obter informações sobre sintaxe, parâmetros, notas de uso e exemplos.

rdsadmin.create_database

Cria um banco de dados.

Sintaxe

db2 "call rdsadmin.create_database(
    'database_name',
    'database_page_size',
    'database_code_set',
    'database_territory',
    'database_collation',
    'database_autoconfigure_str',
    'database_non-restrictive')"

Parâmetros

O seguinte parâmetro é obrigatório:

Os seguintes parâmetros são opcionais:

Observações de uso

Se você planeja modificar o parâmetro db2_compatibility_vector, modifique-o antes de criar um banco de dados. Para obter mais informações, consulte Configuração do parâmetro db2_compatibility_vector.

Considerações especiais:

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.

Para ver as mensagens de erro exibidas ao chamar rdsadmin.create_database, consulte Erros de procedimentos armazenados.

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.deactivate_database

Desativa um banco de dados.

Sintaxe

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

Parâmetros

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

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

Observações de uso

É possível desativar bancos de dados para conservar recursos de memória ou para fazer outras alterações na configuração do banco de dados. Para colocar os bancos de dados desativados novamente on-line, chame o procedimento armazenado rdsadmin.activate_database.

Não é possível desativar um banco de dados em uma instância de banco de dados de origem durante a replicação chamando o procedimento armazenado rdsadmin.deactivate_database.

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

Para ver as mensagens de erro exibidas ao chamar rdsadmin.deactivate_database, consulte Erros de procedimentos armazenados.

Exemplos

O exemplo a seguir desativa um banco de dados chamado TESTDB.

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

rdsadmin.activate_database

Ativa um banco de dados.

Para obter informações sobre as diferenças entre rdsadmin.reactivate_database e rdsadmin.activate_database, consulte Observações de uso.

Sintaxe

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

Parâmetros

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

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

Observações de uso

Todos os bancos de dados são ativados por padrão quando são criados. Se você desativar um banco de dados em uma instância de banco de dados autônoma para conservar recursos de memória ou fazer outras alterações na configuração do banco de dados, chame o procedimento rdsadmin.activate_database armazenado para ativar o banco de dados novamente.

Esse procedimento armazenado ativa somente um banco de dados que esteja em uma instância de banco de dados autônoma e que foi desativado ao chamar o procedimento armazenado rdsadmin.deactivate_database. Para ativar um banco de dados em uma instância de banco de dados de origem de réplica, é necessário chamar o procedimento armazenado rdsadmin.reactivate_database.

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

Para ver as mensagens de erro exibidas ao chamar rdsadmin.activate_database, consulte Erros de procedimentos armazenados.

Exemplos

O exemplo a seguir ativa um banco de dados chamado TESTDB.

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

rdsadmin.reactivate_database

Reativa um banco de dados.

Para ter informações sobre as diferenças entre rdsadmin.activate_database e rdsadmin.reactivate_database, consulte Observações de uso.

Sintaxe

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

Parâmetros

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

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

Observações de uso

Quando você chama o procedimento armazenado rdsadmin.reactivate_database, primeiro ele desativa o banco de dados chamando o procedimento armazenado rdsadmin.deactivate_database e, depois, ativa o banco de dados chamando o procedimento armazenado rdsadmin.activate_database.

Depois de fazer alterações nas configurações do banco de dados, talvez seja necessário reativar um banco de dados em uma instância de banco de dados do RDS para Db2. Para determinar se você precisa reativar um banco de dados, conecte-se a ele e execute db2 get db cfg show detail.

Para um banco de dados em uma instância de banco de dados autônoma, você pode usar o procedimento armazenado rdsadmin.reactivate_database para reativar o banco de dados. Ou, se você já chamou o procedimento armazenado rdsadmin.deactivate_database, você pode chamar o procedimento armazenado rdsadmin.activate_database em vez disso.

Em relação a um banco de dados em uma instância de banco de dados de origem de réplica, é necessário usar o procedimento armazenado rdsadmin.reactivate_database para reativar o banco de dados.

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

Para ver as mensagens de erro exibidas ao chamar rdsadmin.reactivate_database, consulte Erros de procedimentos armazenados.

Exemplos

O exemplo a seguir reativa um banco de dados chamado TESTDB.

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

rdsadmin.drop_database

Remove um banco de dados.

Sintaxe

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

Parâmetros

O seguinte parâmetro é obrigatório:

Observações de uso

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

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.

Para ver as mensagens de erro exibidas ao chamar rdsadmin.drop_database, consulte Erros de procedimentos armazenados.

Exemplos

O seguinte exemplo descarta um banco de dados chamado TESTDB:

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

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',
    'restart_database')"

Parâmetros

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

O seguinte parâmetro é opcional:

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.

Para ver as mensagens de erro exibidas ao chamar rdsadmin.update_db_param, consulte Erros de procedimentos armazenados.

Exemplos

Exemplo 1: atualização de um parâmetro

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')"

Exemplo 2: adiamento da validação de objetos

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')"

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:

Observações de uso

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

Exemplos

Exemplo 1: especificação do número de buffers a serem criados

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

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

Exemplo 2: especificação do número de manipuladores de buffer a serem criados

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

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

Exemplo 3: especificar o número de caminhos ou fluxos de I/O a serem usados durante a restauração

O exemplo a seguir define a configuração RESTORE_DATABASE_NUM_MULTI_PATHS como 5.

db2 "call rdsadmin.set_configuration(
    'RESTORE_DATABASE_NUM_MULTI_PATHS', 
    '5')"

Exemplo 4: definir a restauração para transmitir dados de backup

O exemplo a seguir define a configuração USE_STREAMING_RESTORE como TRUE.

db2 "call rdsadmin.set_configuration(
    'USE_STREAMING_RESTORE', 
    'TRUE')"

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:

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.backup_database

Faz backup de um banco de dados de uma instância de banco de dados do RDS para Db2 para um bucket do Amazon S3.

Sintaxe

db2 "call rdsadmin.backup_database(
    ?,
    'database_name', 
    's3_bucket_name', 
    's3_prefix', 
    'backup_type',
    'compression_option',
    'util_impact_priority', 
    'num_files',
    'parallelism',
    'num_buffers')"

Parâmetros

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

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

Os seguintes parâmetros são opcionais:

Observações de uso

Esse procedimento armazenado cria tarefas de backup assíncronas que transmitem o backup do seu banco de dados diretamente para o bucket do Amazon S3 usando a integração do Amazon S3. Você pode fazer backups do seu servidor local ou de uma instância de banco de dados do RDS para Db2, transmiti-los para o Amazon S3 e, depois, restaurá-los onde quiser. Para acessar informações sobre como restaurar um banco de dados para uma instância de banco de dados do RDS para Db2, consulte rdsadmin.restore_database.

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

Antes de chamar rdsadmin.backup_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

Depois de fazer backup do banco de dados, não se esqueça de encerrar a conexão.

terminate

Para acessar informações sobre como conferir o status do backup de um banco de dados, consulte rdsadmin.get_task_status.

Para ver as mensagens de erro exibidas ao chamar rdsadmin.backup_database, consulte Erros de procedimentos armazenados.

Exemplos

Todos os exemplos fazem backup de um banco de dados chamado MYDB para o bucket do Amazon S3 chamado amzn-s3-demo-bucket e definem o prefix como backups/daily.

Exemplo 1: especificar o banco de dados offline e indisponível com utilização média e um único fluxo de upload

No exemplo a seguir, o banco de dados está offline, o que é mais rápido, mas significa que o banco de dados não está disponível durante o backup. O exemplo não compacta os arquivos, tem impacto médio nos recursos do sistema e usa um único fluxo de upload para o Amazon S3.

db2 call "rdsadmin.backup_database(
    ?, 
    'MYDB',
    'amzn-s3-demo-bucket', 
    'backups/daily',
    'OFFLINE',
    'NONE', 
    50, 
    1)"

Exemplo 2: especificar o banco de dados on-line e disponível com compactação aprimorada, utilização média e poucos fluxos de upload paralelos

No exemplo a seguir, o banco de dados está on-line e disponível durante o backup. O exemplo executa uma compactação aprimorada, o que ocasiona um tamanho de arquivo pequeno, mas consome muita CPU. Ele tem um impacto um pouco maior do que a média nos recursos do sistema e usa cinco fluxos de upload para o Amazon S3.

db2 call "rdsadmin.backup_database(
    ?, 
    'MYDB',
    'amzn-s3-demo-bucket', 
    'backups/daily',
    'ONLINE',
    'ZLIB', 
    60, 
    5)"

Exemplo 3: especificar o banco de dados offline e indisponível com padrões e cálculos do sistema

No exemplo a seguir, o banco de dados está offline, o que é mais rápido, mas significa que o banco de dados não está disponível durante o backup. O exemplo usa a compactação padrão dos arquivos e o impacto nos recursos do sistema. Ele também permite que o RDS para Db2 calcule o número de fluxos de upload paralelos para o Amazon S3, espaços para tabela para leitura paralela e buffers para uso.

db2 "call rdsadmin.backup_database(
    ?, 
    'MYDB', 
    'amzn-s3-demo-bucket',
    'backups/daily', 
    'OFFLINE')"

Exemplo 4: especificar o banco de dados offline e indisponível sem compactação, alta utilização e cálculos personalizados

No exemplo a seguir, o banco de dados está offline, o que é mais rápido, mas significa que o banco de dados não está disponível durante o backup. O exemplo não compacta os arquivos, tem impacto alto nos recursos do sistema e usa vinte fluxos de upload para o Amazon S3. Ele define o número máximo de espaços para tabela a serem lidos em paralelo, o que pode fazer com que a solicitação de backup falhe se a capacidade de processamento for insuficiente. Ele também define o número máximo de buffers a serem usados, o que pode fazer com que a solicitação de backup falhe se a memória for insuficiente.

db2 "call rdsadmin.backup_database(
    ?, 
    'MYDB', 
    'amzn-s3-demo-bucket', 
    'backups/daily', 
    'OFFLINE', 
    'NONE', 
    90, 
    20, 
    256, 
    268435456)"

rdsadmin.restore_database

Restaura um banco de dados de um bucket do Amazon S3 para a instância de banco de dados do RDS para Db2.

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:

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

Observações de uso

Você pode usar esse procedimento armazenado para migrar um banco de dados do Db2 para uma instância de banco de dados do RDS para Db2. Para obter mais informações, consulte Usar serviços da AWS para migrar dados do Db2 para o Amazon RDS para Db2. Também é possível usar esse procedimento armazenado para criar várias cópias do mesmo banco de dados com nomes de banco de dados diferentes que usam a mesma imagem de restauração.

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

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.

Para ver as mensagens de erro exibidas ao chamar rdsadmin.restore_database, consulte Erros de procedimentos armazenados.

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, 
    'rollforward_to_option', 
    'complete_rollforward')"

Parâmetros

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

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

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

Observações de uso

Você pode usar rds.rollforward_database para fazer um backup on-line com a inclusão de logs produzidos no ambiente on-premises em vários cenários diferentes.

Cenário 1: restaurar o banco de dados, aplicar roll forward nos logs incluídos e colocar o banco de dados on-line

Após a conclusão de rdsadmin.restore_database(), use a sintaxe no Exemplo 1 para colocar o banco de dados com logs de transação on-line.

Cenário 2: colocar o banco de dados on-line, mas não aplicar roll forward nos logs incluídos.

Após a conclusão de rdsadmin.restore_database(), use a sintaxe no Exemplo 2 para colocar o banco de dados com logs de transação on-line.

Cenário 3: aplicar roll forward nos logs incluídos no backup e aplicar logs de transação adicionais à medida que eles forem produzidos no ambiente on-premises

Após a conclusão de rdsadmin.restore_database(), use a sintaxe no Exemplo 3 ou Exemplo 4 para aplicar roll forward nos logs sem colocar o banco de dados on-line.

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.rollforward_status.

Exemplos

Exemplo 1: colocar o banco de dados com logs de transação on-line

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')"

Exemplo 2: colocação do banco de dados sem logs de transações online

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')"

Exemplo 3: sem colocação do banco de dados com logs de transações online

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')"

Exemplo 4: sem colocação do banco de dados com logs de transações adicionais online

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.rollforward_status

Retorna a saída de ROLLFORWARD DATABASE database_name QUERY STATUS.

Sintaxe

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

Parâmetros

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

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

Observações de uso

Depois de chamar rdsadmin.rollforward_database, você pode chamar rdsadmin.rollforward_status para verificar o status da aplicação de roll forward no banco de dados.

Para ter informações sobre como conferir o status desse procedimento armazenado, consulte rdsadmin.get_task_status.

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:

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

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.rollforward_status.

Exemplos

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

db2 "call rdsadmin.complete_rollforward(
    ?,
    '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:

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

Exemplo 1: retorno do tempo de atividade da instância de banco de dados

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('-')"

Exemplo 2: retorno do tempo de atividade do banco de dados

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

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

Exemplo 3: retorno do uso de memória da instância de banco de dados

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')"

Exemplo 4: retorno de conjuntos de memória da instância de banco de dados e do banco de dados

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:

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

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

Exemplo 1: especificação de todas as aplicações

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')"

Exemplo 2: especificação de várias aplicações

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:

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

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

Exemplo 1: configuração do tempo de retenção

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')"

Exemplo 2: desativação do tempo de retenção

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:

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

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')"

rdsadmin.list_archive_log_information

Retorna detalhes sobre os arquivos de log de arquivamento, como o tamanho, a data e a hora de criação e o nome dos arquivos de log individuais para o banco de dados especificado. Também retorna a quantidade total de armazenamento usada pelos arquivos de log no banco de dados.

Sintaxe

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

Parâmetros

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

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

Exemplos

O exemplo a seguir retorna informações de log de arquivamento para um banco de dados chamado TESTDB.

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

rdsadmin.fgac_command

Executa comandos de controle de acesso refinado (FGAC).

Sintaxe

db2 "call rdsadmin.fgac_command(
    ?,
    'database_name',
    'fgac_cmd')"

Parâmetros

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

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

Observações de uso

Esse procedimento armazenado controla o acesso em nível de linha ou coluna aos dados da tabela em seu banco de dados em uma instância de banco de dados do RDS para Db2. O RDS para Db2 comporta dois tipos de FGAC no banco de dados:

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

Exemplos

Todos os exemplos a seguir executam comandos do FGAC em um banco de dados chamado testdb.

Exemplo 1: criar um rótulo de segurança chamado FRUITSET

db2 "call rdsadmin.fgac_command(
    ?,
    'testdb',
    'CREATE SECURITY LABEL COMPONENT FRUITSET SET{''apple'',''banana''}')"

Exemplo 2: criar uma máscara para a coluna EMP_ID que é habilitada quando EMP_ID é definido como menos de três

db2 "call rdsadmin.fgac_command(
    ?,
    'testdb',
    'CREATE MASK id_MASK ON EMPLOYEE FOR COLUMN EMP_ID RETURN CASE WHEN (EMP_ID < 3) THEN EMP_ID ELSE NULL END ENABLE')"

Exemplo 3: criar uma máscara para a coluna DEPARTMENT que é habilitada quando SESSION_USER é definido como security_user

db2 "call rdsadmin.fgac_command(
    ?,
    'testdb',
    'CREATE MASK DEPARTMENT_MASK ON EMPLOYEE FOR COLUMN DEPARTMENT RETURN CASE  WHEN SESSION_USER = ''security_user'' THEN DEPARTMENT ELSE NULL END ENABLE')"

Exemplo 4: criar um rótulo de segurança chamado treelabel

db2 "call rdsadmin.fgac_command(
    ?,
    'testdb',
    'CREATE SECURITY LABEL COMPONENT treelabel  TREE(''COMPANY'' ROOT, ''HR'' UNDER ''COMPANY'', ''FINANCE'' UNDER ''COMPANY'', ''IT'' UNDER ''COMPANY'')')"