Gespeicherte Prozeduren für Datenbanken RDS für Db2 - Amazon Relational Database Service
rdsadmin.create_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

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Gespeicherte Prozeduren für Datenbanken RDS für Db2

Die folgenden gespeicherten Prozeduren verwalten Datenbanken für Amazon RDS for Db2. Um diese Prozeduren auszuführen, muss der Masterbenutzer zuerst eine Verbindung zur rdsadmin Datenbank herstellen.

rdsadmin.create_database

Erstellt eine Datenbank.

Syntax

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

Parameter

Anmerkung

Diese gespeicherte Prozedur validiert die Kombination der erforderlichen Parameter nicht. Beim Aufrufen rdsadmin.get_task_status kann die benutzerdefinierte Funktion aufgrund einer Kombination vondatabase_codeset,, einen Fehler zurückgebendatabase_territory, database_collation die nicht gültig ist. Weitere Informationen finden Sie unter Auswählen der Codepage, des Territoriums und der Sortierung für Ihre Datenbank im IBM Db2 -Dokumentation.

Der folgende Parameter ist erforderlich:

database_name

Der Name der zu erstellenden Datenbank. Der Datentyp istvarchar.

Die folgenden Parameter sind optional:

database_page_size

Die Standard-Seitengröße der Datenbank. Zulässige Werte: 4096, 8192, 16384, 32768. Der Datentyp istinteger. Der Standardwert ist 8192.

Wichtig

Amazon RDS unterstützt Schreibatomizität für Seiten mit 4 KiB, 8 KiB und 16 KiB. Im Gegensatz dazu besteht bei Seiten mit 32 KiB die Gefahr, dass Schreibvorgänge abgebrochen werden oder dass unvollständige Daten auf den Schreibtisch geschrieben werden. Wenn Sie Seiten mit 32 KiB verwenden, empfehlen wir Ihnen, die point-in-time Wiederherstellung und automatische Backups zu aktivieren. Andernfalls laufen Sie Gefahr, dass Sie zerrissene Seiten nicht wiederherstellen können. Weitere Informationen erhalten Sie unter Einführung in Backups und Wiederherstellung einer DB-Instance zu einem bestimmten Zeitpunkt für Amazon RDS.

database_code_set

Der Codesatz für die Datenbank. Der Datentyp istvarchar. Der Standardwert ist UTF-8.

database_territory

Der aus zwei Buchstaben bestehende Ländercode für die Datenbank. Der Datentyp istvarchar. Der Standardwert ist US.

database_collation

Die Sortierreihenfolge, die bestimmt, wie in der Datenbank gespeicherte Zeichenketten sortiert und verglichen werden. Der Datentyp istvarchar.

Zulässige Werte:

  • COMPATIBILITY— Eine Kollationssequenz für IBM Db2 Version 2.

  • EBCDIC_819_037— ISO Lateinische Codepage, Sortierung; CCSID 037 (EBCDICUS-Englisch).

  • EBCDIC_819_500— ISO Lateinische Codepage, Sortierung; CCSID 500 (International)EBCDIC.

  • EBCDIC_850_037— ASCII Lateinische Codepage, Sortierung; CCSID 037 (EBCDICUS-Englisch).

  • EBCDIC_850_500— ASCII Lateinische Codepage, Sortierung; CCSID 500 (International)EBCDIC.

  • EBCDIC_932_5026— ASCII Japanische Codepage, Sortierung; CCSID 037 (EBCDICUS-Englisch).

  • EBCDIC_932_5035— ASCII Japanische Codepage, Sortierung; CCSID 500 (international)EBCDIC.

  • EBCDIC_1252_037— Lateinische Windows-Codepage, Sortierung; CCSID 037 (EBCDICUS-Englisch).

  • EBCDIC_1252_500— Lateinische Windows-Codepage, Sortierung; CCSID 500 (international)EBCDIC.

  • IDENTITY— Standardsortierung. Zeichenketten werden Byte für Byte verglichen.

  • IDENTITY_16BIT— Das Kompatibilitätscodierungsschema für die UTF Kollationssequenz -16:8-Bit (CESU-8). Weitere Informationen finden Sie im technischen Unicode-Bericht #26 auf der Website des Unicode-Konsortiums.

  • NLSCHAR— Nur zur Verwendung mit der thailändischen Codepage (CP874).

  • SYSTEM— Wenn Sie verwendenSYSTEM, verwendet die Datenbank die Sortierreihenfolge automatisch für database_codeset unddatabase_territory.

