Procédures stockées pour les bases de données pour RDS pour Db2 - Amazon Relational Database Service
rdsadmin.create_databaserdsadmin.deactivate_databaserdsadmin.activate_databaserdsadmin.drop_databaserdsadmin.update_db_paramrdsadmin.set_configurationrdsadmin.show_configurationrdsadmin.restore_databaserdsadmin.rollforward_databaserdsadmin.complete_rollforwardrdsadmin.db2pd_commandrdsadmin.force_applicationrdsadmin.set_archive_log_retentionrdsadmin.show_archive_log_retention

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 bases de données pour RDS pour Db2

Les procédures stockées intégrées décrites dans cette rubrique gèrent les bases de données pour 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_database

Crée une base de données.

Syntaxe

db2 "call rdsadmin.create_database('database_name')"

Paramètres

Note

Cette procédure stockée ne valide pas la combinaison des paramètres requis. Lorsque vous appelezrdsadmin.get_task_status, la fonction définie par l'utilisateur peut renvoyer une erreur en raison d'une combinaison de database_codesetdatabase_territory, et database_collation cela n'est pas valide. Pour plus d'informations, voir Choix de la page de code, du territoire et du classement pour votre base de données dans IBM Db2 .

Les paramètres suivants sont obligatoires :

database_name

Nom de la base de données à créer. Le type de données estvarchar.

Les paramètres suivants sont facultatifs :

database_page_size

Taille de page par défaut de la base de données. Valeurs valides: 4096, 8192, 16384, 32768. Le type de données estinteger. L’argument par défaut est 8192.

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.

database_code_set

Code défini pour la base de données. Le type de données estvarchar. L’argument par défaut est UTF-8.

database_territory

Code de pays à deux lettres pour la base de données. Le type de données estvarchar. L’argument par défaut est US.

database_collation

Séquence de classement qui détermine la manière dont les chaînes de caractères stockées dans la base de données sont triées et comparées. Le type de données estvarchar.

Valeurs valides :

  • COMPATIBILITY— Une séquence de classement IBM Db2 version 2.

  • EBCDIC_819_037— Page de code latin ISO, classement ; CCSID 037 (EBCDIC, anglais américain).

  • EBCDIC_819_500— Page de code latin ISO, classement ; CCSID 500 (EBCDIC International).

  • EBCDIC_850_037— Page de code latin ASCII, collation ; CCSID 037 (EBCDIC, anglais américain).

  • EBCDIC_850_500— Page de code latin ASCII, classement ; CCSID 500 (EBCDIC International).

  • EBCDIC_932_5026— Page de code ASCII en japonais, collation ; CCSID 037 (EBCDIC, anglais américain).

  • EBCDIC_932_5035— Page de code japonais ASCII, classement ; CCSID 500 (EBCDIC International).

  • EBCDIC_1252_037— Page de code latin de Windows, classement ; CCSID 037 (EBCDIC, anglais américain).

  • EBCDIC_1252_500— Page de code latin Windows, classement ; CCSID 500 (EBCDIC International).

  • IDENTITY— Classement par défaut. Les chaînes sont comparées octet par octet.

  • IDENTITY_16BIT— Le schéma de codage de compatibilité pour UTF-16 : séquence de classement 8 bits (CESU-8). Pour plus d'informations, consultez le rapport technique Unicode #26 sur le site Web du consortium Unicode.

  • NLSCHAR— À utiliser uniquement avec la page de code thaï (CP874).

  • SYSTEM— Si vous utilisezSYSTEM, la base de données utilise automatiquement la séquence de classement pour database_codeset etdatabase_territory.

L’argument par défaut est IDENTITY.

En outre, RDS pour Db2 prend en charge les groupes de collations suivants : language-aware-collation et. locale-sensitive-collation Pour plus d'informations, voir Choisir un classement pour une base de données Unicode dans le IBM Db2 .

database_autoconfigure_str

