Administración de bases de datos - 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

Administración de bases de datos

Los siguientes procedimientos almacenados administran bases de datos de Amazon RDS para Db2. Para ejecutar estos procedimientos, el usuario maestro debe conectarse primero a la base de datos rdsadmin.

rdsadmin.create_database

Crea una base de datos.

Sintaxis

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

Parámetros

nota

Este procedimiento almacenado no valida la combinación de parámetros necesarios. Al llamar a rdsadmin.get_task_status, la función definida por el usuario podría devolver un error debido a una combinación de database_codeset, database_territory y database_collation que no es válida. Para obtener más información, consulte Choosing the code page, territory, and collation for your database en la documentación de IBM Db2.

El siguiente parámetro es obligatorio:

database_name

El nombre de la base de datos que se va a crear. El tipo de datos es varchar.

Los siguientes parámetros son opcionales:

database_page_size

El tamaño de página predeterminado de la base de datos. Valores válidos: 4096, 8192, 16384, 32768. El tipo de datos es integer. El valor predeterminado es 8192.

importante

Amazon RDS admite la atomicidad de escritura para páginas de 4 KiB, 8 KiB y 16 KiB. Por el contrario, las páginas de 32 KiB corren el riesgo de tener errores de escritura o de que se escriban datos parciales en el escritorio. Si utiliza páginas de 32 KiB, le recomendamos habilitar la recuperación a un momento dado y las copias de seguridad automáticas. De lo contrario, corre el riesgo de no poder recuperarse de las páginas con errores. Para obtener más información, consulte Introducción a las copias de seguridad y Restauración de una instancia de base de datos a un momento especificado.

database_code_set

El conjunto de códigos de la base de datos. El tipo de datos es varchar. El valor predeterminado es UTF-8.

database_territory

El código de dos letras de la base de datos. El tipo de datos es varchar. El valor predeterminado es US.

database_collation

La secuencia de intercalación que determina cómo se ordenan y comparan las cadenas de caracteres almacenadas en la base de datos. El tipo de datos es varchar.

Valores válidos:

  • COMPATIBILITY: una secuencia de intercalación de IBM Db2 versión 2.

  • EBCDIC_819_037: página de códigos ISO latinos, intercalación; CCSID 037 (EBCDIC inglés de EE. UU.).

  • EBCDIC_819_500: página de códigos ISO latinos, intercalación; CCSID 500 (EBCDIC internacional).

  • EBCDIC_850_037: página de códigos ASCII latinos, intercalación; CCSID 037 (EBCDIC inglés de EE. UU.).

  • EBCDIC_850_500: página de códigos ASCII latinos, intercalación; CCSID 500 (EBCDIC internacional).

  • EBCDIC_932_5026: página de códigos ASCII japoneses, intercalación; CCSID 037 (EBCDIC inglés de EE. UU.).

  • EBCDIC_932_5035: página de códigos ASCII japoneses, intercalación; CCSID 500 (EBCDIC internacional).

  • EBCDIC_1252_037: página de códigos Windows latinos, intercalación; CCSID 037 (EBCDIC inglés de EE. UU.).

  • EBCDIC_1252_500: página de códigos Windows latinos, intercalación; CCSID 500 (EBCDIC internacional).

  • IDENTITY: intercalación predeterminada. Las cadenas se comparan byte por byte.

  • IDENTITY_16BIT: el esquema de codificación de compatibilidad para UTF-16: secuencia de intercalación de 8 bits (CESU-8). Para obtener más información, consulte Unicode Technical Report #26 en el sitio web de Unicode Consortium.

  • NLSCHAR: solo para su uso con la página de códigos en tailandés (CP874).

  • SYSTEM: si utiliza SYSTEM, la base de datos utiliza automáticamente la secuencia de intercalación para database_codeset y database_territory.

El valor predeterminado es IDENTITY.

Además, RDS para Db2 admite los siguientes grupos de intercalaciones: language-aware-collation y locale-sensitive-collation. Para obtener más información, consulte Choosing a collation for a Unicode database en la documentación de IBM Db2.

database_autoconfigure_str