Der Standardwert ist IDENTITY.

Darüber hinaus unterstützt RDS for Db2 die folgenden Kollatierungsgruppen: und. language-aware-collation locale-sensitive-collation Weitere Informationen finden Sie unter Auswählen einer Kollation für eine Unicode-Datenbank im IBM Db2 -Dokumentation.

database_autoconfigure_str

Die AUTOCONFIGURE Befehlssyntax, zum Beispiel. 'AUTOCONFIGURE APPLY DB' Der Datentyp istvarchar. Die Standardeinstellung ist eine leere Zeichenfolge oder Null.

Weitere Informationen finden Sie unter AUTOCONFIGURE Befehl in der IBM Db2 -Dokumentation.

Nutzungshinweise

Sie können eine Datenbank erstellen, indem Sie aufrufen, rdsadmin.create_database wenn Sie den Namen der Datenbank nicht angegeben haben, als Sie Ihre RDS für Db2-DB-Instance erstellt haben, indem Sie entweder die RDS Amazon-Konsole oder die AWS CLI verwenden. Weitere Informationen finden Sie unter Erstellen einer DB-Instance.

Besondere Überlegungen:

  • Der an die Db2-Instanz gesendete CREATE DATABASE Befehl verwendet die RESTRICTIVE Option.

  • RDSNur für DB2-Anwendungen. AUTOMATIC STORAGE

  • RDSfür Db2 werden die Standardwerte für NUMSEGS und verwendet. DFT_EXTENT_SZ

  • RDSfür Db2 verwendet Speicherverschlüsselung und unterstützt keine Datenbankverschlüsselung.

Weitere Informationen zu diesen Überlegungen finden Sie unter CREATE DATABASE Befehl in der IBM Db2 -Dokumentation.

Vor dem Aufrufen rdsadmin.create_database müssen Sie eine Verbindung zur rdsadmin Datenbank herstellen. Ersetzen Sie im folgenden Beispiel master_username and master_password durch Ihre Informationen RDS für die DB2-DB-Instance:

db2 connect to rdsadmin user master_username using master_password

Hinweise zur Überprüfung des Status beim Erstellen einer Datenbank finden Sie unterrdsadmin.get_task_status.

Beispiele

Im folgenden Beispiel wird eine Datenbank erstellt, die TESTJP mit einer korrekten Kombination von aufgerufen wird database_code_set, database_territory, und database_collation Parameter für Japan:

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

rdsadmin.drop_database

Entfernt eine Datenbank.

Syntax

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

Parameter

Der folgende Parameter ist erforderlich:

database_name

Der Name der Datenbank, die gelöscht werden soll. Der Datentyp istvarchar.

Nutzungshinweise

Sie können eine Datenbank rdsadmin.drop_database nur löschen, indem Sie sie aufrufen, wenn die folgenden Bedingungen erfüllt sind:

  • Sie haben den Namen der Datenbank nicht angegeben, als Sie Ihre RDS für Db2-DB-Instance mit der RDS Amazon-Konsole oder der AWS CLI erstellt haben. Weitere Informationen finden Sie unter Erstellen einer DB-Instance.

  • Sie haben die Datenbank erstellt, indem Sie die rdsadmin.create_database gespeicherte Prozedur aufgerufen haben.

  • Sie haben die Datenbank aus einem Offline- oder Sicherungsabbild wiederhergestellt, indem Sie die rdsadmin.restore_database gespeicherte Prozedur aufgerufen haben.

Vor dem Aufrufen rdsadmin.drop_database müssen Sie eine Verbindung mit der rdsadmin Datenbank herstellen. Ersetzen Sie im folgenden Beispiel master_username and master_password durch Ihre Informationen RDS für die DB2-DB-Instance:

db2 connect to rdsadmin user master_username using master_password

Hinweise zur Überprüfung des Status beim Löschen einer Datenbank finden Sie unterrdsadmin.get_task_status.

Beispiele

Im folgenden Beispiel wird eine Datenbank mit dem Namen gelöschtTESTDB:

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

Beispiele für Antworten