La syntaxe de la AUTOCONFIGURE commande, par exemple,'AUTOCONFIGURE APPLY DB'. Le type de données estvarchar. La valeur par défaut est une chaîne vide ou nulle.

Pour plus d’informations, consultez .AUTOCONFIGURE commande dans le IBM Db2 .

Notes d’utilisation

Si vous envisagez de modifier le db2_compatibility_vector paramètre, modifiez-le avant de créer une base de données. Pour de plus amples informations, veuillez consulter Définition du paramètre db2_compatibility_vector.

Considérations spéciales :

  • La CREATE DATABASE commande envoyée à l'instance Db2 utilise l'RESTRICTIVEoption.

  • RDS pour DB2 utilise AUTOMATIC STORAGE uniquement des tablespaces.

  • RDS pour DB2 utilise les valeurs par défaut pour NUMSEGS et. DFT_EXTENT_SZ

  • RDS pour DB2 utilise le chiffrement du stockage et ne prend pas en charge le chiffrement de base de données.

Pour plus d'informations sur ces considérations, voir CREATE DATABASE commande dans le IBM Db2 .

Avant d'appelerrdsadmin.create_database, vous devez vous connecter à la rdsadmin base de données. Dans l'exemple suivant, remplacez master_username et master_password par votre RDS pour les informations d'instance de base de données DB2 :

db2 connect to rdsadmin user master_username using master_password

Pour plus d'informations sur la vérification de l'état de création d'une base de données, consultezrdsadmin.get_task_status.

Pour les messages d'erreur renvoyés lors de rdsadmin.create_database l'appel, consultezRésolution des erreurs liées aux procédures stockées.

Exemples

L'exemple suivant crée une base de données appelée TESTJP avec une combinaison correcte des database_collation paramètres database_code_setdatabase_territory,, et pour le Japon :

db2 "call rdsadmin.create_database('TESTJP', 4096, 'IBM-437', 'JP', 'SYSTEM')"

rdsadmin.deactivate_database

Désactive une base de données.

Syntaxe

db2 "call rdsadmin.deactivate_database(
    ?,
    'database_name')"

Paramètres

Le paramètre de sortie suivant est requis :

?

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

Le paramètre d'entrée suivant est obligatoire :

database_name

Nom de la base de données à désactiver. Le type de données estvarchar.

Notes d’utilisation

Vous pouvez désactiver les bases de données pour économiser les ressources de mémoire. Pour remettre en ligne une base de données désactivée, appelez la procédure rdsadmin.activate_database stockée.

Pour plus d'informations sur la vérification de l'état de désactivation d'une base de données, consultezrdsadmin.get_task_status.

Exemples

L'exemple suivant désactive une base de données appeléeTESTDB.

db2 "call rdsadmin.deactivate_database(?, 'TESTDB')"

rdsadmin.activate_database

Active une base de données.

Syntaxe

db2 "call rdsadmin.activate_database(
    ?,
    'database_name')"

Paramètres

Le paramètre de sortie suivant est requis :

?

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

Le paramètre d'entrée suivant est obligatoire :

database_name

Nom de la base de données à activer. Le type de données estvarchar.

Notes d’utilisation

Toutes les bases de données sont activées par défaut lors de leur création. Si vous désactivez une base de données pour économiser des ressources de mémoire, appelez la procédure rdsadmin.activate_database stockée pour la réactiver.

Pour plus d'informations sur la vérification de l'état d'activation d'une base de données, consultezrdsadmin.get_task_status.

Exemples

L'exemple suivant active une base de données appeléeTESTDB.

db2 "call rdsadmin.activate_database(?, 'TESTDB')"

rdsadmin.drop_database

Supprime une base de données.

Syntaxe

db2 "call rdsadmin.drop_database('database_name')"

Paramètres

Les paramètres suivants sont obligatoires :

database_name

Nom de la base de données à supprimer. Le type de données estvarchar.

Notes d’utilisation

