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 tablespaces pour RDS for Db2
Les procédures stockées intégrées décrites dans cette rubrique gèrent les tablespaces 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 tablespaces](db2-managing-tablespaces.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\$1tablespace](#db2-sp-create-tablespace)
+ [rdsadmin.alter\$1tablespace](#db2-sp-alter-tablespace)
+ [rdsadmin.rename\$1tablespace](#db2-sp-rename-tablespace)
+ [rdsadmin.drop\$1tablespace](#db2-sp-drop-tablespace)
## rdsadmin.create\$1tablespace
Crée un tablespace.
### Syntaxe
```
db2 "call rdsadmin.create_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_page_size,
tablespace_initial_size,
tablespace_increase_size,
'tablespace_type',
'tablespace_prefetch_size')"
```
### Parameters
Les paramètres suivants sont obligatoires :
*database\$1name*
Nom de la table de base de données dans laquelle créer le tablespace. Le type de données est `varchar`.
*tablespace\$1name*
Nom du tablespace à créer. Le type de données est `varchar`.
Le nom du tablespace présente les restrictions suivantes :
+ Ce nom ne peut pas être identique à celui d’un tablespace existant dans cette base de données.
+ Il ne peut contenir que les caractères `_$#@a-zA-Z0-9`.
+ Il ne peut pas commencer par `_` ou `$`.
+ Il ne peut pas commencer par `SYS`.
Les paramètres suivants sont facultatifs :
*buffer\$1pool\$1name*
Nom du groupe de mémoires tampons à attribuer au tablespace. Le type de données est `varchar`. La valeur par défaut est une chaîne vide.
Vous devez déjà disposer d’un groupe de mémoires tampons de la même taille de page à associer au tablespace.
*tablespace\$1page\$1size*
Taille de page du tablespace en octets. Le type de données est `integer`. Valeurs valides: `4096`, `8192`, `16384`, `32768`. La taille de page par défaut est celle utilisée lorsque vous avez créé la base de données en appelant [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).
Amazon RDS prend en charge l’atomicité d’écriture pour les pages de 4 Kio, 8 Kio et 16 Kio. En revanche, les pages de 32 Kio risquent des écritures déchirées ou des données partielles écrites sur le bureau. Si vous utilisez des pages 32 KiB, nous vous recommandons d'activer la point-in-time restauration et les sauvegardes automatisées. Sinon, vous risquez de ne pas pouvoir récupérer les pages déchirées. Pour plus d’informations, consultez [Présentation des sauvegardes](USER_WorkingWithAutomatedBackups.md) et [Restauration d’une instance de base de données à un instant précis pour Amazon RDS](USER_PIT.md).
*tablespace\$1initial\$1size*
Taille initiale du tablespace en kilo-octets (Ko). Le type de données est `integer`. Valeurs valides : `48` ou plus. La valeur par défaut est NULL.
Si vous ne définissez aucune valeur, Db2 définit une valeur appropriée pour vous.
Ce paramètre ne s’applique pas aux tablespaces temporaires, car le système gère les tablespaces temporaires.
*tablespace\$1increase\$1size*
Pourcentage d’augmentation du tablespace lorsqu’il est plein. Le type de données est `integer`. Valeurs valides : `1` - `100`. La valeur par défaut est NULL.
Si vous ne définissez aucune valeur, Db2 définit une valeur appropriée pour vous.
Ce paramètre ne s’applique pas aux tablespaces temporaires, car le système gère les tablespaces temporaires.
*tablespace\$1type*
Taille du tablespace. Le type de données est `char`. Valeurs valides : `U` (pour les données utilisateur), `T` (pour les données temporaires de l’utilisateur) ou `S` (pour les données temporaires du système). La valeur par défaut est `U`.
*tablespace\$1prefetch\$1size*
Taille de page prefetch en octets. Le type de données est `char`. Valeurs valides : `AUTOMATIC` (insensible à la casse) ou entiers positifs non nuls inférieurs ou égaux à 32767.
### Notes d’utilisation
RDS for Db2 crée toujours une base de données volumineuse.
Pour plus d’informations sur la vérification du statut de création d’un tablespace, consultez [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Exemples
**Exemple 1 : création d’un tablespace et attribution d’un groupe de mémoires tampons**
L’exemple suivant crée un groupe de mémoires tampons appelé `SP8` et attribue un groupe de mémoires tampons appelé `BP8` pour une base de données appelée `TESTDB`. Le tablespace a une taille de page initiale de 4 096 octets, un tablespace initial de 1 000 Ko et une augmentation de taille de table définie à 50 %.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
'BP8',
4096,
1000,
50)"
```
**Exemple 2 : création d’un tablespace temporaire et attribution d’un groupe de mémoires tampons**
L’exemple suivant crée un tablespace temporaire nommé `SP8`. Il attribue un groupe de mémoires tampons appelé `BP8` d’une taille de 8 Kio pour une base de données appelée `TESTDB`.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
'BP8',
8192,
NULL,
NULL,
'T')"
```
**Exemple 3 : création d’un tablespace et attribution d’une taille de page prefetch**
L’exemple suivant crée un tablespace appelé `SP8` pour une base de données appelée `TESTDB`. Le tablespace a une taille initiale d’augmentation de `50` et une taille de page prefetch de `800`.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
NULL,
NULL,
NULL,
50,
NULL,
'800')"
```
## rdsadmin.alter\$1tablespace
Modifie un tablespace.
### Syntaxe
```
db2 "call rdsadmin.alter_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_increase_size,
'max_size',
'reduce_max',
'reduce_stop',
'reduce_value',
'lower_high_water',
'lower_high_water_stop',
'switch_online',
'tablespace_prefetch_size')"
```
### Parameters
Les paramètres suivants sont obligatoires :
*database\$1name*
Nom de la base de données qui utilise le tablespace. Le type de données est `varchar`.
*tablespace\$1name*
Nom du tablespace à modifier. Le type de données est `varchar`.
Les paramètres suivants sont facultatifs :
*buffer\$1pool\$1name*
Nom du groupe de mémoires tampons à attribuer au tablespace. Le type de données est `varchar`. La valeur par défaut est une chaîne vide.
Vous devez déjà disposer d’un groupe de mémoires tampons de la même taille de page à associer au tablespace.
*tablespace\$1increase\$1size*
Pourcentage d’augmentation du tablespace lorsqu’il est plein. Le type de données est `integer`. Valeurs valides : `1` - `100`. La valeur par défaut est `0`.
*max\$1size*
Taille maximale du tablespace. Le type de données est `varchar`. Valeurs valides : *integer* `K` `M` \$1 \$1 `G` ou`NONE`. La valeur par défaut est `NONE`.
*reduce\$1max*
Indique s’il faut réduire la limite supérieur à sa limite maximale. Le type de données est `char`. La valeur par défaut est `N`.
*reduce\$1stop*
Indique s’il faut interrompre une commande `reduce_max` ou `reduce_value` précédente. Le type de données est `char`. La valeur par défaut est `N`.
*reduce\$1value*
Le nombre ou le pourcentage à appliquer pour réduire la limite supérieure du tablespace. Le type de données est `varchar`. Valeurs valides : *integer* `K` `M` \$1 \$1 `G` ou `1` —`100`. La valeur par défaut est `N`.
*lower\$1high\$1water*
Indique s’il faut exécuter la commande `ALTER TABLESPACE LOWER HIGH WATER MARK`. Le type de données est `char`. La valeur par défaut est `N`.
*lower\$1high\$1water\$1stop*
Indique s’il faut exécuter la commande `ALTER TABLESPACE LOWER HIGH WATER MARK STOP`. Le type de données est `char`. La valeur par défaut est `N`.
*switch\$1online*
Indique s’il faut exécuter la commande `ALTER TABLESPACE SWITCH ONLINE`. Le type de données est `char`. La valeur par défaut est `N`.
*tablespace\$1prefetch\$1size*
Taille de page prefetch en octets. Le type de données est `char`. Valeurs valides : `AUTOMATIC` (insensible à la casse) ou entiers positifs non nuls inférieurs ou égaux à 32767.
Ce paramètre ne fonctionne qu’avec `buffer_pool_name`, `table_increase_size`, `max_size` et `switch_online`. Il ne fonctionne pas avec `reduce_max`, `reduce_stop`, `reduce_value`, `lower_high_water` et `lower_high_water_stop`.
### Notes d’utilisation
Avant d’appeler la procédure stockée, passez en revue les considérations suivantes :
+ La procédure stockée `rdsadmin.alter_tablespace` ne fonctionnera pas sur un tablespace avec `tablespace_type` défini sur `T` pour les données temporaires de l’utilisateur.
+ Les paramètres facultatifs `reduce_max`, `reduce_stop`, `reduce_value`, `lower_high_water`, `lower_high_water_stop` et `switch_online` s’excluent mutuellement. Vous ne pouvez pas les combiner avec d’autres paramètres facultatifs, tels que `buffer_pool_name` dans la commande `rdsadmin.alter_tablespace`. Pour plus d’informations, consultez [Statement not valid](db2-troubleshooting.md#alter-tablespace-sp-statement-not-valid).
Pour plus d’informations sur la vérification du statut de modification d’un tablespace, consultez [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Pour les messages d’erreur renvoyés lors de l’appel de procédures stockées, consultez [Erreurs de procédure stockée](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Exemples
**Exemple 1 : abaissement de la limite supérieure**
L’exemple suivant modifier un tablespace appelé `SP8` et attribue un groupe de mémoires tampons appelé `BP8` pour une base de données appelée `TESTDB` afin d’abaisser la limite supérieure.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'SP8',
'BP8',
NULL,
NULL,
'Y')"
```
**Exemple 2 : réduction de la limite supérieure**
L’exemple suivant exécute la commande `REDUCE MAX` sur un tablespace appelé `TBSP_TEST` dans la base de données `TESTDB`.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
'Y')"
```
**Exemple 3 : interruption des commandes pour réduire la limite supérieure**
L’exemple suivant exécute la commande `REDUCE STOP` sur un tablespace appelé `TBSP_TEST` dans la base de données `TESTDB`.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
NULL,
'Y')"
```
**Exemple 4 : modification de la taille de page prefetch existante**
L’exemple suivant exécute la commande `ALTER TABLESPACE SWITCH ONLINE` sur un tablespace appelé `TSBP_TEST` et modifie la taille de page prefetch existante en `64`.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
‘Y’,
‘64’)"
```
## rdsadmin.rename\$1tablespace
Renomme un tablespace.
### Syntaxe
```
db2 "call rdsadmin.rename_tablespace(
?,
'database_name',
'source_tablespace_name',
'target_tablespace_name')"
```
### Parameters
Les paramètres suivants sont obligatoires :
?
Marqueur de paramètre qui génère un message d’erreur. Ce paramètre accepte uniquement ?.
*database\$1name*
Nom de la base de données à laquelle le tablespace appartient. Le type de données est `varchar`.
*source\$1tablespace\$1name*
Nom du tablespace à renommer. Le type de données est `varchar`.
*target\$1tablespace\$1name*
Nom du nouveau tablespace. Le type de données est `varchar`.
Le nouveau nom présente les restrictions suivantes :
+ Ce nom ne peut pas être identique à celui d’un tablespace existant.
+ Il ne peut contenir que les caractères `_$#@a-zA-Z0-9`.
+ Il ne peut pas commencer par `_` ou `$`.
+ Il ne peut pas commencer par `SYS`.
### Notes d’utilisation
Pour plus d’informations sur la vérification du statut de modification du nom d’un tablespace, consultez [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Vous ne pouvez pas renommer les tablespaces appartenant à la base de données `rdsadmin`.
### Exemples
L’exemple suivant renomme un tablespace appelé `SP8` en `SP9` pour une base de données appelée `TESTDB`.
```
db2 "call rdsadmin.rename_tablespace(
?,
'TESTDB',
'SP8',
'SP9')"
```
## rdsadmin.drop\$1tablespace
Supprime un tablespace.
### Syntaxe
```
db2 "call rdsadmin.drop_tablespace(
'database_name',
'tablespace_name')"
```
### Parameters
Les paramètres suivants sont obligatoires :
*database\$1name*
Nom de la base de données à laquelle le tablespace appartient. Le type de données est `varchar`.
*tablespace\$1name*
Nom du tablespace à 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 tablespace, consultez [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Exemples
L’exemple suivant crée un tablespace appelé `SP8` à partir d’une base de données appelée `TESTDB`.
```
db2 "call rdsadmin.drop_tablespace(
'TESTDB',
'SP8')"
```