La sintaxis del comando AUTOCONFIGURE, por ejemplo, 'AUTOCONFIGURE APPLY DB'. El tipo de datos es varchar. El valor predeterminado es una cadena vacía o null.

Para obtener más información, consulte Comando AUTOCONFIGURE en la documentación de IBM Db2.

Notas de uso

Puede crear una base de datos llamando a rdsadmin.create_database si no especificó el nombre de la base de datos al crear la instancia de base de datos de RDS para Db2 mediante la consola de Amazon RDS o la AWS CLI. Para obtener más información, consulte Creación de una instancia de base de datos.

Consideraciones especiales:

  • El comando CREATE DATABASE enviado a la instancia de Db2 usa la opción RESTRICTIVE.

  • RDS para Db2 solo usa AUTOMATIC STORAGE.

  • RDS para Db2 usa los valores predeterminados para NUMSEGS y DFT_EXTENT_SZ.

  • RDS para Db2 utiliza el cifrado de almacenamiento y no admite el cifrado de bases de datos.

Para obtener más información sobre estas consideraciones, consulte el comando CREATE DATABASE en la documentación de IBM Db2.

Antes de llamar a rdsadmin.create_database, debe conectarse a la base de datos rdsadmin. En el siguiente ejemplo, sustituya master_username y master_password por la información de su instancia de base de datos de RDS para Db2:

db2 connect to rdsadmin user master_username using master_password

Para obtener más información sobre cómo comprobar el estado de creación de una base de datos, consulte rdsadmin.get_task_status.

Ejemplos

En el siguiente ejemplo, se crea una base de datos llamada TESTJP con una combinación correcta de los parámetros database_code_set, database_territory y database_collation para Japón:

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

rdsadmin.drop_database

Elimina una base de datos.

Sintaxis

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

Parámetros

El siguiente parámetro es obligatorio:

database_name

El nombre de la base de datos que se eliminará. El tipo de datos es varchar.

Notas de uso

Puede eliminar una base de datos llamando a rdsadmin.drop_database solo si se cumplen las siguientes condiciones:

  • Si no especificó el nombre de la base de datos al crear la instancia de base de datos de RDS para Db2 mediante la consola de Amazon RDS o la AWS CLI. Para obtener más información, consulte Creación de una instancia de base de datos.

  • Si creó la base de datos llamando al procedimiento almacenado rdsadmin.create_database.

  • Si ha restaurado la base de datos a partir de una imagen sin conexión o de una copia de seguridad llamando al procedimiento almacenado rdsadmin.restore_database.

Antes de llamar a rdsadmin.drop_database, debe conectarse a la base de datos rdsadmin. En el siguiente ejemplo, sustituya master_username y master_password por la información de su instancia de base de datos de RDS para Db2:

db2 connect to rdsadmin user master_username using master_password

Para obtener más información sobre cómo comprobar el estado de eliminación de una base de datos, consulte rdsadmin.get_task_status.

Ejemplos

En el siguiente ejemplo, se elimina una base de datos denominada:TESTDB

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

Ejemplos de respuesta

Si pasa un nombre de base de datos incorrecto, el procedimiento almacenado devuelve el siguiente ejemplo de respuesta:

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

Si creó la base de datos mediante la consola de Amazon RDS o mediante la AWS CLI, el procedimiento almacenado devuelve el siguiente ejemplo de respuesta:

Return Status = 0

Después de recibir Return Status = 0, llame al procedimiento almacenado rdsadmin.get_task_status. Una respuesta similar a la del siguiente ejemplo explica el estado:

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

Actualiza los parámetros de la base de datos.

Sintaxis

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

Parámetros

Se requieren los siguientes parámetros:

database_name

Nombre de la base de datos para la que se desea ejecutar la tarea. El tipo de datos es varchar.

parameter_to_modify

El nombre del parámetro que se va a modificar. El tipo de datos es varchar. Para obtener más información, consulte Parámetros de Amazon RDS para Db2.

changed_value

El valor al que se desea cambiar el valor del parámetro. El tipo de datos es varchar.

Notas de uso