Vous pouvez supprimer une base de données en appelant rdsadmin.drop_database uniquement si les conditions suivantes sont remplies :

  • Vous n'avez pas spécifié le nom de la base de données lorsque vous avez créé votre instance de base de données RDS pour DB2 à l'aide de la console Amazon RDS ou du. AWS CLI Pour de plus amples informations, veuillez consulter Création d'une instance de base de données.

  • Vous avez créé la base de données en appelant la procédure rdsadmin.create_database stockée.

  • Vous avez restauré la base de données à partir d'une image hors ligne ou sauvegardée en appelant la procédure rdsadmin.restore_database stockée.

Avant d'appelerrdsadmin.drop_database, vous devez vous connecter à la rdsadmin base de données. Dans l'exemple suivant, remplacez master_username et master_password par votre RDS pour les informations d'instance de base de données DB2 :

db2 connect to rdsadmin user master_username using master_password

Pour plus d'informations sur la vérification de l'état de suppression d'une base de données, consultezrdsadmin.get_task_status.

Pour les messages d'erreur renvoyés lors de rdsadmin.drop_database l'appel, consultezRésolution des erreurs liées aux procédures stockées.

Exemples

L'exemple suivant supprime une base de données appelée TESTDB :

db2 "call rdsadmin.drop_database('TESTDB')"

rdsadmin.update_db_param

Actualise les paramètres de base de données.

Syntaxe

db2 "call rdsadmin.update_db_param(
    'database_name', 
    'parameter_to_modify', 
    'changed_value)"

Paramètres

Les paramètres suivants sont obligatoires :

database_name

Nom de la base de données pour laquelle exécuter la tâche. Le type de données estvarchar.

parameter_to_modify

Nom du paramètre à modifier. Le type de données estvarchar. Pour de plus amples informations, veuillez consulter Paramètres d'Amazon RDS pour DB2.

changed_value

La valeur à laquelle modifier la valeur du paramètre. Le type de données estvarchar.

Notes d’utilisation

Pour plus d'informations sur la vérification de l'état de mise à jour des paramètres de base de données, consultezrdsadmin.get_task_status.

Pour les messages d'erreur renvoyés lors de rdsadmin.update_db_param l'appel, consultezRésolution des erreurs liées aux procédures stockées.

Exemples

Exemple 1 : mise à jour d'un paramètre

L'exemple suivant met à jour le archretrydelay paramètre 100 pour une base de données appelée TESTDB :

db2 "call rdsadmin.update_db_param(
    'TESTDB', 
    'archretrydelay', 
    '100')"

Exemple 2 : report de la validation d'objets

L'exemple suivant reporte la validation des objets créés sur une base de données appelée TESTDB pour éviter la vérification des dépendances :

db2 "call rdsadmin.update_db_param(
    'TESTDB', 
    'auto_reval', 
    'deferred_force')"

rdsadmin.set_configuration

Configure les paramètres spécifiques de la base de données.

Syntaxe

db2 "call rdsadmin.set_configuration(
    'name',  
    'value')"

Paramètres

Les paramètres suivants sont obligatoires :

name

Nom du paramètre de configuration. Le type de données estvarchar.

value

La valeur du paramètre de configuration. Le type de données estvarchar.

Notes d’utilisation

Le tableau suivant indique les paramètres de configuration que vous pouvez contrôlerrdsadmin.set_configuration.

Name (Nom) Description

RESTORE_DATABASE_NUM_BUFFERS

Nombre de tampons à créer lors d'une opération de restauration. Cette valeur doit être inférieure à la taille de mémoire totale de la classe d'instance de base de données. Si ce paramètre n'est pas configuré, Db2 détermine la valeur à utiliser lors de l'opération de restauration. Pour de plus amples informations, veuillez consulter le .IBM Db2 documentation.

RESTORE_DATABASE_PARALLELISM

