Procédures stockées pour les tablespaces pour RDS for Db2 - Amazon Relational Database Service
rdsadmin.create_tablespacerdsadmin.alter_tablespacerdsadmin.rename_tablespacerdsadmin.drop_tablespace

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.

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.

rdsadmin.create_tablespace

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

Paramètres

Les paramètres suivants sont obligatoires :

database_name

Nom de la table de base de données dans laquelle créer le tablespace. Le type de données est varchar.

tablespace_name

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_pool_name

Nom du pool de mémoires tampons à attribuer au tablespace. Le type de données est varchar. La valeur par défaut est une chaîne vide.

Important

Vous devez déjà disposer d’un pool de mémoires tampons de la même taille de page à associer au tablespace.

tablespace_page_size

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_database.

Important

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 de 32 Kio, nous vous recommandons d’activer la reprise ponctuelle et les sauvegardes automatiques. Sinon, vous risquez de ne pas pouvoir récupérer les pages déchirées. Pour plus d’informations, consultez Présentation des sauvegardes et Restauration d’une instance de base de données à un instant précis pour Amazon RDS.

tablespace_initial_size

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.

Note

Ce paramètre ne s’applique pas aux tablespaces temporaires, car le système gère les tablespaces temporaires.

tablespace_increase_size

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.

Note

Ce paramètre ne s’applique pas aux tablespaces temporaires, car le système gère les tablespaces temporaires.

tablespace_type

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_prefetch_size

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_task_status.

Exemples

Exemple 1 : création d’un tablespace et attribution d’un pool de mémoires tampons

L’exemple suivant crée un pool de mémoires tampons appelé SP8 et attribue un pool 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 pool de mémoires tampons

L’exemple suivant crée un tablespace temporaire nommé SP8. Il attribue un pool 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_tablespace

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

Paramètres

Les paramètres suivants sont obligatoires :

database_name

Nom de la base de données qui utilise le tablespace. Le type de données est varchar.

tablespace_name

Nom du tablespace à modifier. Le type de données est varchar.

Les paramètres suivants sont facultatifs :

buffer_pool_name

Nom du pool de mémoires tampons à attribuer au tablespace. Le type de données est varchar. La valeur par défaut est une chaîne vide.

Important

Vous devez déjà disposer d’un pool de mémoires tampons de la même taille de page à associer au tablespace.

tablespace_increase_size

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_size

Taille maximale du tablespace. Le type de données est varchar. Valeurs valides : nombre entier K | M | G ou NONE. La valeur par défaut est NONE.

reduce_max

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_stop

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_value

Le nombre ou le pourcentage à appliquer pour réduire la limite supérieure du tablespace. Le type de données est varchar. Valeurs valides : nombre entier K| M | G ou 1–100. La valeur par défaut est N.

lower_high_water

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_high_water_stop

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_online

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_prefetch_size

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.

Note

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.

Pour plus d’informations sur la vérification du statut de modification d’un tablespace, consultez rdsadmin.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.

Exemples

Exemple 1 : abaissement de la limite supérieure

L’exemple suivant modifier un tablespace appelé SP8 et attribue un pool 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_tablespace

Renomme un tablespace.

Syntaxe

db2 "call rdsadmin.rename_tablespace(
    ?,
    'database_name', 
    'source_tablespace_name',
    'target_tablespace_name')"

Paramètres

Les paramètres suivants sont obligatoires :

?

Marqueur de paramètre qui génère un message d’erreur. Ce paramètre accepte uniquement ?.

database_name

Nom de la base de données à laquelle le tablespace appartient. Le type de données est varchar.

source_tablespace_name

Nom du tablespace à renommer. Le type de données est varchar.

target_tablespace_name

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_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_tablespace

Supprime un tablespace.

Syntaxe

db2 "call rdsadmin.drop_tablespace(
    'database_name', 
    'tablespace_name')"

Paramètres

Les paramètres suivants sont obligatoires :

database_name

Nom de la base de données à laquelle le tablespace appartient. Le type de données est varchar.

tablespace_name

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