Procedimientos almacenados de bases de datos de RDS para Db2 - Amazon Relational Database Service
rdsadmin.create_databaserdsadmin.deactivate_databaserdsadmin.activate_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_retentionrdsadmin.list_archive_log_information

Procedimientos almacenados de bases de datos de RDS para Db2

Los procedimientos almacenados integrados que se describen en este tema 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.

Estos procedimientos almacenados se utilizan en diversas tareas. Esta lista no es exhaustiva.

Consulte los siguientes procedimientos almacenados integrados para obtener información sobre su sintaxis, parámetros, notas de uso y ejemplos.

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 para Amazon RDS.

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

Si tiene previsto modificar el parámetro db2_compatibility_vector, modifíquelo antes de crear una base de datos. Para obtener más información, consulte Establecimiento del parámetro db2_compatibility_vector.

Consideraciones especiales:

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

  • RDS para Db2 solo usa espacios de tabla 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.

Para ver los mensajes de error devueltos al llamar a rdsadmin.create_database, consulte Solución de errores en los procedimientos almacenados.

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

Desactiva una base de datos.

Sintaxis

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

Nombre de la base de datos que se va a desactivar. El tipo de datos es varchar.

Notas de uso

Puede desactivar las bases de datos para conservar los recursos de memoria. Para volver a poner en línea las bases de datos desactivadas, llame al procedimiento rdsadmin.activate_database almacenado.

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

Ejemplos

En el siguiente ejemplo, se desactiva una base de datos denominada TESTDB.

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

rdsadmin.activate_database

Activa una base de datos.

Sintaxis

db2 "call rdsadmin.activate_database(
    ?,
    '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 se va a activar. El tipo de datos es varchar.

Notas de uso

Todas las bases de datos se activan de forma predeterminada cuando se crean. Si desactiva una base de datos para conservar los recursos de memoria, llame al procedimiento rdsadmin.activate_database almacenado para volver a activarla.

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

Ejemplos

En el siguiente ejemplo, se activa una base de datos denominada TESTDB.

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

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.

Para ver los mensajes de error devueltos al llamar a rdsadmin.drop_database, consulte Solución de errores en los procedimientos almacenados.

Ejemplos

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

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

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.

Para ver los mensajes de error devueltos al llamar a rdsadmin.update_db_param, consulte Solución de errores en los procedimientos almacenados.

Ejemplos

Ejemplo 1: actualización de un parámetro

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

Ejemplo 2: aplazamiento de la validación de los objetos

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

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

Ejemplo 1: especificación del número de manipuladores de búferes que se van a crear

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

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

Ejemplo 2: especificación del número de búferes que se van a crear

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

Restablece una base de datos de un bucket de Amazon S3 a una instancia de base de datos de RDS para Db2.

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 de destino que se va a restaurar en RDS para Db2. El tipo de datos es varchar.

Por ejemplo, si el nombre de la base de datos de origen era TESTDB y usted estableció database_name en NEWDB, Amazon RDS restaura NEWDB como la base de datos de origen.

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 de Linux a Linux con un tiempo de inactividad prácticamente nulo para Amazon RDS para Db2.

Notas de uso

Puede utilizar este procedimiento almacenado para migrar una base de datos Db2 a una instancia de base de datos de RDS para Db2. Para obtener más información, consulte Uso de servicios de AWS para migrar datos de Db2 a Amazon RDS para Db2. También puede utilizar este procedimiento almacenado para crear varias copias de la misma base de datos con diferentes nombres de base de datos que utilicen la misma imagen de restauración.

Antes de llamar al procedimiento almacenado, tenga en cuenta lo siguiente:

  • 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. Para obtener más información, consulte Insufficient disk space.

  • 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

  • RDS para Db2 no admite almacenamiento no automático. Para obtener más información, consulte Tablespaces not restored.

  • RDS para Db2 no admite la creación de rutinas no restringidas. Para obtener más información, consulte Non-fenced routines not allowed.

  • 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 poner la base de datos en línea y aplicar registros de transacciones adicionales después de restaurarla, consulte rdsadmin.rollforward_database.

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 ver los mensajes de error devueltos al llamar a rdsadmin.restore_database, consulte Solución de errores en los procedimientos almacenados.

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

Ejemplo 1: puesta en línea de una base de datos con registros de transacciones

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

Ejemplo 2: puesta en línea de una base de datos sin registros de transacciones

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

Ejemplo 3: no puesta en línea de la base de datos con registros de transacciones

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

Ejemplo 4: no puesta en línea de la base de datos con registros de transacciones adicionales

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

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 la opción 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 Db2.

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

Ejemplo 1: devolución del tiempo de actividad de la instancia de base de datos

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

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

Ejemplo 2: devolución del tiempo de actividad de la base de datos

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

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

Ejemplo 3: devolución del uso de memoria de la instancia de base de datos

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

Ejemplo 4: devolución de conjuntos de memoria de una instancia de base de datos y una base de datos

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

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

Ejemplo 1: especificación de todas las aplicaciones

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

Ejemplo 2: especificación de varias aplicaciones

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

Ejemplo 1: establecimiento del tiempo de retención

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

Ejemplo 2: desactivación del tiempo de retención

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

rdsadmin.list_archive_log_information

Devuelve detalles sobre los archivos de registro de archivo, como el tamaño, la fecha y hora de creación y el nombre de los archivos de registro individuales de la base de datos especificada. También devuelve la cantidad total de almacenamiento utilizada por los archivos de registro de la base de datos.

Sintaxis

db2 "call rdsadmin.list_archive_log_information(
    ?,
    '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 va a mostrar la información de registro de archivo. El tipo de datos es varchar.

Ejemplos

El siguiente ejemplo devuelve información de registros de archivo para una base de datos denominada TESTDB.

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