Nombre de manipulateurs de mémoire tampon à créer lors d'une opération de restauration. Cette valeur doit être inférieure au double du nombre de v CPUs pour l'instance de base de données. Si ce paramètre n'est pas configuré, Db2 détermine la valeur à utiliser lors de l'opération de restauration. Pour de plus amples informations, veuillez consulter le .IBM Db2 documentation.

Exemples

Exemple 1 : Spécification du nombre de manipulateurs de mémoire tampon à créer

L'exemple suivant définit la RESTORE_DATABASE_PARALLELISM configuration sur8.

db2 "call rdsadmin.set_configuration(
    'RESTORE_DATABASE_PARALLELISM', 
    '8')"

Exemple 2 : Spécification du nombre de tampons à créer

L'exemple suivant définit la RESTORE_DATABASE_NUM_BUFFERS configuration sur150.

db2 "call rdsadmin.set_configuration(
    'RESTORE_DATABASE_NUM_BUFFERS', 
    '150')"

rdsadmin.show_configuration

Renvoie les paramètres actuels que vous pouvez définir à l'aide de la procédure stockéerdsadmin.set_configuration.

Syntaxe

db2 "call rdsadmin.show_configuration(
    'name')"

Paramètres

Le paramètre suivant est facultatif :

name

Nom du paramètre de configuration pour lequel les informations doivent être renvoyées. Le type de données estvarchar.

Les noms de configuration suivants sont valides :

  • RESTORE_DATABASE_NUM_BUFFERS — Nombre de tampons à créer lors d'une opération de restauration.

  • RESTORE_DATABASE_PARALLELISM — Nombre de manipulateurs de mémoire tampon à créer lors d'une opération de restauration.

Notes d’utilisation

Si vous ne spécifiez pas le nom d'un paramètre de configuration, rdsadmin.show_configuration renvoie des informations pour tous les paramètres de configuration que vous pouvez définir à l'aide de la procédure stockéerdsadmin.set_configuration.

Exemples

L'exemple suivant renvoie des informations sur la RESTORE_DATABASE_PARALLELISM configuration actuelle.

db2 "call rdsadmin.show_configuration(
    'RESTORE_DATABASE_PARALLELISM')"

rdsadmin.restore_database

Restaure une base de données depuis un compartiment Amazon S3 vers votre instance de base de données RDS pour DB2.

Syntaxe

db2 "call rdsadmin.restore_database(
    ?,
    'database_name', 
    's3_bucket_name', 
    's3_prefix', 
    restore_timestamp, 
    'backup_type')"

Paramètres

Le paramètre de sortie suivant est requis :

?

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

Les paramètres d'entrée suivants sont requis :

database_name

Nom de la base de données cible à restaurer dans RDS pour DB2. Le type de données estvarchar.

Par exemple, si le nom de la base de données source était TESTDB et que vous l'avez défini database_name surNEWDB, Amazon RDS effectue la restauration NEWDB en tant que base de données source.

s3_bucket_name

Le nom du compartiment Amazon S3 dans lequel réside votre sauvegarde. Le type de données estvarchar.

s3_prefix

Le préfixe à utiliser pour la mise en correspondance des fichiers lors du téléchargement. Le type de données estvarchar.

Si ce paramètre est vide, tous les fichiers du compartiment Amazon S3 seront téléchargés. Voici un exemple de préfixe :

backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101
restore_timestamp

Horodatage de l'image de sauvegarde de la base de données. Le type de données estvarchar.

L'horodatage est inclus dans le nom du fichier de sauvegarde. Par exemple, 20230615010101 est l'horodatage du nom du fichier. SAMPLE.0.rdsdb.DBPART000.20230615010101.001

backup_type

Type de sauvegarde. Le type de données estvarchar. Valeurs valides : OFFLINE, ONLINE.

À utiliser ONLINE pour des migrations quasiment sans interruption de service. Pour de plus amples informations, veuillez consulter Migration à partir de Linux to Linux avec un temps d'arrêt quasi nul pour Amazon RDS pour DB2.