Wenn Sie einen falschen Datenbanknamen übergeben, gibt die gespeicherte Prozedur das folgende Antwortbeispiel zurück:

SQL0438N Application raised error or warning with diagnostic text: "Cannot
drop database. Database with provided name does not exist". SQLSTATE=99993

Wenn Sie die Datenbank entweder mit der RDS Amazon-Konsole oder mit der erstellt haben AWS CLI, gibt die gespeicherte Prozedur das folgende Antwortbeispiel zurück:

Return Status = 0

Rufen Sie nach dem Empfang Return Status = 0 die rdsadmin.get_task_status gespeicherte Prozedur auf. Eine Antwort, die dem folgenden Beispiel ähnelt, erklärt den Status:

1 ERROR DROP_DATABASE RDSDB 2023-10-10-16.33.03.744122 2023-10-10-16.33.30.143797 - 2023-10-10-16.33.30.098857 Task execution has started.
2023-10-10-16.33.30.143797 Caught exception during executing task id 1, Aborting task. 
Reason Dropping database created via rds CreateDBInstance api is not allowed. 
Only database created using rdsadmin.create_database can be dropped

rdsadmin.update_db_param

Aktualisiert die Datenbankparameter.

Syntax

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

Parameter

Die folgenden Parameter sind erforderlich:

database_name

Der Name der Datenbank, für die die Aufgabe ausgeführt werden soll. Der Datentyp istvarchar.

parameter_to_modify

Der Name des zu ändernden Parameters. Der Datentyp istvarchar. Weitere Informationen finden Sie unter Amazon RDS für Db2-Parameter.

changed_value

Der Wert, auf den der Parameterwert geändert werden soll. Der Datentyp istvarchar.

Nutzungshinweise

Hinweise zur Überprüfung des Status der Aktualisierung von Datenbankparametern finden Sie unterrdsadmin.get_task_status.

Beispiele

Im folgenden Beispiel archretrydelay wird der Parameter 100 für eine Datenbank mit dem Namen auf aktualisiertTESTDB:

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

Im folgenden Beispiel wird die Überprüfung der erstellten Objekte in einer Datenbank verschoben, die aufgerufen wird, um eine Abhängigkeitsprüfung TESTDB zu vermeiden:

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

Beispiele für Antworten

Wenn Sie versuchen, einen Datenbankkonfigurationsparameter zu ändern, der nicht unterstützt oder geändert werden kann, gibt die gespeicherte Prozedur das folgende Antwortbeispiel zurück:

SQL0438N Application raised error or warning with diagnostic text: "Parameter
is either not supported or not modifiable to customers". SQLSTATE=99993

rdsadmin.set_configuration

Konfiguriert spezifische Einstellungen für die Datenbank.

Syntax

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

Parameter

Die folgenden Parameter sind erforderlich:

name

Der Name der Konfigurationseinstellung. Der Datentyp istvarchar.

value

Der Wert für die Konfigurationseinstellung. Der Datentyp istvarchar.

Nutzungshinweise

Die folgende Tabelle zeigt die Konfigurationseinstellungen, mit denen Sie steuern könnenrdsadmin.set_configuration.

Name Beschreibung

RESTORE_DATABASE_NUM_BUFFERS

Die Anzahl der Puffer, die während eines Wiederherstellungsvorgangs erstellt werden sollen. Dieser Wert muss kleiner als die Gesamtspeichergröße der DB-Instance-Klasse sein. Wenn diese Einstellung nicht konfiguriert ist, bestimmt Db2 den Wert, der während des Wiederherstellungsvorgangs verwendet werden soll. Weitere Informationen finden Sie hier: IBM Db2 Dokumentation.

RESTORE_DATABASE_PARALLELISM

Die Anzahl der Puffermanipulatoren, die während eines Wiederherstellungsvorgangs erstellt werden sollen. Dieser Wert muss kleiner als das Doppelte der Zahl vCPUs für die DB-Instance sein. Wenn diese Einstellung nicht konfiguriert ist, bestimmt Db2 den Wert, der während des Wiederherstellungsvorgangs verwendet werden soll. Weitere Informationen finden Sie hier: IBM Db2 Dokumentation.

Beispiele

Im folgenden Beispiel wird die RESTORE_DATABASE_PARALLELISM Konfiguration auf gesetzt8.

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

