Datenbanken verwalten - 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.

Datenbanken verwalten

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 in der Dokumentation unter Codepage, Gebiet und Sortierung für Ihre Datenbank auswählen. IBM Db2

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 finden Sie unter Einführung in Backups und Wiederherstellen einer DB-Instance zu einer bestimmten Zeit.

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 IBM Db2 Version 2-Kollationssequenz.

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

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

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

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

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

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

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

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

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

  • IDENTITY_16BIT— Das Kompatibilitätskodierungsschema für UTF-16:8-Bit-Kollationssequenz (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 und. database_codeset database_territory

Der Standardwert ist IDENTITY.

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

database_autoconfigure_str

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

Weitere Informationen finden Sie unter AUTOCONFIGUREBefehl 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 for Db2-DB-Instance mit der Amazon RDS-Konsole oder dem AWS CLI erstellt haben. Weitere Informationen finden Sie unter Erstellen einer DB-Instance.

Besondere Überlegungen:

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

  • RDS wird nur für Db2 verwendet. AUTOMATIC STORAGE

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

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

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

Vor dem Aufrufen rdsadmin.create_database müssen Sie eine Verbindung zur rdsadmin Datenbank herstellen. Ersetzen Sie im folgenden Beispiel master_username und master_password durch Ihre RDS for Db2-DB-Instance-Informationen:

db2 connect to rdsadmin user master_username using master_password

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

Beispiele

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

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 for Db2-DB-Instance mit der Amazon RDS-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 zur Datenbank herstellen. rdsadmin Ersetzen Sie im folgenden Beispiel master_username und master_password durch Ihre RDS for Db2-DB-Instance-Informationen:

db2 connect to rdsadmin user master_username using master_password

Hinweise zur Überprüfung des Status beim Löschen einer Datenbank finden Sie unter. rdsadmin.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 Amazon RDS-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.

Zu ändernder Parameter

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

geänderter Wert

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.

Wert

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 in der IBM Db2-Dokumentation.

RESTORE_DATABASE_PARALLELISM

Die Anzahl der Puffermanipulatoren, die während eines Wiederherstellungsvorgangs erstellt werden sollen. Dieser Wert muss weniger als das Doppelte der Anzahl der 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 in der IBM Db2-Dokumentation.

Beispiele

Im folgenden Beispiel wird die RESTORE_DATABASE_PARALLELISM Konfiguration auf 8 festgelegt.

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 nahezu ohne Ausfallzeiten für Linux basierte Db2-Datenbanken.

Nutzungshinweise

Sie können eine Datenbank wiederherstellen, indem Sie aufrufen, rdsadmin.restore_database wenn Sie den Namen der Datenbank nicht angegeben haben, als Sie Ihre RDS for Db2-DB-Instance mit der Amazon RDS-Konsole oder dem AWS CLI erstellt haben. Weitere Informationen finden Sie unter Erstellen einer DB-Instance.

Bevor Sie eine Datenbank wiederherstellen, müssen Sie Speicherplatz für Ihre RDS for Db2-DB-Instance bereitstellen, der mindestens der Summe aus der Größe Ihres Backups und der ursprünglichen Db2-Datenbank auf der Festplatte entspricht. Wenn Sie das Backup wiederherstellen, extrahiert Amazon RDS die Sicherungsdatei 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. Das s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101 stellt beispielsweise 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

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

Hinweise zur Überprüfung des Status der Wiederherstellung Ihrer Datenbank finden Sie unterrdsadmin.get_task_status.

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

Beispiele

Das folgende Beispiel stellt eine Offline-Sicherung mit einer einzelnen Datei oder mehreren Dateien mit dem Präfix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101s3_wieder her:

db2 "call rdsadmin.restore_database(
    ?,
    'SAMPLE',
    'DOC-EXAMPLE-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 wurde. rdsadmin.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',
    'DOC-EXAMPLE-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 und die Datenbank dann nicht online geschaltet:

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    'DOC-EXAMPLE-BUCKET',
    'logsfolder/S0000155.LOG',
    'END_OF_LOGS',
    'FALSE')"

rdsadmin.complete_rollforward

Bringt die Datenbank aus einem ROLL-FORWARD PENDING Status 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

Im folgenden Beispiel wird die TESTDB Datenbank online geschaltet:

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 in der IBM-Dokumentation unter db2pd — Db2-Datenbankbefehl überwachen und beheben.

Die folgenden Parameter können nicht verwendet werden:

  • -rep | -repeat

  • -fil | -file

  • -db| -data | -database <dbname> ohne Unteroptionen wie -apinfo oder -logs

  • -inst | -instance

Nutzungshinweise

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

Die gespeicherte Prozedur verwendet das IBM db2pd Hilfsprogramm, um verschiedene Befehle auszuführen. Das db2pd Hilfsprogramm erfordert eine SYSADM Autorisierung, über die der RDS for Db2-Masterbenutzer nicht verfügt. Mit der gespeicherten Amazon RDS-Prozedur kann der Masterbenutzer das Hilfsprogramm jedoch verwenden, um verschiedene Befehle auszuführen. Weitere Informationen über das Hilfsprogramm finden Sie unter db2pd — Db2-Datenbankbefehl überwachen und beheben in der IBM-Dokumentation.

Die Ausgabe ist auf maximal 2 MB 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 den IBM FORCE APPLICATION Befehl. Für den FORCE APPLICATION Befehl ist eine SYSCTRL Autorisierung oder Autorisierung erforderlich SYSADMSYSMAINT, über die der RDS for Db2-Masterbenutzer nicht verfügt. Mit der gespeicherten Amazon RDS-Prozedur kann der Masterbenutzer den Befehl jedoch verwenden. Weitere Informationen finden Sie unter dem Befehl FORCE APPLICATION in der IBM-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 angegebene RDS for Db2-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 RDS die Archiv-Protokolldateien nicht.

Nutzungshinweise

Sie können die aktuelle Einstellung zur Aufbewahrung von Archivprotokollen einsehen, indem Sie Folgendes rdsadmin.show_archive_log_retention aufrufen:

Sie können die Einstellung für die 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')"