Notes d’utilisation

Vous pouvez utiliser cette procédure stockée pour migrer une base de données DB2 vers une instance de base de données RDS pour DB2. Pour de plus amples informations, veuillez consulter Utilisation de AWS services pour migrer des données de Db2 vers Amazon RDS pour Db2. Vous pouvez également utiliser cette procédure stockée pour créer plusieurs copies de la même base de données portant des noms de base de données différents et utilisant la même image de restauration.

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

  • Avant de restaurer une base de données, vous devez allouer un espace de stockage pour votre instance de base de données RDS for DB2 égal ou supérieur à la somme de la taille de votre sauvegarde et de la base de données DB2 d'origine sur le disque. Pour de plus amples informations, veuillez consulter Insufficient disk space.

  • Lorsque vous restaurez la sauvegarde, Amazon RDS extrait le fichier de sauvegarde sur votre instance de base de données RDS pour DB2. Chaque fichier de sauvegarde doit être inférieur ou égal à 5 To. Si un fichier de sauvegarde dépasse 5 To, vous devez diviser celui-ci en plusieurs fichiers plus petits.

  • Pour restaurer tous les fichiers à l'aide de la procédure rdsadmin.restore_database stockée, n'incluez pas le suffixe du numéro de fichier après l'horodatage dans les noms de fichiers. Par exemple, les fichiers suivants sont s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101 restaurés :

    SAMPLE.0.rdsdb.DBPART000.20230615010101.001
SAMPLE.0.rdsdb.DBPART000.20230615010101.002
SAMPLE.0.rdsdb.DBPART000.20230615010101.003
SAMPLE.0.rdsdb.DBPART000.20230615010101.004
SAMPLE.0.rdsdb.DBPART000.20230615010101.005

  • RDS pour DB2 ne prend pas en charge le stockage non automatique. Pour de plus amples informations, veuillez consulter Tablespaces not restored.

  • RDS pour DB2 ne prend pas en charge les routines non clôturées. Pour de plus amples informations, veuillez consulter Non-fenced routines not allowed.

  • Pour améliorer les performances des opérations de restauration de base de données, vous pouvez configurer le nombre de tampons et de manipulateurs de mémoire tampon à utiliser par RDS. Pour vérifier la configuration actuelle, utilisezrdsadmin.show_configuration. Pour modifier la configuration, utilisezrdsadmin.set_configuration.

Pour mettre la base de données en ligne et appliquer des journaux de transactions supplémentaires après la restauration de la base de données, consultezrdsadmin.rollforward_database.

Pour plus d'informations sur la vérification de l'état de restauration de votre base de données, consultezrdsadmin.get_task_status.

Pour les messages d'erreur renvoyés lors de rdsadmin.restore_database l'appel, consultezRésolution des erreurs liées aux procédures stockées.

Exemples

L'exemple suivant restaure une sauvegarde hors ligne avec un seul fichier ou plusieurs fichiers dotés des caractéristiques s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101 suivantes :

db2 "call rdsadmin.restore_database(
    ?,
    'SAMPLE',
    'amzn-s3-demo-bucket',
    'backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101',
    20230615010101,
    'OFFLINE')"

rdsadmin.rollforward_database

Met la base de données en ligne et applique des journaux de transactions supplémentaires après avoir restauré une base de données en appelantrdsadmin.restore_database.

Syntaxe

db2 "call rdsadmin.rollforward_database(
    ?,
    'database_name',
    's3_bucket_name', 
    s3_prefix, 
    'rollfoward_to_option', 
    'complete_rollforward')"

Paramètres

Le paramètre de sortie suivant est requis :

?

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

Les paramètres d'entrée suivants sont requis :

database_name

Nom de la base de données sur laquelle effectuer l'opération. Le type de données estvarchar.

s3_bucket_name

Le nom du compartiment Amazon S3 dans lequel réside votre sauvegarde. Le type de données estvarchar.

s3_prefix