Im folgenden Beispiel wird die RESTORE_DATABASE_NUM_BUFFERS Konfiguration auf gesetzt150.

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

rdsadmin.show_configuration

Gibt die aktuellen Einstellungen zurück, die Sie mithilfe der gespeicherten Prozedur festlegen könnenrdsadmin.set_configuration.

Syntax

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

Parameter

Der folgende Parameter ist optional:

name

Der Name der Konfigurationseinstellung, über die Informationen zurückgegeben werden sollen. Der Datentyp istvarchar.

Die folgenden Konfigurationsnamen sind gültig:

  • RESTORE_ DATABASE _ NUM _ BUFFERS — Die Anzahl der Puffer, die während eines Wiederherstellungsvorgangs erstellt werden sollen.

  • RESTORE_ DATABASE _ PARALLELISM — Die Anzahl der Puffermanipulatoren, die während eines Wiederherstellungsvorgangs erstellt werden sollen.

Nutzungshinweise

Wenn Sie den Namen einer Konfigurationseinstellung nicht angeben, werden Informationen für alle Konfigurationseinstellungen rdsadmin.show_configuration zurückgegeben, die Sie mithilfe der gespeicherten Prozedur festlegen können. rdsadmin.set_configuration

Beispiele

Im folgenden Beispiel werden Informationen zur aktuellen RESTORE_DATABASE_PARALLELISM Konfiguration zurückgegeben.

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

rdsadmin.restore_database

Stellt eine Datenbank wieder her.

Syntax

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

Parameter

Der folgende Ausgabeparameter ist erforderlich:

?

Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur?.

Die folgenden Eingabeparameter sind erforderlich:

database_name

Der Name der wiederherzustellenden Datenbank. Dieser Name muss mit dem Namen der Datenbank im Backup-Image übereinstimmen. Der Datentyp istvarchar.

s3_bucket_name

Der Name des Amazon S3 S3-Buckets, in dem sich Ihr Backup befindet. Der Datentyp istvarchar.

s3_prefix

Das Präfix, das für den Dateiabgleich beim Herunterladen verwendet werden soll. Der Datentyp istvarchar.

Wenn dieser Parameter leer ist, werden alle Dateien im Amazon S3 S3-Bucket heruntergeladen. Das Folgende ist ein Beispiel für ein Präfix:

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

Der Zeitstempel des Datenbank-Backup-Images. Der Datentyp istvarchar.

Der Zeitstempel ist im Namen der Sicherungsdatei enthalten. 20230615010101Ist zum Beispiel der Zeitstempel für den Dateinamen. SAMPLE.0.rdsdb.DBPART000.20230615010101.001

backup_type

Die Art der Sicherung. Der Datentyp istvarchar. Zulässige Werte: OFFLINE, ONLINE.

Wird ONLINE für Migrationen verwendet, bei denen fast keine Ausfallzeiten auftreten. Weitere Informationen finden Sie unter Migration von Linux to Linux mit nahezu null Ausfallzeiten für Amazon for Db2 RDS.

Nutzungshinweise

Bevor Sie die gespeicherte Prozedur aufrufen, sollten Sie sich die folgenden Überlegungen ansehen:

  • Sie können eine Datenbank wiederherstellen, indem Sie sie rdsadmin.restore_database nur aufrufen, wenn Sie den Namen der Datenbank nicht angegeben haben, als Sie Ihre RDS für Db2-DB-Instance mithilfe der RDS Amazon-Konsole oder der AWS CLI Weitere Informationen finden Sie unter Erstellen einer DB-Instance.

  • Bevor Sie eine Datenbank wiederherstellen, müssen Sie Speicherplatz RDS für Ihre Db2-DB-Instance bereitstellen, der mindestens der Summe aus der Größe Ihres Backups und der ursprünglichen Db2-Datenbank auf der Festplatte entspricht. Weitere Informationen finden Sie unter Insufficient disk space.

  • Wenn Sie das Backup wiederherstellen, RDS extrahiert Amazon die Backup-Datei auf Ihrer RDS for Db2-DB-Instance. Jede Backup-Datei muss 5 TB oder kleiner sein. Wenn eine Sicherungsdatei größer als 5 TB ist, müssen Sie die Sicherungsdatei in kleinere Dateien aufteilen.

  • Um alle Dateien mithilfe der rdsadmin.restore_database gespeicherten Prozedur wiederherzustellen, geben Sie das Dateinummersuffix nach dem Zeitstempel nicht in die Dateinamen ein. Zum Beispiel die s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101stellt die folgenden Dateien wieder her:

    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

  • RDSfür Db2 unterstützt kein nichtautomatisches Speichern. Weitere Informationen finden Sie unter Tablespaces not restored.

  • RDSfür Db2 unterstützt keine Routinen ohne Umzäunung. Weitere Informationen finden Sie unter Non-fenced routines not allowed.

  • Um die Leistung von Datenbankwiederherstellungsvorgängen zu verbessern, können Sie die Anzahl der zu verwendenden Puffer und Puffermanipulatoren konfigurieren. RDS Um die aktuelle Konfiguration zu überprüfen, verwenden Sie. rdsadmin.show_configuration Um die Konfiguration zu ändern, verwenden Sierdsadmin.set_configuration.