Para obtener más información sobre cómo comprobar el estado de actualización de los parámetros de base de datos, consulte rdsadmin.get_task_status.

Ejemplos

En el siguiente ejemplo, se actualiza el parámetro archretrydelay a 100 para una base de datos denominada:TESTDB

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

El siguiente ejemplo aplaza la validación de los objetos creados en una base de datos denominada TESTDB para evitar la comprobación de dependencias:

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

Ejemplos de respuesta

Si intenta modificar un parámetro de configuración de base de datos que no es compatible o no se puede modificar, el procedimiento almacenado devuelve el siguiente ejemplo de respuesta:

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

rdsadmin.set_configuration

Configura ajustes específicos para la base de datos.

Sintaxis

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

Parámetros

Se requieren los siguientes parámetros:

name

El nombre del ajuste de configuración. El tipo de datos es varchar.

value

El valor del ajuste de la configuración. El tipo de datos es varchar.

Notas de uso

La siguiente tabla muestra los ajustes de configuración que puede controlar con rdsadmin.set_configuration.

Nombre Descripción

RESTORE_DATABASE_NUM_BUFFERS

El número de búferes que se van a crear durante una operación de restauración. Este valor debe ser menor que el tamaño de memoria total de la clase de instancia de base de datos. Si este ajuste no está configurado, Db2 determina el valor que se utilizará durante la operación de restauración. Para obtener más información, consulte la Documentación de IBM Db2.

RESTORE_DATABASE_PARALLELISM

El número de manipuladores de búferes que se van a crear durante una operación de restauración. Este valor debe ser menor que el doble de la cantidad de vCPU para la instancia de base de datos. Si este ajuste no está configurado, Db2 determina el valor que se utilizará durante la operación de restauración. Para obtener más información, consulte la Documentación de IBM Db2.

Ejemplos

En el siguiente ejemplo, se establece la configuración RESTORE_DATABASE_PARALLELISM en 8.

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

En el siguiente ejemplo, se establece la configuración RESTORE_DATABASE_NUM_BUFFERS en 150.

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

rdsadmin.show_configuration

Devuelve el ajuste actual que puede establecer mediante el procedimiento almacenado rdsadmin.set_configuration.

Sintaxis

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

Parámetros

El siguiente parámetro es opcional:

name

El nombre del ajuste de configuración sobre el que se va a devolver la información. El tipo de datos es varchar.

Son válidos los siguientes nombres de configuración:

  • RESTORE_DATABASE_NUM_BUFFERS: el número de búferes que se van a crear durante una operación de restauración.

  • RESTORE_DATABASE_PARALLELISM: el número de manipuladores de búferes que se van a crear durante una operación de restauración.

Notas de uso

Si no especifica el nombre de un ajuste de configuración, rdsadmin.show_configuration devuelve la información de todos los ajustes de configuración que puede establecer mediante el procedimiento almacenado rdsadmin.set_configuration.

Ejemplos

En el siguiente ejemplo, se devuelve información sobre la configuración RESTORE_DATABASE_PARALLELISM actual.

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

rdsadmin.restore_database

Restaura una base de datos.

Sintaxis

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

Parámetros

El siguiente parámetro de salida es obligatorio:

?

Un marcador de parámetros que genera un mensaje de error. Este parámetro solo acepta ?.

Se requieren los siguientes parámetros de entrada:

database_name

El nombre de la base de datos que se va a restaurar. Este nombre debe coincidir con el nombre de la base de datos de la imagen de copia de seguridad. El tipo de datos es varchar.

s3_bucket_name

El nombre del bucket de Amazon S3 donde se almacena su copia de seguridad. El tipo de datos es varchar.

s3_prefix

El prefijo que se utilizará para la coincidencia de archivos durante la descarga. El tipo de datos es varchar.

Si este parámetro está vacío, se descargarán todos los archivos del bucket de Amazon S3. A continuación, se muestra un prefijo de ejemplo:

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

La marca de tiempo de la imagen de copia de seguridad de la base de datos. El tipo de datos es varchar.