Le préfixe à utiliser pour la mise en correspondance des fichiers lors du téléchargement. Le type de données estvarchar.

Si ce paramètre est vide, tous les fichiers du compartiment S3 seront téléchargés. L'exemple suivant est un exemple de préfixe :

backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101

Les paramètres d'entrée suivants sont facultatifs :

rollforward_to_option

Le point vers lequel vous souhaitez avancer. Le type de données estvarchar. Valeurs valides : END_OF_LOGS, END_OF_BACKUP. L’argument par défaut est END OF LOGS.

complete_rollforward

Spécifie s'il faut terminer le processus de reconduction. Le type de données estvarchar. L’argument par défaut est TRUE.

SiTRUE, une fois terminée, la base de données est en ligne et accessible. Si c'est le casFALSE, la base de données reste dans un ROLL-FORWARD PENDING état.

Notes d’utilisation

Après avoir appelérdsadmin.restore_database, vous devez appeler rollforward_database pour appliquer les journaux d'archivage à partir d'un compartiment S3. Vous pouvez également utiliser cette procédure stockée pour restaurer des journaux de transactions supplémentaires après un appelrdsadmin.restore_database.

Si vous définissez complete_rollforward cette optionFALSE, votre base de données est en ROLL-FORWARD PENDING état et hors ligne. Pour mettre la base de données en ligne, vous devez appelerrdsadmin.complete_rollforward.

Pour plus d'informations sur la vérification de l'état du report de la base de données, consultezrdsadmin.get_task_status.

Exemples

Exemple 1 : mise en ligne d'une base de données contenant des journaux de transactions

L'exemple suivant passe à une sauvegarde en ligne de la base de données avec les journaux de transactions, puis met la base de données en ligne :

db2 "call rdsadmin.rollforward_database(
    ?,
    null,
    null,
    'END_OF_LOGS',
    'TRUE')"

Exemple 2 : mise en ligne d'une base de données sans journaux de transactions

L'exemple suivant passe à une sauvegarde en ligne de la base de données sans journaux de transactions, puis met la base de données en ligne :

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    'amzn-s3-demo-bucket',
    'logsfolder/,
    'END_OF_BACKUP',
    'TRUE')"

Exemple 3 : ne pas mettre en ligne une base de données contenant des journaux de transactions

L'exemple suivant passe à une sauvegarde en ligne de la base de données avec les journaux de transactions, puis ne met pas la base de données en ligne :

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    null,
    'onlinebackup/TESTDB',
    'END_OF_LOGS',
    'FALSE')"

Exemple 4 : ne pas mettre en ligne une base de données contenant des journaux de transactions supplémentaires

L'exemple suivant passe à une sauvegarde en ligne de la base de données avec des journaux de transactions supplémentaires, puis ne met pas la base de données en ligne :

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    'amzn-s3-demo-bucket',
    'logsfolder/S0000155.LOG',
    'END_OF_LOGS',
    'FALSE')"

rdsadmin.complete_rollforward

Met en ligne la base de données d'un ROLL-FORWARD PENDING État.

Syntaxe

db2 "call rdsadmin.complete_rollforward(
    ?,
    'database_name')"

Paramètres

Le paramètre de sortie suivant est requis :

?

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

Le paramètre d'entrée suivant est obligatoire :

database_name

Nom de la base de données que vous souhaitez mettre en ligne. Le type de données estvarchar.

Notes d’utilisation

Si vous avez appelé rdsadmin.rollforward_database avec complete_rollforward set toFALSE, cela signifie que votre base de données est en ROLL-FORWARD PENDING état et hors ligne. Pour terminer le processus de reconduction et mettre la base de données en ligne, appelez. rdsadmin.complete_rollforward

Pour plus d'informations sur la vérification de l'état d'achèvement du processus de report, voir. rdsadmin.get_task_status

Exemples

L'exemple suivant présente TESTDB base de données en ligne :

