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

Les procédures stockées suivantes 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.

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

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.

Notes d’utilisation

RDSfor Db2 crée toujours une grande base de données pour les données.

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

Exemples

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

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

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

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 du niveau de filigrane à sa 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.

Notes d’utilisation

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. Si vous combinez ces paramètres avec tout autre paramètre facultatif dans la rdsadmin.alter_tablespace commanderdsadmin.get_task_status, Db2 renverra une erreur comme celle-ci lors de l'exécution :

DB21034E  The command was processed as an SQL statement because it was not a valid Command Line Processor command.  During SQL processing it returned:
SQL1763N  Invalid ALTER TABLESPACE statement for table space "TBSP_TEST" due to reason "12"

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

Exemples

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

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

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

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