# Procedimientos almacenados de grupos de búferes de RDS para Db2
<a name="db2-sp-managing-buffer-pools"></a>

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.
+ [Tareas comunes para grupos de búferes](db2-managing-buffer-pools.md)
+ [Generación de informes de rendimiento](db2-managing-databases.md#db2-generating-performance-reports)
+ [Copia de metadatos de bases de datos con db2look](db2-native-db2-tools-db2look.md)
+ [Creación de una base de datos de repositorios para IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md#db2-creating-repo-db-monitoring-dmc)

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

**Topics**
+ [rdsadmin.create\$1bufferpool](#db2-sp-create-buffer-pool)
+ [rdsadmin.alter\$1bufferpool](#db2-sp-alter-buffer-pool)
+ [rdsadmin.drop\$1bufferpool](#db2-sp-drop-buffer-pool)

## rdsadmin.create\$1bufferpool
<a name="db2-sp-create-buffer-pool"></a>

Crea un grupo de búferes.

### Sintaxis
<a name="db2-sp-create-buffer-pool-syntax"></a>

```
db2 "call rdsadmin.create_bufferpool(
    'database_name', 
    'buffer_pool_name', 
    buffer_pool_size, 
    'immediate', 
    'automatic', 
    page_size, 
    number_block_pages, 
    block_size)"
```

### Parameters
<a name="db2-sp-create-buffer-pool-parameters"></a>

Se requieren los siguientes parámetros:

*database\$1name*  
Nombre de la base de datos en la que se va a ejecutar el comando. El tipo de datos es `varchar`.

*buffer\$1pool\$1name*  
Nombre del grupo de búferes que se va a crear. El tipo de datos es `varchar`.

Los siguientes parámetros son opcionales:

*buffer\$1pool\$1size*  
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 es `Y`.

*automatic*  
Especifica si el grupo de búferes se va a configurar como automático. El tipo de datos es `char`. El valor predeterminado es `Y`.

*page\$1size*  
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 es `8192`.

*number\$1block\$1pages*  
El número de páginas de bloques en los grupos de búferes. El tipo de datos es `integer`. El valor predeterminado es `0`.

*block\$1size*  
El tamaño de bloque de las páginas de bloques. El tipo de datos es `integer`. Valores válidos: de `2` a `256`. El valor predeterminado es `32`.

### Notas de uso
<a name="db2-sp-create-buffer-pool-usage-notes"></a>

Para obtener más información sobre cómo comprobar el estado de creación de un grupo de búferes, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

### Ejemplos
<a name="db2-sp-create-buffer-pool-examples"></a>

**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\$1bufferpool
<a name="db2-sp-alter-buffer-pool"></a>

Modifica un grupo de búferes.

### Sintaxis
<a name="db2-sp-alter-buffer-pool-syntax"></a>

```
db2 "call rdsadmin.alter_bufferpool(
    'database_name', 
    'buffer_pool_name', 
    buffer_pool_size, 
    'immediate', 
    'automatic', 
    change_number_blocks, 
    number_block_pages, 
    block_size)"
```

### Parameters
<a name="db2-sp-alter-buffer-pool-parameters"></a>

Se requieren los siguientes parámetros:

*database\$1name*  
Nombre de la base de datos en la que se va a ejecutar el comando. El tipo de datos es `varchar`.

*buffer\$1pool\$1name*  
Nombre del grupo de búferes que se va a modificar. El tipo de datos es `varchar`.

*buffer\$1pool\$1size*  
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 es `Y`.

*automatic*  
Especifica si el grupo de búferes se va a configurar como automático. El tipo de datos es `char`. El valor predeterminado es `N`.

*change\$1number\$1blocks*  
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 es `N`.

*number\$1block\$1pages*  
El número de páginas de bloques en los grupos de búferes. El tipo de datos es `integer`. El valor predeterminado es `0`.

*block\$1size*  
El tamaño de bloque de las páginas de bloques. El tipo de datos es `integer`. Valores válidos: de `2` a `256`. El valor predeterminado es `32`.

### Notas de uso
<a name="db2-sp-alter-buffer-pool-usage-notes"></a>

Para obtener más información sobre cómo comprobar el estado de modificación de un grupo de búferes, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

### Ejemplos
<a name="db2-sp-alter-buffer-pool-examples"></a>

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\$1bufferpool
<a name="db2-sp-drop-buffer-pool"></a>

Elimina un grupo de búferes.

### Sintaxis
<a name="db2-sp-drop-buffer-pool-syntax"></a>

```
db2 "call rdsadmin.drop_bufferpool(
    'database_name', 
    'buffer_pool_name'"
```

### Parameters
<a name="db2-sp-drop-buffer-pool-parameters"></a>

Se requieren los siguientes parámetros:

*database\$1name*  
El nombre de la base de datos a la que pertenece el grupo de búferes. El tipo de datos es `varchar`.

*buffer\$1pool\$1name*  
Nombre del grupo de búferes que se va a eliminar. El tipo de datos es `varchar`.

### Notas de uso
<a name="db2-sp-drop-buffer-pool-usage-notes"></a>

Para obtener más información sobre cómo comprobar el estado de eliminación de un grupo de búferes, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

### Ejemplos
<a name="db2-sp-drop-buffer-pool-examples"></a>

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