db2 "call rdsadmin.complete_rollfoward(
    ?,
    'TESTDB')"

rdsadmin.db2pd_command

Collecte des informations sur une base de données RDS pour DB2.

Syntaxe

db2 "call rdsadmin.db2pd_command('db2pd_cmd')"

Paramètres

Le paramètre d'entrée suivant est obligatoire :

db2pd_cmd

Nom de la db2pd commande que vous souhaitez exécuter. Le type de données estvarchar.

Le paramètre doit commencer par un tiret. Pour obtenir la liste des paramètres, voir db2pd--Surveiller et résoudre les problèmes liés à la commande de base de données DB2 dans le IBM Db2 .

Les options suivantes ne sont pas prises en charge :

  • -addnode

  • -alldatabases

  • -alldbp

  • -alldbs

  • -allmembers

  • -alm_in_memory

  • -cfinfo

  • -cfpool

  • -command

  • -dbpartitionnum

  • -debug

  • -dump

  • -everything

  • -file | -o

  • -ha

  • -interactive

  • -member

  • -pages

    Note

    -pages summary est pris en charge.

  • -pdcollection

  • -repeat

  • -stack

  • -totalmem

La file sous-option n'est pas prise en charge, db2pd -db testdb -tcbstats file=tcbstat.out par exemple.

L'utilisation de l'stacksoption n'est pas prise en charge, par exempledb2pd -edus interval=5 top=10 stacks.

Notes d’utilisation

Cette procédure stockée rassemble des informations qui peuvent aider à surveiller et à dépanner les bases de données RDS pour DB2.

La procédure stockée utilise IBM db2pdutilitaire pour exécuter diverses commandes. L'db2pdutilitaire nécessite une SYSADM autorisation, que l'utilisateur principal de RDS pour DB2 ne possède pas. Cependant, avec la procédure stockée Amazon RDS, l'utilisateur principal peut utiliser l'utilitaire pour exécuter diverses commandes. Pour plus d'informations sur cet utilitaire, consultez la section db2pd--Surveiller et dépanner la commande de base de données DB2 dans le IBM Db2 .

La sortie est limitée à un maximum de 2 Go.

Pour plus d'informations sur la vérification de l'état de la collecte d'informations sur la base de données, consultezrdsadmin.get_task_status.

Exemples

Exemple 1 : retour de la disponibilité d'une instance de base de données

L'exemple suivant renvoie le temps de disponibilité d'une instance de base de données RDS pour DB2 :

db2 "call rdsadmin.db2pd_command('-')"

Exemple 2 : retour du temps de disponibilité de la base de données

L'exemple suivant renvoie le temps de disponibilité d'une base de données appelée TESTDB :

db2 "call rdsadmin.db2pd_command('-db TESTDB -')"

Exemple 3 : retour de l'utilisation de la mémoire d'une instance de base de données

L'exemple suivant renvoie l'utilisation de la mémoire d'une instance de base de données RDS pour DB2 :

db2 "call rdsadmin.db2pd_command('-dbptnmem')"

Exemple 4 : renvoyer des ensembles de mémoire d'une instance de base de données et d'une base de données

L'exemple suivant renvoie les ensembles de mémoire d'une instance de base de données RDS pour DB2 et d'une base de données appelée : TESTDB

db2 "call rdsadmin.db2pd_command('-inst -db TESTDB -memsets')"

rdsadmin.force_application

Force les applications à quitter une base de données RDS pour DB2.

Syntaxe

db2 "call rdsadmin.force_application(
    ?,
    'applications')"

Paramètres

Le paramètre de sortie suivant est requis :

?

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

Le paramètre d'entrée suivant est obligatoire :

applications

Les applications que vous souhaitez forcer à quitter une base de données RDS pour DB2. Le type de données estvarchar. Valeurs valides : ALL ou application_handle.

Séparez les noms de plusieurs applications par des virgules. Exemple : «application_handle_1, application_handle_2 ».

Notes d’utilisation

