Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Procédures stockées pour les groupes de mémoires tampons pour RDS for Db2
Les procédures stockées intégrées décrites dans cette rubrique gèrent les groupes de mémoires tampons pour les bases de données Amazon RDS for Db2. Pour exécuter ces procédures, l’utilisateur principal doit d’abord se connecter à la base de données `rdsadmin`.
Ces procédures stockées sont utilisées dans diverses tâches. Cette liste n’est pas exhaustive.
+ [Tâches courantes pour les pools de mémoires tampons](db2-managing-buffer-pools.md)
+ [Génération de rapports de performance](db2-managing-databases.md#db2-generating-performance-reports)
+ [Copie des métadonnées d’une base de données avec db2look](db2-native-db2-tools-db2look.md)
+ [Création d’une base de données de référentiel pour IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md#db2-creating-repo-db-monitoring-dmc)
Reportez-vous aux procédures stockées intégrées suivantes pour obtenir des informations sur leur syntaxe, leurs paramètres, leurs notes d’utilisation et des exemples.
**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
Crée un groupe de mémoires tampons.
### Syntaxe
```
db2 "call rdsadmin.create_bufferpool(
'database_name',
'buffer_pool_name',
buffer_pool_size,
'immediate',
'automatic',
page_size,
number_block_pages,
block_size)"
```
### Parameters
Les paramètres suivants sont obligatoires :
*database\$1name*
Nom de la base de données sur laquelle la commande doit être exécutée. Le type de données est `varchar`.
*buffer\$1pool\$1name*
Nom du groupe de mémoires tampons à créer. Le type de données est `varchar`.
Les paramètres suivants sont facultatifs :
*buffer\$1pool\$1size*
Taille du groupe de mémoires tampons en nombre de pages. Le type de données est `integer`. La valeur par défaut est `-1`.
*immediate*
Spécifie si la commande s’exécute immédiatement. Le type de données est `char`. La valeur par défaut est `Y`.
*automatic*
Spécifie s’il faut définir le groupe de mémoires tampons sur automatique. Le type de données est `char`. La valeur par défaut est `Y`.
*page\$1size*
Taille de la page du groupe de mémoires tampons. Le type de données est `integer`. Valeurs valides: `4096`, `8192`, `16384`, `32768`. La valeur par défaut est `8192`.
*number\$1block\$1pages*
Nombre de pages de blocs dans les groupes de mémoires tampons. Le type de données est `integer`. La valeur par défaut est `0`.
*block\$1size*
Taille de bloc pour les pages de blocs. Le type de données est `integer`. Valeurs valides : `2` à `256`. La valeur par défaut est `32`.
### Notes d’utilisation
Pour plus d’informations sur la vérification du statut de création d’un groupe de mémoires tampons, consultez [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Exemples
**Exemple 1 : création d’un groupe de mémoires tampons avec des paramètres par défaut**
L’exemple suivant crée un groupe de mémoires tampons appelé `BP8` pour une base de données appelée `TESTDB` avec des paramètres par défaut, de sorte que le groupe de mémoires tampons utilise une taille de page de 8 Ko.
```
db2 "call rdsadmin.create_bufferpool(
'TESTDB',
'BP8')"
```
**Exemple 2 : création d’un groupe de mémoires tampons à exécuter immédiatement avec allocation automatique**
L’exemple suivant crée un groupe de mémoires tampons appelé `BP16` pour une base de données appelée `TESTDB` qui utilise une taille de page de 16 Ko avec un nombre de pages initial de 1 000 et qui est défini sur automatique. Db2 exécute la commande immédiatement. Si vous utilisez un nombre de pages initial de -1, Db2 utilisera l’allocation automatique des pages.
```
db2 "call rdsadmin.create_bufferpool(
'TESTDB',
'BP16',
1000,
'Y',
'Y',
16384)"
```
**Exemple 3 : création d’un groupe de mémoires tampons à exécuter immédiatement à l’aide de pages de blocs**
L’exemple suivant crée un groupe de mémoires tampons appelé `BP16` pour une base de données appelée `TESTDB`. Ce groupe de mémoires tampons a une taille de page de 16 Ko avec un nombre de pages initial de 10 000. Db2 exécute immédiatement la commande en utilisant 500 pages de blocs d’une taille de bloc de 512.
```
db2 "call rdsadmin.create_bufferpool(
'TESTDB',
'BP16',
10000,
'Y',
'Y',
16384,
500,
512)"
```
## rdsadmin.alter\$1bufferpool
Modifie un groupe de mémoires tampons.
### Syntaxe
```
db2 "call rdsadmin.alter_bufferpool(
'database_name',
'buffer_pool_name',
buffer_pool_size,
'immediate',
'automatic',
change_number_blocks,
number_block_pages,
block_size)"
```
### Parameters
Les paramètres suivants sont obligatoires :
*database\$1name*
Nom de la base de données sur laquelle la commande doit être exécutée. Le type de données est `varchar`.
*buffer\$1pool\$1name*
Nom du groupe de mémoires tampons à modifier. Le type de données est `varchar`.
*buffer\$1pool\$1size*
Taille du groupe de mémoires tampons en nombre de pages. Le type de données est `integer`.
Les paramètres suivants sont facultatifs :
*immediate*
Spécifie si la commande s’exécute immédiatement. Le type de données est `char`. La valeur par défaut est `Y`.
*automatic*
Spécifie s’il faut définir le groupe de mémoires tampons sur automatique. Le type de données est `char`. La valeur par défaut est `N`.
*change\$1number\$1blocks*
Indique si le nombre de pages de blocs dans le groupe de mémoires tampons a été modifié. Le type de données est `char`. La valeur par défaut est `N`.
*number\$1block\$1pages*
Nombre de pages de blocs dans les groupes de mémoires tampons. Le type de données est `integer`. La valeur par défaut est `0`.
*block\$1size*
Taille de bloc pour les pages de blocs. Le type de données est `integer`. Valeurs valides : `2` à `256`. La valeur par défaut est `32`.
### Notes d’utilisation
Pour plus d’informations sur la vérification du statut de modification d’un groupe de mémoires tampons, consultez [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Exemples
L’exemple suivant modifie un groupe de mémoires tampons appelé `BP16` pour une base de données appelée `TESTDB` en non automatique et modifie la taille à 10 000 pages. Db2 exécute cette commande immédiatement.
```
db2 "call rdsadmin.alter_bufferpool(
'TESTDB',
'BP16',
10000,
'Y',
'N')"
```
## rdsadmin.drop\$1bufferpool
Supprime un groupe de mémoires tampons.
### Syntaxe
```
db2 "call rdsadmin.drop_bufferpool(
'database_name',
'buffer_pool_name'"
```
### Parameters
Les paramètres suivants sont obligatoires :
*database\$1name*
Nom de la base de données à laquelle appartient le groupe de mémoires tampons. Le type de données est `varchar`.
*buffer\$1pool\$1name*
Nom du groupe de mémoires tampons à supprimer. Le type de données est `varchar`.
### Notes d’utilisation
Pour plus d’informations sur la vérification du statut de suppression d’un groupe de mémoires tampons, consultez [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Exemples
L’exemple suivant supprime un groupe de mémoires tampons appelé `BP16` pour une base de données appelée `TESTDB`.
```
db2 "call rdsadmin.drop_bufferpool(
'TESTDB',
'BP16')"
```