La marca de tiempo se incluye en el nombre del archivo de copia de seguridad. Por ejemplo, 20230615010101 es la marca de tiempo del nombre del archivo SAMPLE.0.rdsdb.DBPART000.20230615010101.001.

backup_type

El tipo de copia de seguridad. El tipo de datos es varchar. Valores válidos: OFFLINE, ONLINE.

Use ONLINE para migraciones con un tiempo de inactividad prácticamente nulo Para obtener más información, consulte Migración con tiempo de inactividad prácticamente nulo para bases de datos Db2 basadas en Linux.

Notas de uso

Puede restaurar una base de datos llamando a rdsadmin.restore_database si no especificó el nombre de la base de datos al crear la instancia de base de datos de RDS para Db2 mediante la consola de Amazon RDS o la AWS CLI. Para obtener más información, consulte Creación de una instancia de base de datos.

Antes de restaurar una base de datos, debe aprovisionar un espacio de almacenamiento para la instancia de base de datos de RDS para Db2 que sea igual o mayor que la suma del tamaño de la copia de seguridad y de la base de datos de Db2 original en el disco. Al restaurar la copia de seguridad, Amazon RDS extrae el archivo de copia de seguridad de la instancia de base de datos de RDS para Db2.

Cada archivo de copia de seguridad debe tener 5 TB o menos. Si un archivo de copia de seguridad supera los 5 TB, debe dividir el archivo de copia de seguridad en archivos más pequeños.

Para restaurar todos los archivos con el procedimiento almacenado rdsadmin.restore_database, no incluya el sufijo del número de archivo después de la marca de tiempo en los nombres de los archivos. Por ejemplo, el s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101 restaura los siguientes archivos:

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

Para mejorar el rendimiento de las operaciones de restauración de bases de datos, puede configurar el número de búferes y manipuladores de búferes que utilizará RDS. Para comprobar la configuración actual, utilice rdsadmin.show_configuration. Para cambiar la configuración, utilice rdsadmin.set_configuration.

Para obtener más información sobre cómo comprobar el estado de restauración de su base de datos, consulte rdsadmin.get_task_status.

Para poner la base de datos en línea y aplicar registros de transacciones adicionales después de restaurarla, consulte rdsadmin.rollforward_database.

Ejemplos

El siguiente ejemplo restaura una copia de seguridad sin conexión con uno o varios archivos que tienen el 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

Pone la base de datos en línea y aplicar registros de transacciones adicionales después de restaurar una base de datos llamando a rdsadmin.restore_database.

Sintaxis

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

Parámetros

El siguiente parámetro de salida es obligatorio:

?

Un marcador de parámetros que genera un mensaje de error. Este parámetro solo acepta ?.

Se requieren los siguientes parámetros de entrada:

database_name

Nombre de la base de datos en la que se va a realizar la operación. El tipo de datos es varchar.

s3_bucket_name

El nombre del bucket de Amazon S3 donde se almacena su copia de seguridad. El tipo de datos es varchar.

s3_prefix

El prefijo que se utilizará para la coincidencia de archivos durante la descarga. El tipo de datos es varchar.

Si este parámetro está vacío, se descargarán todos los archivos del bucket de S3. A continuación, se muestra un ejemplo de prefijo:

backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101

Los siguientes parámetros de entrada son opcionales:

rollforward_to_option

El punto al que desee realizar la puesta al día. El tipo de datos es varchar. Valores válidos: END_OF_LOGS, END_OF_BACKUP. El valor predeterminado es END OF LOGS.

complete_rollforward

Especifica si se debe completar el proceso de puesta al día. El tipo de datos es varchar. El valor predeterminado es TRUE.

Si es TRUE, una vez finalizado el proceso, la base de datos está en línea y accesible. Si es FALSE, entonces la base de datos permanece en el estado ROLL-FORWARD PENDING.

Notas de uso

Después de llamar a rdsadmin.restore_database, debe llamar a rollforward_database para aplicar los registros de archivo de un bucket de S3. También puede usar este procedimiento almacenado para restaurar registros de transacciones adicionales después de llamar a rdsadmin.restore_database.