Informationen zum Onlineschalten der Datenbank und zum Anwenden zusätzlicher Transaktionslogs nach dem Wiederherstellen der Datenbank finden Sie unterrdsadmin.rollforward_database.

Hinweise zur Überprüfung des Status der Datenbankwiederherstellung finden Sie unterrdsadmin.get_task_status.

Beispiele

Das folgende Beispiel stellt eine Offline-Sicherung mit einer einzelnen Datei oder mehreren Dateien wieder her, die s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101:

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

rdsadmin.rollforward_database

Bringt die Datenbank online und wendet zusätzliche Transaktionsprotokolle an, nachdem eine Datenbank durch einen Aufruf wiederhergestellt wurderdsadmin.restore_database.

Syntax

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

Parameter

Der folgende Ausgabeparameter ist erforderlich:

?

Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur?.

Die folgenden Eingabeparameter sind erforderlich:

database_name

Der Name der Datenbank, für die der Vorgang ausgeführt werden soll. Der Datentyp istvarchar.

s3_bucket_name

Der Name des Amazon S3 S3-Buckets, in dem sich Ihr Backup befindet. Der Datentyp istvarchar.

s3_prefix

Das Präfix, das für den Dateiabgleich beim Herunterladen verwendet werden soll. Der Datentyp istvarchar.

Wenn dieser Parameter leer ist, werden alle Dateien im S3-Bucket heruntergeladen. Das folgende Beispiel ist ein Beispielpräfix:

backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101

Die folgenden Eingabeparameter sind optional:

rollforward_to_option

Der Punkt, zu dem Sie weiterrollen möchten. Der Datentyp istvarchar. Zulässige Werte: END_OF_LOGS, END_OF_BACKUP. Der Standardwert ist END OF LOGS.

complete_rollforward

Gibt an, ob der Roll-Forward-Prozess abgeschlossen werden soll. Der Datentyp ist. varchar Der Standardwert ist TRUE.

WennTRUE, dann ist die Datenbank nach Abschluss online und zugänglich. WennFALSE, dann bleibt die Datenbank in einem ROLL-FORWARD PENDING Zustand.

Nutzungshinweise

Nach dem Aufruf müssen Sie aufrufenrdsadmin.restore_database, rollforward_database um Archivprotokolle aus einem S3-Bucket anzuwenden. Sie können diese gespeicherte Prozedur auch verwenden, um nach dem Aufruf zusätzliche Transaktionsprotokolle wiederherzustellenrdsadmin.restore_database.

Wenn Sie complete_rollforward auf einstellenFALSE, befindet sich Ihre Datenbank in einem ROLL-FORWARD PENDING Zustand und ist offline. Um die Datenbank online zu schalten, müssen Sie anrufenrdsadmin.complete_rollforward.

Hinweise zur Überprüfung des Status beim Rollforward der Datenbank finden Sie unterrdsadmin.get_task_status.

Beispiele

Im folgenden Beispiel wird ein Rollforward zu einer Online-Sicherung der Datenbank mit Transaktionsprotokollen durchgeführt und die Datenbank anschließend online geschaltet:

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

Im folgenden Beispiel wird ein Rollforward zu einer Online-Sicherung der Datenbank ohne Transaktionsprotokolle ausgeführt und die Datenbank anschließend online geschaltet:

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

