Procédures stockées pour les pools de mémoires tampons pour RDS for Db2 - Amazon Relational Database Service
rdsadmin.create_bufferpoolrdsadmin.alter_bufferpoolrdsadmin.drop_bufferpool

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 pools de mémoires tampons pour RDS for Db2

Les procédures stockées intégrées décrites dans cette rubrique gèrent les pools 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.

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_bufferpool

Crée un pool 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)"

Paramètres

Les paramètres suivants sont obligatoires :

database_name

Nom de la base de données sur laquelle la commande doit être exécutée. Le type de données est varchar.

buffer_pool_name

Nom du pool de mémoires tampons à créer. Le type de données est varchar.

Les paramètres suivants sont facultatifs :

buffer_pool_size

Taille du pool 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 pool de mémoires tampons sur automatique. Le type de données est char. La valeur par défaut est Y.

page_size

Taille de la page du pool 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_block_pages

Nombre de pages de blocs dans les pools de mémoires tampons. Le type de données est integer. La valeur par défaut est 0.

block_size

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 pool de mémoires tampons, consultez rdsadmin.get_task_status.

Exemples

Exemple 1 : création d’un pool de mémoires tampons avec des paramètres par défaut

L’exemple suivant crée un pool 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 pool 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 pool de mémoires tampons à exécuter immédiatement avec allocation automatique

L’exemple suivant crée un pool 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 pool de mémoires tampons à exécuter immédiatement à l’aide de pages de blocs

L’exemple suivant crée un pool de mémoires tampons appelé BP16 pour une base de données appelée TESTDB. Ce pool 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_bufferpool

Modifie un pool 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)"

Paramètres

Les paramètres suivants sont obligatoires :

database_name

Nom de la base de données sur laquelle la commande doit être exécutée. Le type de données est varchar.

buffer_pool_name

Nom du pool de mémoires tampons à modifier. Le type de données est varchar.

buffer_pool_size

Taille du pool 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 pool de mémoires tampons sur automatique. Le type de données est char. La valeur par défaut est N.

change_number_blocks

Indique si le nombre de pages de blocs dans le pool de mémoires tampons a été modifié. Le type de données est char. La valeur par défaut est N.

number_block_pages

Nombre de pages de blocs dans les pools de mémoires tampons. Le type de données est integer. La valeur par défaut est 0.

block_size

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 pool de mémoires tampons, consultez rdsadmin.get_task_status.

Exemples

L’exemple suivant modifie un pool 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_bufferpool

Supprime un pool de mémoires tampons.

Syntaxe

db2 "call rdsadmin.drop_bufferpool(
    'database_name', 
    'buffer_pool_name'"

Paramètres

Les paramètres suivants sont obligatoires :

database_name

Nom de la base de données à laquelle appartient le pool de mémoires tampons. Le type de données est varchar.

buffer_pool_name

Nom du pool 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 pool de mémoires tampons, consultez rdsadmin.get_task_status.

Exemples

L’exemple suivant supprime un pool de mémoires tampons appelé BP16 pour une base de données appelée TESTDB.

db2 "call rdsadmin.drop_bufferpool(
    'TESTDB',
    'BP16')"