Procedimientos almacenados de grupos de búferes de RDS para Db2
Los procedimientos almacenados integrados que se describen en este tema administran grupos de búferes para 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.
Procedimientos almacenados
rdsadmin.create_bufferpool
Crea un grupo de búferes.
Sintaxis
db2 "call rdsadmin.create_bufferpool( 'database_name', 'buffer_pool_name',buffer_pool_size, 'immediate', 'automatic',page_size,number_block_pages,block_size)"
Parámetros
Se requieren los siguientes parámetros:
database_name-
Nombre de la base de datos en la que se va a ejecutar el comando. El tipo de datos es
varchar. buffer_pool_name-
Nombre del grupo de búferes que se va a crear. El tipo de datos es
varchar.
Los siguientes parámetros son opcionales:
buffer_pool_size-
El tamaño del grupo de búferes en número de páginas. El tipo de datos es
integer. El valor predeterminado es-1. immediate-
Especifica si el comando se ejecuta inmediatamente. El tipo de datos es
char. El valor predeterminado esY. automatic-
Especifica si el grupo de búferes se va a configurar como automático. El tipo de datos es
char. El valor predeterminado esY. page_size-
El tamaño de página del grupo de búferes El tipo de datos es
integer. Valores válidos:4096,8192,16384,32768. El valor predeterminado es8192. number_block_pages-
El número de páginas de bloques en los grupos de búferes. El tipo de datos es
integer. El valor predeterminado es0. block_size-
El tamaño de bloque de las páginas de bloques. El tipo de datos es
integer. Valores válidos: de2a256. El valor predeterminado es32.
Notas de uso
Para obtener más información sobre cómo comprobar el estado de creación de un grupo de búferes, consulte rdsadmin.get_task_status.
Ejemplos
Ejemplo 1: Crear un conjunto de búferes con los parámetros predeterminados
El siguiente ejemplo crea un grupo de búferes llamado BP8 para una base de datos llamada TESTDB con los parámetros predeterminados, de modo que el grupo de búferes utiliza un tamaño de página de 8 KB.
db2 "call rdsadmin.create_bufferpool( 'TESTDB', 'BP8')"
Ejemplo 2: Crear un grupo de búferes para que se ejecute inmediatamente sin asignación automática
En el siguiente ejemplo, se crea un grupo de búferes denominado BP16 para una base de datos denominada TESTDB que utiliza un tamaño de página de 16 KB con un recuento inicial de páginas de 1000 y se establece en automático. Db2 ejecuta el comando inmediatamente. Si utiliza un recuento inicial de páginas de -1, Db2 utilizará la asignación automática de páginas.
db2 "call rdsadmin.create_bufferpool( 'TESTDB', 'BP16', 1000, 'Y', 'Y', 16384)"
Ejemplo 3: Crear un grupo de búferes para que se ejecute de forma inmediata mediante páginas de bloques
En el siguiente ejemplo, se crea un grupo de búferes llamado BP16 para una base de datos llamada TESTDB. Este grupo de búferes tiene un tamaño de página de 16 KB con un recuento inicial de 10 000 páginas. Db2 ejecuta el comando inmediatamente utilizando 500 páginas de bloque con un tamaño de bloque de 512.
db2 "call rdsadmin.create_bufferpool( 'TESTDB', 'BP16', 10000, 'Y', 'Y', 16384, 500, 512)"
rdsadmin.alter_bufferpool
Modifica un grupo de búferes.
Sintaxis
db2 "call rdsadmin.alter_bufferpool( 'database_name', 'buffer_pool_name',buffer_pool_size, 'immediate', 'automatic',change_number_blocks,number_block_pages,block_size)"
Parámetros
Se requieren los siguientes parámetros:
database_name-
Nombre de la base de datos en la que se va a ejecutar el comando. El tipo de datos es
varchar. buffer_pool_name-
Nombre del grupo de búferes que se va a modificar. El tipo de datos es
varchar. buffer_pool_size-
El tamaño del grupo de búferes en número de páginas. El tipo de datos es
integer.
Los siguientes parámetros son opcionales:
immediate-
Especifica si el comando se ejecuta inmediatamente. El tipo de datos es
char. El valor predeterminado esY. automatic-
Especifica si el grupo de búferes se va a configurar como automático. El tipo de datos es
char. El valor predeterminado esN. change_number_blocks-
Especifica si se ha producido un cambio en el número de páginas de bloques del conjunto de búferes. El tipo de datos es
char. El valor predeterminado esN. number_block_pages-
El número de páginas de bloques en los grupos de búferes. El tipo de datos es
integer. El valor predeterminado es0. block_size-
El tamaño de bloque de las páginas de bloques. El tipo de datos es
integer. Valores válidos: de2a256. El valor predeterminado es32.
Notas de uso
Para obtener más información sobre cómo comprobar el estado de modificación de un grupo de búferes, consulte rdsadmin.get_task_status.
Ejemplos
En el siguiente ejemplo, se modifica un grupo de búferes llamado BP16 para una base de datos llamada TESTDB a no automático y se cambia el tamaño a 10 000 páginas. Db2 ejecuta este comando inmediatamente.
db2 "call rdsadmin.alter_bufferpool( 'TESTDB', 'BP16', 10000, 'Y', 'N')"
rdsadmin.drop_bufferpool
Elimina un grupo de búferes.
Sintaxis
db2 "call rdsadmin.drop_bufferpool( 'database_name', 'buffer_pool_name'"
Parámetros
Se requieren los siguientes parámetros:
database_name-
El nombre de la base de datos a la que pertenece el grupo de búferes. El tipo de datos es
varchar. buffer_pool_name-
Nombre del grupo de búferes que se va a eliminar. El tipo de datos es
varchar.
Notas de uso
Para obtener más información sobre cómo comprobar el estado de eliminación de un grupo de búferes, consulte rdsadmin.get_task_status.
Ejemplos
El siguiente ejemplo elimina un grupo de búferes llamado BP16 para una base de datos llamada TESTDB.
db2 "call rdsadmin.drop_bufferpool( 'TESTDB', 'BP16')"