Si configura complete_rollforward como FALSE la base de datos estará en el estado ROLL-FORWARD PENDING y sin conexión. Para poner la base de datos en línea, debe llamar a rdsadmin.complete_rollforward.

Para obtener información sobre cómo comprobar el estado de puesta al día de una base de datos, consulte rdsadmin.get_task_status.

Ejemplos

El siguiente ejemplo pone al día una base de datos desde una copia de seguridad en línea con los registros de transacciones y pone la base de datos en línea:

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

El siguiente ejemplo pone al día una base de datos desde una copia de seguridad en línea sin los registros de transacciones y pone la base de datos en línea:

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

El siguiente ejemplo pone al día una base de datos desde una copia de seguridad en línea con los registros de transacciones y luego no pone la base de datos en línea:

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

El siguiente ejemplo pone al día una base de datos desde una copia de seguridad en línea con los registros de transacciones adicionales y luego no pone la base de datos en línea:

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

rdsadmin.complete_rollforward

Pone en línea la base de datos desde un estado ROLL-FORWARD PENDING.

Sintaxis

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

Parámetros

El siguiente parámetro de salida es obligatorio:

?

Un marcador de parámetros que genera un mensaje de error. Este parámetro solo acepta ?.

El siguiente parámetro de entrada es obligatorio:

database_name

El nombre de la base de datos que quiera poner en línea. El tipo de datos es varchar.

Notas de uso

Si llamó a rdsadmin.rollforward_database con complete_rollforward configurado como FALSE, la base de datos está en un estado ROLL-FORWARD PENDING y sin conexión. Para completar el proceso de puesta al día y poner la base de datos en línea, llame a rdsadmin.complete_rollforward.

Para obtener información sobre cómo comprobar el estado de finalización del proceso de puesta al día, consulte rdsadmin.get_task_status.

Ejemplos

El siguiente ejemplo pone la base de datos TESTDB en línea:

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

rdsadmin.db2pd_command

Recopila información sobre una base de datos de RDS para Db2.

Sintaxis

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

Parámetros

El siguiente parámetro de entrada es obligatorio:

db2pd_cmd

El nombre del comando db2pd que desea ejecutar. El tipo de datos es varchar.

El parámetro debe comenzar con un guion. Para obtener una lista de parámetros, consulte db2pd - Monitor and troubleshoot Db2 database command en la documentación de IBM.

Las siguientes opciones no son compatibles:

  • -addnode

  • -alldatabases

  • -alldbp

  • -alldbs

  • -allmembers

  • -alm_in_memory

  • -cfinfo

  • -cfpool

  • -command

  • -dbpartitionnum

  • -debug

  • -dump

  • -everything

  • -file | -o

  • -ha

  • -interactive

  • -member

  • -pages

    nota

    Compatible con -pages summary.

  • -pdcollection

  • -repeat

  • -stack

  • -totalmem

La subopción file no es compatible; por ejemplo, db2pd -db testdb -tcbstats file=tcbstat.out.

El uso de stacks no es compatible; por ejemplo, db2pd -edus interval=5 top=10 stacks.

Notas de uso

Este procedimiento almacenado recopila información que puede ayudar a supervisar y solucionar problemas de bases de datos de RDS para Db2.

El procedimiento almacenado utiliza la utilidad db2pd de IBM para ejecutar varios comandos. La utilidad db2pd requiere una autorización SYSADM, que el usuario maestro de RDS para Db2 no tiene. Sin embargo, con el procedimiento almacenado de Amazon RDS, el usuario maestro puede utilizar la utilidad para ejecutar varios comandos. Para obtener más información acerca de la utilidad, consulte db2pd - Monitor and troubleshoot Db2 database command en la documentación de IBM.

El resultado está restringido a un máximo de 2 GB.

Para obtener información sobre cómo comprobar el estado de la recopilación de información sobre la base de datos, consulte rdsadmin.get_task_status.

Ejemplos

El siguiente ejemplo devuelve el tiempo de actividad de una instancia de base de datos de RDS para Db2:

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

El siguiente ejemplo devuelve el tiempo de actividad de una base de datos denominada:TESTDB

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

