Procédures stockées pour les espaces de table pour RDS pour 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 espaces de table pour RDS pour Db2

Les procédures stockées intégrées décrites dans cette rubrique gèrent les espaces de table 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 rdsadmin base de données.

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 base de données dans laquelle créer le tablespace. Le type de données estvarchar.

tablespace_name

Nom du tablespace à créer. Le type de données estvarchar.

Le nom du tablespace est soumis aux restrictions suivantes :

  • Il ne peut pas être identique au nom d'un tablespace existant dans cette base de données.

  • Il ne peut contenir que les caractères_$#@a-zA-Z0-9.

  • Cela ne peut pas commencer par _ ou$.

  • Ça ne peut pas commencer parSYS.

Les paramètres suivants sont facultatifs :

buffer_pool_name

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

Important

Vous devez déjà disposer d'un pool de mémoire tampon de même taille de page à associer au tablespace.

tablespace_page_size

Taille de page du tablespace en octets. Le type de données estinteger. 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 appelantrdsadmin.create_database.

Important

Amazon RDS prend en charge l'atomicité d'écriture pour les pages 4 KiB, 8 KiB et 16 KiB. En revanche, les pages de 32 Kio risquent d'être déchirées ou d'écrire des données partielles 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 des pages déchirées. Pour plus d’informations, consultez Présentation des sauvegardes et Restauration d'une instance de base de données à une heure spécifiée pour Amazon RDS.

tablespace_initial_size

Taille initiale du tablespace en kilo-octets (Ko). Le type de données estinteger. Valeurs valides : 48 ou supérieures. 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 espaces disque logiques temporaires car le système gère les espaces disque logiques temporaires.

tablespace_increase_size

Pourcentage d'augmentation du tablespace lorsqu'il est plein. Le type de données estinteger. 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 espaces disque logiques temporaires car le système gère les espaces disque logiques temporaires.

tablespace_type

Type du tablespace. Le type de données estchar. 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). L’argument par défaut est U.

tablespace_prefetch_size

Taille de page de prélecture du tablespace. Le type de données estchar. Valeurs valides : AUTOMATIC (sans distinction majuscules/minuscules) ou entiers positifs non nuls inférieurs ou égaux à 32767.

Notes d’utilisation

RDS pour DB2 crée toujours une base de données volumineuse.

Pour plus d'informations sur la vérification de l'état de création d'un tablespace, consultez. rdsadmin.get_task_status

Exemples

Exemple 1 : création d'un espace disque logique et attribution d'un pool de mémoire tampon

L'exemple suivant crée un tablespace appelé SP8 et affecte un pool de mémoire tampon 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 espace disque logique temporaire et attribution d'un pool de mémoire tampon

L'exemple suivant crée un tablespace temporaire appelé. SP8 Il attribue un pool de mémoire tampon appelé BP8 d'une taille de 8 KiB pour une base de données appeléeTESTDB.

db2 "call rdsadmin.create_tablespace(
    'TESTDB',
    'SP8',
    'BP8', 
    8192, 
    NULL, 
    NULL, 
    'T')"

Exemple 3 : création d'un espace disque logique et attribution d'une taille de page de prélecture

L'exemple suivant crée un tablespace appelé SP8 pour une base de données appelée. TESTDB L'espace disque logique a une taille d'augmentation initiale de l'espace disque logique 50 et une taille de page de prélecture 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 estvarchar.

tablespace_name

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

Les paramètres suivants sont facultatifs :

buffer_pool_name

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

Important

Vous devez déjà disposer d'un pool de mémoire tampon de 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 estinteger. Valeurs valides : 1 —100. L’argument par défaut est 0.

max_size

Taille maximale du tablespace. Le type de données estvarchar. Valeurs valides : integer K M | | G ouNONE. L’argument par défaut est NONE.

reduce_max

Spécifie s'il faut réduire le maximum de la limite maximale. Le type de données estchar. L’argument par défaut est N.

reduce_stop

Spécifie s'il faut interrompre une reduce_value commande reduce_max ou une commande précédente. Le type de données estchar. L’argument par défaut est N.

reduce_value

