# 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.
+ [Tareas comunes para bases de datos](db2-managing-databases.md)
+ [Creación de bases de datos con intercalación EBCDIC](db2-ebcdic.md)
+ [Recopilación de información sobre las bases de datos](db2-supported-parameters.md#db2-modifying-parameters-db2-commands)
+ [Modificación de parámetros de configuración de bases de datos](db2-supported-parameters.md#db2-modifying-parameters-db2-commands)
+ [Migración de Linux a Linux](db2-one-time-migration-linux.md)
+ [Migración de Linux a Linux con un tiempo de inactividad prácticamente nulo](db2-near-zero-downtime-migration.md)
Consulte los siguientes procedimientos almacenados integrados para obtener información sobre su sintaxis, parámetros, notas de uso y ejemplos.
**Topics**
+ [rdsadmin.create\$1database](#db2-sp-create-database)
+ [rdsadmin.deactivate\$1database](#db2-sp-deactivate-database)
+ [rdsadmin.activate\$1database](#db2-sp-activate-database)
+ [rdsadmin.reactivate\$1database](#db2-sp-reactivate-database)
+ [rdsadmin.drop\$1database](#db2-sp-drop-database)
+ [rdsadmin.update\$1db\$1param](#db2-sp-update-db-param)
+ [rdsadmin.set\$1configuration](#db2-sp-set-configuration)
+ [rdsadmin.show\$1configuration](#db2-sp-show-configuration)
+ [rdsadmin.backup\$1database](#db2-sp-backup-database)
+ [rdsadmin.restore\$1database](#db2-sp-restore-database)
+ [rdsadmin.rollforward\$1database](#db2-sp-rollforward-database)
+ [rdsadmin.rollforward\$1status](#db2-sp-rollforward-status)
+ [rdsadmin.complete\$1rollforward](#db2-sp-complete-rollforward)
+ [rdsadmin.db2pd\$1command](#db2-sp-db2pd-command)
+ [rdsadmin.force\$1application](#db2-sp-force-application)
+ [rdsadmin.set\$1archive\$1log\$1retention](#db2-sp-set-archive-log-retention)
+ [rdsadmin.show\$1archive\$1log\$1retention](#db2-sp-show-archive-log-retention)
+ [rdsadmin.list\$1archive\$1log\$1information](#db2-sp-list-archive-log-information)
+ [rdsadmin.enable\$1archive\$1log\$1copy](#db2-sp-enable_archive_log_copy)
+ [rdsadmin.disable\$1archive\$1log\$1copy](#db2-sp-disable_archive_log_copy)
+ [rdsadmin.fgac\$1command](#db2-sp-fgac-command)
+ [rdsadmin.db2support\$1command](#db2-sp-db2support-command)
## rdsadmin.create\$1database
Crea una base de datos.
### Sintaxis
```
db2 "call rdsadmin.create_database(
'database_name',
'database_page_size',
'database_code_set',
'database_territory',
'database_collation',
'database_autoconfigure_str',
'database_non-restrictive')"
```
### Parameters
**nota**
Este procedimiento almacenado no valida la combinación de parámetros necesarios. Al llamar a [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-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](https://www.ibm.com/docs/en/db2/11.5?topic=support-choosing-code-page-territory-collation-your-database) en la documentación de IBM Db2.
El siguiente parámetro es obligatorio:
*database\$1name*
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\$1page\$1size*
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`.
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 disco. 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](USER_WorkingWithAutomatedBackups.md) y [Restauración de una instancia de base de datos a un momento especificado para Amazon RDS](USER_PIT.md).
*database\$1code\$1set*
El conjunto de códigos de la base de datos. El tipo de datos es `varchar`. El valor predeterminado es `UTF-8`.
*database\$1territory*
El código de dos letras de la base de datos. El tipo de datos es `varchar`. El valor predeterminado es `US`.
*database\$1collation*
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 5026 (EBCDIC inglés de EE. UU.).
+ `EBCDIC_932_5035`: página de códigos ASCII japoneses, intercalación; CCSID 5035 (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 \$126](https://www.unicode.org/reports/tr26/tr26-4.html) 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](https://www.ibm.com/docs/en/db2/11.5?topic=collation-choosing-unicode-database) en la documentación de IBM Db2.
*database\$1autoconfigure\$1str*
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](https://www.ibm.com/docs/en/db2/11.5?topic=cc-autoconfigure) en la documentación de IBM Db2.
*database\$1non-restrictive*
La concesión de las autoridades y privilegios predeterminados en la base de datos. El tipo de datos es `varchar`. El valor predeterminado es `N`.
Valores válidos:
+ `N`: la base de datos creada es restrictiva y no concede autoridades ni privilegios.
+ `Y`: la base de datos creada no es restrictiva y concede un conjunto de permisos al grupo especial `PUBLIC`. Para obtener más información, consulte [los privilegios predeterminados que se conceden al crear una base de datos](https://www.ibm.com/docs/en/db2/11.5.x?topic=ownership-default-privileges-granted-creating-database) 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\$1compatibility\$1vector](db2-known-issues-limitations.md#db2-known-issues-limitations-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](https://www.ibm.com/docs/en/db2/11.5?topic=commands-create-database#:~:text=in%20the%20database.-,RESTRICTIVE,-If%20the%20RESTRICTIVE) 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\$1username* y *master\$1password* 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\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Para ver los mensajes de error devueltos al llamar a `rdsadmin.create_database`, consulte [Errores en los procedimientos almacenados](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Ejemplos
En el siguiente ejemplo, se crea una base de datos llamada `TESTJP` con una combinación correcta de los parámetros *database\$1code\$1set*, *database\$1territory* y *database\$1collation* para Japón:
```
db2 "call rdsadmin.create_database('TESTJP', 4096, 'IBM-437', 'JP', 'SYSTEM')"
```
## rdsadmin.deactivate\$1database
Desactiva una base de datos.
### Sintaxis
```
db2 "call rdsadmin.deactivate_database(
?,
'database_name')"
```
### Parameters
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\$1name*
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 o para realizar otros cambios en la configuración de las bases de datos. Para volver a poner en línea las bases de datos desactivadas, llame al procedimiento almacenado [rdsadmin.activate\$1database](#db2-sp-activate-database).
No puede desactivar una base de datos en una instancia de base de datos de origen durante la replicación mediante una llamada al procedimiento `rdsadmin.deactivate_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\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Para ver los mensajes de error devueltos al llamar a `rdsadmin.deactivate_database`, consulte [Errores en los procedimientos almacenados](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Ejemplos
En el siguiente ejemplo, se desactiva una base de datos denominada `TESTDB`.
```
db2 "call rdsadmin.deactivate_database(?, 'TESTDB')"
```
## rdsadmin.activate\$1database
Activa una base de datos.
Para obtener información acerca de las diferencias entre [rdsadmin.reactivate\$1database](#db2-sp-reactivate-database) y `rdsadmin.activate_database`, consulte [Notas de uso](#db2-sp-activate-database-usage-notes).
### Sintaxis
```
db2 "call rdsadmin.activate_database(
?,
'database_name')"
```
### Parameters
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\$1name*
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 en una instancia de base de datos independiente para conservar los recursos de memoria o para realizar otros cambios en la configuración de la base de datos, llame al procedimiento almacenado `rdsadmin.activate_database` para volver a activar la base de datos.
Este procedimiento almacenado solo activa una base de datos que se encuentra en una instancia de base de datos independiente y que se desactivó al llamar al procedimiento almacenado [rdsadmin.deactivate\$1database](#db2-sp-deactivate-database). Para activar una base de datos en una instancia de base de datos de origen de réplica, debe llamar al procedimiento almacenado [rdsadmin.reactivate\$1database](#db2-sp-reactivate-database).
Para obtener más información sobre cómo comprobar el estado de activación de una base de datos, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Para ver los mensajes de error devueltos al llamar a `rdsadmin.activate_database`, consulte [Errores en los procedimientos almacenados](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Ejemplos
En el siguiente ejemplo, se activa una base de datos denominada `TESTDB`.
```
db2 "call rdsadmin.activate_database(?, 'TESTDB')"
```
## rdsadmin.reactivate\$1database
Reactiva una base de datos.
Para obtener información acerca de las diferencias entre [rdsadmin.activate\$1database](#db2-sp-activate-database) y `rdsadmin.reactivate_database`, consulte [Notas de uso](#db2-sp-reactivate-database-usage-notes).
### Sintaxis
```
db2 "call rdsadmin.reactivate_database(
?,
'database_name')"
```
### Parameters
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\$1name*
El nombre de la base de datos que se va a reactivar. El tipo de datos es `varchar`.
### Notas de uso
Al llamar al procedimiento almacenado `rdsadmin.reactivate_database`, este primero desactiva la base de datos llamando al procedimiento almacenado [rdsadmin.deactivate\$1database](#db2-sp-deactivate-database) y, a continuación, activa la base de datos llamando al procedimiento almacenado [rdsadmin.activate\$1database](#db2-sp-activate-database).
Después de realizar cambios en las configuraciones de las bases de datos, es posible que necesite reactivar una base de datos en una instancia de base de datos de RDS para Db2. Para determinar si necesita reactivar una base de datos, conéctese a la base de datos y ejecute `db2 get db cfg show detail`.
Para una base de datos en una instancia de base de datos independiente, puede utilizar el procedimiento almacenado `rdsadmin.reactivate_database` para reactivar la base de datos. O bien, si ya ha llamado al procedimiento almacenado [rdsadmin.deactivate\$1database](#db2-sp-deactivate-database), puede llamar al procedimiento almacenado [rdsadmin.activate\$1database](#db2-sp-activate-database) en su lugar.
Para una base de datos en una instancia de base de datos de origen de réplica, debe utilizar el procedimiento almacenado `rdsadmin.reactivate_database` para reactivar la base de datos.
Para obtener información sobre cómo comprobar el estado de reactivación de una base de datos, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Para ver los mensajes de error devueltos al llamar a `rdsadmin.reactivate_database`, consulte [Errores en los procedimientos almacenados](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Ejemplos
En el siguiente ejemplo, se reactiva una base de datos denominada `TESTDB`.
```
db2 "call rdsadmin.reactivate_database(?, 'TESTDB')"
```
## rdsadmin.drop\$1database
Elimina una base de datos.
### Sintaxis
```
db2 "call rdsadmin.drop_database('database_name')"
```
### Parameters
El siguiente parámetro es obligatorio:
*database\$1name*
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](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
+ Si creó la base de datos llamando al procedimiento almacenado [rdsadmin.create\$1database](#db2-sp-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\$1database](#db2-sp-restore-database).
Antes de llamar a `rdsadmin.drop_database`, debe conectarse a la base de datos `rdsadmin`. En el siguiente ejemplo, sustituya *master\$1username* y *master\$1password* 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\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Para ver los mensajes de error devueltos al llamar a `rdsadmin.drop_database`, consulte [Errores en los procedimientos almacenados](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Ejemplos
En el siguiente ejemplo, se elimina una base de datos denominada:`TESTDB`
```
db2 "call rdsadmin.drop_database('TESTDB')"
```
## rdsadmin.update\$1db\$1param
Actualiza los parámetros de la base de datos.
### Sintaxis
```
db2 "call rdsadmin.update_db_param(
'database_name',
'parameter_to_modify',
'changed_value',
'restart_database')"
```
### Parameters
Se requieren los siguientes parámetros:
*database\$1name*
Nombre de la base de datos para la que se desea ejecutar la tarea. El tipo de datos es `varchar`.
*parameter\$1to\$1modify*
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](db2-supported-parameters.md).
*changed\$1value*
El valor al que se desea cambiar el valor del parámetro. El tipo de datos es `varchar`.
El siguiente parámetro es opcional:
*restart\$1database*
Especifica si RDS reinicia la base de datos si es necesario. El tipo de datos es `varchar`. Para modificar `logprimary` y `logfilsiz`, establezca este parámetro en `'YES'`.
### 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\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Para ver los mensajes de error devueltos al llamar a `rdsadmin.update_db_param`, consulte [Errores en los procedimientos almacenados](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### 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\$1configuration
Configura ajustes específicos para la base de datos.
### Sintaxis
```
db2 "call rdsadmin.set_configuration(
'name',
'value')"
```
### Parameters
Se requieren los siguientes parámetros:
*name*
El nombre del ajuste de configuración. El tipo de datos es `varchar`.
*valor de*
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 el [comando RESTORE DATABASE](https://www.ibm.com/docs/en/db2/11.5?topic=commands-restore-database) en 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 el [comando RESTORE DATABASE](https://www.ibm.com/docs/en/db2/11.5?topic=commands-restore-database) en la documentación de IBM Db2. |
| `RESTORE_DATABASE_NUM_MULTI_PATHS` | El número de rutas (o secuencias de E/S) que se van a utilizar durante una operación de restauración desde Amazon S3. Para usar este ajuste de configuración, debe tener varios archivos de copia de seguridad. Este valor puede mejorar el rendimiento al restaurar bases de datos con grandes volúmenes de datos, ya que restaura varios archivos de copia de seguridad de bases de datos en paralelo. Recomendamos que establezca este valor para que coincida con el número de los archivos de copia de seguridad de base de datos. Para obtener más información, consulte el [comando BACKUP DATABASE](https://www.ibm.com/docs/en/db2/11.5?topic=commands-backup-database) en la documentación de IBM Db2. |
| `USE_STREAMING_RESTORE` | Especifica si se deben transmitir los datos de la copia de seguridad directamente durante la restauración, en lugar de descargar primero la copia de seguridad completa en la instancia de base de datos de RDS para Db2 y, a continuación, extraerla. La configuración de `USE_STREAMING_RESTORE` en `TRUE` reduce considerablemente los requisitos de almacenamiento y se puede mejorar el rendimiento de la restauración. Esta configuración requiere el motor IBM Db2 versión 11.5.9.0.sb00063198.r1 o posterior y conectividad con Amazon S3 a través de la interfaz de red elástica (ENI) de la base de datos. Para obtener más información, consulte [almacenamiento remoto](https://www.ibm.com/docs/en/db2/11.5.x?topic=databases-remote-storage) en la documentación de IBM Db2. |
### Ejemplos
**Ejemplo 1: 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')"
```
**Ejemplo 2: 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 3: especificación del número de rutas o flujos de E/S que se van a utilizar durante la restauración**
En el siguiente ejemplo, se establece la configuración `RESTORE_DATABASE_NUM_MULTI_PATHS` en `5`.
```
db2 "call rdsadmin.set_configuration(
'RESTORE_DATABASE_NUM_MULTI_PATHS',
'5')"
```
**Ejemplo 4: configuración de la restauración para transmitir datos de copia de seguridad**
En el siguiente ejemplo, se establece la configuración `USE_STREAMING_RESTORE` en `TRUE`.
```
db2 "call rdsadmin.set_configuration(
'USE_STREAMING_RESTORE',
'TRUE')"
```
## rdsadmin.show\$1configuration
Devuelve el ajuste actual que puede establecer mediante el procedimiento almacenado `rdsadmin.set_configuration`.
### Sintaxis
```
db2 "call rdsadmin.show_configuration(
'name')"
```
### Parameters
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.
+ `RESTORE_DATABASE_NUM_MULTI_PATHS`: el número de rutas (o secuencias de E/S) que se van a utilizar durante una operación de restauración desde Amazon S3.
+ `USE_STREAMING_RESTORE`: especifica si se deben transmitir los datos de la copia de seguridad directamente durante la restauración, en lugar de descargar primero la copia de seguridad completa en la instancia de base de datos de RDS para Db2 y, a continuación, extraerla.
### 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.backup\$1database
Se realiza la copia de seguridad de una base de datos de una instancia de base de datos de RDS para Db2 en un bucket de Amazon S3.
### Sintaxis
```
db2 "call rdsadmin.backup_database(
?,
'database_name',
's3_bucket_name',
's3_prefix',
'backup_type',
'compression_option',
'util_impact_priority',
'num_files',
'parallelism',
'num_buffers')"
```
### Parameters
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\$1name*
El nombre de la base de datos de destino en una instancia de base de datos de RDS para Db2 de la que se va a realizar una copia de seguridad. El tipo de datos es `varchar`.
La base de datos debe existir en la instancia de base de datos. No se puede hacer una copia de seguridad de la base de datos de `rdsadmin`.
*s3\$1bucket\$1name*
El nombre del bucket de Amazon S3 donde desea que resida la copia de seguridad. El tipo de datos es `varchar`.
El bucket de S3 debe existir antes de la llamada a `rdsadmin.backup_database`, estar en la misma Región de AWS que la base de datos de destino de la instancia de base de datos de RDS para Db2 de la que desee realizar una copia de seguridad y ser accesible a través del rol de IAM asociado a la instancia de base de datos.
*s3\$1prefix*
El prefijo de la ruta a Amazon S3, donde RDS para Db2 carga los archivos de copia de seguridad. El tipo de datos es `varchar`.
El prefijo se limita a 1024 caracteres. No debe incluir una barra inicial o final (/). Debido a una limitación con la transmisión de IBM a Amazon S3, recomendamos que el prefijo incluya subdirectorios.
Para una mejor administración de los archivos, RDS para Db2 crea directorios adicionales después de *s3\$1prefix*. RDS para Db2 carga todos los archivos de copia de seguridad en *s3\$1prefix/dbi\$1resource\$1id/db\$1name*. Si establece el *num\$1files* por encima de `1`, el directorio de *db\$1name* contendrá más de un archivo de copia de seguridad.
A continuación, se muestra un ejemplo de ubicación de Amazon S3 para los archivos de copia de seguridad. En el ejemplo, `backups/daily` es el valor establecido para el parámetro *s3\$1prefix*.
```
backups/daily/db-5N7FXOY4GDP7RG2NSH2ZTAI2W4/SAMPLEDB
```
*backup\$1type*
El tipo de copia de seguridad que determina si la base de datos permanece disponible durante la copia de seguridad. El tipo de datos es `varchar`.
Valores válidos:
+ `OFFLINE`: la base de datos no está disponible durante la copia de seguridad. Este tipo es más rápido, pero provoca tiempo de inactividad.
+ `ONLINE`: la base de datos permanece disponible durante la copia de seguridad. De forma predeterminada, `ONLINE` está establecido en `INCLUDE LOGS`.
Los siguientes parámetros son opcionales:
*compression\$1option*
El tipo de algoritmo de compresión utilizado que afecta al tiempo de copia de seguridad, al uso de la CPU y a los costos de almacenamiento. El tipo de datos es `varchar`. El valor predeterminado es `NONE`.
Valores válidos:
+ `NONE`: el tamaño de archivo más grande, el menor uso de la CPU y los costes de almacenamiento más económicos.
+ `STANDARD`: compresión de Db2 estándar. Usa `libdb2compr.so`.
+ `ZLIB`: compresión de Db2 mejorada. Usa `libdb2zcompr.so`, pero consume más CPU y el costo de almacenamiento más caro.
*util\$1impact\$1priority*
La configuración que controla el impacto de la copia de seguridad en los recursos del sistema. El tipo de datos es `integer`. Valores válidos: `1` - `100` (de menor a mayor). El valor predeterminado es `50`.
Los valores más bajos reducen el impacto de la copia de seguridad en los recursos del sistema, pero pueden aumentar el tiempo necesario para realizar la copia de seguridad de la base de datos. Los valores más altos podrían completar la copia de seguridad de la base de datos con mayor rapidez, pero podrían afectar a otras operaciones. El impacto real depende del uso general del sistema y de la configuración de `util_impact_lim`. Puede ver y modificar los ajustes de `util_impact_lim` en grupos de parámetros. Para obtener más información, consulte [Parámetros de Amazon RDS para Db2](db2-supported-parameters.md).
*num\$1files*
El número de transmisiones de carga paralelas a Amazon S3. El tipo de datos es `integer`. Valores válidos: `1`-`256`.
Le recomendamos que solo establezca este parámetro después de observar el rendimiento de la copia de seguridad en los valores predeterminados que Amazon RDS calcula automáticamente. Los valores más altos podrían mejorar el rendimiento de las copias de seguridad de gran tamaño, especialmente con conexiones de gran ancho de banda, pero en un momento determinado, los valores más altos reducen el rendimiento. Además, asegúrese de tener en cuenta los recursos del sistema disponibles y la capacidad de la red.
*paralelismo*
El número de espacios de tabla que la utilidad de copia de seguridad puede leer en paralelo. El tipo de datos es `integer`. Valores válidos: `1`-`256`.
Le recomendamos que solo establezca este parámetro después de observar el rendimiento de la copia de seguridad en los valores predeterminados que el motor de Db2 calcula automáticamente como valor óptimo. Si establece este parámetro, Amazon RDS lo valida con los procesadores disponibles y no ejecutará la solicitud de copia de seguridad si la potencia de procesamiento es insuficiente.
*num\$1buffers*
El número de búferes que se van a utilizar. El tipo de datos es `integer`. Valores válidos: `1`-`268435456`.
Le recomendamos que solo establezca este parámetro después de observar el rendimiento de la copia de seguridad en los valores predeterminados que Amazon RDS calcula automáticamente en función de la memoria. Si establece este parámetro, Amazon RDS lo valida con la memoria disponible y no ejecutará la solicitud de copia de seguridad si la memoria disponible es insuficiente. Si va a realizar copias de seguridad en varias ubicaciones (`num_files` está configurado en más de `1`), un mayor número de búferes podría mejorar el rendimiento. Si no está configurado `compression_option` en `NONE`, puede mejorar el rendimiento aumentando `num_buffers` y `parallelism`.
### Notas de uso
Este procedimiento almacenado crea tareas de copia de seguridad asíncronas que transmiten la copia de seguridad de la base de datos directamente al bucket de Amazon S3 mediante la integración de Amazon S3. Puede realizar copias de seguridad desde el servidor local o desde una instancia de base de datos de RDS para Db2, transmitirlas a Amazon S3 y, a continuación, restaurarlas cuando lo desee. Para obtener información acerca de cómo restaurar una base de datos a una instancia de base de datos de RDS para Db2, consulte [rdsadmin.restore\$1database](#db2-sp-restore-database).
Antes de llamar al procedimiento almacenado, tenga en cuenta lo siguiente:
+ Solo puede realizar la copia de seguridad de una base de datos a la vez.
+ No puede realizar una copia de seguridad y una restauración juntas en una instancia de base de datos.
+ El cifrado del servidor de Amazon S3 con AWS KMS (SSE-KMS) no se admite. Incluso si el bucket de S3 está configurado como SSE-KMS, los archivos cargados en el bucket de S3 no utilizarán el cifrado de SSE-KMS.
+ Para transmitir los archivos de copia de seguridad a Amazon S3, debe haber configurado previamente la integración. Para obtener más información, consulte [Integración de una instancia de base de datos de Amazon RDS para Db2 con Amazon S3](db2-s3-integration.md).
+ Para que una instancia de base de datos de RDS para Db2 interactúe con Amazon S3, debe tener una VPC y un punto de conexión de puerta de enlace de Amazon S3 para que lo utilicen las subredes privadas. Para obtener más información, consulte [Paso 1: crear un punto de conexión de puerta de enlace de VPC para Amazon S3](db2-troubleshooting.md#db2-creating-endpoint) y [Paso 2: confirme que existe el punto de conexión de la puerta de enlace de Amazon S3](db2-troubleshooting.md#db2-confirming-endpoint).
Antes de llamar a `rdsadmin.backup_database`, debe conectarse a la base de datos `rdsadmin`. En el siguiente ejemplo, sustituya *master\$1username* y *master\$1password* 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
```
Después de hacer una copia de seguridad de la base de datos, asegúrese de terminar la conexión.
```
terminate
```
Para obtener más información sobre cómo comprobar el estado de la copia de seguridad de una base de datos, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Para ver los mensajes de error devueltos al llamar a `rdsadmin.backup_database`, consulte [Errores en los procedimientos almacenados](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Ejemplos
Todos los ejemplos hacen una copia de seguridad de una base de datos llamada `MYDB` en el bucket de Amazon S3 llamado `amzn-s3-demo-bucket` y configuran el *s3\$1prefix* en `backups/daily`.
**Ejemplo n.º 1: especificación de una base de datos fuera de línea y no disponible con un uso medio y un único flujo de carga**
En el siguiente ejemplo, la base de datos está fuera de línea, lo que es más rápido, pero significa que la base de datos no está disponible durante la copia de seguridad. El ejemplo no comprime los archivos, tiene un impacto medio en los recursos del sistema y utiliza una única transmisión de carga a Amazon S3.
```
db2 call "rdsadmin.backup_database(
?,
'MYDB',
'amzn-s3-demo-bucket',
'backups/daily',
'OFFLINE',
'NONE',
50,
1)"
```
**Ejemplo n.º 2: especificación de una base de datos en línea y disponible con compresión mejorada, utilización media y pocos flujos de carga paralelos**
En el siguiente ejemplo, la base de datos está en línea y disponible durante la copia de seguridad. En el ejemplo se realiza una compresión mejorada, lo que se traduce en un tamaño de archivo pequeño, pero requiere un uso intensivo de la CPU. Tiene un impacto ligeramente superior a la media en los recursos del sistema y utiliza cinco flujos de carga a Amazon S3.
```
db2 call "rdsadmin.backup_database(
?,
'MYDB',
'amzn-s3-demo-bucket',
'backups/daily',
'ONLINE',
'ZLIB',
60,
5)"
```
**Ejemplo n.º 3: especificación de una base de datos sin conexión y no disponible con valores predeterminados y cálculos del sistema**
En el siguiente ejemplo, la base de datos está fuera de línea, lo que es más rápido, pero significa que la base de datos no está disponible durante la copia de seguridad. En el ejemplo, se utiliza la compresión predeterminada de los archivos, lo que afecta a los recursos del sistema. También permite a RDS para Db2 calcular el número de flujos de carga paralelos a Amazon S3, los espacios de tablas que se deben leer en paralelo y los búferes que se deben utilizar.
```
db2 "call rdsadmin.backup_database(
?,
'MYDB',
'amzn-s3-demo-bucket',
'backups/daily',
'OFFLINE')"
```
**Ejemplo n.º 4: especificación de una base de datos sin conexión y no disponible sin compresión, con una utilización alta y con cálculos personalizados**
En el siguiente ejemplo, la base de datos está fuera de línea, lo que es más rápido, pero significa que la base de datos no está disponible durante la copia de seguridad. El ejemplo no comprime los archivos, tiene un impacto alto en los recursos del sistema y utiliza 20 transmisiones de carga a Amazon S3. Establece el número máximo de espacios de tablas para leer en paralelo, lo que puede provocar que la solicitud de copia de seguridad produzca un error si la potencia de procesamiento es insuficiente. También establece el número máximo de búferes que se deben utilizar, lo que puede provocar un error en la solicitud de copia de seguridad si la memoria es insuficiente.
```
db2 "call rdsadmin.backup_database(
?,
'MYDB',
'amzn-s3-demo-bucket',
'backups/daily',
'OFFLINE',
'NONE',
90,
20,
256,
268435456)"
```
## rdsadmin.restore\$1database
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')"
```
### Parameters
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\$1name*
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\$1name* en `NEWDB`, Amazon RDS restaura `NEWDB` como la base de datos de origen.
*s3\$1bucket\$1name*
El nombre del bucket de Amazon S3 donde se almacena su copia de seguridad. El tipo de datos es `varchar`.
*s3\$1prefix*
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 procesará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\$1timestamp*
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\$1type*
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](db2-near-zero-downtime-migration.md).
### 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](db2-migration-approaches.md). 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 mayor que la base de datos de Db2 original en el disco. Si ha habilitado `USE_STREAMING_RESTORE`, cuando restaure la copia de seguridad, Amazon RDS transmite los archivos de copia de seguridad directamente desde el bucket de S3 a la instancia de base de datos de RDS para Db2. Si no habilita `USE_STREAMING_RESTORE`, 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 más la base de datos Db2 original en el disco. Para obtener más información, consulte [Insufficient disk space](db2-troubleshooting.md#restore-database-sp-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\$1prefix* `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](db2-troubleshooting.md#restore-database-sp-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](db2-troubleshooting.md#restore-database-sp-non-fenced-routines).
+ Para mejorar el rendimiento de las operaciones de restauración de bases de datos, puede configurar el número de búferes, manipuladores de búferes y el número de rutas de varias copias de seguridad que utilizará RDS. Para optimizar el uso del almacenamiento y mejorar potencialmente el rendimiento, también puede transmitir directamente una copia de seguridad desde Amazon S3. Para comprobar la configuración actual, utilice [rdsadmin.show\$1configuration](#db2-sp-show-configuration). Para cambiar la configuración, utilice [rdsadmin.set\$1configuration](#db2-sp-set-configuration).
Para poner la base de datos en línea y aplicar registros de transacciones adicionales después de restaurarla, consulte [rdsadmin.rollforward\$1database](#db2-sp-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\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Para ver los mensajes de error devueltos al llamar a `rdsadmin.restore_database`, consulte [Errores en los procedimientos almacenados](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Ejemplos
El siguiente ejemplo restaura una copia de seguridad sin conexión con uno o varios archivos que tienen el *s3\$1prefix*:`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\$1database
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\$1database](#db2-sp-restore-database).
### Sintaxis
```
db2 "call rdsadmin.rollforward_database(
?,
'database_name',
's3_bucket_name',
s3_prefix,
'rollforward_to_option',
'complete_rollforward')"
```
### Parameters
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\$1name*
Nombre de la base de datos en la que se va a realizar la operación. El tipo de datos es `varchar`.
*s3\$1bucket\$1name*
El nombre del bucket de Amazon S3 donde se almacena su copia de seguridad. El tipo de datos es `varchar`.
*s3\$1prefix*
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\$1to\$1option*
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` con la marca temporal en el formato `YYYY-MM-DD-HH.MM.SS`. El valor predeterminado es `END_OF_LOGS`.
*complete\$1rollforward*
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
Puede utilizar `rds.rollforward_database` como copia de seguridad en línea e incluir registros que se generan en las instalaciones en muchos escenarios diferentes.
**Escenario 1: restauración de la base de datos, actualización de los registros incluidos y puesta en línea de la base de datos**
Una vez completo `rdsadmin.restore_database()`, utilice la sintaxis del [Ejemplo 1](#db2-sp-rollforward-database-examples) para poner en línea la base de datos con los registros de transacciones.
**Escenario 2: puesta en línea de la base de datos, pero no actualización de los registros incluidos. **
Una vez completo `rdsadmin.restore_database()`, utilice la sintaxis del [Ejemplo 2](#db2-sp-rollforward-database-examples) para poner en línea la base de datos sin los registros de transacciones.
**Escenario 3: continuar con los registros incluidos en la copia de seguridad y aplicar registros de transacciones adicionales a medida que se producen en las instalaciones**
Una vez completo `rdsadmin.restore_database()`, utilice la sintaxis del [Ejemplo 3 o Ejemplo 4](#db2-sp-rollforward-database-examples) para recuperar los registros sin poner la base de datos en línea.
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\$1rollforward](#db2-sp-complete-rollforward).
Para obtener información sobre cómo comprobar el estado de puesta al día de una base de datos, consulte [rdsadmin.rollforward\$1status](#db2-sp-rollforward-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.rollforward\$1status
Devuelve el resultado de `ROLLFORWARD DATABASE database_name QUERY STATUS`.
### Sintaxis
```
db2 "call rdsadmin.rollforward_status(
?,
'database_name')"
```
### Parameters
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\$1name*
Nombre de la base de datos en la que se va a realizar la operación. El tipo de datos es `varchar`.
### Notas de uso
Después de llamar a [rdsadmin.rollforward\$1database](#db2-sp-rollforward-database), puede llamar a `rdsadmin.rollforward_status` para comprobar el estado de la acumulación en la base de datos.
Para obtener información sobre cómo comprobar el estado de este procedimiento almacenado, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
## rdsadmin.complete\$1rollforward
Pone en línea la base de datos desde un estado `ROLL-FORWARD PENDING`.
### Sintaxis
```
db2 "call rdsadmin.complete_rollforward(
?,
'database_name')"
```
### Parameters
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\$1name*
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\$1database](#db2-sp-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 avance, consulte [rdsadmin.rollforward\$1status](#db2-sp-rollforward-status).
### Ejemplos
El siguiente ejemplo pone la base de datos TESTDB en línea:
```
db2 "call rdsadmin.complete_rollforward(
?,
'TESTDB')"
```
## rdsadmin.db2pd\$1command
Recopila información sobre una base de datos de RDS para Db2.
### Sintaxis
```
db2 "call rdsadmin.db2pd_command('db2pd_cmd')"
```
### Parameters
El siguiente parámetro de entrada es obligatorio:
*db2pd\$1cmd*
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](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2pd-monitor-troubleshoot-db2-engine-activities) 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**
`-pages summary`Compatible con .
+ `-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](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2pd-monitor-troubleshoot-db2-engine-activities) 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\$1task\$1status](db2-user-defined-functions.md#db2-udf-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\$1application
Fuerza a las aplicaciones a salir de una base de datos de RDS para Db2.
### Sintaxis
```
db2 "call rdsadmin.force_application(
?,
'applications')"
```
### Parameters
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:
*aplicaciones*
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\$1handle*.
Separe los nombres de varias aplicaciones con comas. Ejemplo: '*application\$1handle\$11*, *application\$1handle\$12*'.
### 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](https://www.ibm.com/docs/en/db2/11.1?topic=commands-force-application) 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\$1task\$1status](db2-user-defined-functions.md#db2-udf-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\$1archive\$1log\$1retention
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')"
```
### Parameters
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\$1name*
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\$1log\$1retention\$1hours*
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 `840` (35 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\$1archive\$1log\$1retention](#db2-sp-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\$1archive\$1log\$1retention
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')"
```
### Parameters
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\$1name*
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\$1archive\$1log\$1information
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')"
```
### Parameters
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\$1name*
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')"
```
## rdsadmin.enable\$1archive\$1log\$1copy
Habilita la copia del registro de archivos de la base de datos de RDS Db2 en Amazon S3.
### Sintaxis
```
db2 "call rdsadmin.enable_archive_log_copy(
?,
'database_name')"
```
### Parameters
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\$1name*
El nombre de la base de datos para la que se habilitará la copia del registro de archivos en Amazon S3. El tipo de datos es `varchar`.
### Ejemplos
El siguiente ejemplo habilita la copia del registro de archivos para una base de datos denominada `TESTDB`.
```
db2 "call rdsadmin.enable_archive_log_copy(
?,
'TESTDB')"
```
## rdsadmin.disable\$1archive\$1log\$1copy
Deshabilita la copia del registro de archivos de la base de datos de RDS Db2 en Amazon S3.
### Sintaxis
```
db2 "call rdsadmin.disable_archive_log_copy(
?,
'database_name')"
```
### Parameters
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\$1name*
El nombre de la base de datos para la que se va a deshabilitar la copia del registro de archivos en Amazon S3. El tipo de datos es `varchar`.
### Ejemplos
El siguiente ejemplo deshabilita la copia del registro de archivos para una base de datos denominada `TESTDB`.
```
db2 "call rdsadmin.disable_archive_log_copy(
?,
'TESTDB')"
```
## rdsadmin.fgac\$1command
Ejecuta comandos de control de acceso preciso (FGAC).
### Sintaxis
```
db2 "call rdsadmin.fgac_command(
?,
'database_name',
'fgac_cmd')"
```
### Parameters
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\$1name*
El nombre de la base de datos en la que desea ejecutar comandos de FGAC. El tipo de datos es `varchar`.
*fgac\$1cmd*
El comando de control de acceso preciso que desea ejecutar. El tipo de datos es `varchar`.
Los comandos siguientes son válidos:
+ `ALTER MASK`: modifica una máscara de columna existente en el control de acceso por filas y columnas (RCAC).
+ `ALTER PERMISSION`: modifica las propiedades de un permiso de fila existente en el RCAC.
+ `ALTER SECURITY POLICY`: modifica una política de seguridad existente para el RCAC.
+ `ALTER SECURITY LABEL`: modifica las propiedades de una etiqueta de seguridad existente en el control de acceso basado en etiquetas (LBAC).
+ `ALTER TABLE`: modifica la estructura de la tabla, incluida la agregación de controles RCAC o LBAC.
+ `CREATE MASK`: crea una nueva máscara de columna para el RCAC.
+ `CREATE PERMISSION`: crea un nuevo permiso de fila para el RCAC.
+ `CREATE SECURITY LABEL`: crea una nueva etiqueta de seguridad para el LBAC.
+ `CREATE SECURITY POLICY`: crea una nueva política de seguridad para el RCAC.
+ `DROP MASK`: elimina una máscara de columna existente.
+ `DROP PERMISSION`: elimina un permiso de fila existente.
+ `DROP SECURITY LABEL`: elimina una etiqueta de seguridad del LBAC.
+ `DROP SECURITY POLICY`: elimina una política de seguridad existente del RCAC.
+ `GRANT EXEMPTION ON RULE`: permite al usuario eludir reglas específicas del LBAC.
+ `GRANT SECURITY LABEL`: asigna una etiqueta de seguridad de LBAC a un usuario.
+ `REVOKE EXEMPTION ON RULE`: elimina la exención de un usuario de las normas del LBAC.
+ `REVOKE SECURITY LABEL`: elimina una etiqueta de seguridad del LBAC de un usuario.
### Notas de uso
Este procedimiento almacenado controla el acceso por fila o columna a los datos de tabla de la base de datos en una instancia de base de datos de RDS para Db2. RDS para Db2 admite dos tipos de FGAC en la base de datos:
+ control de acceso basado en etiquetas (LBAC)
+ control de acceso por filas y columnas (RCAC)
Antes de llamar al procedimiento almacenado, tenga en cuenta lo siguiente:
+ Para evitar una comilla simple (‘), utilice una comilla simple adicional. Los siguientes ejemplos muestran cómo evitar `'apple'`, `'banana'` y `'fruit'`.
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE SECURITY LABEL COMPONENT FRUITSET SET{''apple'',''banana''}')"
```
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE SECURITY LABEL COMPONENT FRUITTREE TREE(''fruit'' ROOT, ''apple'' UNDER ''fruit'', ''banana'' UNDER ''fruit'')')"
```
+ Para evitar los corchetes ([ ]), utilice una barra invertida (\$1). En el siguiente ejemplo, se muestra cómo evitar `[''apple'',''banana'']`.
```
db2 "call rdsadmin.fgac_command(
?, '
testdb',
'CREATE SECURITY LABEL COMPONENT FRUITARRAY ARRAY\[''apple'',''banana''\]')"
```
### Ejemplos
Todos los ejemplos siguientes ejecutan comandos de FGAC en una base de datos llamada `testdb`.
**Ejemplo 1: creación de una nueva etiqueta de seguridad llamada `FRUITSET`**
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE SECURITY LABEL COMPONENT FRUITSET SET{''apple'',''banana''}')"
```
**Ejemplo 2: creación de una nueva máscara para la columna `EMP_ID` que está habilitada cuando `EMP_ID` está configurado en menos de tres**
```
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')"
```
**Ejemplo 3: creación de una nueva máscara para la columna `DEPARTMENT` que está habilitada cuando `SESSION_USER` está configurado en `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')"
```
**Ejemplo 4: creación de una nueva etiqueta de seguridad llamada `treelabel`**
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE SECURITY LABEL COMPONENT treelabel TREE(''COMPANY'' ROOT, ''HR'' UNDER ''COMPANY'', ''FINANCE'' UNDER ''COMPANY'', ''IT'' UNDER ''COMPANY'')')"
```
## rdsadmin.db2support\$1command
Recopila información de diagnóstico sobre una base de datos de RDS para Db2 y la carga en un bucket de Amazon S3.
### Sintaxis
```
db2 "call rdsadmin.db2support_command(
?,
'database_name',
's3_bucket_name',
's3_prefix')"
```
### Parameters
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\$1name*
El nombre de la base de datos para la que se recopilará la información de diagnóstico. El tipo de datos es `varchar`.
*s3\$1bucket\$1name*
El nombre del bucket de Amazon S3 donde desea cargar la información de diagnóstico. El tipo de datos es `varchar`.
*s3\$1prefix*
El prefijo de la ruta a Amazon S3, donde RDS para Db2 carga los archivos de diagnóstico. El tipo de datos es `varchar`.
### Notas de uso
Este procedimiento almacenado recopila información de diagnóstico que puede ayudar a solucionar problemas de bases de datos de RDS para Db2 y carga la información en un bucket de Amazon S3.
El procedimiento almacenado utiliza la utilidad `db2support` de IBM para recopilar datos de diagnóstico. Para obtener más información sobre la utilidad, consulte [db2support - Problem analysis and environment collection tool command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2support-problem-analysis-environment-collection-tool) en la documentación de IBM Db2.
Antes de llamar al procedimiento almacenado, tenga en cuenta lo siguiente:
+ Para subir los archivos de diagnóstico a Amazon S3, debe haber configurado previamente la integración. Para obtener más información, consulte [Integración de una instancia de base de datos de Amazon RDS para Db2 con Amazon S3](db2-s3-integration.md).
+ Para que una instancia de base de datos de RDS para Db2 interactúe con Amazon S3, debe tener una VPC y un punto de conexión de puerta de enlace de Amazon S3 para que lo utilicen las subredes privadas. Para obtener más información, consulte [Paso 1: crear un punto de conexión de puerta de enlace de VPC para Amazon S3](db2-troubleshooting.md#db2-creating-endpoint) y [Paso 2: confirme que existe el punto de conexión de la puerta de enlace de Amazon S3](db2-troubleshooting.md#db2-confirming-endpoint).
Antes de llamar a `rdsadmin.db2support_command`, debe conectarse a la base de datos `rdsadmin`. En el siguiente ejemplo, sustituya *master\$1username* y *master\$1password* 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 información sobre cómo comprobar el estado de la recopilación de información de diagnóstico, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Ejemplos
**Ejemplo 1: Recopilación de información de diagnóstico para una base de datos**
El siguiente ejemplo recopila la información de diagnóstico de una base de datos denominada `TESTDB` y la carga en el bucket de Amazon S3 denominado `amzn-s3-demo-bucket` con el prefijo `diagnostics/testdb`:
```
db2 "call rdsadmin.db2support_command(
?,
'TESTDB',
'amzn-s3-demo-bucket',
'diagnostics/testdb')"
```
**Ejemplo 2: Recopilación de información de diagnóstico con un prefijo basado en fecha**
El siguiente ejemplo recopila la información de diagnóstico de una base de datos denominada `MYDB` y la carga en el bucket de Amazon S3 denominado `amzn-s3-demo-bucket` con un prefijo basado en fecha:
```
db2 "call rdsadmin.db2support_command(
?,
'MYDB',
'amzn-s3-demo-bucket',
'support/2024/01/15')"
```