El siguiente ejemplo devuelve el uso de memoria de una instancia de base de datos de RDS para Db2:

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

El siguiente ejemplo devuelve los conjuntos de memoria de una instancia de base de datos de RDS para Db2 y una base de datos denominada:TESTDB

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

rdsadmin.force_application

Fuerza a las aplicaciones a salir de una base de datos de RDS para Db2.

Sintaxis

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

Parámetros

El siguiente parámetro de salida es obligatorio:

?

Un marcador de parámetros que genera un mensaje de error. Este parámetro solo acepta ?.

El siguiente parámetro de entrada es obligatorio:

applications

Las aplicaciones que quiere forzar a que salgan de una base de datos de RDS para Db2. El tipo de datos es varchar. Valores válidos: ALL o application_handle.

Separe los nombres de varias aplicaciones con comas. Ejemplo: 'application_handle_1, application_handle_2'.

Notas de uso

Este procedimiento almacenado obliga a todas las aplicaciones a salir de una base de datos para que pueda realizar el mantenimiento.

El procedimiento almacenado utiliza el comando FORCE APPLICATION de IBM. El comando FORCE APPLICATION requiere autorización SYSADM, SYSMAINT o SYSCTRL que el usuario maestro de RDS para Db2 no tiene. Sin embargo, con el procedimiento almacenado de Amazon RDS, el usuario maestro puede utilizar el comando. Para obtener más información, consulte FORCE APPLICATION command en la documentación de IBM.

Para obtener información sobre cómo comprobar el estado al obligar la salida de aplicaciones de una base de datos, consulte rdsadmin.get_task_status.

Ejemplos

El siguiente ejemplo fuerza a todas las aplicaciones a salir de una base de datos de RDS para Db2:

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

El siguiente ejemplo obliga a los controladores de aplicaciones 9991, 8891 y 1192 a salir de una base de datos de RDS para Db2:

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

rdsadmin.set_archive_log_retention

Configura la cantidad de tiempo (en horas) que se conservarán los archivos de registro de la base de datos de RDS para Db2 especificada.

Sintaxis

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

Parámetros

El siguiente parámetro de salida es obligatorio:

?

Un marcador de parámetros que genera un mensaje de error. Este parámetro solo acepta ?.

Se requieren los siguientes parámetros de entrada:

database_name

El nombre de la base de datos para la que se configura la retención de registros de archivo. El tipo de datos es varchar.

archive_log_retention_hours

El número de horas que se van a conservar los archivos de registros de archivo. El tipo de datos es smallint. El valor predeterminado es 0 y el máximo es 168 (7 días).

Si el valor es 0, Amazon RDS no conserva los archivos de registro de archivo.

Notas de uso

De forma predeterminada, RDS para Db2 retiene los registros durante 5 minutos. Si utiliza herramientas de replicación, como AWS DMS para la captura de datos de cambios (CDC) o IBM Q Replication, le recomendamos que configure la retención de registros en esas herramientas para más de 5 minutos.

Puede ver la configuración actual de conservación de registros de archivo llamando a rdsadmin.show_archive_log_retention.

No puede configurar el ajuste de retención de registros de archivos en la base de datos rdsadmin.

Ejemplos

El siguiente ejemplo ajusta el tiempo de conservación de registros de archivo para una base de datos denominada TESTDB en 24 horas.

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

El siguiente ejemplo deshabilita la conservación de registros de archivo para una base de datos denominada TESTDB.

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

rdsadmin.show_archive_log_retention

Devuelve la configuración actual de retención de registros de archivo de la base de datos especificada.

Sintaxis

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

Parámetros

El siguiente parámetro de salida es obligatorio:

?

Un marcador de parámetros que genera un mensaje de error. Este parámetro solo acepta ?.

El siguiente parámetro de entrada es obligatorio:

database_name

El nombre de la base de datos para la que se muestra la configuración de la conservación de registros de archivo. El tipo de datos es varchar.

Ejemplos

El siguiente ejemplo muestra el ajuste de conservación de registros de archivo para una base de datos denominada TESTDB.

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