Le nombre ou le pourcentage de réduction du point culminant de l'espace disque logique de. Le type de données estvarchar. Valeurs valides : integer K M | | G ou 1 —100. L’argument par défaut est N.

lower_high_water

Spécifie s'il faut exécuter la ALTER TABLESPACE LOWER HIGH WATER MARK commande. Le type de données estchar. L’argument par défaut est N.

lower_high_water_stop

Spécifie s'il faut exécuter la ALTER TABLESPACE LOWER HIGH WATER MARK STOP commande. Le type de données estchar. L’argument par défaut est N.

switch_online

Spécifie s'il faut exécuter la ALTER TABLESPACE SWITCH ONLINE commande. Le type de données estchar. L’argument par défaut est N.

tablespace_prefetch_size

Taille de page de prélecture du tablespace. Le type de données estchar. Valeurs valides : AUTOMATIC (sans distinction majuscules/minuscules) ou entiers positifs non nuls inférieurs ou égaux à 32767.

Note

Ce paramètre ne fonctionne qu'avec buffer_pool_nametable_increase_size,max_size, etswitch_online. Cela ne fonctionne pas avec reduce_maxreduce_stop,reduce_value,lower_high_water, etlower_high_water_stop.

Notes d’utilisation

Avant d'appeler la procédure stockée, prenez en compte les points suivants :

  • La procédure rdsadmin.alter_tablespace stockée ne fonctionnera pas sur un tablespace tablespace_type défini sur T pour les données temporaires de l'utilisateur.

  • Les paramètres facultatifs reduce_maxreduce_stop,reduce_value,, lower_high_waterlower_high_water_stop, et s'switch_onlineexcluent mutuellement. Vous ne pouvez pas les combiner avec d'autres paramètres facultatifsbuffer_pool_name, tels que ceux de la rdsadmin.alter_tablespace commande. Pour de plus amples informations, veuillez consulter Statement not valid.

Pour plus d'informations sur la vérification de l'état de modification d'un espace disque logique, consultez. rdsadmin.get_task_status

Pour les messages d'erreur renvoyés lors de l'appel de procédures stockées, consultezErreurs de procédure stockée.

Exemples

Exemple 1 : Abaisser le niveau du haut du niveau des eaux

L'exemple suivant modifie un tablespace appelé SP8 et affecte un pool de mémoire tampon appelé BP8 pour une base de données appelée TESTDB pour abaisser le seuil maximum.

db2 "call rdsadmin.alter_tablespace(
    'TESTDB',
    'SP8',
    'BP8', 
    NULL, 
    NULL, 
    'Y')"

Exemple 2 : Réduire le niveau des hautes eaux

L'exemple suivant exécute la REDUCE MAX commande 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 de commandes pour réduire le niveau de saturation

L'exemple suivant exécute la REDUCE STOP commande 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 de prélecture existante

L'exemple suivant exécute la ALTER TABLESPACE SWITCH ONLINE commande sur un tablespace appelé TSBP_TEST et modifie la taille de page de prélecture 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 n'accepte que ?

database_name

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

source_tablespace_name

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

target_tablespace_name

Le nouveau nom du tablespace. Le type de données estvarchar.

Le nouveau nom comporte les restrictions suivantes :

  • Il ne peut pas être identique au nom d'un tablespace existant.

  • Il ne peut contenir que les caractères_$#@a-zA-Z0-9.

  • Cela ne peut pas commencer par _ ou$.

  • Ça ne peut pas commencer parSYS.

Notes d’utilisation

Pour plus d'informations sur la vérification de l'état du changement de nom d'un espace disque logique, 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é SP9 dans une base SP8 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 appartient le tablespace. Le type de données estvarchar.

tablespace_name

Nom du tablespace à supprimer. Le type de données estvarchar.

Notes d’utilisation

Pour plus d'informations sur la vérification de l'état de suppression d'un tablespace, consultez. rdsadmin.get_task_status

Exemples

L'exemple suivant supprime un tablespace appelé SP8 depuis une base de données appelée. TESTDB

db2 "call rdsadmin.drop_tablespace(
    'TESTDB',
    'SP8')"