Im folgenden Beispiel wird ein Rollforward zu einer Online-Sicherung der Datenbank mit Transaktionsprotokollen ausgeführt, ohne dass die Datenbank online geschaltet wird:

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

Im folgenden Beispiel wird ein Rollforward zu einer Online-Sicherung der Datenbank mit zusätzlichen Transaktionsprotokollen durchgeführt, ohne dass die Datenbank online geschaltet wird:

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

rdsadmin.complete_rollforward

Bringt die Datenbank aus einem bestimmten ROLL-FORWARD PENDING Zustand online.

Syntax

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

Parameter

Der folgende Ausgabeparameter ist erforderlich:

?

Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur?.

Der folgende Eingabeparameter ist erforderlich:

database_name

Der Name der Datenbank, die Sie online stellen möchten. Der Datentyp istvarchar.

Nutzungshinweise

Wenn Sie rdsadmin.rollforward_database mit der complete_rollforward Einstellung auf aufgerufen habenFALSE, befindet sich Ihre Datenbank in einem ROLL-FORWARD PENDING Status und ist offline. Rufen Sie an, um den Roll-Forward-Vorgang abzuschließen und die Datenbank online zu schalten. rdsadmin.complete_rollforward

Hinweise zur Überprüfung des Status des Abschlusses des Roll-Forward-Prozesses finden Sie unter. rdsadmin.get_task_status

Beispiele

Das folgende Beispiel zeigt TESTDB Datenbank online:

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

rdsadmin.db2pd_command

Sammelt Informationen über eine RDS For-Db2-Datenbank.

Syntax

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

Parameter

Der folgende Eingabeparameter ist erforderlich:

db2pd_cmd

Der Name des db2pd Befehls, den Sie ausführen möchten. Der Datentyp istvarchar.

Der Parameter muss mit einem Bindestrich beginnen. Eine Liste der Parameter finden Sie unter db2pd — Db2-Datenbankbefehl überwachen und beheben in der IBM Db2 -Dokumentation.

Die folgenden Optionen werden nicht unterstützt:

  • -addnode

  • -alldatabases

  • -alldbp

  • -alldbs

  • -allmembers

  • -alm_in_memory

  • -cfinfo

  • -cfpool

  • -command

  • -dbpartitionnum

  • -debug

  • -dump

  • -everything

  • -file | -o

  • -ha

  • -interactive

  • -member

  • -pages

    Anmerkung

    -pages summary wird unterstützt.

  • -pdcollection

  • -repeat

  • -stack

  • -totalmem

Die file Unteroption wird beispielsweise nicht unterstützt. db2pd -db testdb -tcbstats file=tcbstat.out

Die Verwendung von wird beispielsweise stacks nicht unterstützt. db2pd -edus interval=5 top=10 stacks

Nutzungshinweise

Diese gespeicherte Prozedur sammelt Informationen, die bei der Überwachung und Problembehandlung von RDS Db2-Datenbanken helfen können.

Die gespeicherte Prozedur verwendet die IBM db2pdHilfsprogramm zum Ausführen verschiedener Befehle. Das db2pd Hilfsprogramm benötigt eine SYSADM Autorisierung, über die der RDS for Db2-Master-Benutzer nicht verfügt. Mit der RDS gespeicherten Amazon-Prozedur kann der Hauptbenutzer das Hilfsprogramm jedoch verwenden, um verschiedene Befehle auszuführen. Weitere Informationen über das Hilfsprogramm finden Sie unter db2pd — Db2-Datenbankbefehl überwachen und beheben im IBM Db2 -Dokumentation.

Die Ausgabe ist auf maximal 2 GB beschränkt.

Hinweise zur Überprüfung des Status der Erfassung von Informationen über die Datenbank finden Sie unterrdsadmin.get_task_status.

Beispiele

Das folgende Beispiel gibt die Verfügbarkeit einer RDS for Db2-DB-Instance zurück:

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

Das folgende Beispiel gibt die Verfügbarkeit einer Datenbank mit dem Namen zurück: TESTDB

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

Das folgende Beispiel gibt den Speicherverbrauch einer RDS for Db2-DB-Instance zurück:

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

Das folgende Beispiel gibt die Speichersätze einer RDS for Db2-DB-Instance und einer Datenbank namens zurück: TESTDB

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

rdsadmin.force_application

