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.
# Referenz für gespeicherte Prozeduren von RDS für Db2
Sie können die DB-Instances von Amazon RDS für Db2, auf denen die Db2-Engine ausgeführt wird, durch Aufrufen integrierter gespeicherter Prozeduren verwalten.
| Gespeicherte Prozedur | Kategorie | Description |
| --- | --- | --- |
| [rdsadmin.activate\$1database](db2-sp-managing-databases.md#db2-sp-activate-database) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.activate_database`, um eine Datenbank auf einer eigenständigen DB-Instance von RDS für Db2 zu aktivieren. |
| [rdsadmin.add\$1groups](db2-sp-granting-revoking-privileges.md#db2-sp-add-groups) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.add_groups`, um einem Benutzer für eine Datenbank auf einer DB-Instance von RDS für Db2 eine oder mehrere Gruppen hinzuzufügen. |
| [rdsadmin.add\$1user](db2-sp-granting-revoking-privileges.md#db2-sp-add-user) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.add_user`, um einer Autorisierungsliste für eine Datenbank auf einer DB-Instance von RDS für Db2 einen Benutzer hinzuzufügen. |
| [rdsadmin.alter\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-alter-buffer-pool) | Pufferpools | Verwenden Sie die gespeicherte Prozedur `rdsadmin.alter_bufferpool`, um einen Pufferpool für eine Datenbank auf einer DB-Instance von RDS für Db2 zu ändern. |
| [rdsadmin.alter\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-alter-tablespace) | Tablespaces | Verwenden Sie die gespeicherte Prozedur `rdsadmin.alter_tablespace`, um ein Tablespace für eine Datenbank auf einer DB-Instance von RDS für Db2 zu ändern. |
| [rdsadmin.backup\$1database](db2-sp-managing-databases.md#db2-sp-backup-database) | Datenbank | Verwenden Sie die `rdsadmin.backup_database` gespeicherte Prozedur, um eine Datenbank auf einer RDS for Db2-DB-Instance in einem Amazon S3 S3-Bucket zu sichern. Anschließend können Sie das Backup von Amazon S3 auf einer RDS for Db2-DB-Instance oder an einem anderen Ort, z. B. einem lokalen Server, wiederherstellen. |
| [rdsadmin.catalog\$1storage\$1access](db2-sp-managing-storage-access.md#db2-sp-catalog-storage-access) | Speicherzugriff | Verwenden Sie die gespeicherte Prozedur `rdsadmin.catalog_storage_access`, um einen Speicheralias für den Zugriff auf einen Amazon-S3-Bucket mit Db2-Datendateien für eine Datenbank auf einer DB-Instance von RDS für Db2 zu katalogisieren. |
| [rdsadmin.change\$1password](db2-sp-granting-revoking-privileges.md#db2-sp-change-password) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.change_password`, um das Passwort eines Benutzers für eine Datenbank auf einer DB-Instance von RDS für Db2 zu ändern. |
| [rdsadmin.complete\$1rollforward](db2-sp-managing-databases.md#db2-sp-complete-rollforward) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.complete_rollforward`, um eine Datenbank auf einer DB-Instance von RDS für Db2 im Status `ROLL-FORWARD PENDING` online zu schalten. Der Status `ROLL-FORWARD PENDING` liegt vor, wenn Sie [rdsadmin.rollforward\$1database](db2-sp-managing-databases.md#db2-sp-rollforward-database) aufgerufen haben, den Parameter `complete_rollforward` jedoch auf `FALSE` festgelegt haben. |
| [rdsadmin.configure\$1db\$1audit](db2-sp-managing-audit-policies.md#db2-sp-configure-db-audit) | Audit-Richtlinien | Verwenden Sie die gespeicherte Prozedur `rdsadmin.configure_db_audit`, um eine Audit-Richtlinie für eine Datenbank auf einer DB-Instance von RDS für Db2 zu ändern. Wenn keine Audit-Richtlinie vorhanden ist, wird durch die Ausführung dieser gespeicherten Prozedur eine Audit-Richtlinie erstellt. |
| [rdsadmin.create\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-create-buffer-pool) | Pufferpools | Verwenden Sie die gespeicherte Prozedur `rdsadmin.create_bufferpool`, um einen Pufferpool für eine Datenbank auf einer DB-Instance von RDS für Db2 zu erstellen. |
| [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.create_database`, um eine Datenbank auf einer DB-Instance von RDS für Db2 zu erstellen. |
| [rdsadmin.create\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-create-role) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.create_role`, um eine Rolle zum Anfügen an eine Datenbank auf einer DB-Instance von RDS für Db2 zu erstellen. |
| [rdsadmin.create\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-create-tablespace) | Tablespaces | Verwenden Sie die gespeicherte Prozedur `rdsadmin.create_tablespace`, um ein Tablespace für eine Datenbank auf einer DB-Instance von RDS für Db2 zu erstellen. |
| [rdsadmin.db2pd\$1command](db2-sp-managing-databases.md#db2-sp-db2pd-command) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.db2pd_command`, um Informationen über eine Datenbank auf einer DB-Instance von RDS für Db2 zu erfassen. Diese Informationen können bei der Überwachung und Fehlerbehebung für Datenbanken in RDS für Db2 hilfreich sein. |
| [rdsadmin.db2support\$1command](db2-sp-managing-databases.md#db2-sp-db2support-command) | Datenbanken | Verwenden Sie die `rdsadmin.db2support_command` gespeicherte Prozedur, um Diagnoseinformationen über eine Datenbank auf einer RDS for Db2-DB-Instance zu sammeln und sie in einen Amazon S3 S3-Bucket hochzuladen. |
| [rdsadmin.dbadm\$1grant](db2-sp-granting-revoking-privileges.md#db2-sp-dbadm-grant) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.dbadm_grant`, um einer oder mehreren Rollen, Benutzern oder Gruppen für eine Datenbank auf einer DB-Instance von RDS für Db2 einen oder mehrere Autorisierungstypen (`DBADM`, `ACCESSCTRL` oder `DATAACCESS`) zu gewähren. |
| [rdsadmin.dbadm\$1revoke](db2-sp-granting-revoking-privileges.md#db2-sp-dbadm-revoke) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.dbadm_revoke`, um eine oder mehrere Autorisierungstypen (`DBADM`, `ACCESSCTRL` oder `DATAACCESS`) von einer oder mehreren Rollen, Benutzern oder Gruppen für eine Datenbank auf einer DB-Instance von RDS für Db2 zurückzunehmen. |
| [rdsadmin.deactivate\$1database](db2-sp-managing-databases.md#db2-sp-deactivate-database) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.deactivate_database`, um eine Datenbank auf einer DB-Instance von RDS für Db2 zu deaktivieren. Sie können Datenbanken deaktivieren, um Speicherressourcen zu schonen. |
| [rdsadmin.disable\$1db\$1audit](db2-sp-managing-audit-policies.md#db2-sp-disable-db-audit) | Audit-Richtlinien | Verwenden Sie die gespeicherte Prozedur `rdsadmin.disable_db_audit`, um die Audit-Protokollierung zu beenden und eine Audit-Richtlinie von einer Datenbank auf einer DB-Instance von RDS für Db2 zu entfernen. |
| [rdsadmin.drop\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-drop-buffer-pool) | Pufferpools | Verwenden Sie die gespeicherte Prozedur `rdsadmin.drop_bufferpool`, um einen Pufferpool aus einer Datenbank auf einer DB-Instance von RDS für Db2 zu verwerfen. |
| [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.drop_database`, um eine Datenbank aus einer DB-Instance von RDS für Db2 zu verwerfen. |
| [rdsadmin.drop\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-drop-role) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.drop_role`, um eine Rolle aus einer Datenbank auf einer DB-Instance von RDS für Db2 zu löschen. |
| [rdsadmin.drop\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-drop-tablespace) | Tablespaces | Verwenden Sie die gespeicherte Prozedur `rdsadmin.drop_tablespace`, um ein Tablespace aus einer Datenbank auf einer DB-Instance von RDS für Db2 zu verwerfen. |
| [rdsadmin.fgac\$1command](db2-sp-managing-databases.md#db2-sp-fgac-command) | Datenbanken | Verwenden Sie die `rdsadmin.fgac_command` gespeicherte Prozedur, um den Zugriff auf Zeilen- oder Spaltenebene auf Tabellendaten in Ihrer Datenbank auf einer RDS for Db2-DB-Instance zu steuern. |
| [rdsadmin.force\$1application](db2-sp-managing-databases.md#db2-sp-force-application) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.force_application`, um die Deaktivierung von Anwendungen einer Datenbank auf einer DB-Instance von RDS für Db2 zu erzwingen, um Wartungsarbeiten durchzuführen. |
| [rdsadmin.grant\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-grant-role) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.grant_role`, um einer berechtigten Rolle, einem berechtigten Benutzer oder einer berechtigten Gruppe in einer Datenbank auf einer DB-Instance von RDS für Db2 eine Rolle zuzuweisen. Sie können diese gespeicherte Prozedur auch verwenden, um die Autorisierung `DBADM` für die berechtigte Rolle zum Zuweisen von Rollen zu gewähren. |
| [rdsadmin.list\$1archive\$1log\$1information](db2-sp-managing-databases.md#db2-sp-list-archive-log-information) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.list_archive_log_information`, um Informationen über Archivprotokolle für eine Datenbank auf einer DB-Instance von RDS für Db2 zurückzugeben. Zu diesen Informationen gehören Details wie die Größe und das Erstellungsdatum einzelner Protokolldateien sowie der Gesamtspeicherplatz, der von den Archivprotokolldateien belegt wird. |
| [rdsadmin.list\$1sid\$1group\$1mapping](db2-sp-granting-revoking-privileges.md#db2-sp-list-sid-group-mapping) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.list_sid_group_mapping`, um eine Liste aller Sicherheits-IDs (SID) und Active-Directory-Gruppenzuordnungen zurückzugeben, die auf einer DB-Instance von RDS für Db2 konfiguriert sind. |
| [rdsadmin.list\$1users](db2-sp-granting-revoking-privileges.md#db2-sp-list-users) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.list_users`, um eine Liste von Benutzern in einer Autorisierungsliste für eine Datenbank auf einer DB-Instance von RDS für Db2 zurückzugeben. |
| [rdsadmin.reactivate\$1database](db2-sp-managing-databases.md#db2-sp-reactivate-database) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.reactivate_database`, um eine Datenbank auf einer DB-Instance von RDS für Db2 wieder zu aktivieren, nachdem Sie Änderungen an der Datenbankkonfiguration vorgenommen haben. Für eine Datenbank auf einer eigenständigen DB-Instance können Sie entweder diese gespeicherte Prozedur oder die gespeicherte Prozedur [rdsadmin.activate\$1database](db2-sp-managing-databases.md#db2-sp-activate-database) verwenden. Für eine Datenbank auf einer Replikatquell-DB-Instance müssen Sie die gespeicherte Prozedur `rdsadmin.reactivate_database` verwenden. |
| [rdsadmin.remove\$1groups](db2-sp-granting-revoking-privileges.md#db2-sp-remove-groups) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.remove_groups`, um eine oder mehrere Gruppen eines Benutzers für eine Datenbank auf einer DB-Instance von RDS für Db2 zu entfernen. |
| [rdsadmin.remove\$1sid\$1group\$1mapping](db2-sp-granting-revoking-privileges.md#db2-sp-remove-sid-group-mapping) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.remove_sid_group_mapping`, um eine Sicherheits-ID (SID) und die entsprechende Active-Directory-Gruppenzuordnung aus einer DB-Instance von RDS für Db2 zu entfernen. |
| [rdsadmin.remove\$1user](db2-sp-granting-revoking-privileges.md#db2-sp-remove-user) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.remove_user`, um einen Benutzer aus einer Autorisierungsliste für eine Datenbank auf einer DB-Instance von RDS für Db2 zu entfernen. |
| [rdsadmin.rename\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-rename-tablespace) | Tablespaces | Verwenden Sie die gespeicherte Prozedur `rdsadmin.rename_tablespace`, um ein Tablespace für eine Datenbank auf einer DB-Instance von RDS für Db2 umzubenennen. |
| [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.restore_database`, um eine Datenbank auf einer DB-Instance von RDS für Db2 anhand eines Amazon-S3-Bucket wiederherzustellen. |
| [rdsadmin.revoke\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-revoke-role) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.revoke_role`, um eine Rolle von einer berechtigten Rolle, einem berechtigten Benutzer oder einer berechtigten Gruppe in einer Datenbank auf einer DB-Instance von RDS für Db2 zurückzunehmen. |
| [rdsadmin.rollforward\$1database](db2-sp-managing-databases.md#db2-sp-rollforward-database) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.rollforward_database`, um eine Datenbank auf einer DB-Instance von RDS für Db2 online zu schalten und Transaktionsprotokolle anzuwenden, nachdem Sie eine Datenbank auf einer DB-Instance von RDS für Db2 durch Aufrufen von [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database) wiederhergestellt haben. |
| [rdsadmin.rollforward\$1status](db2-sp-managing-databases.md#db2-sp-rollforward-status) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.rollforward_status`, um den Rollforward-Status beim Aufrufen der gespeicherten Prozedur [rdsadmin.rollforward\$1database](db2-sp-managing-databases.md#db2-sp-rollforward-database) oder [rdsadmin.complete\$1rollforward](db2-sp-managing-databases.md#db2-sp-complete-rollforward) auf einer DB-Instance von RDS für Db2 abzufragen. |
| [rdsadmin.set\$1archive\$1log\$1retention](db2-sp-managing-databases.md#db2-sp-set-archive-log-retention) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.set_archive_log_retention` zum Konfigurieren, wie lange die Archivprotokolldateien für eine Datenbank auf einer DB-Instance von RDS für Db2 aufbewahrt werden sollen. Sie können diese gespeicherte Prozedur auch verwenden, um die Aufbewahrungsdauer von Archivprotokollen zu deaktivieren. |
| [rdsadmin.set\$1configuration](db2-sp-managing-databases.md#db2-sp-set-configuration) | Datenbanken | Verwenden Sie die gespeicherte Prozedur `rdsadmin.set_configuration`, um bestimmte Einstellungen für eine Datenbank auf einer DB-Instance von RDS für Db2 zu konfigurieren. |
| [rdsadmin.set\$1sid\$1group\$1mapping](db2-sp-granting-revoking-privileges.md#db2-sp-set-sid-group-mapping) | Gewähren und Widerrufen von Berechtigungen | Verwenden Sie die gespeicherte Prozedur `rdsadmin.set_sid_group_mapping`, um eine Zuordnung zwischen einer Sicherheits-ID (SID) und der entsprechenden Active-Directory-Gruppe auf einer DB-Instance von RDS für Db2 zu erstellen. |
| [rdsadmin.show\$1archive\$1log\$1retention](db2-sp-managing-databases.md#db2-sp-show-archive-log-retention) | Datenbanken | Verwenden Sie die gespeicherte Prozedur rdsadmin.show\$1archive\$1log\$1retention, um die aktuelle Einstellung für die Aufbewahrung von Archivprotokollen für eine Datenbank auf einer DB-Instance von RDS für Db2 zurückzugeben. |
| [rdsadmin.show\$1configuration](db2-sp-managing-databases.md#db2-sp-show-configuration) | Datenbanken | Verwenden Sie die gespeicherte Prozedur rdsadmin.show\$1configuration, um eine oder mehrere Einstellungen zurückzugeben, die für eine Datenbank auf einer DB-Instance von RDS für Db2 geändert werden können. |
| [rdsadmin.uncatalog\$1storage\$1access](db2-sp-managing-storage-access.md#db2-sp-uncatalog-storage-access) | Speicherzugriff | Verwenden Sie die gespeicherte Prozedur `rdsadmin.uncatalog_storage_access`, um einen Speicheralias für den Zugriff auf einen Amazon-S3-Bucket mit Db2-Datendateien zu entfernen. |
| [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param) | Datenbanken | Verwenden Sie die gespeicherte Prozedur rdsadmin.update\$1db\$1param, um Datenbankparameter für eine Datenbank auf einer DB-Instance von RDS für Db2 zu aktualisieren. |
| [rdsadmin.enable\$1archive\$1log\$1copy](db2-sp-managing-databases.md#db2-sp-enable_archive_log_copy) | Datenbanken | Verwenden Sie die rdsadmin.enable\$1archive\$1log\$1copy gespeicherte Prozedur, um das Kopieren des Protokollprotokolls von RDS Db2-Datenbankarchiven nach Amazon S3 zu aktivieren. |
| [rdsadmin.disable\$1archive\$1log\$1copy](db2-sp-managing-databases.md#db2-sp-disable_archive_log_copy) | Datenbanken | Verwenden Sie die rdsadmin.disable\$1archive\$1log\$1copy gespeicherte Prozedur, um die Protokollkopie des RDS-DB2-Datenbankarchivs nach Amazon S3 zu deaktivieren. |
**Topics**
+ [Überlegungen zu gespeicherten Prozeduren von Amazon RDS für Db2](db2-stored-procedures-considerations.md)
+ [Gespeicherte Prozeduren zum Gewähren und Widerrufen von Berechtigungen für RDS für Db2](db2-sp-granting-revoking-privileges.md)
+ [Gespeicherte Prozeduren für Audit-Richtlinien für RDS für Db2](db2-sp-managing-audit-policies.md)
+ [Gespeicherte Prozeduren für Pufferpools von RDS für Db2](db2-sp-managing-buffer-pools.md)
+ [Gespeicherte Prozeduren für Datenbanken von RDS für Db2](db2-sp-managing-databases.md)
+ [Gespeicherte Prozeduren für den Speicherzugriff von RDS für Db2](db2-sp-managing-storage-access.md)
+ [Gespeicherte Prozeduren für Tablespaces von RDS für Db2](db2-sp-managing-tablespaces.md)
# Überlegungen zu gespeicherten Prozeduren von Amazon RDS für Db2
Bevor Sie die gespeicherten Systemprozeduren von Amazon RDS für DB-Instances von RDS für Db2 verwenden, auf denen die Db2-Engine ausgeführt wird, lesen Sie die folgenden Informationen:
+ Vor dem Ausführen der gespeicherten Prozeduren müssen Sie zunächst als Masterbenutzer für die DB-Instance von RDS für Db2 eine Verbindung mit der Datenbank `rdsadmin` herstellen. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
+ Die gespeicherten Prozeduren geben den Parameter `ERR_MESSAGE` zurück, der darauf hinweist, ob die gespeicherte Prozedur erfolgreich ausgeführt wurde oder nicht und warum sie nicht erfolgreich ausgeführt wurde.
**Beispiele**
Das folgende Beispiel zeigt, dass die gespeicherte Prozedur erfolgreich ausgeführt wurde.
```
Parameter Name : ERR_MESSAGE
Parameter Value : -
Return Status = 0
```
Das folgende Beispiel zeigt, dass die gespeicherte Prozedur nicht erfolgreich ausgeführt wurde, weil der in der gespeicherten Prozedur verwendete Amazon-S3-Bucket-Name nicht gültig war.
```
Parameter Name : ERR_MESSAGE
Parameter Value : Invalid S3 bucket name
Return Status = -1006
```
Informationen zu Fehlermeldungen, die beim Aufrufen von gespeicherten Prozeduren zurückgegeben werden, finden Sie unter [Fehler bei gespeicherten Prozeduren](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
Informationen zum Überprüfen des Status einer gespeicherten Prozedur finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
# Gespeicherte Prozeduren zum Gewähren und Widerrufen von Berechtigungen für RDS für Db2
Mit den in diesem Thema beschrieben integrierten gespeicherten Prozeduren werden Benutzer, Rollen, Gruppen und Autorisierungen für Datenbanken von Amazon RDS für Db2 verwaltet. Um diese Prozeduren auszuführen, muss der Masterbenutzer zuerst eine Verbindung mit der Datenbank `rdsadmin` herstellen.
Aufgaben, die diese gespeicherten Prozeduren verwenden, finden Sie unter [Gewähren und Widerrufen von Berechtigungen](db2-granting-revoking-privileges.md) und [Einrichten der Kerberos-Authentifizierung](db2-kerberos-setting-up.md).
In den folgenden integrierten gespeicherten Prozeduren erhalten Sie Informationen zu deren Syntax, Parametern, Nutzungshinweisen und Beispielen.
**Topics**
+ [rdsadmin.create\$1role](#db2-sp-create-role)
+ [rdsadmin.grant\$1role](#db2-sp-grant-role)
+ [rdsadmin.revoke\$1role](#db2-sp-revoke-role)
+ [rdsadmin.drop\$1role](#db2-sp-drop-role)
+ [rdsadmin.add\$1user](#db2-sp-add-user)
+ [rdsadmin.change\$1password](#db2-sp-change-password)
+ [rdsadmin.list\$1users](#db2-sp-list-users)
+ [rdsadmin.remove\$1user](#db2-sp-remove-user)
+ [rdsadmin.add\$1groups](#db2-sp-add-groups)
+ [rdsadmin.remove\$1groups](#db2-sp-remove-groups)
+ [rdsadmin.dbadm\$1grant](#db2-sp-dbadm-grant)
+ [rdsadmin.dbadm\$1revoke](#db2-sp-dbadm-revoke)
+ [rdsadmin.set\$1sid\$1group\$1mapping](#db2-sp-set-sid-group-mapping)
+ [rdsadmin.list\$1sid\$1group\$1mapping](#db2-sp-list-sid-group-mapping)
+ [rdsadmin.remove\$1sid\$1group\$1mapping](#db2-sp-remove-sid-group-mapping)
## rdsadmin.create\$1role
Erstellt eine Rolle.
### Syntax
```
db2 "call rdsadmin.create_role(
'database_name',
'role_name')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, auf der der Befehl ausgeführt wird. Der Datentyp ist `varchar`.
*role\$1name*
Der Name der Rolle, die Sie erstellen möchten. Der Datentyp ist `varchar`.
### Nutzungshinweise
Informationen zum Überprüfen des Erstellungsstatus einer Rolle finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel wird eine Rolle mit dem Namen `MY_ROLE` für die Datenbank `DB2DB` erstellt.
```
db2 "call rdsadmin.create_role(
'DB2DB',
'MY_ROLE')"
```
## rdsadmin.grant\$1role
Weist einer Rolle, einem Benutzer oder einer Gruppe eine Rolle zu.
### Syntax
```
db2 "call rdsadmin.grant_role(
?,
'database_name',
'role_name',
'grantee',
'admin_option')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die die eindeutige Kennung für die Aufgabe ausgibt. Dieser Parameter akzeptiert nur `?`.
Die folgenden Eingabeparameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, auf der der Befehl ausgeführt wird. Der Datentyp ist `varchar`.
*role\$1name*
Der Name der Rolle, die Sie erstellen möchten. Der Datentyp ist `varchar`.
*grantee*
Die Rolle, der Benutzer oder die Gruppe, die bzw. der die Autorisierung erhalten soll. Der Datentyp ist `varchar`. Zulässige Werte: `ROLE`, `USER`, `GROUP`, `PUBLIC`.
Das Format muss ein Wert gefolgt von einem Namen sein. Trennen Sie mehrere Werte und Namen durch Kommas. Beispiel: '`USER user1, user2, GROUP group1, group2`'. Ersetzen Sie die Namen durch Ihre Informationen.
Der folgende Eingabeparameter ist optional:
*admin\$1option*
Gibt an, ob der Berechtigungsempfänger `ROLE` über die `DBADM`-Autorisierung verfügt, um Rollen zuzuweisen. Der Datentyp ist `char`. Der Standardwert ist `N`.
### Nutzungshinweise
Informationen zum Überprüfen des Zuweisungsstatus einer Rolle finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
**Beispiel 1: Zuweisen einer Rolle zu einer Rolle, Gruppe oder einem Benutzer und Gewähren der Autorisierung**
Im folgenden Beispiel wird eine Rolle mit dem Namen `ROLE_TEST` für die Datenbank `TESTDB` der Rolle mit dem Namen `role1`, dem Benutzer mit dem Namen `user1` und der Gruppe mit dem Namen `group1` zugewiesen. `ROLE_TEST` erhält die Administratorberechtigung zum Zuweisen von Rollen.
```
db2 "call rdsadmin.grant_role(
?,
'TESTDB',
'ROLE_TEST',
'ROLE role1, USER user1, GROUP group1',
'Y')"
```
**Beispiel 2: Zuweisen einer Rolle zu `PUBLIC` ohne Gewähren einer Autorisierung**
Im folgenden Beispiel wird eine Rolle mit dem Namen `ROLE_TEST` für die Datenbank `TESTDB` `PUBLIC`zugewiesen. `ROLE_TEST` erhält keine Administratorberechtigung zum Zuweisen von Rollen.
```
db2 "call rdsadmin.grant_role(
?,
'TESTDB',
'ROLE_TEST',
'PUBLIC')"
```
## rdsadmin.revoke\$1role
Widerruft eine Rolle von einer Rolle, einem Benutzer oder einer Gruppe.
### Syntax
```
db2 "call rdsadmin.revoke_role(
?,
'database_name',
'role_name',
'grantee')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die die eindeutige Kennung für die Aufgabe ausgibt. Dieser Parameter akzeptiert nur „?“.
Die folgenden Eingabeparameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, auf der der Befehl ausgeführt wird. Der Datentyp ist `varchar`.
*role\$1name*
Der Name der Rolle, die Sie widerrufen möchten. Der Datentyp ist `varchar`.
*grantee*
Die Rolle, der Benutzer oder die Gruppe, die bzw. der die Autorisierung verlieren soll. Der Datentyp ist `varchar`. Zulässige Werte: `ROLE`, `USER`, `GROUP`, `PUBLIC`.
Das Format muss ein Wert gefolgt von einem Namen sein. Trennen Sie mehrere Werte und Namen durch Kommas. Beispiel: '`USER user1, user2, GROUP group1, group2`'. Ersetzen Sie die Namen durch Ihre Informationen.
### Nutzungshinweise
Informationen zum Überprüfen des Widerrufungsstatus einer Rolle finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
**Beispiel 1: Widerrufen einer Rolle von einer Rolle, Gruppe oder einem Benutzer**
Im folgenden Beispiel wird eine Rolle mit dem Namen `ROLE_TEST` für die Datenbank `TESTDB` von der Rolle mit dem Namen `role1`, dem Benutzer mit dem Namen `user1` und der Gruppe mit dem Namen `group1` widerrufen.
```
db2 "call rdsadmin.revoke_role(
?,
'TESTDB',
'ROLE_TEST',
'ROLE role1, USER user1, GROUP group1')"
```
**Beispiel 2: Widerrufen einer Rolle von `PUBLIC`**
Im folgenden Beispiel wird eine Rolle mit dem Namen `ROLE_TEST` für die Datenbank `TESTDB` von `PUBLIC` widerrufen.
```
db2 "call rdsadmin.revoke_role(
?,
'TESTDB',
'ROLE_TEST',
'PUBLIC')"
```
## rdsadmin.drop\$1role
Entfernt eine Rolle.
### Syntax
```
db2 "call rdsadmin.drop_role(
?,
'database_name',
'role_name')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die die eindeutige Kennung für die Aufgabe ausgibt. Dieser Parameter akzeptiert nur „?“.
Die folgenden Eingabeparameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, auf der der Befehl ausgeführt wird. Der Datentyp ist `varchar`.
*role\$1name*
Der Name der Rolle, die Sie löschen möchten. Der Datentyp ist `varchar`.
### Nutzungshinweise
Informationen zum Überprüfen des Löschstatus einer Rolle finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel wird eine Rolle mit dem Namen `ROLE_TEST` für die Datenbank `TESTDB` gelöscht.
```
db2 "call rdsadmin.drop_role(
?,
'TESTDB',
'ROLE_TEST')"
```
## rdsadmin.add\$1user
Fügt einen Benutzer zu einer Autorisierungsliste hinzu.
### Syntax
```
db2 "call rdsadmin.add_user(
'username',
'password',
'group_name,group_name')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*username*
Der Benutzername eines Benutzers. Der Datentyp ist `varchar`.
*password*
Das Passwort eines Benutzers. Der Datentyp ist `varchar`.
Der folgende Parameter ist optional:
*group\$1name*
Der Name einer Gruppe, zu der Sie den Benutzer hinzufügen möchten. Der Datentyp ist `varchar`. Der Standardwert ist eine leere Zeichenfolge oder Null.
### Nutzungshinweise
Sie können einen Benutzer zu einer oder mehreren Gruppen hinzufügen, indem Sie die Gruppennamen durch Kommas trennen.
Sie können eine Gruppe erstellen, wenn Sie einen neuen Benutzer erstellen, oder wenn Sie [einem vorhandenen Benutzer eine Gruppe hinzufügen](db2-granting-revoking-privileges.md#add-group-to-user). Sie können eine Gruppe nicht alleine erstellen.
**Anmerkung**
Die maximale Anzahl von Benutzern, die Sie mithilfe des Aufrufs `rdsadmin.add_user` hinzufügen können, beträgt 5 000.
Weitere Informationen zum Überprüfen des Hinzufügungsstatus für einen Benutzer finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel wird ein Benutzer mit dem Namen `jorge_souza` erstellt und den Gruppen mit den Namen `sales` und `inside_sales` zugewiesen.
```
db2 "call rdsadmin.add_user(
'jorge_souza',
'*******',
'sales,inside_sales')"
```
## rdsadmin.change\$1password
Ändert das Passwort eines Benutzers.
### Syntax
```
db2 "call rdsadmin.change_password(
'username',
'new_password')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*username*
Der Benutzername eines Benutzers. Der Datentyp ist `varchar`.
*new\$1password*
Ein neues Passwort für den Benutzer. Der Datentyp ist `varchar`.
### Nutzungshinweise
Weitere Informationen zum Überprüfen des Status der Passwortänderung finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel wird das Passwort für `jorge_souza` geändert.
```
db2 "call rdsadmin.change_password(
'jorge_souza',
'*******')"
```
## rdsadmin.list\$1users
Führt Benutzer in einer Autorisierungsliste auf.
### Syntax
```
db2 "call rdsadmin.list_users()"
```
### Nutzungshinweise
Weitere Informationen zum Überprüfen des Auflistungsstatus für Benutzer finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
## rdsadmin.remove\$1user
Entfernt Benutzer aus der Autorisierungsliste.
### Syntax
```
db2 "call rdsadmin.remove_user('username')"
```
### Parameters
Der folgende Parameter ist erforderlich:
*username*
Der Benutzername eines Benutzers. Der Datentyp ist `varchar`.
### Nutzungshinweise
Weitere Informationen zum Überprüfen des Entfernungsstatus für einen Benutzer finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel wird `jorge_souza` der Zugriff auf Datenbanken auf DB-Instances von RDS für Db2 entzogen.
```
db2 "call rdsadmin.remove_user('jorge_souza')"
```
## rdsadmin.add\$1groups
Fügt Gruppen zu einem Benutzer hinzu.
### Syntax
```
db2 "call rdsadmin.add_groups(
'username',
'group_name,group_name')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*username*
Der Benutzername eines Benutzers. Der Datentyp ist `varchar`.
*group\$1name*
Der Name einer Gruppe, zu der Sie den Benutzer hinzufügen möchten. Der Datentyp ist `varchar`. Der Standardwert ist eine leere Zeichenfolge.
### Nutzungshinweise
Sie können einem Benutzer eine oder mehrere Gruppen hinzufügen, indem Sie die Gruppennamen durch Kommas trennen. Weitere Informationen zum Überprüfen des Hinzufügungsstatus für Gruppen finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel werden die Gruppen `direct_sales` und `b2b_sales` zum Benutzer `jorge_souza` hinzugefügt.
```
db2 "call rdsadmin.add_groups(
'jorge_souza',
'direct_sales,b2b_sales')"
```
## rdsadmin.remove\$1groups
Entfernt Gruppen von einem Benutzer.
### Syntax
```
db2 "call rdsadmin.remove_groups(
'username',
'group_name,group_name')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*username*
Der Benutzername eines Benutzers. Der Datentyp ist `varchar`.
*group\$1name*
Der Name einer Gruppe, aus der Sie den Benutzer entfernen möchten. Der Datentyp ist `varchar`.
### Nutzungshinweise
Sie können eine oder mehrere Gruppen von einem Benutzer entfernen, indem Sie die Gruppennamen durch Kommas trennen.
Weitere Informationen zum Überprüfen des Entfernungsstatus für Gruppen finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel werden die Gruppen `direct_sales` und `b2b_sales` vom Benutzer `jorge_souza` entfernt.
```
db2 "call rdsadmin.remove_groups(
'jorge_souza',
'direct_sales,b2b_sales')"
```
## rdsadmin.dbadm\$1grant
Erteilt einer Rolle, einem Benutzer oder einer Gruppe die Autorisierung `DBADM`, `ACCESSCTRL` oder `DATAACCESS`.
### Syntax
```
db2 "call rdsadmin.dbadm_grant(
?,
'database_name',
'authorization',
'grantee')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die die eindeutige Kennung für die Aufgabe ausgibt. Dieser Parameter akzeptiert nur `?`.
Die folgenden Eingabeparameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, auf der der Befehl ausgeführt wird. Der Datentyp ist `varchar`.
*authorization*
Der Typ der zu gewährenden Autorisierung. Der Datentyp ist `varchar`. Zulässige Werte: `DBADM`, `ACCESSCTRL`, `DATAACCESS`.
Trennen Sie mehrere Typen durch Kommas.
*grantee*
Die Rolle, der Benutzer oder die Gruppe, die bzw. der die Autorisierung erhalten soll. Der Datentyp ist `varchar`. Zulässige Werte: `ROLE`, `USER`, `GROUP`.
Das Format muss ein Wert gefolgt von einem Namen sein. Trennen Sie mehrere Werte und Namen durch Kommas. Beispiel: '`USER user1, user2, GROUP group1, group2`'. Ersetzen Sie die Namen durch Ihre Informationen.
### Nutzungshinweise
Die Rolle, die Zugriff erhalten soll, muss vorhanden sein.
Informationen zum Überprüfen des Gewährungsstatus für den Datenbankadmin-Zugriff finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
**Beispiel 1: Einer Rolle Datenbankadmin-Zugriff gewähren**
Im folgenden Beispiel wird der Rolle `ROLE_DBA` Datenbankadmin-Zugriff auf die Datenbank mit dem Namen `TESTDB` gewährt.
```
db2 "call rdsadmin.dbadm_grant(
?,
'TESTDB',
'DBADM',
'ROLE ROLE_DBA')"
```
**Beispiel 2: Benutzern und Gruppen Datenbankadmin-Zugriff gewähren**
Im folgenden Beispiel wird `user1` and `group1` Datenbankadmin-Zugriff auf die Datenbank mit dem Namen `TESTDB` gewährt.
```
db2 "call rdsadmin.dbadm_grant(
?,
'TESTDB',
'DBADM',
'USER user1, GROUP group1')"
```
**Beispiel 3: Mehreren Benutzern und Gruppen Datenbankadmin-Zugriff gewähren**
Im folgenden Beispiel wird `user1`, `user2`, `group1` und `group2` Datenbankadmin-Zugriff auf die Datenbank mit dem Namen `TESTDB` gewährt.
```
db2 "call rdsadmin.dbadm_grant(
?,
'TESTDB',
'DBADM',
'USER user1, user2, GROUP group1, group2')"
```
## rdsadmin.dbadm\$1revoke
Widerruft die Autorisierung `DBADM`, `ACCESSCTRL` oder `DATAACCESS` für eine Rolle, einen Benutzer oder eine Gruppe.
### Syntax
```
db2 "call rdsadmin.dbadm_revoke(
?,
'database_name',
'authorization',
'grantee')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Die eindeutige Kennung für die Aufgabe. Dieser Parameter akzeptiert nur `?`.
Die folgenden Eingabeparameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, auf der der Befehl ausgeführt wird. Der Datentyp ist `varchar`.
*authorization*
Der Typ der zu widerrufenden Autorisierung. Der Datentyp ist `varchar`. Zulässige Werte: `DBADM`, `ACCESSCTRL`, `DATAACCESS`.
Trennen Sie mehrere Typen durch Kommas.
*grantee*
Die Rolle, der Benutzer oder die Gruppe, für die bzw. den die Autorisierung widerrufen werden soll. Der Datentyp ist `varchar`. Zulässige Werte: `ROLE`, `USER`, `GROUP`.
Das Format muss ein Wert gefolgt von einem Namen sein. Trennen Sie mehrere Werte und Namen durch Kommas. Beispiel: '`USER user1, user2, GROUP group1, group2`'. Ersetzen Sie die Namen durch Ihre Informationen.
### Nutzungshinweise
Informationen zum Überprüfen des Widerrufungsstatus für den Datenbankadmin-Zugriff finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
**Beispiel 1: Widerrufen des Datenbankadmin-Zugriffs für eine Rolle**
Im folgenden Beispiel wird für die Rolle `ROLE_DBA` der Datenbankadmin-Zugriff auf die Datenbank mit dem Namen `TESTDB` widerrufen.
```
db2 "call rdsadmin.dbadm_revoke(
?,
'TESTDB',
'DBADM',
'ROLE ROLE_DBA')"
```
**Beispiel 2: Widerrufen des Datenbankadmin-Zugriffs für Benutzer und Gruppen**
Im folgenden Beispiel wird für `user1` und `group1` der Datenbankadmin-Zugriff auf die Datenbank mit dem Namen `TESTDB` widerrufen.
```
db2 "call rdsadmin.dbadm_revoke(
?,
'TESTDB',
'DBADM',
'USER user1, GROUP group1')"
```
**Beispiel 3: Widerrufen des Datenbankadmin-Zugriffs für mehrere Benutzer und Gruppen**
Im folgenden Beispiel wird für `user1`, `user2`, `group1` und `group2` der Datenbankadmin-Zugriff auf die Datenbank mit dem Namen `TESTDB` widerrufen.
```
db2 "call rdsadmin.dbadm_revoke(
?,
'TESTDB',
'DBADM',
'USER user1, user2, GROUP group1, group2')"
```
## rdsadmin.set\$1sid\$1group\$1mapping
Erstellt eine Zuordnung zwischen einer Sicherheits-ID (SID) und der entsprechenden Active Directory-Gruppe.
### Syntax
```
db2 "call rdsadmin.set_sid_group_mapping(
?,
'SID',
'group_name')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Die folgenden Eingabeparameter sind erforderlich:
*SID*
Die Sicherheits-ID (SID). Der Datentyp ist `varchar`.
*group\$1name*
Der Name der Active Directory-Gruppe, die der SID zugeordnet werden soll. Der Datentyp ist `varchar`.
### Nutzungshinweise
Verwenden Sie diese gespeicherte Prozedur, um die Kerberos-Authentifizierung mit Active-Directory-Gruppen zu aktivieren. Wenn die `SID` oder der `group_name` bereits in der Zuordnung vorhanden ist, schlägt diese gespeicherte Prozedur fehl.
Weitere Informationen zur Ermittlung der SID für eine Gruppe finden Sie unter [Schritt 8: Rufen Sie die Active Directory-Gruppen-SID ab in PowerShellSchritt 8: Rufen Sie die Active Directory-Gruppen-SID ab in PowerShell](db2-kerberos-setting-up.md#db2-kerberos-setting-up-retrieve-ad-group-sid).
Informationen zum Überprüfen des Erstellungsstatus einer Zuordnung finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel wird einer Gruppe mit dem Namen `my_group` eine SID zugeordnet.
```
db2 "call rdsadmin.set_sid_group_mapping(
?,
'S-1-5-21-9146495592-531070549-834388463-513',
'my_group')"
```
## rdsadmin.list\$1sid\$1group\$1mapping
Listet alle Zuordnungen von Sicherheits-IDs (SIDs) und Active-Directory-Gruppen auf, die auf der DB-Instance konfiguriert sind.
### Syntax
```
db2 "call rdsadmin.list_sid_group_mapping()"
```
### Nutzungshinweise
Weitere Informationen zum Überprüfen des Auflistungsstatus für Zuordnungen finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
## rdsadmin.remove\$1sid\$1group\$1mapping
Entfernt eine Sicherheits-ID (SID) und die entsprechende Active-Directory-Gruppenzuordnung aus einer DB-Instance.
### Syntax
```
db2 "call rdsadmin.remove_sid_group_mapping(
?,
'SID')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Der folgende Eingabeparameter ist erforderlich:
*SID*
Die Sicherheits-ID (SID). Der Datentyp ist `varchar`.
### Nutzungshinweise
Weitere Informationen zur Ermittlung der SID für eine Gruppe finden Sie unter [Schritt 8: Rufen Sie die Active Directory-Gruppen-SID ab in PowerShellSchritt 8: Rufen Sie die Active Directory-Gruppen-SID ab in PowerShell](db2-kerberos-setting-up.md#db2-kerberos-setting-up-retrieve-ad-group-sid).
Weitere Informationen zum Überprüfen des Entfernungsstatus von Zuordnungen finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel wird eine SID-Zuordnung aus der Gruppe entfernt, der sie zugeordnet wurde.
```
db2 "call rdsadmin.remove_sid_group_mapping(
?,
'S-1-5-21-9146495592-531070549-834388463-513')"
```
# Gespeicherte Prozeduren für Audit-Richtlinien für RDS für Db2
Mit den in diesem Thema beschrieben integrierten gespeicherten Prozeduren werden Audit-Richtlinien für Datenbanken von Amazon RDS für Db2 verwaltet, die Audit-Protokollierung verwenden. Weitere Informationen finden Sie unter [Db2-Audit-Protokollierung](Db2.Options.Audit.md). Um diese Prozeduren auszuführen, muss der Masterbenutzer zuerst eine Verbindung mit der Datenbank `rdsadmin` herstellen.
In den folgenden integrierten gespeicherten Prozeduren erhalten Sie Informationen zu deren Syntax, Parametern, Nutzungshinweisen und Beispielen.
**Topics**
+ [rdsadmin.configure\$1db\$1audit](#db2-sp-configure-db-audit)
+ [rdsadmin.disable\$1db\$1audit](#db2-sp-disable-db-audit)
## rdsadmin.configure\$1db\$1audit
Konfiguriert die Überwachungsrichtlinie für die RDS for Db2-Datenbank, die von angegeben ist. *db\$1name* Wenn die Richtlinie, die Sie konfigurieren, nicht existiert, wird sie durch Aufrufen dieser gespeicherten Prozedur erstellt. Wenn diese Richtlinie existiert, werden ihre Parameterwerte durch Aufrufen dieser gespeicherten Prozedur entsprechend Ihrer Angaben geändert.
### Syntax
```
db2 "call rdsadmin.configure_db_audit(
'db_name',
'category',
'category_setting',
'?')"
```
### Parameters
Die folgenden Parameter sind erforderlich.
*db\$1name*
Der DB-Name der Datenbank von RDS für Db2, für die die Audit-Richtlinie konfiguriert werden soll. Der Datentyp ist `varchar`.
*category*
Der Name der Kategorie, für die diese Audit-Richtlinie konfiguriert werden soll. Der Datentyp ist `varchar`. Die folgenden Werte sind für diesen Parameter gültig:
+ `ALL` – Mit `ALL` schließt Amazon RDS die Kategorien `CONTEXT`, `EXECUTE` oder `ERROR` nicht ein.
+ `AUDIT`
+ `CHECKING`
+ `CONTEXT`
+ `ERROR`
+ `EXECUTE` – Sie können diese Kategorie mit oder ohne Daten konfigurieren. „Mit Daten“ bedeutet, dass auch Eingabedatenwerte protokolliert werden, die für beliebige Host-Variablen und Parametermarkierungen bereitgestellt wurden. Die Standardeinstellung ist „ohne Daten“. Weitere Informationen finden Sie in der Beschreibung des *category\$1setting* Parameters und des. [Beispiele](#db2-sp-configure-db-audit-examples)
+ `OBJMAINT`
+ `SECMAINT`
+ `SYSADMIN`
+ `VALIDATE`
Weitere Informationen über diese Kategorien finden Sie in der [IBM Db2-Dokumentation](https://www.ibm.com/docs/en/db2/11.1?topic=statements-create-audit-policy).
*category\$1setting*
Die Einstellung für die angegebene Audit-Kategorie. Der Datentyp ist `varchar`.
Die folgende Tabelle zeigt die gültigen Einstellungswerte für jede Kategorie.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/db2-sp-managing-audit-policies.html)
### Nutzungshinweise
Stellen Sie vor dem Anruf von `rdsadmin.configure_db_audit` sicher, dass die DB-Instance von RDS für Db2 zusammen mit der Datenbank, für die Sie die Audit-Richtlinie konfigurieren, einer Optionsgruppe zugeordnet ist, die die Option `DB2_AUDIT` enthält. Weitere Informationen finden Sie unter [Einrichten der Db2-Audit-Protokollierung](Db2.Options.Audit.md#db2-audit-setting-up).
Nachdem Sie die Audit-Richtlinie konfiguriert haben, können Sie den Status der Audit-Konfiguration für die Datenbank überprüfen, indem Sie die Schritte unter [Überprüfen der Audit-Konfiguration](Db2.Options.Audit.md#db2-audit-check-config-status) befolgen.
Wenn Sie für den Parameter `category` `ALL` festlegen, werden die Kategorien `CONTEXT`, `EXECUTE` oder `ERROR` nicht eingeschlossen. Um diese Kategorien zu Ihrer Audit-Richtlinie hinzuzufügen, rufen Sie `rdsadmin.configure_db_audit` separat für jede Kategorie auf, die Sie hinzufügen möchten. Weitere Informationen finden Sie unter [Beispiele](#db2-sp-configure-db-audit-examples).
### Beispiele
In den folgenden Beispielen wird die Audit-Richtlinie für eine Datenbank mit dem Namen `TESTDB` erstellt oder geändert. Wenn in den Beispielen 1 bis 5 die Kategorie `ERROR` nicht zuvor konfiguriert wurde, ist sie auf `NORMAL` (Standard) gesetzt. Folgen Sie [Example 6: Specifying the ERROR category](#example-6), um diese Einstellung in `AUDIT` zu ändern.
**Beispiel 1: Festlegen der Kategorie `ALL`**
```
db2 "call rdsadmin.configure_db_audit('TESTDB', 'ALL', 'BOTH', ?)"
```
In diesem Beispiel konfiguriert der Aufruf die Kategorien `AUDIT`, `CHECKING`, `OBJMAINT`, `SECMAINT`, `SYSADMIN` und `VALIDATE` in der Audit-Richtlinie. Die Angabe `BOTH` bedeutet, dass sowohl erfolgreiche als auch fehlgeschlagene Ereignisse für jede dieser Kategorien geprüft werden.
**Beispiel 2: Festlegen der Kategorie `EXECUTE` mit Daten**
```
db2 "call rdsadmin.configure_db_audit('TESTDB', 'EXECUTE', 'SUCCESS,WITH', ?)"
```
In dem Beispiel konfiguriert der Aufruf die Kategorie `EXECUTE` in der Audit-Richtlinie. Die Angabe `SUCCESS,WITH` bedeutet, dass die Protokolle für diese Kategorie nur erfolgreiche Ereignisse sowie Eingabedatenwerte enthalten werden, die für Host-Variablen und Parametermarkierungen bereitgestellt wurden.
**Beispiel 3: Festlegen der Kategorie `EXECUTE` ohne Daten**
```
db2 "call rdsadmin.configure_db_audit('TESTDB', 'EXECUTE', 'FAILURE,WITHOUT', ?)"
```
In dem Beispiel konfiguriert der Aufruf die Kategorie `EXECUTE` in der Audit-Richtlinie. Die Angabe `FAILURE,WITHOUT` bedeutet, dass die Protokolle für diese Kategorie nur fehlgeschlagene Ereignisse und keine Eingabedatenwerte enthalten werden, die für Host-Variablen und Parametermarkierungen bereitgestellt wurden.
**Beispiel 4: Festlegen der Kategorie `EXECUTE` ohne Statusereignisse**
```
db2 "call rdsadmin.configure_db_audit('TESTDB', 'EXECUTE', 'NONE', ?)"
```
In dem Beispiel konfiguriert der Aufruf die Kategorie `EXECUTE` in der Audit-Richtlinie. Die Angabe `NONE` bedeutet, dass keine Ereignisse in dieser Kategorie geprüft werden.
**Beispiel 5: Festlegen der Kategorie `OBJMAINT`**
```
db2 "call rdsadmin.configure_db_audit('TESTDB', 'OBJMAINT', 'NONE', ?)"
```
In dem Beispiel konfiguriert der Aufruf die Kategorie `OBJMAINT` in der Audit-Richtlinie. Die Angabe `NONE` bedeutet, dass keine Ereignisse in dieser Kategorie geprüft werden.
**Beispiel 6: Festlegen der Kategorie `ERROR`**
```
db2 "call rdsadmin.configure_db_audit('TESTDB', 'ERROR', 'AUDIT', ?)"
```
In dem Beispiel konfiguriert der Aufruf die Kategorie `ERROR` in der Audit-Richtlinie. Die Angabe `AUDIT` bedeutet, dass alle Fehler, einschließlich derer, die in der Audit-Protokollierung selbst auftreten, in den Protokollen erfasst werden. Der Standard-Fehlertyp ist `NORMAL`. Bei `NORMAL` werden die im Rahmen des Audits generierten Fehler ignoriert, und es werden nur die `SQLCODE`s für Fehler im Zusammenhang mit dem ausgeführten Vorgang erfasst.
## rdsadmin.disable\$1db\$1audit
Beendet die Überwachungsprotokollierung für die von angegebene RDS for Db2-Datenbank *db\$1name* und entfernt die dafür konfigurierte Überwachungsrichtlinie.
**Anmerkung**
Diese gespeicherte Prozedur entfernt nur Audit-Richtlinien, die durch Aufrufen von [rdsadmin.configure\$1db\$1audit](#db2-sp-configure-db-audit) konfiguriert wurden.
### Syntax
```
db2 "call rdsadmin.disable_db_audit('db_name', ?)"
```
### Parameters
Die folgenden Parameter sind erforderlich.
*db\$1name*
Der DB-Name der Datenbank von RDS für Db2, für die die Audit-Protokollierung deaktiviert werden soll. Der Datentyp ist `varchar`.
### Nutzungshinweise
Wenn Sie `rdsadmin.disable_db_audit` aufrufen, wird die Audit-Protokollierung für die DB-Instance von RDS für Db2 nicht deaktiviert. Um die Audit-Protokollierung auf DB-Instance-Ebene zu deaktivieren, entfernen Sie die Optionsgruppe aus der DB-Instance. Weitere Informationen finden Sie unter [Deaktivieren der Db2-Audit-Protokollierung](Db2.Options.Audit.md#db2-audit-disabling).
### Beispiele
Im folgenden Beispiel wird die Audit-Protokollierung für eine Datenbank mit dem Namen `TESTDB` deaktiviert.
```
db2 "call rdsadmin.disable_db_audit('TESTDB', ?)"
```
# Gespeicherte Prozeduren für Pufferpools von RDS für Db2
Mit den in diesem Thema beschrieben integrierten gespeicherten Prozeduren werden Pufferpools von Datenbanken von Amazon RDS für Db2 verwaltet. Um diese Prozeduren auszuführen, muss der Masterbenutzer zuerst eine Verbindung mit der Datenbank `rdsadmin` herstellen.
Diese gespeicherten Prozeduren werden für eine Vielzahl von Aufgaben verwendet. Diese Liste ist nicht umfassend.
+ [Allgemeine Aufgaben für Pufferpools](db2-managing-buffer-pools.md)
+ [Generieren von Leistungsberichten](db2-managing-databases.md#db2-generating-performance-reports)
+ [Kopieren von Datenbank-Metadaten mit db2look](db2-native-db2-tools-db2look.md)
+ [Erstellen einer Repository-Datenbank für IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md#db2-creating-repo-db-monitoring-dmc)
In den folgenden integrierten gespeicherten Prozeduren erhalten Sie Informationen zu deren Syntax, Parametern, Nutzungshinweisen und Beispielen.
**Topics**
+ [rdsadmin.create\$1bufferpool](#db2-sp-create-buffer-pool)
+ [rdsadmin.alter\$1bufferpool](#db2-sp-alter-buffer-pool)
+ [rdsadmin.drop\$1bufferpool](#db2-sp-drop-buffer-pool)
## rdsadmin.create\$1bufferpool
Erstellt einen Pufferpool.
### Syntax
```
db2 "call rdsadmin.create_bufferpool(
'database_name',
'buffer_pool_name',
buffer_pool_size,
'immediate',
'automatic',
page_size,
number_block_pages,
block_size)"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, auf der der Befehl ausgeführt werden soll. Der Datentyp ist `varchar`.
*buffer\$1pool\$1name*
Der Name des Pufferpools, der erstellt werden soll. Der Datentyp ist `varchar`.
Die folgenden Parameter sind optional:
*buffer\$1pool\$1size*
Die Größe des Pufferpools in Anzahl von Seiten. Der Datentyp ist `integer`. Der Standardwert ist `-1`.
*immediate*
Gibt an, ob der Befehl sofort ausgeführt wird. Der Datentyp ist `char`. Der Standardwert ist `Y`.
*automatic*
Gibt an, ob der Pufferpool auf „automatisch“ gesetzt werden soll. Der Datentyp ist `char`. Der Standardwert ist `Y`.
*page\$1size*
Die Seitengröße des Pufferpools. Der Datentyp ist `integer`. Zulässige Werte: `4096`, `8192`, `16384`, `32768`. Der Standardwert ist `8192`.
*number\$1block\$1pages*
Die Anzahl der Blockseiten in den Pufferpools. Der Datentyp ist `integer`. Der Standardwert ist `0`.
*block\$1size*
Die Blockgröße für die Blockseiten. Der Datentyp ist `integer`. Gültige Werte: `2` to `256`. Der Standardwert ist `32`.
### Nutzungshinweise
Informationen zum Überprüfen des Erstellungsstatus eines Pufferpools finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
**Beispiel 1: Erstellen eines Pufferpools mit Standardparametern**
Das folgende Beispiel erstellt einen Pufferpool mit dem Namen `BP8` für eine Datenbank mit dem Namen `TESTDB` mit Standardparametern, sodass der Pufferpool eine Seitengröße von 8 KB verwendet.
```
db2 "call rdsadmin.create_bufferpool(
'TESTDB',
'BP8')"
```
**Beispiel 2: Erstellen eines Pufferpools, der mit automatischer Zuweisung sofort ausgeführt werden kann**
Das folgende Beispiel erstellt einen Pufferpool mit dem Namen `BP16` für eine Datenbank mit dem Namen `TESTDB`, die eine Seitengröße von 16 KB mit einer anfänglichen Seitenanzahl von 1 000 verwendet und auf „automatisch“ eingestellt ist. Db2 führt den Befehl sofort aus. Wenn Sie eine anfängliche Seitenanzahl von -1 verwenden, verwendet Db2 die automatische Zuweisung von Seiten.
```
db2 "call rdsadmin.create_bufferpool(
'TESTDB',
'BP16',
1000,
'Y',
'Y',
16384)"
```
**Beispiel 3: Erstellen eines Pufferpools zur sofortigen Ausführung mithilfe von Blockseiten**
Im folgenden Beispiel wird ein Pufferpool mit dem Namen `BP16` für eine Datenbank mit dem Namen `TESTDB` erstellt. Dieser Pufferpool hat eine Seitengröße von 16 KB mit einer anfänglichen Seitenanzahl von 10 000. Db2 führt den Befehl sofort aus und verwendet dabei 500 Blockseiten mit einer Blockgröße von 512.
```
db2 "call rdsadmin.create_bufferpool(
'TESTDB',
'BP16',
10000,
'Y',
'Y',
16384,
500,
512)"
```
## rdsadmin.alter\$1bufferpool
Ändert einen Pufferpool.
### Syntax
```
db2 "call rdsadmin.alter_bufferpool(
'database_name',
'buffer_pool_name',
buffer_pool_size,
'immediate',
'automatic',
change_number_blocks,
number_block_pages,
block_size)"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, auf der der Befehl ausgeführt werden soll. Der Datentyp ist `varchar`.
*buffer\$1pool\$1name*
Der Name des Pufferpools, der geändert werden soll. Der Datentyp ist `varchar`.
*buffer\$1pool\$1size*
Die Größe des Pufferpools in Anzahl von Seiten. Der Datentyp ist `integer`.
Die folgenden Parameter sind optional:
*immediate*
Gibt an, ob der Befehl sofort ausgeführt wird. Der Datentyp ist `char`. Der Standardwert ist `Y`.
*automatic*
Gibt an, ob der Pufferpool auf „automatisch“ gesetzt werden soll. Der Datentyp ist `char`. Der Standardwert ist `N`.
*change\$1number\$1blocks*
Gibt an, ob sich die Anzahl der Blockseiten im Pufferpool geändert hat. Der Datentyp ist `char`. Der Standardwert ist `N`.
*number\$1block\$1pages*
Die Anzahl der Blockseiten in den Pufferpools. Der Datentyp ist `integer`. Der Standardwert ist `0`.
*block\$1size*
Die Blockgröße für die Blockseiten. Der Datentyp ist `integer`. Gültige Werte: `2` to `256`. Der Standardwert ist `32`.
### Nutzungshinweise
Informationen zum Überprüfen des Änderungsstatus eines Pufferpools finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel wird ein Pufferpool mit dem Namen `BP16` für eine Datenbank mit dem Namen `TESTDB` in „nicht automatisch“ und seine Größe in 10 000 Seiten geändert. Db2 führt diesen Befehl sofort aus.
```
db2 "call rdsadmin.alter_bufferpool(
'TESTDB',
'BP16',
10000,
'Y',
'N')"
```
## rdsadmin.drop\$1bufferpool
Verwirft einen Pufferpool.
### Syntax
```
db2 "call rdsadmin.drop_bufferpool(
'database_name',
'buffer_pool_name'"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, zu der der Pufferpool gehört. Der Datentyp ist `varchar`.
*buffer\$1pool\$1name*
Der Name des Pufferpools, der entfernt werden soll. Der Datentyp ist `varchar`.
### Nutzungshinweise
Informationen zum Überprüfen des Status der Entfernung eines Pufferpools finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel wird ein Pufferpool mit dem Namen `BP16` aus einer Datenbank mit dem Namen `TESTDB` entfernt.
```
db2 "call rdsadmin.drop_bufferpool(
'TESTDB',
'BP16')"
```
# Gespeicherte Prozeduren für Datenbanken von RDS für Db2
Mit den in diesem Thema beschrieben integrierten gespeicherten Prozeduren werden Datenbanken von Amazon RDS für Db2 verwaltet. Um diese Prozeduren auszuführen, muss der Masterbenutzer zuerst eine Verbindung mit der Datenbank `rdsadmin` herstellen.
Diese gespeicherten Prozeduren werden für eine Vielzahl von Aufgaben verwendet. Diese Liste ist nicht umfassend.
+ [Häufige Aufgaben in Bezug auf Datenbanken](db2-managing-databases.md)
+ [Erstellen von Datenbanken mit EBCDIC-Sortierung](db2-ebcdic.md)
+ [Sammeln von Informationen zu Datenbanken](db2-supported-parameters.md#db2-modifying-parameters-db2-commands)
+ [Ändern der Datenbank-Konfigurationsparameter](db2-supported-parameters.md#db2-modifying-parameters-db2-commands)
+ [Migrieren von Linux zu Linux](db2-one-time-migration-linux.md)
+ [Migrieren von Linux zu Linux mit geringster Ausfallzeit](db2-near-zero-downtime-migration.md)
In den folgenden integrierten gespeicherten Prozeduren erhalten Sie Informationen zu deren Syntax, Parametern, Nutzungshinweisen und Beispielen.
**Topics**
+ [rdsadmin.create\$1database](#db2-sp-create-database)
+ [rdsadmin.deactivate\$1database](#db2-sp-deactivate-database)
+ [rdsadmin.activate\$1database](#db2-sp-activate-database)
+ [rdsadmin.reactivate\$1database](#db2-sp-reactivate-database)
+ [rdsadmin.drop\$1database](#db2-sp-drop-database)
+ [rdsadmin.update\$1db\$1param](#db2-sp-update-db-param)
+ [rdsadmin.set\$1configuration](#db2-sp-set-configuration)
+ [rdsadmin.show\$1configuration](#db2-sp-show-configuration)
+ [rdsadmin.backup\$1database](#db2-sp-backup-database)
+ [rdsadmin.restore\$1database](#db2-sp-restore-database)
+ [rdsadmin.rollforward\$1database](#db2-sp-rollforward-database)
+ [rdsadmin.rollforward\$1status](#db2-sp-rollforward-status)
+ [rdsadmin.complete\$1rollforward](#db2-sp-complete-rollforward)
+ [rdsadmin.db2pd\$1command](#db2-sp-db2pd-command)
+ [rdsadmin.force\$1application](#db2-sp-force-application)
+ [rdsadmin.set\$1archive\$1log\$1retention](#db2-sp-set-archive-log-retention)
+ [rdsadmin.show\$1archive\$1log\$1retention](#db2-sp-show-archive-log-retention)
+ [rdsadmin.list\$1archive\$1log\$1information](#db2-sp-list-archive-log-information)
+ [rdsadmin.enable\$1archive\$1log\$1copy](#db2-sp-enable_archive_log_copy)
+ [rdsadmin.disable\$1archive\$1log\$1copy](#db2-sp-disable_archive_log_copy)
+ [rdsadmin.fgac\$1command](#db2-sp-fgac-command)
+ [rdsadmin.db2support\$1command](#db2-sp-db2support-command)
## rdsadmin.create\$1database
Erstellt eine Datenbank.
### Syntax
```
db2 "call rdsadmin.create_database(
'database_name',
'database_page_size',
'database_code_set',
'database_territory',
'database_collation',
'database_autoconfigure_str',
'database_non-restrictive')"
```
### Parameters
**Anmerkung**
Mit dieser gespeicherten Prozedur wird die Kombination der erforderlichen Parameter nicht validiert. Beim Aufrufen von [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status) kann die benutzerdefinierte Funktion aufgrund einer ungültigen Kombination von `database_codeset`, `database_territory` und `database_collation` einen Fehler zurückgeben. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [Choosing the code page, territory, and collation for your database](https://www.ibm.com/docs/en/db2/11.5?topic=support-choosing-code-page-territory-collation-your-database).
Der folgende Parameter ist erforderlich:
*database\$1name*
Der Name der zu erstellenden Datenbank. Der Datentyp ist `varchar`.
Die folgenden Parameter sind optional:
*database\$1page\$1size*
Die Standard-Seitengröße der Datenbank. Zulässige Werte: `4096`, `8192`, `16384`, `32768`. Der Datentyp ist `integer`. Der Standardwert ist `8192`.
Amazon RDS unterstützt Write-Atomizitä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* beschädigt werden oder dass Teile von Daten auf die Festplatte geschrieben werden. Wenn Sie Seiten mit 32 KiB verwenden, empfehlen wir Ihnen, die point-in-time Wiederherstellung und automatische Backups zu aktivieren. Andernfalls ist nach fehlerhaften Schreibvorgängen keine Wiederherstellung möglich. Weitere Informationen erhalten Sie unter [Einführung in Backups](USER_WorkingWithAutomatedBackups.md) und [Wiederherstellen einer DB-Instance auf einen bestimmten Zeitpunkt für Amazon RDS](USER_PIT.md).
*database\$1code\$1set*
Der Codesatz für die Datenbank. Der Datentyp ist `varchar`. Der Standardwert ist `UTF-8`.
*database\$1territory*
Der zweistellige Ländercode für die Datenbank. Der Datentyp ist `varchar`. Der Standardwert ist `US`.
*database\$1collation*
Die Sortierreihenfolge, die festlegt, wie die in der Datenbank gespeicherten Zeichenfolgen sortiert und verglichen werden. Der Datentyp ist `varchar`.
Zulässige Werte:
+ `COMPATIBILITY` – Sortierreihenfolge von IBM Db2 Version 2.
+ `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 5026 (EBCDIC US-Englisch).
+ `EBCDIC_932_5035` – Japanische ASCII-Codepage, Sortierung; CCSID 5035 (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. Die Zeichenfolgen werden Byte für Byte verglichen.
+ `IDENTITY_16BIT` – Das Kompatibilitäts-Kodierungsschema für die UTF-16:8-Bit-Sortierreihenfolge (CESU-8). Weitere Informationen finden Sie im [Unicode Technical Report \$126](https://www.unicode.org/reports/tr26/tr26-4.html) auf der Website vom Unicode Consortium.
+ `NLSCHAR`— Nur zur Verwendung mit der thailändischen Codepage (CP874).
+ `SYSTEM` – Wenn Sie `SYSTEM` verwenden, nutzt die Datenbank automatisch die Sortierreihenfolge für `database_codeset` und `database_territory`.
Der Standardwert ist `IDENTITY`.
Darüber hinaus unterstützt RDS für Db2 die folgenden Sortierungsgruppen: `language-aware-collation` und `locale-sensitive-collation`. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [Choosing a collation for a Unicode database](https://www.ibm.com/docs/en/db2/11.5?topic=collation-choosing-unicode-database).
*database\$1autoconfigure\$1str*
Die Befehlssyntax `AUTOCONFIGURE`, zum Beispiel `'AUTOCONFIGURE APPLY DB'`. Der Datentyp ist `varchar`. Der Standardwert ist eine leere Zeichenfolge oder Null.
Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [AUTOCONFIGURE command](https://www.ibm.com/docs/en/db2/11.5?topic=cc-autoconfigure).
*database\$1non-restrictive*
Die Gewährung von Standardberechtigungen und -berechtigungen innerhalb der Datenbank. Der Datentyp ist `varchar`. Der Standardwert ist `N`.
Zulässige Werte:
+ `N`— Die erstellte Datenbank ist restriktiv und gewährt keine Befugnisse oder Privilegien.
+ `Y`— Die erstellte Datenbank ist nicht restriktiv und gewährt der speziellen Gruppe `PUBLIC` eine Reihe von Berechtigungen. Weitere Informationen finden Sie in der IBM Db2 Dokumentation unter [Standardberechtigungen, die beim Erstellen einer Datenbank gewährt](https://www.ibm.com/docs/en/db2/11.5.x?topic=ownership-default-privileges-granted-creating-database) werden.
### Nutzungshinweise
Wenn Sie den Parameter `db2_compatibility_vector` ändern möchten, erledigen Sie dies vor dem Erstellen einer Datenbank. Weitere Informationen finden Sie unter [Festlegen des Parameters db2\$1compatibility\$1vector](db2-known-issues-limitations.md#db2-known-issues-limitations-db2-compatibility-vector).
Spezielle Anforderungen:
+ Der an die Db2-Instance gesendete Befehl `CREATE DATABASE` verwendet die Option `RESTRICTIVE`.
+ RDS für Db2 verwendet nur `AUTOMATIC STORAGE`-Tabellenbereiche.
+ 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 Anforderungen finden Sie in der IBM Db2-Dokumentation unter [CREATE DATABASE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-create-database#:~:text=in%20the%20database.-,RESTRICTIVE,-If%20the%20RESTRICTIVE).
Vor dem Aufrufen von `rdsadmin.create_database` müssen Sie eine Verbindung mit der Datenbank `rdsadmin` herstellen. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch die Informationen Ihrer RDS for Db2-DB-Instance:
```
db2 connect to rdsadmin user master_username using master_password
```
Informationen zum Überprüfen des Erstellungsstatus einer Datenbank finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Informationen zu Fehlermeldungen, die beim Aufrufen von `rdsadmin.create_database` zurückgegeben werden, finden Sie unter [Fehler bei gespeicherten Prozeduren](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Beispiele
Im folgenden Beispiel wird eine Datenbank erstellt, die `TESTJP` mit einer korrekten Kombination der *database\$1collation* Parameter *database\$1code\$1set**database\$1territory*, und für Japan aufgerufen wird:
```
db2 "call rdsadmin.create_database('TESTJP', 4096, 'IBM-437', 'JP', 'SYSTEM')"
```
## rdsadmin.deactivate\$1database
Deaktiviert eine Datenbank.
### Syntax
```
db2 "call rdsadmin.deactivate_database(
?,
'database_name')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Der folgende Eingabeparameter ist erforderlich:
*database\$1name*
Der Name der zu deaktivierenden Datenbank. Der Datentyp ist `varchar`.
### Nutzungshinweise
Sie können Datenbanken deaktivieren, um Speicherressourcen zu schonen oder andere Änderungen an der Datenbankkonfiguration vorzunehmen. Rufen Sie die gespeicherte Prozedur [rdsadmin.activate\$1database](#db2-sp-activate-database) auf, um deaktivierte Datenbanken wieder online zu schalten.
Durch Aufrufen der gespeicherten Prozedur `rdsadmin.deactivate_database` können Sie eine Datenbank auf einer Quell-DB-Instance während der Replikation nicht deaktivieren.
Informationen zum Überprüfen des Deaktivierungsstatus einer Datenbank finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Informationen zu Fehlermeldungen, die beim Aufrufen von `rdsadmin.deactivate_database` zurückgegeben werden, finden Sie unter [Fehler bei gespeicherten Prozeduren](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Beispiele
Im folgenden Beispiel wird die Datenbank `TESTDB` deaktiviert.
```
db2 "call rdsadmin.deactivate_database(?, 'TESTDB')"
```
## rdsadmin.activate\$1database
Aktiviert eine Datenbank.
Informationen zu den Unterschieden zwischen [rdsadmin.reactivate\$1database](#db2-sp-reactivate-database) und `rdsadmin.activate_database` finden Sie unter [Nutzungshinweise](#db2-sp-activate-database-usage-notes).
### Syntax
```
db2 "call rdsadmin.activate_database(
?,
'database_name')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Der folgende Eingabeparameter ist erforderlich:
*database\$1name*
Der Name der zu aktivierenden Datenbank. Der Datentyp ist `varchar`.
### Nutzungshinweise
Alle Datenbanken werden bei der Erstellung standardmäßig aktiviert. Wenn Sie eine Datenbank auf einer eigenständigen DB-Instance [deaktivieren](), um Speicherressourcen zu schonen oder andere Änderungen an der Datenbankkonfiguration vorzunehmen, rufen Sie die gespeicherte Prozedur `rdsadmin.activate_database` auf, um die Datenbank erneut zu aktivieren.
Mit dieser gespeicherten Prozedur wird nur eine Datenbank aktiviert, die sich auf einer eigenständigen DB-Instance befindet und durch Aufrufen der gespeicherten Prozedur [rdsadmin.deactivate\$1database](#db2-sp-deactivate-database) deaktiviert wurde. Um eine Datenbank auf einer Replikatquell-DB-Instance zu aktivieren, müssen Sie die gespeicherte Prozedur [rdsadmin.reactivate\$1database](#db2-sp-reactivate-database) aufrufen.
Informationen zum Überprüfen des Aktivierungsstatus einer Datenbank finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Informationen zu Fehlermeldungen, die beim Aufrufen von `rdsadmin.activate_database` zurückgegeben werden, finden Sie unter [Fehler bei gespeicherten Prozeduren](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Beispiele
Im folgenden Beispiel wird die Datenbank `TESTDB` aktiviert.
```
db2 "call rdsadmin.activate_database(?, 'TESTDB')"
```
## rdsadmin.reactivate\$1database
Aktiviert eine Datenbank erneut.
Informationen zu den Unterschieden zwischen [rdsadmin.activate\$1database](#db2-sp-activate-database) und `rdsadmin.reactivate_database` finden Sie unter [Nutzungshinweise](#db2-sp-reactivate-database-usage-notes).
### Syntax
```
db2 "call rdsadmin.reactivate_database(
?,
'database_name')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Der folgende Eingabeparameter ist erforderlich:
*database\$1name*
Der Name der erneut zu aktivierenden Datenbank. Der Datentyp ist `varchar`.
### Nutzungshinweise
Wenn Sie die gespeicherte Prozedur `rdsadmin.reactivate_database` aufrufen, wird mit dieser zuerst die Datenbank durch Aufrufen der gespeicherten Prozedur [rdsadmin.deactivate\$1database](#db2-sp-deactivate-database) deaktiviert und dann durch Aufrufen der gespeicherten Prozedur [rdsadmin.activate\$1database](#db2-sp-activate-database) aktiviert.
Nachdem Sie Änderungen an den Datenbankkonfigurationen vorgenommen haben, müssen Sie möglicherweise eine Datenbank auf einer DB-Instance von RDS für Db2 erneut aktivieren. Um zu ermitteln, ob Sie eine Datenbank erneut aktivieren müssen, stellen Sie eine Verbindung mit der Datenbank her und führen Sie `db2 get db cfg show detail` aus.
Eine Datenbank auf einer eigenständigen DB-Instance können Sie mit der gespeicherten Prozedur `rdsadmin.reactivate_database` erneut aktivieren. Wenn Sie die gespeicherte Prozedur [rdsadmin.deactivate\$1database](#db2-sp-deactivate-database) bereits aufgerufen haben, können Sie auch stattdessen die gespeicherte Prozedur [rdsadmin.activate\$1database](#db2-sp-activate-database) aufrufen.
Für eine Datenbank auf einer Replikatquell-DB-Instance müssen Sie die gespeicherte Prozedur `rdsadmin.reactivate_database` verwenden, um sie erneut zu aktivieren.
Informationen zum Überprüfen des Reaktivierungsstatus einer Datenbank finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Informationen zu Fehlermeldungen, die beim Aufrufen von `rdsadmin.reactivate_database` zurückgegeben werden, finden Sie unter [Fehler bei gespeicherten Prozeduren](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Beispiele
Im folgenden Beispiel wird die Datenbank `TESTDB` erneut aktiviert.
```
db2 "call rdsadmin.reactivate_database(?, 'TESTDB')"
```
## rdsadmin.drop\$1database
Entfernt eine Datenbank.
### Syntax
```
db2 "call rdsadmin.drop_database('database_name')"
```
### Parameters
Der folgende Parameter ist erforderlich:
*database\$1name*
Der Name der zu entfernenden Datenbank. Der Datentyp ist `varchar`.
### Nutzungshinweise
Sie können eine Datenbank durch Aufrufen von `rdsadmin.drop_database` nur dann entfernen, wenn die folgenden Bedingungen erfüllt sind:
+ Beim Erstellen der DB-Instance von RDS für Db2 mithilfe der Amazon-RDS-Konsole oder der AWS CLI haben Sie den Namen der Datenbank nicht angegeben. Weitere Informationen finden Sie unter [Erstellen einer DB-Instance](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
+ Sie haben die Datenbank durch Aufrufen der gespeicherten Prozedur [rdsadmin.create\$1database](#db2-sp-create-database) erstellt.
+ Sie haben die Datenbank aus einem Offline- oder Sicherungsabbild durch Aufrufen der gespeicherten Prozedur [rdsadmin.restore\$1database](#db2-sp-restore-database) wiederhergestellt.
Vor dem Aufrufen von `rdsadmin.drop_database` müssen Sie eine Verbindung mit der Datenbank `rdsadmin` herstellen. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre RDS for Db2-DB-Instance-Informationen:
```
db2 connect to rdsadmin user master_username using master_password
```
Informationen zum Überprüfen des Löschstatus einer Datenbank finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Informationen zu Fehlermeldungen, die beim Aufrufen von `rdsadmin.drop_database` zurückgegeben werden, finden Sie unter [Fehler bei gespeicherten Prozeduren](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Beispiele
Im folgenden Beispiel wird die Datenbank `TESTDB` entfernt:
```
db2 "call rdsadmin.drop_database('TESTDB')"
```
## rdsadmin.update\$1db\$1param
Aktualisiert die Datenbankparameter.
### Syntax
```
db2 "call rdsadmin.update_db_param(
'database_name',
'parameter_to_modify',
'changed_value',
'restart_database')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, für die die Aufgabe ausgeführt werden soll. Der Datentyp ist `varchar`.
*parameter\$1to\$1modify*
Der Name des zu ändernden Parameters. Der Datentyp ist `varchar`. Weitere Informationen finden Sie unter [Parameter von Amazon RDS für Db2](db2-supported-parameters.md).
*changed\$1value*
Der Wert, in den der Parameterwert geändert werden soll. Der Datentyp ist `varchar`.
Der folgende Parameter ist optional:
*restart\$1database*
Gibt an, ob RDS die Datenbank neu startet, sofern ein Neustart erforderlich ist. Der Datentyp ist `varchar`. Um `logprimary` und `logfilsiz` zu ändern, legen Sie diesen Parameter auf `'YES'` fest.
### Nutzungshinweise
Informationen zum Überprüfen des Aktualisierungsstatus von Datenbankparametern finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Informationen zu Fehlermeldungen, die beim Aufrufen von `rdsadmin.update_db_param` zurückgegeben werden, finden Sie unter [Fehler bei gespeicherten Prozeduren](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Beispiele
**Beispiel 1: Aktualisieren eines Parameters**
Im folgenden Beispiel wird der Parameter `archretrydelay` für die Datenbank `TESTDB` auf `100` aktualisiert:
```
db2 "call rdsadmin.update_db_param(
'TESTDB',
'archretrydelay',
'100')"
```
**Beispiel 2: Verzögern der Validierung von Objekten**
Im folgenden Beispiel wird die Validierung von erstellten Objekten in der Datenbank `TESTDB` verzögert, um eine Überprüfung der Abhängigkeiten zu vermeiden:
```
db2 "call rdsadmin.update_db_param(
'TESTDB',
'auto_reval',
'deferred_force')"
```
## rdsadmin.set\$1configuration
Konfiguriert spezifische Einstellungen für die Datenbank.
### Syntax
```
db2 "call rdsadmin.set_configuration(
'name',
'value')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*name*
Der Name der Konfigurationseinstellung. Der Datentyp ist `varchar`.
*value*
Der Wert der Konfigurationseinstellung. Der Datentyp ist `varchar`.
### Nutzungshinweise
In der folgenden Tabelle sind die Konfigurationseinstellungen angegeben, die Sie mit `rdsadmin.set_configuration` steuern können.
| Name | Description |
| --- | --- |
| `RESTORE_DATABASE_NUM_BUFFERS` | Die Anzahl der während einer Wiederherstellung zu erstellenden Puffer. Dieser Wert muss kleiner als die Gesamtspeichergröße der DB-Instance-Klasse sein. Wenn diese Einstellung nicht konfiguriert ist, legt Db2 den Wert fest, der während der Wiederherstellung verwendet werden soll. Weitere Informationen finden Sie in der IBM Db2 Dokumentation unter [dem Befehl RESTORE DATABASE](https://www.ibm.com/docs/en/db2/11.5?topic=commands-restore-database). |
| `RESTORE_DATABASE_PARALLELISM` | Die Anzahl der während einer Wiederherstellung zu erstellenden Puffermanipulatoren. Dieser Wert muss kleiner als das Doppelte der Zahl von v CPUs für die DB-Instance sein. Wenn diese Einstellung nicht konfiguriert ist, legt Db2 den Wert fest, der während der Wiederherstellung verwendet werden soll. Weitere Informationen finden Sie in der IBM Db2 Dokumentation unter [dem Befehl RESTORE DATABASE](https://www.ibm.com/docs/en/db2/11.5?topic=commands-restore-database). |
| `RESTORE_DATABASE_NUM_MULTI_PATHS` | Die Anzahl der Pfade (oder I/O Streams), die während einer Wiederherstellung aus Amazon S3 verwendet werden sollen. Um diese Konfigurationseinstellung verwenden zu können, benötigen Sie mehrere Sicherungsdateien. Dieser Wert kann die Leistung bei der Wiederherstellung von Datenbanken mit großen Datenmengen verbessern, da er mehrere Datenbanksicherungsdateien parallel wiederherstellt. Wir empfehlen, dass Sie diesen Wert so einstellen, dass er der Anzahl Ihrer Datenbanksicherungsdateien entspricht. Weitere Informationen finden Sie in der IBM Db2 Dokumentation unter [dem Befehl BACKUP DATABASE](https://www.ibm.com/docs/en/db2/11.5?topic=commands-backup-database). |
| `USE_STREAMING_RESTORE` | Gibt an, ob Backup-Daten direkt während der Wiederherstellung gestreamt werden sollen, anstatt zuerst das gesamte Backup auf Ihre RDS for Db2-DB-Instance herunterzuladen und dann zu extrahieren. Die Einstellung `USE_STREAMING_RESTORE` auf reduziert den Speicherbedarf `TRUE` erheblich und kann die Wiederherstellungsleistung verbessern. Diese Einstellung erfordert IBM Db2 Engine Version 11.5.9.0.sb00063198.r1 oder höher und Amazon S3 S3-Konnektivität über das elastic network interface (ENI) Ihrer Datenbank. [Weitere Informationen finden Sie in der Dokumentation unter Remotespeicher.](https://www.ibm.com/docs/en/db2/11.5.x?topic=databases-remote-storage) IBM Db2 |
### Beispiele
**Beispiel 1: Angeben der Anzahl der zu erstellenden Puffer**
Im folgenden Beispiel wird die Konfiguration `RESTORE_DATABASE_NUM_BUFFERS` auf `150` festgelegt.
```
db2 "call rdsadmin.set_configuration(
'RESTORE_DATABASE_NUM_BUFFERS',
'150')"
```
**Beispiel 2: Angabe der Anzahl der zu erstellenden Puffermanipulatoren**
Im folgenden Beispiel wird die Konfiguration `RESTORE_DATABASE_PARALLELISM` auf `8` festgelegt.
```
db2 "call rdsadmin.set_configuration(
'RESTORE_DATABASE_PARALLELISM',
'8')"
```
**Beispiel 3: Angabe der Anzahl der Pfade oder I/O Streams, die bei der Wiederherstellung verwendet werden sollen**
Im folgenden Beispiel wird die Konfiguration `RESTORE_DATABASE_NUM_MULTI_PATHS` auf `5` festgelegt.
```
db2 "call rdsadmin.set_configuration(
'RESTORE_DATABASE_NUM_MULTI_PATHS',
'5')"
```
**Beispiel 4: Einstellung der Wiederherstellung auf Stream-Backup-Daten**
Im folgenden Beispiel wird die Konfiguration `USE_STREAMING_RESTORE` auf `TRUE` festgelegt.
```
db2 "call rdsadmin.set_configuration(
'USE_STREAMING_RESTORE',
'TRUE')"
```
## rdsadmin.show\$1configuration
Gibt die aktuellen Einstellungen zurück, die Sie mithilfe der gespeicherten Prozedur `rdsadmin.set_configuration` festlegen können.
### Syntax
```
db2 "call rdsadmin.show_configuration(
'name')"
```
### Parameters
Der folgende Parameter ist optional:
*name*
Der Name der Konfigurationseinstellung, zu der Informationen zurückgegeben werden sollen. Der Datentyp ist `varchar`.
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.
+ `RESTORE_DATABASE_NUM_MULTI_PATHS`— Die Anzahl der Pfade (oder I/O Streams), die während einer Wiederherstellung aus Amazon S3 verwendet werden sollen.
+ `USE_STREAMING_RESTORE`— Gibt an, ob Backup-Daten direkt während der Wiederherstellung gestreamt werden sollen, anstatt zuerst die gesamten Backup-Daten auf Ihre RDS for Db2-DB-Instance herunterzuladen und dann zu extrahieren.
### Nutzungshinweise
Wenn Sie den Namen einer Konfigurationseinstellung nicht festlegen, gibt `rdsadmin.show_configuration` Informationen für alle Konfigurationseinstellungen zurück, die Sie mithilfe der gespeicherten Prozedur `rdsadmin.set_configuration` festlegen können.
### Beispiele
Im folgenden Beispiel werden Informationen zur aktuellen Konfiguration `RESTORE_DATABASE_PARALLELISM` zurückgegeben.
```
db2 "call rdsadmin.show_configuration(
'RESTORE_DATABASE_PARALLELISM')"
```
## rdsadmin.backup\$1database
Sichert eine Datenbank von einer RDS for Db2-DB-Instance in einem Amazon S3 S3-Bucket.
### Syntax
```
db2 "call rdsadmin.backup_database(
?,
'database_name',
's3_bucket_name',
's3_prefix',
'backup_type',
'compression_option',
'util_impact_priority',
'num_files',
'parallelism',
'num_buffers')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Die folgenden Eingabeparameter sind erforderlich:
*database\$1name*
Der Name der Zieldatenbank auf einer RDS for Db2-DB-Instance, die gesichert werden soll. Der Datentyp ist `varchar`.
Die Datenbank muss in der DB-Instance vorhanden sein. Sie können die `rdsadmin` Datenbank nicht sichern.
*s3\$1bucket\$1name*
Der Name des Amazon S3 S3-Buckets, in dem sich Ihr Backup befinden soll. Der Datentyp ist `varchar`.
Der S3-Bucket muss vor dem Aufruf vorhanden sein`rdsadmin.backup_database`, sich in derselben Zieldatenbank AWS-Region wie die Zieldatenbank in der RDS for Db2-DB-Instance befinden, die Sie sichern möchten, und über die der DB-Instance zugeordnete IAM-Rolle zugänglich sein.
*s3\$1prefix*
Das Präfix des Pfads zu Amazon S3, in den RDS for Db2 die Sicherungsdateien hochlädt. Der Datentyp ist `varchar`.
Das Präfix ist auf 1024 Zeichen begrenzt. Es darf keinen führenden oder abschließenden Schrägstrich (/) enthalten. Aufgrund einer Einschränkung beim IBM Streaming zu Amazon S3 empfehlen wir, dass das Präfix Unterverzeichnisse einschließt.
Für eine bessere Dateiverwaltung erstellt RDS for Db2 anschließend zusätzliche Verzeichnisse. *s3\$1prefix* RDS für Db2 lädt alle Sicherungsdateien auf hoch. *s3\$1prefix/dbi\$1resource\$1id/db\$1name* Wenn Sie einen *num\$1files* höheren Wert als `1` angeben, enthält das *db\$1name* Verzeichnis mehr als eine Sicherungsdatei.
Im Folgenden finden Sie ein Beispiel für einen Amazon S3 S3-Speicherort für Sicherungsdateien. Im Beispiel `backups/daily` ist der Wert für den *s3\$1prefix* Parameter festgelegt.
```
backups/daily/db-5N7FXOY4GDP7RG2NSH2ZTAI2W4/SAMPLEDB
```
*backup\$1type*
Der Sicherungstyp, der bestimmt, ob die Datenbank während der Sicherung verfügbar bleibt. Der Datentyp ist `varchar`.
Zulässige Werte:
+ `OFFLINE`— Die Datenbank ist während der Sicherung nicht verfügbar. Dieser Typ ist schneller, verursacht aber Ausfallzeiten.
+ `ONLINE`— Die Datenbank bleibt während des Backups verfügbar. `ONLINE` ist standardmäßig auf `INCLUDE LOGS` festgelegt.
Die folgenden Parameter sind optional:
*compression\$1option*
Die Art des verwendeten Komprimierungsalgorithmus, der sich auf die Backup-Zeit, die CPU-Auslastung und die Speicherkosten auswirkt. Der Datentyp ist `varchar`. Der Standardwert ist `NONE`.
Zulässige Werte:
+ `NONE`— Die größte Dateigröße, die geringste CPU-Auslastung und die günstigsten Speicherkosten.
+ `STANDARD`— Standard-Db2-Komprimierung. Nutzt`libdb2compr.so`.
+ `ZLIB`— Verbesserte Db2-Komprimierung. Verwendet `libdb2zcompr.so` Speicherplatz, ist aber rechenintensiver und kostet am teuersten.
*util\$1impact\$1priority*
Die Einstellung, mit der die Auswirkungen des Backups auf die Systemressourcen gesteuert werden. Der Datentyp ist `integer`. Gültige Werte: `1` — `100` (von niedrig bis hoch). Der Standardwert ist `50`.
Niedrigere Werte reduzieren die Auswirkungen des Backups auf die Systemressourcen, können jedoch die Zeit verlängern, die für die Sicherung der Datenbank benötigt wird. Höhere Werte können die Sicherung der Datenbank möglicherweise schneller abschließen, können sich jedoch auf andere Vorgänge auswirken. Die tatsächlichen Auswirkungen hängen von der Gesamtsystemauslastung und der `util_impact_lim` Einstellung ab. Sie können die `util_impact_lim` Einstellung in Parametergruppen anzeigen und ändern. Weitere Informationen finden Sie unter [Parameter von Amazon RDS für Db2](db2-supported-parameters.md).
*num\$1files*
Die Anzahl der parallel Upload-Streams zu Amazon S3. Der Datentyp ist `integer`. Gültige Werte: `1`–`256`.
Wir empfehlen, diesen Parameter erst festzulegen, nachdem Sie die Backup-Leistung auf die Standardwerte eingestellt haben, die Amazon RDS automatisch berechnet. Höhere Werte könnten die Leistung für große Backups verbessern, insbesondere bei Verbindungen mit hoher Bandbreite, aber ab einem bestimmten Punkt verschlechtern höhere Werte die Leistung. Achten Sie außerdem darauf, Ihre verfügbaren Systemressourcen und Netzwerkkapazitäten zu berücksichtigen.
*parallelism*
Die Anzahl der Tablespaces, die das Backup-Hilfsprogramm parallel lesen kann. Der Datentyp ist `integer`. Gültige Werte: `1`–`256`.
Es wird empfohlen, diesen Parameter erst festzulegen, nachdem Sie die Backup-Leistung auf den Standardwert eingestellt haben, den die Db2-Engine automatisch als optimalen Wert berechnet. Wenn Sie diesen Parameter festlegen, validiert Amazon RDS anhand der verfügbaren Prozessoren und führt die Backup-Anfrage nicht aus, wenn die Rechenleistung nicht ausreicht.
*num\$1buffers*
Die Anzahl der zu verwendenden Puffer. Der Datentyp ist `integer`. Gültige Werte: `1`–`268435456`.
Wir empfehlen, diesen Parameter erst festzulegen, nachdem Sie die Backup-Leistung auf die Standardeinstellung eingestellt haben, die Amazon RDS automatisch auf der Grundlage des Speichers berechnet. Wenn Sie diesen Parameter festlegen, validiert Amazon RDS anhand des verfügbaren Speichers und führt die Backup-Anfrage nicht aus, wenn der verfügbare Speicher nicht ausreicht. Wenn Sie an mehreren Speicherorten sichern (`num_files`ist auf mehr als eingestellt`1`), kann eine höhere Anzahl von Puffern die Leistung verbessern. Wenn Sie dies nicht tun `compression_option``NONE`, können Sie die Leistung verbessern, indem Sie `num_buffers` und `parallelism` erhöhen.
### Nutzungshinweise
Diese gespeicherte Prozedur erstellt asynchrone Backup-Aufgaben, die das Backup Ihrer Datenbank mithilfe der Amazon S3 S3-Integration direkt in Ihren Amazon S3 S3-Bucket streamen. Sie können Backups sowohl von Ihrem lokalen Server als auch von einer RDS for Db2-DB-Instance erstellen, sie auf Amazon S3 streamen und sie dann wiederherstellen, wo immer Sie möchten. Informationen zum Wiederherstellen einer Datenbank auf einer RDS for Db2-DB-Instance finden Sie unter. [rdsadmin.restore\$1database](#db2-sp-restore-database)
Bevor Sie die gespeicherte Prozedur aufrufen, lesen Sie die folgenden Hinweise:
+ Sie können jeweils nur eine Datenbank sichern.
+ Sie können eine Sicherung und Wiederherstellung nicht zusammen auf einer DB-Instance durchführen.
+ Die serverseitige Amazon S3 S3-Verschlüsselung mit AWS KMS (SSE-KMS) wird nicht unterstützt. Selbst wenn der S3-Bucket auf SSE-KMS eingestellt ist, verwenden die in den S3-Bucket hochgeladenen Dateien keine SSE-KMS-Verschlüsselung.
+ Um die Backup-Dateien auf Amazon S3 zu streamen, müssen Sie die Integration bereits konfiguriert haben. Weitere Informationen finden Sie unter [Integration einer DB-Instance von Amazon RDS für Db2 mit Amazon S3](db2-s3-integration.md).
+ Damit eine RDS for Db2-DB-Instance mit Amazon S3 interagieren kann, benötigen Sie eine VPC und einen Amazon S3 S3-Gateway-Endpunkt für die Nutzung privater Subnetze. Weitere Informationen erhalten Sie unter [Schritt 1: Erstellen eines VPC-Gateway-Endpunkts für Amazon S3](db2-troubleshooting.md#db2-creating-endpoint) und [Schritt 2: Überprüfen, ob der VPC-Gateway-Endpunkt für Amazon S3 vorhanden ist](db2-troubleshooting.md#db2-confirming-endpoint).
Vor dem Aufrufen von `rdsadmin.backup_database` müssen Sie eine Verbindung mit der Datenbank `rdsadmin` herstellen. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre RDS for Db2-DB-Instance-Informationen:
```
db2 connect to rdsadmin user master_username using master_password
```
Nachdem Sie Ihre Datenbank gesichert haben, stellen Sie sicher, dass Sie die Verbindung beenden.
```
terminate
```
Hinweise zur Überprüfung des Status einer Datenbanksicherung finden Sie unter[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Informationen zu Fehlermeldungen, die beim Aufrufen von `rdsadmin.backup_database` zurückgegeben werden, finden Sie unter [Fehler bei gespeicherten Prozeduren](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Beispiele
Alle Beispiele sichern eine Datenbank, die im Amazon S3 S3-Bucket aufgerufen `amzn-s3-demo-bucket` und *s3\$1prefix* auf gesetzt wird`backups/daily`. `MYDB`
**Beispiel \$11: Geben Sie an, dass die Datenbank offline und nicht verfügbar ist, bei durchschnittlicher Auslastung und einem einzigen Upload-Stream**
Im folgenden Beispiel ist die Datenbank offline, was schneller ist, aber bedeutet, dass die Datenbank während des Backups nicht verfügbar ist. Das Beispiel führt keine Komprimierung der Dateien durch, hat mittlere Auswirkungen auf die Systemressourcen und verwendet einen einzigen Upload-Stream zu Amazon S3.
```
db2 call "rdsadmin.backup_database(
?,
'MYDB',
'amzn-s3-demo-bucket',
'backups/daily',
'OFFLINE',
'NONE',
50,
1)"
```
**Beispiel \$12: Angabe der Datenbank online und verfügbar mit verbesserter Komprimierung, Medianauslastung und wenigen parallel Upload-Streams**
Im folgenden Beispiel ist die Datenbank online und während der Sicherung verfügbar. In diesem Beispiel wird eine verbesserte Komprimierung durchgeführt, was zu einer geringen Dateigröße führt, aber CPU-intensiv ist. Es hat einen etwas überdurchschnittlichen Einfluss auf die Systemressourcen und verwendet fünf Upload-Streams zu Amazon S3.
```
db2 call "rdsadmin.backup_database(
?,
'MYDB',
'amzn-s3-demo-bucket',
'backups/daily',
'ONLINE',
'ZLIB',
60,
5)"
```
**Beispiel \$13: Mit Standardwerten und Systemberechnungen wird angegeben, dass die Datenbank offline und nicht verfügbar ist**
Im folgenden Beispiel ist die Datenbank offline, was schneller ist, aber bedeutet, dass die Datenbank während der Sicherung nicht verfügbar ist. Das Beispiel verwendet die Standardkomprimierung der Dateien und die Auswirkung auf die Systemressourcen. Es ermöglicht RDS for Db2 auch, die Anzahl der parallelen Upload-Streams zu Amazon S3, Tablespaces, die parallel gelesen werden sollen, und die zu verwendenden Puffer zu berechnen.
```
db2 "call rdsadmin.backup_database(
?,
'MYDB',
'amzn-s3-demo-bucket',
'backups/daily',
'OFFLINE')"
```
**Beispiel \$14: Angabe, dass die Datenbank offline und nicht verfügbar ist, ohne Komprimierung, hohe Auslastung und benutzerdefinierte Berechnungen**
Im folgenden Beispiel ist die Datenbank offline, was schneller ist, aber bedeutet, dass die Datenbank während der Sicherung nicht verfügbar ist. Das Beispiel führt keine Komprimierung der Dateien durch, hat einen hohen Einfluss auf die Systemressourcen und verwendet 20 Upload-Streams zu Amazon S3. Es legt die maximale Anzahl von Tablespaces fest, die parallel gelesen werden sollen, was dazu führen kann, dass die Backup-Anfrage fehlschlägt, wenn die Rechenleistung nicht ausreicht. Außerdem wird die maximale Anzahl der zu verwendenden Puffer festgelegt, was dazu führen kann, dass die Backup-Anfrage fehlschlägt, wenn der Arbeitsspeicher nicht ausreicht.
```
db2 "call rdsadmin.backup_database(
?,
'MYDB',
'amzn-s3-demo-bucket',
'backups/daily',
'OFFLINE',
'NONE',
90,
20,
256,
268435456)"
```
## rdsadmin.restore\$1database
Stellt eine Datenbank aus einem Amazon-S3-Bucket für die DB-Instance von RDS für Db2 wieder her.
### Syntax
```
db2 "call rdsadmin.restore_database(
?,
'database_name',
's3_bucket_name',
's3_prefix',
restore_timestamp,
'backup_type')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Die folgenden Eingabeparameter sind erforderlich:
*database\$1name*
Der Name der Zieldatenbank, die in RDS für Db2 wiederhergestellt werden soll. Der Datentyp ist `varchar`.
Wenn der Quelldatenbankname beispielsweise lautete `TESTDB` und Sie *database\$1name* auf eingestellt haben`NEWDB`, stellt Amazon RDS `NEWDB` als Quelldatenbank wieder her.
*s3\$1bucket\$1name*
Der Name des Amazon-S3-Bucket, in dem sich das Backup befindet. Der Datentyp ist `varchar`.
*s3\$1prefix*
Das Präfix, das beim Download für den Dateiabgleich verwendet werden soll. Der Datentyp ist `varchar`.
Wenn dieser Parameter leer ist, werden alle Dateien im Amazon S3 S3-Bucket verarbeitet. Nachfolgend ist ein Beispielpräfix angegeben:
```
backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101
```
*restore\$1timestamp*
Der Zeitstempel für das Abbild des Datenbank-Backups. Der Datentyp ist `varchar`.
Der Zeitstempel ist im Namen der Backup-Datei enthalten. Beispielsweise ist `20230615010101` der Zeitstempel für den Dateinamen `SAMPLE.0.rdsdb.DBPART000.20230615010101.001`.
*backup\$1type*
Der Typ des Backups. Der Datentyp ist `varchar`. Zulässige Werte: `OFFLINE`, `ONLINE`.
Verwenden Sie `ONLINE` für Migrationen mit geringster Ausfallzeit. Weitere Informationen finden Sie unter [Migrieren von Linux zu Linux fast ohne Ausfallzeit für Amazon RDS für Db2](db2-near-zero-downtime-migration.md).
### Nutzungshinweise
Sie können diese gespeicherte Prozedur verwenden, um eine Db2-Datenbank zu einer DB-Instance von RDS für Db2 zu migrieren. Weitere Informationen finden Sie unter [Nutzung von AWS-Services zur Migration von Daten von Db2 zu Amazon RDS für Db2](db2-migration-approaches.md). Sie können diese gespeicherte Prozedur auch verwenden, um mehrere Kopien derselben Datenbank mit unterschiedlichen Datenbanknamen zu erstellen, die dasselbe Wiederherstellungsabbild nutzen.
Bevor Sie die gespeicherte Prozedur aufrufen, lesen Sie die folgenden Hinweise:
+ Bevor Sie eine Datenbank wiederherstellen, müssen Sie Speicherplatz für Ihre RDS for Db2-DB-Instance bereitstellen, der größer ist als die ursprüngliche Db2-Datenbank auf der Festplatte. Wenn Sie diese Option aktiviert haben`USE_STREAMING_RESTORE`, streamt Amazon RDS bei der Wiederherstellung Ihres Backups die Sicherungsdateien direkt von Ihrem S3-Bucket auf Ihre RDS for Db2-DB-Instance. Wenn Sie die Aktivierung nicht aktivieren`USE_STREAMING_RESTORE`, müssen Sie Speicherplatz für Ihre RDS for Db2-DB-Instance bereitstellen, der mindestens der Summe aus Backup-Größe und der ursprünglichen Db2-Datenbank auf der Festplatte entspricht. Weitere Informationen finden Sie unter [Insufficient disk space](db2-troubleshooting.md#restore-database-sp-insufficient-disk-space).
+ Wenn Sie das Backup wiederherstellen, extrahiert Amazon RDS die Backup-Datei auf der DB-Instance von RDS für Db2. Jede Backup-Datei darf maximal 5 TB umfassen. Wenn eine Sicherungsdatei größer als 5 TB ist, müssen Sie die Sicherungsdatei in kleinere Dateien aufteilen.
+ Um alle Dateien mithilfe der gespeicherten Prozedur `rdsadmin.restore_database` wiederherzustellen, geben Sie das Dateinummernsuffix nicht nach dem Zeitstempel in die Dateinamen ein. Das stellt beispielsweise die folgenden *s3\$1prefix* `backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101` 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
```
+ RDS für Db2 unterstützt keine nichtautomatische Speicherung. Weitere Informationen finden Sie unter [Tablespaces not restored](db2-troubleshooting.md#restore-database-sp-tablespaces-not-restored).
+ RDS für Db2 unterstützt keine Routinen ohne Fencing. Weitere Informationen finden Sie unter [Non-fenced routines not allowed](db2-troubleshooting.md#restore-database-sp-non-fenced-routines).
+ Um die Leistung von Datenbankwiederherstellungsvorgängen zu verbessern, können Sie die Anzahl der Puffer, Puffermanipulatoren und die Anzahl der mehreren Sicherungspfade, die RDS verwenden soll, konfigurieren. Um die Speichernutzung zu optimieren und die Leistung potenziell zu verbessern, können Sie ein Backup auch direkt von Amazon S3 streamen. Verwenden Sie [rdsadmin.show\$1configuration](#db2-sp-show-configuration), um die aktuelle Konfiguration zu überprüfen. Verwenden Sie [rdsadmin.set\$1configuration](#db2-sp-set-configuration), um die Konfiguration zu ändern.
Informationen zum Onlineschalten der Datenbank und zum Anwenden zusätzlicher Transaktionsprotokolle nach dem Wiederherstellen der Datenbank finden Sie unter [rdsadmin.rollforward\$1database](#db2-sp-rollforward-database).
Informationen zum Überprüfen des Wiederherstellungsstatus der Datenbank finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Informationen zu Fehlermeldungen, die beim Aufrufen von `rdsadmin.restore_database` zurückgegeben werden, finden Sie unter [Fehler bei gespeicherten Prozeduren](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Beispiele
Das folgende Beispiel stellt eine Offline-Sicherung mit einer einzelnen Datei oder mehreren Dateien wieder her, die Folgendes aufweisen *s3\$1prefix*`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\$1database
Schaltet die Datenbank online und wendet zusätzliche Transaktionsprotokolle an, nachdem eine Datenbank durch Aufrufen von [rdsadmin.restore\$1database](#db2-sp-restore-database) wiederhergestellt wurde.
### Syntax
```
db2 "call rdsadmin.rollforward_database(
?,
'database_name',
's3_bucket_name',
s3_prefix,
'rollforward_to_option',
'complete_rollforward')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Die folgenden Eingabeparameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, für die der Vorgang ausgeführt werden soll. Der Datentyp ist `varchar`.
*s3\$1bucket\$1name*
Der Name des Amazon-S3-Bucket, in dem sich das Backup befindet. Der Datentyp ist `varchar`.
*s3\$1prefix*
Das Präfix, das beim Download für den Dateiabgleich verwendet werden soll. Der Datentyp ist `varchar`.
Wenn dieser Parameter leer ist, werden alle Dateien im S3-Bucket heruntergeladen. Im Folgenden ist ein Beispielpräfix angegeben:
```
backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101
```
Die folgenden Eingabeparameter sind optional:
*rollforward\$1to\$1option*
Der Punkt, zu dem Sie ein Rollforward ausführen möchten. Der Datentyp ist `varchar`. Gültige Werte: `END_OF_LOGS`, `END_OF_BACKUP` mit dem Zeitstempel im Format `YYYY-MM-DD-HH.MM.SS`. Der Standardwert ist `END_OF_LOGS`.
*complete\$1rollforward*
Gibt an, ob der Rollforward-Prozess abgeschlossen werden soll. Der Datentyp ist `varchar`. Der Standardwert ist `TRUE`.
Wenn `TRUE`, dann ist die Datenbank nach Abschluss online und es kann darauf zugegriffen werden. Wenn `FALSE`, dann verbleibt die Datenbank im Status `ROLL-FORWARD PENDING`.
### Nutzungshinweise
Sie können `rds.rollforward_database` für ein Online-Backup mit enthaltenen Protokollen verwenden, die in vielen verschiedenen Szenarien On-Premises erstellt werden.
**Szenario 1: Wiederherstellen der Datenbank, Ausführen von Rollforward der enthaltenen Protokolle und Onlineschalten der Datenbank**
Nachdem `rdsadmin.restore_database()` abgeschlossen wurde, verwenden Sie die Syntax in [Beispiel 1](#db2-sp-rollforward-database-examples), um die Datenbank mit den Transaktionsprotokollen online zu schalten.
**Szenario 2: Onlineschalten der Datenbank, ohne ein Rollforward der enthaltenen Protokolle auszuführen**
Nachdem `rdsadmin.restore_database()` abgeschlossen wurde, verwenden Sie die Syntax in [Beispiel 2](#db2-sp-rollforward-database-examples), um die Datenbank ohne die Transaktionsprotokolle online zu schalten.
**Szenario 3: Ausführen eines Rollforward der im Backup enthaltenen Protokolle und Anwenden zusätzlicher Transaktionsprotokolle, wenn sie On-Premises erstellt werden**
Nachdem `rdsadmin.restore_database()` abgeschlossen wurde, verwenden Sie die Syntax in [Beispiel 3 oder Beispiel 4](#db2-sp-rollforward-database-examples), um ein Rollforward der Protokolle auszuführen, ohne die Datenbank online zu schalten.
Wenn Sie `complete_rollforward` auf `FALSE` festlegen, befindet sich die Datenbank im Status `ROLL-FORWARD PENDING` und ist offline. Um die Datenbank online zu schalten, müssen Sie [rdsadmin.complete\$1rollforward](#db2-sp-complete-rollforward) aufrufen.
Informationen zum Überprüfen des Rollforward-Status der Datenbank finden Sie unter [rdsadmin.rollforward\$1status](#db2-sp-rollforward-status).
### Beispiele
**Beispiel 1: Onlineschalten der Datenbank mit Transaktionsprotokollen**
Im folgenden Beispiel wird ein Rollforward zu einem Online-Backup der Datenbank mit Transaktionsprotokollen ausgeführt und die Datenbank dann online geschaltet:
```
db2 "call rdsadmin.rollforward_database(
?,
null,
null,
'END_OF_LOGS',
'TRUE')"
```
**Beispiel 2: Onlineschalten der Datenbank ohne Transaktionsprotokolle**
Im folgenden Beispiel wird ein Rollforward zu einem Online-Backup der Datenbank ohne Transaktionsprotokolle durchgeführt und die Datenbank dann online geschaltet:
```
db2 "call rdsadmin.rollforward_database(
?,
'TESTDB',
'amzn-s3-demo-bucket',
'logsfolder/,
'END_OF_BACKUP',
'TRUE')"
```
**Beispiel 3: Nicht-Onlineschalten der Datenbank mit Transaktionsprotokollen**
Im folgenden Beispiel wird ein Rollforward zu einem Online-Backup der Datenbank mit Transaktionsprotokollen ausgeführt und die Datenbank dann nicht online geschaltet:
```
db2 "call rdsadmin.rollforward_database(
?,
'TESTDB',
null,
'onlinebackup/TESTDB',
'END_OF_LOGS',
'FALSE')"
```
**Beispiel 4: Nicht-Onlineschalten der Datenbank mit zusätzlichen Transaktionsprotokollen**
Im folgenden Beispiel wird ein Rollforward zu einem Online-Backup der Datenbank mit zusätzlichen Transaktionsprotokollen ausgeführt und die Datenbank dann nicht online geschaltet:
```
db2 "call rdsadmin.rollforward_database(
?,
'TESTDB',
'amzn-s3-demo-bucket',
'logsfolder/S0000155.LOG',
'END_OF_LOGS',
'FALSE')"
```
## rdsadmin.rollforward\$1status
Gibt die Ausgabe von `ROLLFORWARD DATABASE database_name QUERY STATUS` zurück.
### Syntax
```
db2 "call rdsadmin.rollforward_status(
?,
'database_name')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Der folgende Eingabeparameter ist erforderlich:
*database\$1name*
Der Name der Datenbank, für die der Vorgang ausgeführt werden soll. Der Datentyp ist `varchar`.
### Nutzungshinweise
Nach dem Aufrufen von [rdsadmin.rollforward\$1database](#db2-sp-rollforward-database) können Sie `rdsadmin.rollforward_status` aufrufen, um den Status des Rollforward in der Datenbank zu überprüfen.
Informationen zum Überprüfen des Status dieser gespeicherten Prozedur finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
## rdsadmin.complete\$1rollforward
Schaltet die Datenbank aus dem Status `ROLL-FORWARD PENDING` online.
### Syntax
```
db2 "call rdsadmin.complete_rollforward(
?,
'database_name')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Der folgende Eingabeparameter ist erforderlich:
*database\$1name*
Der Name der Datenbank, die Sie online schalten möchten. Der Datentyp ist `varchar`.
### Nutzungshinweise
Wenn Sie [rdsadmin.rollforward\$1database](#db2-sp-rollforward-database) aufgerufen haben, wobei `complete_rollforward` auf `FALSE` festgelegt ist, befindet sich die Datenbank im Status `ROLL-FORWARD PENDING` und ist offline. Rufen Sie `rdsadmin.complete_rollforward` auf, um den Rollforward-Prozess abzuschließen und die Datenbank online zu schalten.
Informationen zum Überprüfen des Abschlussstatus des Rollforward-Prozesses finden Sie unter [rdsadmin.rollforward\$1status](#db2-sp-rollforward-status).
### Beispiele
Im folgenden Beispiel wird die Datenbank TESTDB online geschaltet:
```
db2 "call rdsadmin.complete_rollforward(
?,
'TESTDB')"
```
## rdsadmin.db2pd\$1command
Sammelt Informationen zu einer Datenbank von RDS für Db2.
### Syntax
```
db2 "call rdsadmin.db2pd_command('db2pd_cmd')"
```
### Parameters
Der folgende Eingabeparameter ist erforderlich:
*db2pd\$1cmd*
Der Name des Befehls `db2pd`, den Sie ausführen möchten. Der Datentyp ist `varchar`.
Der Parameter muss mit einem Bindestrich beginnen. Eine Liste der Parameter finden Sie in der IBM Db2-Dokumentation unter [db2pd - Monitor and troubleshoot Db2 database command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2pd-monitor-troubleshoot-db2-engine-activities).
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 Unteroption `file` wird nicht unterstützt. Beispiel: `db2pd -db testdb -tcbstats file=tcbstat.out`.
Die Verwendung der Option `stacks` wird nicht unterstützt. Beispiel: `db2pd -edus interval=5 top=10 stacks`.
### Nutzungshinweise
Mit dieser gespeicherten Prozedur werden Informationen gesammelt, die bei der Überwachung und Problembehandlung von Datenbanken von RDS für Db2 hilfreich sein können.
Die gespeicherte Prozedur verwendet das IBM-Dienstprogramm `db2pd`, um verschiedene Befehle auszuführen. Für das Dienstprogramm `db2pd` ist die Autorisierung `SYSADM` erforderlich, über die der Masterbenutzer von RDS für Db2 nicht verfügt. Mit der gespeicherten Amazon-RDS-Prozedur kann der Masterbenutzer das Dienstprogramm jedoch zum Ausführen verschiedener Befehle verwenden. Weitere Informationen zum Dienstprogramm finden Sie in der IBM Db2-Dokumentation unter [db2pd - Monitor and troubleshoot Db2 database command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2pd-monitor-troubleshoot-db2-engine-activities).
Die Ausgabe ist auf maximal 2 GB beschränkt.
Informationen zum Überprüfen des Erfassungsstatus von Datenbankinformationen finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
**Beispiel 1: Zurückgeben der Betriebszeit einer DB-Instance**
Im folgenden Beispiel wird die Betriebszeit einer DB-Instance von RDS für Db2 zurückgegeben:
```
db2 "call rdsadmin.db2pd_command('-')"
```
**Beispiel 2: Zurückgeben der Betriebszeit einer Datenbank**
Im folgenden Beispiel wird die Betriebszeit der Datenbank `TESTDB` zurückgegeben:
```
db2 "call rdsadmin.db2pd_command('-db TESTDB -')"
```
**Beispiel 3: Zurückgeben der Speicherauslastung einer DB-Instance**
Im folgenden Beispiel wird die Speicherauslastung einer DB-Instance von RDS für Db2 zurückgegeben:
```
db2 "call rdsadmin.db2pd_command('-dbptnmem')"
```
**Beispiel 4: Zurückgeben von Speichersätzen einer DB-Instance und Datenbank**
Im folgenden Beispiel werden die Speichersätze einer DB-Instance von RDS für Db2 und der Datenbank `TESTDB` zurückgegeben:
```
db2 "call rdsadmin.db2pd_command('-inst -db TESTDB -memsets')"
```
## rdsadmin.force\$1application
Erzwingt die Deaktivierung von Anwendungen aus einer Datenbank von RDS für Db2.
### Syntax
```
db2 "call rdsadmin.force_application(
?,
'applications')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Der folgende Eingabeparameter ist erforderlich:
*applications*
Die Anwendungen, für die Sie die Deaktivierung aus einer Datenbank von RDS für Db2 erzwingen möchten. Der Datentyp ist `varchar`. Gültige Werte: `ALL` oder *application\$1handle*.
Trennen Sie die Namen mehrerer Anwendungen durch Kommas. Beispiel: '*application\$1handle\$11*,*application\$1handle\$12*'.
### Nutzungshinweise
Mit dieser gespeicherten Prozedur wird die Deaktivierung aller Anwendungen aus einer Datenbank erzwungen, sodass Sie Wartungsarbeiten durchführen können.
Die gespeicherte Prozedur verwendet den IBM-Befehl `FORCE APPLICATION`. Für den Befehl `FORCE APPLICATION` ist die Autorisierung `SYSADM`, `SYSMAINT` oder `SYSCTRL` erforderlich, über die der Masterbenutzer von RDS für Db2 nicht verfügt. Mit der gespeicherten Amazon-RDS-Prozedur kann der Masterbenutzer den Befehl jedoch verwenden. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [FORCE APPLICATION command](https://www.ibm.com/docs/en/db2/11.1?topic=commands-force-application).
Informationen zum Überprüfen des Status der erzwungenen Deaktivierung von Anwendungen aus einer Datenbank finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
**Beispiel 1: Festlegen aller Anwendungen**
Im folgenden Beispiel wird die Deaktivierung aller Anwendungen aus einer Datenbank von RDS für Db2 erzwungen.
```
db2 "call rdsadmin.force_application(
?,
'ALL')"
```
**Beispiel 2: Festlegen mehrerer Anwendungen**
Im folgenden Beispiel wird die Deaktivierung der Anwendungs-Handles `9991`, `8891` und `1192` aus einer Datenbank von RDS für Db2 erzwungen:
```
db2 "call rdsadmin.force_application(
?,
'9991, 8891, 1192')"
```
## rdsadmin.set\$1archive\$1log\$1retention
Konfiguriert den Zeitraum (in Stunden) für die Beibehaltung von Archivprotokolldateien für die angegebene Datenbank von RDS für Db2.
### Syntax
```
db2 "call rdsadmin.set_archive_log_retention(
?,
'database_name',
'archive_log_retention_hours')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Die folgenden Eingabeparameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, für die die Beibehaltung des Archivprotokolls konfiguriert werden soll. Der Datentyp ist `varchar`.
*archive\$1log\$1retention\$1hours*
Die Anzahl der Stunden, die die Archivprotokolldateien beibehalten werden sollen. Der Datentyp ist `smallint`. Die Standardeinstellung ist`0`, und das Maximum ist `840` (35 Tage).
Wenn der Wert `0` ist, behält Amazon RDS die Archivprotokolldateien nicht bei.
### Nutzungshinweise
Standardmäßig behält RDS für Db2 Protokolle 5 Minuten lang bei. Wenn Sie Replikationstools wie AWS DMS Change Data Capture (CDC) oder verwenden, empfehlen wirIBM Q Replication, die Aufbewahrung von Protokollen in diesen Tools für mehr als 5 Minuten festzulegen.
Sie können die aktuelle Einstellung für die Beibehaltung von Archivprotokollen durch Aufrufen von [rdsadmin.show\$1archive\$1log\$1retention](#db2-sp-show-archive-log-retention) einsehen.
Sie können die Einstellung für die Beibehaltung von Archivprotokollen in der Datenbank `rdsadmin` nicht konfigurieren.
### Beispiele
**Beispiel 1: Festlegen des Beibehaltungszeitraums**
Im folgenden Beispiel wird der Beibehaltungszeitraum des Archivprotokolls für die Datenbank `TESTDB` auf 24 Stunden festgelegt.
```
db2 "call rdsadmin.set_archive_log_retention(
?,
'TESTDB',
'24')"
```
**Beispiel 2: Deaktivieren des Beibehaltungszeitraums**
Im folgenden Beispiel wird die Beibehaltung des Archivprotokolls für die Datenbank `TESTDB` deaktiviert.
```
db2 "call rdsadmin.set_archive_log_retention(
?,
'TESTDB',
'0')"
```
## rdsadmin.show\$1archive\$1log\$1retention
Gibt die aktuelle Einstellung für die Beibehaltung des Archivprotokolls für die angegebene Datenbank zurück.
### Syntax
```
db2 "call rdsadmin.show_archive_log_retention(
?,
'database_name')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Der folgende Eingabeparameter ist erforderlich:
*database\$1name*
Der Name der Datenbank, für die die Beibehaltungseinstellung des Archivprotokolls angezeigt werden soll. Der Datentyp ist `varchar`.
### Beispiele
Im folgenden Beispiel wird die Einstellung für die Beibehaltung des Archivprotokolls für die Datenbank `TESTDB` veranschaulicht.
```
db2 "call rdsadmin.show_archive_log_retention(?,'TESTDB')"
```
## rdsadmin.list\$1archive\$1log\$1information
Gibt Details zu den Archivprotokolldateien zurück, z. B. die Größe, das Datum und die Uhrzeit der Erstellung sowie den Namen der einzelnen Protokolldateien für die angegebene Datenbank. Außerdem wird die Gesamtspeichermenge zurückgegeben, die von den Protokolldateien in der Datenbank belegt wird.
### Syntax
```
db2 "call rdsadmin.list_archive_log_information(
?,
'database_name')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Der folgende Eingabeparameter ist erforderlich:
*database\$1name*
Der Name der Datenbank, für die die Archivprotokollinformationen aufgeführt werden sollen. Der Datentyp ist `varchar`.
### Beispiele
Im folgenden Beispiel werden Archivprotokollinformationen für die Datenbank `TESTDB` zurückgegeben.
```
db2 "call rdsadmin.list_archive_log_information(
?,
'TESTDB')"
```
## rdsadmin.enable\$1archive\$1log\$1copy
Aktiviert die Protokollkopie des RDS-Db2-Datenbankarchivs nach Amazon S3.
### Syntax
```
db2 "call rdsadmin.enable_archive_log_copy(
?,
'database_name')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Der folgende Eingabeparameter ist erforderlich:
*database\$1name*
Der Name der Datenbank, für die das Kopieren von Archivprotokollen nach Amazon S3 aktiviert werden soll. Der Datentyp ist `varchar`.
### Beispiele
Das folgende Beispiel aktiviert die Archivprotokollkopie für eine Datenbank namens`TESTDB`.
```
db2 "call rdsadmin.enable_archive_log_copy(
?,
'TESTDB')"
```
## rdsadmin.disable\$1archive\$1log\$1copy
Deaktiviert die Protokollkopie des RDS-Db2-Datenbankarchivs nach Amazon S3.
### Syntax
```
db2 "call rdsadmin.disable_archive_log_copy(
?,
'database_name')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Der folgende Eingabeparameter ist erforderlich:
*database\$1name*
Der Name der Datenbank, für die das Kopieren von Archivprotokollen nach Amazon S3 deaktiviert werden soll. Der Datentyp ist `varchar`.
### Beispiele
Das folgende Beispiel deaktiviert die Archivprotokollkopie für eine Datenbank namens`TESTDB`.
```
db2 "call rdsadmin.disable_archive_log_copy(
?,
'TESTDB')"
```
## rdsadmin.fgac\$1command
Führt fein abgestufte Befehle zur Zugriffskontrolle (FGAC) aus.
### Syntax
```
db2 "call rdsadmin.fgac_command(
?,
'database_name',
'fgac_cmd')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Die folgenden Eingabeparameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, für die Sie FGAC-Befehle ausführen möchten. Der Datentyp ist `varchar`.
*fgac\$1cmd*
Der detaillierte Zugriffskontrollbefehl, den Sie ausführen möchten. Der Datentyp ist `varchar`.
Die folgenden Befehle sind gültig:
+ `ALTER MASK`— Ändert eine bestehende Spaltenmaske in der Zugriffskontrolle für Zeilen und Spalten (RCAC).
+ `ALTER PERMISSION`— Ändert die Eigenschaften einer bestehenden Zeilenberechtigung in RCAC.
+ `ALTER SECURITY POLICY`— Ändert eine bestehende Sicherheitsrichtlinie für RCAC.
+ `ALTER SECURITY LABEL`— Ändert die Eigenschaften eines vorhandenen Sicherheitslabels in der Label-Based Access Control (LBAC).
+ `ALTER TABLE`— Ändert die Tabellenstruktur, einschließlich des Hinzufügens von RCAC- oder LBAC-Steuerelementen.
+ `CREATE MASK`— Erzeugt eine neue Spaltenmaske für RCAC.
+ `CREATE PERMISSION`— Erzeugt eine neue Zeilenberechtigung für RCAC.
+ `CREATE SECURITY LABEL`— Erzeugt ein neues Sicherheitslabel für LBAC.
+ `CREATE SECURITY POLICY`— Erstellt eine neue Sicherheitsrichtlinie für RCAC.
+ `DROP MASK`— Löscht eine bestehende Spaltenmaske.
+ `DROP PERMISSION`— Löscht eine bestehende Zeilenberechtigung.
+ `DROP SECURITY LABEL`— Löscht ein Sicherheitslabel von LBAC.
+ `DROP SECURITY POLICY`— Löscht eine bestehende RCAC-Sicherheitsrichtlinie.
+ `GRANT EXEMPTION ON RULE`— Ermöglicht einem Benutzer, bestimmte LBAC-Regeln zu umgehen.
+ `GRANT SECURITY LABEL`— Weist einem Benutzer ein LBAC-Sicherheitslabel zu.
+ `REVOKE EXEMPTION ON RULE`— Entfernt die Ausnahme eines Benutzers von den LBAC-Regeln.
+ `REVOKE SECURITY LABEL`— Entfernt ein LBAC-Sicherheitslabel von einem Benutzer.
### Nutzungshinweise
Diese gespeicherte Prozedur steuert den Zugriff auf Zeilen- oder Spaltenebene auf Tabellendaten in Ihrer Datenbank auf einer RDS for Db2-DB-Instance. RDS for Db2 unterstützt zwei Arten von FGAC in der Datenbank:
+ Labelbasierte Zugriffskontrolle (LBAC)
+ Zugriffskontrolle für Zeilen und Spalten (RCAC)
Bevor Sie die gespeicherte Prozedur aufrufen, lesen Sie die folgenden Hinweise:
+ Um ein einfaches Anführungszeichen (') zu umgehen, verwenden Sie ein zusätzliches einfaches Anführungszeichen. Die folgenden Beispiele zeigen, wie man `'apple'``'banana'`, und maskiert`'fruit'`.
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE SECURITY LABEL COMPONENT FRUITSET SET{''apple'',''banana''}')"
```
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE SECURITY LABEL COMPONENT FRUITTREE TREE(''fruit'' ROOT, ''apple'' UNDER ''fruit'', ''banana'' UNDER ''fruit'')')"
```
+ Um Klammern ([]) zu umgehen, verwenden Sie einen umgekehrten Schrägstrich (\$1). Das folgende Beispiel zeigt, wie Sie entkommen können. `[''apple'',''banana'']`
```
db2 "call rdsadmin.fgac_command(
?, '
testdb',
'CREATE SECURITY LABEL COMPONENT FRUITARRAY ARRAY\[''apple'',''banana''\]')"
```
### Beispiele
In den folgenden Beispielen werden alle FGAC-Befehle in einer Datenbank namens ausgeführt. `testdb`
**Beispiel 1: Erstellen einer neuen Sicherheitsbeschriftung namens `FRUITSET`**
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE SECURITY LABEL COMPONENT FRUITSET SET{''apple'',''banana''}')"
```
**Beispiel 2: Erstellen einer neuen Maske für die `EMP_ID` Spalte, die aktiviert ist, wenn sie auf weniger als drei gesetzt `EMP_ID` ist**
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE MASK id_MASK ON EMPLOYEE FOR COLUMN EMP_ID RETURN CASE WHEN (EMP_ID < 3) THEN EMP_ID ELSE NULL END ENABLE')"
```
**Beispiel 3: Erstellen einer neuen Maske für die `DEPARTMENT` Spalte, die aktiviert ist, wenn auf gesetzt `SESSION_USER` ist `security_user`**
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE MASK DEPARTMENT_MASK ON EMPLOYEE FOR COLUMN DEPARTMENT RETURN CASE WHEN SESSION_USER = ''security_user'' THEN DEPARTMENT ELSE NULL END ENABLE')"
```
**Beispiel 4: Erstellen einer neuen Sicherheitsbeschriftung namens `treelabel`**
```
db2 "call rdsadmin.fgac_command(
?,
'testdb',
'CREATE SECURITY LABEL COMPONENT treelabel TREE(''COMPANY'' ROOT, ''HR'' UNDER ''COMPANY'', ''FINANCE'' UNDER ''COMPANY'', ''IT'' UNDER ''COMPANY'')')"
```
## rdsadmin.db2support\$1command
Sammelt Diagnoseinformationen über eine RDS for Db2-Datenbank und lädt sie in einen Amazon S3 S3-Bucket hoch.
### Syntax
```
db2 "call rdsadmin.db2support_command(
?,
'database_name',
's3_bucket_name',
's3_prefix')"
```
### Parameters
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur `?`.
Die folgenden Eingabeparameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, für die Diagnoseinformationen gesammelt werden sollen. Der Datentyp ist `varchar`.
*s3\$1bucket\$1name*
Der Name des Amazon S3 S3-Buckets, in den Sie die Diagnoseinformationen hochladen möchten. Der Datentyp ist `varchar`.
*s3\$1prefix*
Das Präfix des Pfads zu Amazon S3, in den RDS for Db2 die Diagnosedateien hochlädt. Der Datentyp ist `varchar`.
### Nutzungshinweise
Diese gespeicherte Prozedur sammelt Diagnoseinformationen, die bei der Fehlerbehebung bei RDS for Db2-Datenbanken helfen können, und lädt die Informationen in einen Amazon S3 S3-Bucket hoch.
Die gespeicherte Prozedur verwendet das IBM `db2support` Hilfsprogramm, um Diagnosedaten zu sammeln. Weitere Informationen zum Hilfsprogramm finden Sie in der Dokumentation unter dem [Befehl db2support — Tool zur Problemanalyse und Umgebungserfassung](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2support-problem-analysis-environment-collection-tool). IBM Db2
Bevor Sie die gespeicherte Prozedur aufrufen, lesen Sie die folgenden Hinweise:
+ Um die Diagnosedateien auf Amazon S3 hochzuladen, müssen Sie die Integration bereits konfiguriert haben. Weitere Informationen finden Sie unter [Integration einer DB-Instance von Amazon RDS für Db2 mit Amazon S3](db2-s3-integration.md).
+ Damit eine RDS for Db2-DB-Instance mit Amazon S3 interagieren kann, benötigen Sie eine VPC und einen Amazon S3 S3-Gateway-Endpunkt für die Nutzung privater Subnetze. Weitere Informationen erhalten Sie unter [Schritt 1: Erstellen eines VPC-Gateway-Endpunkts für Amazon S3](db2-troubleshooting.md#db2-creating-endpoint) und [Schritt 2: Überprüfen, ob der VPC-Gateway-Endpunkt für Amazon S3 vorhanden ist](db2-troubleshooting.md#db2-confirming-endpoint).
Vor dem Aufrufen von `rdsadmin.db2support_command` müssen Sie eine Verbindung mit der Datenbank `rdsadmin` herstellen. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre RDS for Db2-DB-Instance-Informationen:
```
db2 connect to rdsadmin user master_username using master_password
```
Hinweise zur Überprüfung des Status der Erfassung von Diagnoseinformationen finden Sie unter[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
**Beispiel 1: Sammeln von Diagnoseinformationen für eine Datenbank**
Das folgende Beispiel sammelt Diagnoseinformationen für eine aufgerufene Datenbank `TESTDB` und lädt sie in den Amazon S3 S3-Bucket hoch, der `amzn-s3-demo-bucket` mit dem Präfix `diagnostics/testdb` aufgerufen wird:
```
db2 "call rdsadmin.db2support_command(
?,
'TESTDB',
'amzn-s3-demo-bucket',
'diagnostics/testdb')"
```
**Beispiel 2: Erfassung von Diagnoseinformationen mit einem datumsbasierten Präfix**
Das folgende Beispiel sammelt Diagnoseinformationen für eine aufgerufene Datenbank `MYDB` und lädt sie in den Amazon S3 S3-Bucket hoch, der `amzn-s3-demo-bucket` mit einem datumsbasierten Präfix aufgerufen wird:
```
db2 "call rdsadmin.db2support_command(
?,
'MYDB',
'amzn-s3-demo-bucket',
'support/2024/01/15')"
```
# Gespeicherte Prozeduren für den Speicherzugriff von RDS für Db2
Mit den integrierten gespeicherten Prozeduren, die in diesem Thema beschrieben werden, wird der Speicherzugriff für RDS-für-Db2-Datenbanken verwaltet, die Amazon S3 zum Migrieren von Daten verwenden. Weitere Informationen finden Sie unter [Migrieren von Db2-Daten über Amazon S3 zu Amazon RDS für Db2](db2-migration-load-from-s3.md).
In den folgenden integrierten gespeicherten Prozeduren erhalten Sie Informationen zu deren Syntax, Parametern, Nutzungshinweisen und Beispielen.
**Topics**
+ [rdsadmin.catalog\$1storage\$1access](#db2-sp-catalog-storage-access)
+ [rdsadmin.uncatalog\$1storage\$1access](#db2-sp-uncatalog-storage-access)
## rdsadmin.catalog\$1storage\$1access
Katalogisiert einen Speicheralias für den Zugriff auf einen Amazon-S3-Bucket mit Db2-Datendateien.
### Syntax
```
db2 "call rdsadmin.catalog_storage_access(
?,
'alias',
's3_bucket_name',
'grantee_type',
'grantee'
)"
```
### Parameter
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Der Datentyp ist `varchar`.
Die folgenden Eingabeparameter sind erforderlich:
*alias*
Der Aliasname für den Zugriff auf Remotespeicher in einem Amazon-S3-Bucket. Der Datentyp ist `varchar`.
*s3\$1bucket\$1name*
Der Name des Amazon-S3-Bucket, in dem sich Ihre Daten befinden. Der Datentyp ist `varchar`.
*grantee\$1type*
Der Typ des Berechtigungsempfängers, der die Autorisierung erhalten soll. Der Datentyp ist `varchar`. Zulässige Werte: `USER`, `GROUP`.
*grantee*
Der Benutzer oder die Gruppe, die bzw. der die Autorisierung erhalten soll. Der Datentyp ist `varchar`.
### Nutzungshinweise
Amazon RDS enthält den katalogisierten Alias in der IAM-Rolle, die Sie zu Ihrer DB-Instance von RDS für Db2 hinzugefügt haben. Wenn Sie die IAM-Rolle aus Ihrer DB-Instance entfernen, löscht Amazon RDS den Alias. Weitere Informationen finden Sie unter [Migrieren von Db2-Daten über Amazon S3 zu Amazon RDS für Db2](db2-migration-load-from-s3.md).
Informationen zum Überprüfen des Katalogisierungsstatus für Ihren Alias finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel wird der Alias `SAMPLE` registriert. Dem Benutzer `jorge_souza` wird Zugriff auf den Amazon-S3-Bucket `amzn-s3-demo-bucket` gewährt.
```
db2 "call rdsadmin.catalog_storage_access(
?,
'SAMPLE',
'amzn-s3-demo-bucket',
'USER',
'jorge_souza')"
```
## rdsadmin.uncatalog\$1storage\$1access
Entfernt einen Alias für den Speicherzugriff.
### Syntax
```
db2 "call rdsadmin.uncatalog_storage_access(
?,
'alias')"
```
### Parameter
Der folgende Ausgabeparameter ist erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Der Datentyp ist `varchar`.
Der folgende Eingabeparameter ist erforderlich:
*alias*
Der Name des zu entfernenden Speicheralias. Der Datentyp ist `varchar`.
### Nutzungshinweise
Informationen zum Überprüfen des Entfernungsstatus für Ihren Alias finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel wird der Alias `SAMPLE` entfernt. Dieser Alias ermöglicht keinen Zugriff mehr auf den Amazon-S3-Bucket, mit dem er verknüpft war.
```
db2 "call rdsadmin.uncatalog_storage_access(
?,
'SAMPLE')"
```
# Gespeicherte Prozeduren für Tablespaces von RDS für Db2
Mit den in diesem Thema beschrieben integrierten gespeicherten Prozeduren werden Tablespaces für Datenbanken von Amazon RDS für Db2 verwaltet. Um diese Prozeduren auszuführen, muss der Masterbenutzer zuerst eine Verbindung mit der Datenbank `rdsadmin` herstellen.
Diese gespeicherten Prozeduren werden für eine Vielzahl von Aufgaben verwendet. Diese Liste ist nicht umfassend.
+ [Häufige Aufgaben in Bezug auf Tablespaces](db2-managing-tablespaces.md)
+ [Generieren von Leistungsberichten](db2-managing-databases.md#db2-generating-performance-reports)
+ [Kopieren von Datenbank-Metadaten mit db2look](db2-native-db2-tools-db2look.md)
+ [Erstellen einer Repository-Datenbank für IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md#db2-creating-repo-db-monitoring-dmc)
In den folgenden integrierten gespeicherten Prozeduren erhalten Sie Informationen zu deren Syntax, Parametern, Nutzungshinweisen und Beispielen.
**Topics**
+ [rdsadmin.create\$1tablespace](#db2-sp-create-tablespace)
+ [rdsadmin.alter\$1tablespace](#db2-sp-alter-tablespace)
+ [rdsadmin.rename\$1tablespace](#db2-sp-rename-tablespace)
+ [rdsadmin.drop\$1tablespace](#db2-sp-drop-tablespace)
## rdsadmin.create\$1tablespace
Erstellt ein Tablespace.
### Syntax
```
db2 "call rdsadmin.create_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_page_size,
tablespace_initial_size,
tablespace_increase_size,
'tablespace_type',
'tablespace_prefetch_size')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, in der die Partition erstellt wird. Der Datentyp ist `varchar`.
*tablespace\$1name*
Der Name des zu erstellenden Tablespace. Der Datentyp ist `varchar`.
Der Name des Tablespace weist die folgenden Einschränkungen auf:
+ Er darf nicht mit dem Namen eines vorhandenen Tablespace in dieser Datenbank identisch sein.
+ Er kann nur die Zeichen `_$#@a-zA-Z0-9` enthalten.
+ Er darf nicht mit `_` oder `$` beginnen.
+ Er darf nicht mit `SYS` beginnen.
Die folgenden Parameter sind optional:
*buffer\$1pool\$1name*
Der Name des Pufferpools, dem das Tablespace zugewiesen werden soll. Der Datentyp ist `varchar`. Der Standardwert ist eine leere Zeichenfolge.
Sie müssen bereits über einen Pufferpool mit derselben Seitengröße verfügen, um ihn mit dem Tablespace verknüpfen zu können.
*tablespace\$1page\$1size*
Die Seitengröße des Tablespace in Bytes. Der Datentyp ist `integer`. Zulässige Werte: `4096`, `8192`, `16384`, `32768`. Die Standardeinstellung ist die Seitengröße, die Sie beim Erstellen der Datenbank durch Aufrufen von [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database) verwendet haben.
Amazon RDS unterstützt Write-Atomizitä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 fehlerhaft sind oder dass partielle Daten auf den Desk geschrieben werden. Wenn Sie Seiten mit 32 KiB verwenden, empfehlen wir Ihnen, die point-in-time Wiederherstellung und automatische Backups zu aktivieren. Andernfalls ist nach fehlerhaften Schreibvorgängen keine Wiederherstellung möglich. Weitere Informationen erhalten Sie unter [Einführung in Backups](USER_WorkingWithAutomatedBackups.md) und [Wiederherstellen einer DB-Instance auf einen bestimmten Zeitpunkt für Amazon RDS](USER_PIT.md).
*tablespace\$1initial\$1size*
Die Anfangsgröße des Tablespace in Kilobyte (KB). Der Datentyp ist `integer`. Gültige Werte: `48` oder höher. Der Standardwert ist „null“.
Wenn Sie keinen Wert festlegen, legt Db2 einen geeigneten Wert für Sie fest.
Dieser Parameter gilt nicht für temporäre Tablespaces, da diese vom System verwaltet werden.
*tablespace\$1increase\$1size*
Der Prozentsatz, um den das Tablespace vergrößert werden soll, wenn es voll ist. Der Datentyp ist `integer`. Gültige Werte: `1`–`100`. Der Standardwert ist „null“.
Wenn Sie keinen Wert festlegen, legt Db2 einen geeigneten Wert für Sie fest.
Dieser Parameter gilt nicht für temporäre Tablespaces, da diese vom System verwaltet werden.
*tablespace\$1type*
Der Typ des Tablespace. Der Datentyp ist `char`. Gültige Werte: `U` (für Benutzerdaten), `T` (für temporäre Benutzerdaten) oder `S` (für temporäre Systemdaten). Der Standardwert ist `U`.
*tablespace\$1prefetch\$1size*
Die Speichervorgriff-Seitengröße des Tablespace. Der Datentyp ist `char`. Gültige Werte: `AUTOMATIC` (Groß- und Kleinschreibung wird nicht berücksichtigt) oder positive Ganzzahlen ungleich Null, die kleiner als oder gleich 32767 sind.
### Nutzungshinweise
RDS für Db2 erstellt immer eine große Datenbank für Daten.
Informationen zum Überprüfen des Status beim Erstellen eines Tablespace finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
**Beispiel 1: Erstellen eines Tablespace und Zuweisen eines Pufferpools**
Im folgenden Beispiel wird das Tablespace `SP8` erstellt und der Pufferpool `BP8` für die Datenbank `TESTDB` zugewiesen. Das Tablespace hat eine ursprüngliche Tablespace-Seitengröße von 4096 Byte, ein ursprüngliches Tablespace von 1000 KB und die Erweiterung der Tabellengröße ist auf 50 % festgelegt.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
'BP8',
4096,
1000,
50)"
```
**Beispiel 2: Erstellen eines temporären Tablespace und Zuweisen eines Pufferpools**
Im folgenden Beispiel wird das temporäre Tablespace `SP8` erstellt. Es weist den Pufferpool `BP8` mit einer Größe von 8 KiB für die Datenbank `TESTDB` zu.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
'BP8',
8192,
NULL,
NULL,
'T')"
```
**Beispiel 3: Erstellen eines Tablespace und Zuweisen einer Speichervorgriff-Seitengröße**
Im folgenden Beispiel wird das Tablespace `SP8` für die Datenbank `TESTDB` zugewiesen. Das Tablespace hat eine ursprüngliche Tablespace-Erweiterungsgröße von `50` und eine Speichervorgriff-Seitengröße von `800`.
```
db2 "call rdsadmin.create_tablespace(
'TESTDB',
'SP8',
NULL,
NULL,
NULL,
50,
NULL,
'800')"
```
## rdsadmin.alter\$1tablespace
Ändert ein Tablespace.
### Syntax
```
db2 "call rdsadmin.alter_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_increase_size,
'max_size',
'reduce_max',
'reduce_stop',
'reduce_value',
'lower_high_water',
'lower_high_water_stop',
'switch_online',
'tablespace_prefetch_size')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, die das Tablespace verwendet. Der Datentyp ist `varchar`.
*tablespace\$1name*
Der Name des zu ändernden Tablespace. Der Datentyp ist `varchar`.
Die folgenden Parameter sind optional:
*buffer\$1pool\$1name*
Der Name des Pufferpools, dem das Tablespace zugewiesen werden soll. Der Datentyp ist `varchar`. Der Standardwert ist eine leere Zeichenfolge.
Sie müssen bereits über einen Pufferpool mit derselben Seitengröße verfügen, um ihn mit dem Tablespace verknüpfen zu können.
*tablespace\$1increase\$1size*
Der Prozentsatz, um den das Tablespace vergrößert werden soll, wenn es voll ist. Der Datentyp ist `integer`. Gültige Werte: `1`–`100`. Der Standardwert ist `0`.
*max\$1size*
Die maximale Größe für das Tablespace. Der Datentyp ist `varchar`. Gültige Werte: *integer* `K` \$1 `M` \$1`G`, oder`NONE`. Der Standardwert ist `NONE`.
*reduce\$1max*
Gibt an, ob der Wert für „High Water Mark“ auf den maximalen Grenzwert reduziert werden soll. Der Datentyp ist `char`. Der Standardwert ist `N`.
*reduce\$1stop*
Gibt an, ob der vorhergehende Befehl `reduce_max` oder der Befehl `reduce_value` unterbrochen werden soll. Der Datentyp ist `char`. Der Standardwert ist `N`.
*reduce\$1value*
Der Wert oder der Prozentsatz, um den der Wert für „High Water Mark“ im Tablespace reduziert werden soll. Der Datentyp ist `varchar`. Gültige Werte: *integer* `K` `M` \$1 \$1 `G` oder `1` —`100`. Der Standardwert ist `N`.
*lower\$1high\$1water*
Gibt an, ob der Befehl `ALTER TABLESPACE LOWER HIGH WATER MARK` ausgeführt werden soll. Der Datentyp ist `char`. Der Standardwert ist `N`.
*lower\$1high\$1water\$1stop*
Gibt an, ob der Befehl `ALTER TABLESPACE LOWER HIGH WATER MARK STOP` ausgeführt werden soll. Der Datentyp ist `char`. Der Standardwert ist `N`.
*switch\$1online*
Gibt an, ob der Befehl `ALTER TABLESPACE SWITCH ONLINE` ausgeführt werden soll. Der Datentyp ist `char`. Der Standardwert ist `N`.
*tablespace\$1prefetch\$1size*
Die Speichervorgriff-Seitengröße des Tablespace. Der Datentyp ist `char`. Gültige Werte: `AUTOMATIC` (Groß- und Kleinschreibung wird nicht berücksichtigt) oder positive Ganzzahlen ungleich Null, die kleiner als oder gleich 32767 sind.
Dieser Parameter funktioniert nur mit `buffer_pool_name`, `table_increase_size`, `max_size` und `switch_online`. Er funktioniert nicht mit `reduce_max`, `reduce_stop`, `reduce_value`, `lower_high_water` und `lower_high_water_stop`.
### Nutzungshinweise
Bevor Sie die gespeicherte Prozedur aufrufen, lesen Sie die folgenden Hinweise:
+ Die gespeicherte Prozedur `rdsadmin.alter_tablespace` funktioniert nicht in einem Tablespace, in dem `tablespace_type` für temporäre Benutzerdaten auf `T` festgelegt ist.
+ Die Parameter `reduce_max`, `reduce_stop`, `reduce_value`, `lower_high_water`, `lower_high_water_stop` und `switch_online` schließen sich gegenseitig aus. Sie können nicht mit anderen optionalen Parametern wie `buffer_pool_name` im Befehl `rdsadmin.alter_tablespace` kombiniert werden. Weitere Informationen finden Sie unter [Statement not valid](db2-troubleshooting.md#alter-tablespace-sp-statement-not-valid).
Informationen zum Überprüfen des Status beim Ändern eines Tablespace finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Informationen zu Fehlermeldungen, die beim Aufrufen von gespeicherten Prozeduren zurückgegeben werden, finden Sie unter [Fehler bei gespeicherten Prozeduren](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Beispiele
**Beispiel 1: Senken des Werts für „High Water Mark“**
Im folgenden Beispiel wird das Tablespace `SP8` geändert und der Pufferpool `BP8` für die Datenbank `TESTDB` zugewiesen, um den Wert für „High Water Mark“ zu senken.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'SP8',
'BP8',
NULL,
NULL,
'Y')"
```
**Beispiel 2: Reduzieren des Werts für „High Water Mark“**
Im folgenden Beispiel wird der Befehl `REDUCE MAX` im Tablespace `TBSP_TEST` in der Datenbank `TESTDB` ausgeführt.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
'Y')"
```
**Beispiel 3: Unterbrechen von Befehlen, um den Wert für „High Water Mark“ zu reduzieren**
Im folgenden Beispiel wird der Befehl `REDUCE STOP` im Tablespace `TBSP_TEST` in der Datenbank `TESTDB` ausgeführt.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
NULL,
'Y')"
```
**Beispiel 4: Ändern der vorhandenen Speichervorgriff-Seitengröße**
Im folgenden Beispiel wird der Befehl `ALTER TABLESPACE SWITCH ONLINE` für das Tablespace `TSBP_TEST` ausgeführt und die vorhandene Speichervorgriff-Seitengröße auf `64` geändert.
```
db2 "call rdsadmin.alter_tablespace(
'TESTDB',
'TBSP_TEST',
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
NULL,
‘Y’,
‘64’)"
```
## rdsadmin.rename\$1tablespace
Benennt ein Tablespace um.
### Syntax
```
db2 "call rdsadmin.rename_tablespace(
?,
'database_name',
'source_tablespace_name',
'target_tablespace_name')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
?
Eine Parametermarkierung, die eine Fehlermeldung ausgibt. Dieser Parameter akzeptiert nur „?“.
*database\$1name*
Der Name der Datenbank, zu der das Tablespace gehört. Der Datentyp ist `varchar`.
*source\$1tablespace\$1name*
Der Name des Tablespace, das umbenannt werden soll. Der Datentyp ist `varchar`.
*target\$1tablespace\$1name*
Der neue Name des Tablespace. Der Datentyp ist `varchar`.
Der neue Name weist die folgenden Einschränkungen auf:
+ Er darf nicht mit dem Namen eines vorhandenen Tablespace identisch sein.
+ Er kann nur die Zeichen `_$#@a-zA-Z0-9` enthalten.
+ Er darf nicht mit `_` oder `$` beginnen.
+ Er darf nicht mit `SYS` beginnen.
### Nutzungshinweise
Informationen zum Überprüfen des Status beim Umbenennen eines Tablespace finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Sie können Tablespaces, die zur Datenbank `rdsadmin` gehören, nicht umbenennen.
### Beispiele
Im folgenden Beispiel wird das Tablespace `SP8` in der Datenbank `TESTDB` in `SP9` umbenannt.
```
db2 "call rdsadmin.rename_tablespace(
?,
'TESTDB',
'SP8',
'SP9')"
```
## rdsadmin.drop\$1tablespace
Verwirft ein Tablespace.
### Syntax
```
db2 "call rdsadmin.drop_tablespace(
'database_name',
'tablespace_name')"
```
### Parameters
Die folgenden Parameter sind erforderlich:
*database\$1name*
Der Name der Datenbank, zu der das Tablespace gehört. Der Datentyp ist `varchar`.
*tablespace\$1name*
Der Name des Tablespace, das verworfen werden soll. Der Datentyp ist `varchar`.
### Nutzungshinweise
Informationen zum Überprüfen des Status beim Verwerfen eines Tablespace finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
### Beispiele
Im folgenden Beispiel wird das Tablespace `SP8` aus der Datenbank `TESTDB` verworfen.
```
db2 "call rdsadmin.drop_tablespace(
'TESTDB',
'SP8')"
```