Cette procédure stockée force toutes les applications à quitter une base de données afin que vous puissiez effectuer la maintenance.

La procédure stockée utilise IBM FORCE APPLICATIONcommande. La FORCE APPLICATION commande nécessiteSYSADM, ou SYSCTRL autorisationSYSMAINT, que l'utilisateur principal de RDS pour DB2 ne possède pas. Cependant, avec la procédure stockée Amazon RDS, l'utilisateur principal peut utiliser la commande. Pour plus d'informations, voir la commande FORCE APPLICATION dans le IBM Db2 .

Pour plus d'informations sur la vérification de l'état du forçage des applications hors d'une base de données, consultezrdsadmin.get_task_status.

Exemples

Exemple 1 : Spécification de toutes les applications

L'exemple suivant force toutes les applications à quitter une base de données RDS pour DB2 :

db2 "call rdsadmin.force_application(
    ?,
    'ALL')"

Exemple 2 : Spécification de plusieurs applications

L'exemple suivant force les descripteurs 9991 d'application et la 1192 désactivation d'une base de données RDS pour DB2 : 8891

db2 "call rdsadmin.force_application(
    ?,
    '9991, 8891, 1192')"

rdsadmin.set_archive_log_retention

Configure la durée (en heures) de conservation des fichiers journaux d'archivage pour la base de données RDS pour DB2 spécifiée.

Syntaxe

db2 "call rdsadmin.set_archive_log_retention(
    ?,            
    'database_name',  
    'archive_log_retention_hours')"

Paramètres

Le paramètre de sortie suivant est requis :

?

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

Les paramètres d'entrée suivants sont requis :

database_name

Nom de la base de données pour laquelle configurer la conservation des journaux d'archivage. Le type de données estvarchar.

archive_log_retention_hours

Le nombre d'heures pendant lesquelles les fichiers journaux d'archivage sont conservés. Le type de données estsmallint. La valeur par défaut est0, et le maximum est de 168 (7 jours).

Si la valeur est0, Amazon RDS ne conserve pas les fichiers journaux d'archivage.

Notes d’utilisation

Par défaut, RDS pour DB2 conserve les journaux pendant 5 minutes. Nous vous recommandons d'utiliser des outils de réplication tels que AWS DMS pour la capture des données modifiées (CDC) ou IBM Q Replication, vous définissez la durée de conservation des journaux dans ces outils pendant plus de 5 minutes.

Vous pouvez consulter le paramètre actuel de conservation des journaux d'archivage en appelantrdsadmin.show_archive_log_retention.

Vous ne pouvez pas configurer le paramètre de conservation des journaux d'archivage sur la rdsadmin base de données.

Exemples

Exemple 1 : définition de la durée de rétention

L'exemple suivant définit la durée de conservation du journal d'archivage pour une base de données appelée TESTDB à 24 heures.

db2 "call rdsadmin.set_archive_log_retention(
    ?,
    'TESTDB', 
    '24')"

Exemple 2 : désactivation de la durée de rétention

L'exemple suivant désactive la conservation des journaux d'archivage pour une base de données appeléeTESTDB.

db2 "call rdsadmin.set_archive_log_retention(
    ?,
    'TESTDB', 
    '0')"

rdsadmin.show_archive_log_retention

Renvoie le paramètre actuel de conservation du journal d'archivage pour la base de données spécifiée.

Syntaxe

db2 "call rdsadmin.show_archive_log_retention(
    ?,
    'database_name')"

Paramètres

Le paramètre de sortie suivant est requis :

?

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

Le paramètre d'entrée suivant est obligatoire :

database_name

Nom de la base de données pour laquelle le paramètre de conservation du journal d'archivage doit être affiché. Le type de données estvarchar.

Exemples

L'exemple suivant montre le paramètre de conservation des journaux d'archivage pour une base de données appeléeTESTDB.

db2 "call rdsadmin.show_archive_log_retention(
    ?
    'TESTDB')"