Zwingt Anwendungen aus einer RDS for Db2-Datenbank.

Syntax

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

Parameter

Der folgende Ausgabeparameter ist erforderlich:

?

Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur?.

Der folgende Eingabeparameter ist erforderlich:

applications

Die Anwendungen, die Sie aus einer RDS For-Db2-Datenbank ausschalten möchten. Der Datentyp istvarchar. Gültige Werte: ALL oder application_handle.

Trennen Sie die Namen mehrerer Anwendungen durch Kommas. Beispiel: 'application_handle_1, application_handle_2'.

Nutzungshinweise

Diese gespeicherte Prozedur zwingt alle Anwendungen aus einer Datenbank, sodass Sie Wartungsarbeiten durchführen können.

Die gespeicherte Prozedur verwendet die IBM FORCE APPLICATIONBefehl. Der FORCE APPLICATION Befehl erfordert die SYSCTRL Autorisierung SYSADMSYSMAINT, oder, über die der RDS for Db2-Masterbenutzer nicht verfügt. Mit der RDS gespeicherten Amazon-Prozedur kann der Hauptbenutzer den Befehl jedoch verwenden. Weitere Informationen finden Sie unter FORCEAPPLICATIONdem Befehl in der IBM Db2 -Dokumentation.

Hinweise zur Überprüfung des Status beim Abschalten von Anwendungen aus einer Datenbank finden Sie unterrdsadmin.get_task_status.

Beispiele

Im folgenden Beispiel wird die Deaktivierung aller Anwendungen aus einer RDS For-Db2-Datenbank erzwungen:

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

Im folgenden Beispiel wird die Deaktivierung von Anwendungs-Handles 99918891, und 1192 aus einer RDS For-Db2-Datenbank erzwungen:

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

rdsadmin.set_archive_log_retention

Konfiguriert den Zeitraum (in Stunden) für die Aufbewahrung von Archivprotokolldateien für die für Db2-Datenbank angegebene RDS Datenbank.

Syntax

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

Parameter

Der folgende Ausgabeparameter ist erforderlich:

?

Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur?.

Die folgenden Eingabeparameter sind erforderlich:

database_name

Der Name der Datenbank, für die die Aufbewahrung von Archivprotokollen konfiguriert werden soll. Der Datentyp istvarchar.

archive_log_retention_hours

Die Anzahl der Stunden, für die die Archiv-Protokolldateien aufbewahrt werden sollen. Der Datentyp istsmallint. Die Standardeinstellung ist0, und das Maximum ist 168 (7 Tage).

Wenn der Wert ist0, speichert Amazon die Archiv-Protokolldateien RDS nicht.

Nutzungshinweise

Standardmäßig werden die Protokolle RDS für Db2 5 Minuten lang aufbewahrt. Wir empfehlen, dass Sie Replikationstools verwenden, z. B. AWS DMS für Change Data Capture (CDC) oder IBM Q Replication, legen Sie in diesen Tools die Aufbewahrung von Protokollen für mehr als 5 Minuten fest.

Sie können die aktuellen Einstellungen für die Aufbewahrung von Archivprotokollen einsehen, indem Sie anrufenrdsadmin.show_archive_log_retention.

Sie können die Einstellung zur Aufbewahrung von Archivprotokollen in der rdsadmin Datenbank nicht konfigurieren.

Beispiele

Im folgenden Beispiel wird die Aufbewahrungszeit für Archivprotokolle für eine aufgerufene Datenbank TESTDB auf 24 Stunden festgelegt.

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

Im folgenden Beispiel wird die Aufbewahrung von Archivprotokollen für eine Datenbank mit dem Namen TESTDB deaktiviert.

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

rdsadmin.show_archive_log_retention

Gibt die aktuelle Aufbewahrungseinstellung für das Archivprotokoll für die angegebene Datenbank zurück.

Syntax

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

Parameter

Der folgende Ausgabeparameter ist erforderlich:

?

Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur?.

Der folgende Eingabeparameter ist erforderlich:

database_name

Der Name der Datenbank, für die die Einstellung zur Aufbewahrung von Archivprotokollen angezeigt werden soll. Der Datentyp istvarchar.

Beispiele

Das folgende Beispiel zeigt die Einstellung zur Aufbewahrung von Archivprotokollen für eine Datenbank namensTESTDB.

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