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.
# Amazon RDS für Db2
Amazon RDS unterstützt DB-Instances, die die folgenden Editionen von IBM Db2 ausführen:
+ Db2 Standard Edition
+ Db2 Advanced Edition
Amazon RDS unterstützt DB-Instances, die die folgenden Versionen und Editionen von Db2 ausführen:
+ Db2 11.5
Weitere Informationen über den Support für Minor-Versionen finden Sie unter [Db2 in Amazon-RDS-Versionen](Db2.Concepts.VersionMgmt.md).
Führen Sie die Schritte im Abschnitt [Einrichten Ihrer Umgebung für Amazon RDS](CHAP_SettingUp.md) in diesem Benutzerhandbuch durch, bevor Sie eine DB-Instance erstellen. Wenn Sie eine DB-Instance mit Ihrem Masterbenutzer erstellen, erhält dieser die Berechtigung `DBADM`, allerdings mit einigen Einschränkungen. Verwenden Sie diesen Benutzer für administrative Aufgaben wie das Erstellen zusätzlicher Datenbankkonten. Sie können keine `SYSADM`-, `SYSCTRL`-, `SYSMAINT`-Instance-Berechtigung oder `SECADM`-Datenbankberechtigung verwenden.
Sie können das folgende erstellen:
+ DB-Instances
+ DB-Snapshots
+ Point-in-Time-Wiederherstellungen
+ Automatisierte Speicher-Backups
+ Manuelle Speicher-Backups
Sie können DB-Instances verwenden, auf denen Db2 in einer Virtual Private Cloud (VPC) ausgeführt wird. Sie können auch Funktionen zu Ihrer DB-Instance für Amazon RDS für Db2 hinzufügen, indem Sie verschiedene Optionen aktivieren. Amazon RDS unterstützt Multi-AZ-Bereitstellungen für RDS für Db2 als eine Lösung mit hoher Verfügbarkeit und Failover.
**Wichtig**
Um eine verwaltete Service-Erfahrung zu bieten, ermöglicht Amazon RDS keinen Shell-Zugriff auf DB-Instances. Eingeschränkt wird auch der Zugriff auf bestimmte Systemprozeduren und Tabellen, für die erhöhte Berechtigungen erforderlich sind. Sie können mit Standard-SQL-Clients wie IBM Db2 CLP auf Ihre Datenbank zugreifen. Sie können jedoch nicht direkt auf den Host zugreifen, indem Sie Telnet oder Secure Shell (SSH) verwenden.
**Topics**
+ [Übersicht über Db2 auf Amazon RDS](db2-overview.md)
+ [Voraussetzungen für das Erstellen einer DB-Instance von Amazon RDS für Db2](db2-db-instance-prereqs.md)
+ [Mehrere Datenbanken auf einer DB-Instance von Amazon RDS für Db2](db2-multiple-databases.md)
+ [Herstellen einer Verbindung mit Ihrer Db2-DB-Instance](USER_ConnectToDb2DBInstance.md)
+ [Sichern von Verbindungen der DB-Instance von Amazon RDS für Db2](Db2.Concepts.RestrictedDBAPrivileges.md)
+ [Verwalten Ihrer DB-Instance von Amazon RDS für Db2](db2-administering-db-instance.md)
+ [Integration einer DB-Instance von Amazon RDS für Db2 mit Amazon S3](db2-s3-integration.md)
+ [Migrieren von Daten zu Amazon RDS für Db2](db2-migrating-data-to-rds.md)
+ [Verbund für Amazon RDS für Db2](db2-federation.md)
+ [Arbeiten mit Replikaten für Amazon RDS für Db2](db2-replication.md)
+ [Optionen für DB-Instances von Amazon RDS für Db2](Db2.Options.md)
+ [Externe gespeicherte Prozeduren für Amazon RDS für Db2](db2-external-stored-procedures.md)
+ [Bekannte Probleme und Einschränkungen für Amazon RDS für Db2](db2-known-issues-limitations.md)
+ [Referenz für gespeicherte Prozeduren von RDS für Db2](db2-stored-procedures.md)
+ [Referenz für benutzerdefinierte Funktionen von Amazon RDS für Db2](db2-user-defined-functions.md)
+ [Fehlerbehebung für Amazon RDS für Db2](db2-troubleshooting.md)
# Übersicht über Db2 auf Amazon RDS
In den folgenden Abschnitten erhalten Sie einen Überblick über Db2 auf Amazon RDS.
**Topics**
+ [Funktionen in Amazon RDS für Db2](Db2.Concepts.FeatureSupport.md)
+ [Db2 in Amazon-RDS-Versionen](Db2.Concepts.VersionMgmt.md)
+ [Lizenzierungsoptionen für Amazon RDS für Db2](db2-licensing.md)
+ [Instance-Klassen von Amazon RDS für Db2](Db2.Concepts.General.InstanceClasses.md)
+ [Standardrollen in Amazon RDS für Db2](db2-default-roles.md)
+ [Parameter von Amazon RDS für Db2](db2-supported-parameters.md)
+ [EBCDIC-Sortierung für Db2-Datenbanken auf Amazon RDS](db2-ebcdic.md)
+ [Lokale Zeitzone für DB-Instances von Amazon RDS für Db2](db2-time-zone.md)
# Funktionen in Amazon RDS für Db2
Amazon RDS für Db2 unterstützt die meisten Features und Funktionen der IBM Db2-Datenbank. Einige Funktionen werden möglicherweise nur begrenzt unterstützt oder haben eingeschränkte Berechtigungen. Weitere Informationen zu den Db2-Datenbankfunktionen für bestimmte Db2-Versionen finden Sie in der [IBM Db2-Dokumentation](https://www.ibm.com/docs/en/db2).
Sie können neue Amazon RDS Funktionen auf der [Was ist neu mit Datenbank?](https://aws.amazon.com/about-aws/whats-new/database/)-Seite filtern. Wählen Sie für **Produkte** **Amazon RDS** aus. Sie können dann mithilfe von Schlüsselwörtern wie **Db2 2023** suchen.
**Anmerkung**
Die folgenden Listen sind nicht vollständig.
**Topics**
+ [Unterstützte Funktionen in RDS für Db2](#db2-supported-features)
+ [Nicht unterstützte Funktionen in RDS für Db2](#db2-unsupported-features)
## Unterstützte Funktionen in RDS für Db2
RDS für Db2 unterstützt Funktionen, die für IBM Db2 systemeigen sind, sowie Funktionen, die zu den Kernfunktionen von Amazon RDS gehören.
### Für IBM Db2 systemeigene Funktionen
RDS für Db2 unterstützt die folgenden Db2-Datenbankfunktionen:
+ Erstellen einer Standarddatenbank, die vom Kunden definierte Codesätze, Sortierungen, Seitengrößen und Gebiete verwendet. Verwenden Sie die gespeicherte Amazon-RDS-Prozedur [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).
+ Hinzufügen, Löschen oder Ändern von lokalen Benutzern und Gruppen. Verwenden Sie die gespeicherten Amazon-RDS-Prozeduren unter [Gespeicherte Prozeduren zum Gewähren und Widerrufen von Berechtigungen für RDS für Db2](db2-sp-granting-revoking-privileges.md).
+ Erstellen von Rollen mit der gespeicherten Amazon-RDS-Prozedur [rdsadmin.create\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-create-role).
+ Unterstützung für standardmäßige in Zeilen unterteilte Tabellen.
+ Unterstützung für die analytische Workload der in Spalten unterteilte Tabellen.
+ Fähigkeit, Db2-Kompatibilitätsfunktionen wie Oracle und MySQL zu definieren.
+ Unterstützung für Java-basierte externe gespeicherte Prozeduren.
+ Unterstützung für die Datenverschlüsselung während der Übertragung mithilfe von SSL/TLS.
+ Überwachen des Status einer Datenbank (`ALIVE`, `DOWN`, `STORAGE_FULL`, `UNKNOWN` und `STANDBY_CONNECTABLE`).
+ Wiederherstellen einer vom Kunden bereitgestellten Offline- oder Linux (LE)-Online-Datenbank. Verwenden Sie die gespeicherten Amazon-RDS-Prozeduren unter [Gespeicherte Prozeduren für Datenbanken von RDS für Db2](db2-sp-managing-databases.md).
+ Anwenden der vom Kunden bereitgestellten Db2-Archivprotokolle, um die Datenbank mit selbstverwalteten Db2-Datenbanken zu synchronisieren. Verwenden Sie die gespeicherten Amazon-RDS-Prozeduren unter [Gespeicherte Prozeduren für Datenbanken von RDS für Db2](db2-sp-managing-databases.md).
+ Unterstützung für Prüfungen auf Db2-Instance- und Datenbankebene.
+ Unterstützung für einen homogenen Verbund
+ Möglichkeit, eine Tabelle anhand von Datendateien in Amazon Simple Storage Service (Amazon S3) zu laden.
+ Autorisierungen, die Benutzern, Gruppen oder Rollen gewährt wurden, wie `CONNECT`, `SYSMON`, `ACCESSCTRL`, `DATAACCESS`, `SQLADM`, `WLMADM`, `EXPLAIN`, `LOAD` oder `IMPLICIT_SCHEMA`.
+ Erstellen mehrerer Datenbanken.
**Anmerkung**
Eine DB-Instance von RDS für Db2 kann bis zu 50 Datenbanken enthalten. Weitere Informationen finden Sie unter [Mehrere Datenbanken auf einer DB-Instance von Amazon RDS für Db2](db2-multiple-databases.md).
### Kernfunktionen von Amazon RDS
RDS für Db2 unterstützt die folgenden Kernfunktionen von Amazon RDS:
+ Benutzerdefinierte Parametergruppen, die DB-Instances zugewiesen werden sollen
+ Erstellen, Ändern und Löschen von DB-Instances
+ Wiederherstellen einer selbstverwalteten Db2-Offline- oder Linux (LE)-Online-Datenbanksicherung
**Anmerkung**
Damit Sie das Backup wiederherstellen können, geben Sie beim Erstellen einer DB-Instance keinen Namen für die Datenbank an. Weitere Informationen finden Sie unter [Erstellen einer Amazon-RDS-DB-Instance](USER_CreateDBInstance.md).
+ Unterstützung der Speichertypen gp3, io2 und io1
+ Verwendung von AWS Managed Microsoft AD für die Kerberos Authentifizierung und LDAP-Gruppenautorisierung für RDS for Db2
+ Ändern von Sicherheitsgruppen, Ports, Instance-Typen, Speicher, Aufbewahrungsfristen für Backups und anderen Einstellungen für vorhandene Db2-Instances
+ Löschschutz für DB-Instances
+ Regionsübergreifende point-in-time Wiederherstellung (PITR), auch für verschlüsselte Backups
+ Verwendung von AWS Key Management Service (AWS KMS) für Speicherverschlüsselung und Verschlüsselung im Ruhezustand
+ Multi-AZ-DB-Instances mit einer Standby-Instance für hohe Verfügbarkeit
+ Neustarts von DB-Instances
+ Aktualisierungen der Masterpasswörter
+ Wiederherstellen von DB-Instances auf einen bestimmten Zeitpunkt
+ Backup und Wiederherstellung von DB-Instances mithilfe von Backups auf Speicherebene
+ Starten und Stoppen von DB-Instances
+ Wartung von DB-Instances
+ Standby- und Lesereplikate in derselben Region und regionsübergreifend
## Nicht unterstützte Funktionen in RDS für Db2
RDS für Db2 unterstützt die folgenden Db2-Datenbankfunktionen nicht:
+ `SYSADM`-, `SECADM`- und `SYSMAINT`-Zugriff für den Masterbenutzer.
+ In C, C\$1\$1 oder Cobol geschriebene externe gespeicherte Prozeduren.
+ Mehrere Db2-DB-Instances auf einem einzigen Host.
+ Externe GSS-API-Plugins zur Authentifizierung.
+ Externe Plugins von Drittanbietern zum Sichern oder Wiederherstellen von Db2-Datenbanken.
+ Massiv-Parallelverarbeitung (Massively Parallel Processing, MPP) mit mehreren Knoten, wie z. B IBM Db2 Warehouse.
+ IBM Db2 pureScale.
+ Manuelle Einrichtung der Hochverfügbarkeit für die Notfallwiederherstellung (High Availability Disaster Recovery, HADR) für RDS für Db2.
**Anmerkung**
Amazon RDS unterstützt und verwaltet HADR für RDS für Db2 mithilfe von Replikaten. Weitere Informationen finden Sie unter [Arbeiten mit Replikaten für Amazon RDS für Db2](db2-replication.md).
RDS für Db2 unterstützt Multi-AZ-Bereitstellungen, regionsübergreifende automatische Backups und Replikationen. Weitere Informationen erhalten Sie unter [Bereitstellungen von Multi-AZ-DB-Instances für Amazon RDS](Concepts.MultiAZSingleStandby.md) und [Automatisierte Backups auf ein anderes replizieren AWS-Region](USER_ReplicateBackups.md).
+ Systemeigene Datenbankverschlüsselung.
+ Heterogener Verbund mit Informix, Sybase und Teradata. Weitere Informationen finden Sie unter [Verbund für Amazon RDS für Db2](db2-federation.md).
+ Erstellen von Routinen ohne Fencing und Migration vorhandener Routinen ohne Fencing durch Backup und Wiederherstellung von Daten. Weitere Informationen finden Sie unter [Routinen ohne Fencing](db2-known-issues-limitations.md#db2-known-issues-limitations-non-fenced-routines).
+ Erstellen von neuen nichtautomatischen Speicher-Tablespaces. Weitere Informationen finden Sie unter [Nicht automatische Speicher-Tablespaces während der Migration](db2-known-issues-limitations.md#db2-known-issues-limitations-non-automatic-storage-tablespaces).
+ Externe Tabellen.
# Db2 in Amazon-RDS-Versionen
Für Db2 haben die Versionsnummern das Format *major.minor.build.revision*, zum Beispiel 11.5.9.0.sb00000000.r1. Unsere Versionsimplementierung entspricht der von Db2.
**Hauptversion**
Die Engine-Hauptversionsnummer ist sowohl die Ganzzahl als auch der erste Nachkommateil der Versionsnummer, z. B. 11.5. Eine Versionsänderung gilt als wesentlich, wenn sich die Hauptversionsnummer ändert, z. B. von Version 11.5 auf 12.1.
**Unterversion**
Die Nebenversionsnummer ist der dritte und vierte Teil der Versionsnummer, z. B. 9.0 in 11.5.9.0. Der dritte Teil gibt das Db2-Modpack an, z. B. 9 in 9.0. Der vierte Teil gibt das Db2-Fixpack an, z. B. 0 in 9.0. Eine Versionsänderung gilt als geringfügig, wenn sich entweder das Db2-Modpack oder das Db2-Fixpack ändert, z. B. von Version 11.5.9.0 auf 11.5.9.1 oder von Version 11.5.9.0 auf 11.5.10.0, mit Ausnahmen bei der Bereitstellung von Katalogtabellen-Updates. (Amazon RDS übernimmt diese Ausnahmen.)
**Build**
Die Build-Nummer ist der fünfte Teil der Versionsnummer, z. B. sb00000000 in 11.5.9.0.sb00000000. Eine Buildnummer, bei der der Zahlenteil nur aus Nullen besteht, weist auf einen Standard-Build hin. Eine Buildnummer, bei der der Zahlenteil nicht nur aus Nullen besteht, weist auf einen speziellen Build hin. Eine Buildnummer ändert sich, wenn es ein Sicherheitsupdate oder einen speziellen Build einer vorhandenen Db2-Version gibt. Eine Änderung der Buildnummer weist auch darauf hin, dass Amazon RDS automatisch eine neue Nebenversion angewendet hat.
**Änderung**
Die Revisionsnummer ist der sechste Teil der Versionsnummer, z. B. r1 in 11.5.9.0.sb00000000.r1. Eine Überarbeitung ist eine Amazon-RDS-Revision einer bestehenden Db2-Version. Eine Änderung der Revisionsnummer weist darauf hin, dass Amazon RDS automatisch eine neue Nebenversion angewendet hat.
**Topics**
+ [Upgrade-Management für Amazon RDS Db2-Instances](Db2.Concepts.VersionMgmt.Supported.md)
+ [Unterstützte Db2-Hauptversionen in Amazon RDS](#Db2.Concepts.VersionMgmt.ReleaseCalendar)
# Upgrade-Management für Amazon RDS Db2-Instances
Verwenden Sie einen der folgenden Befehle, um die aktuelle Liste der unterstützten Db2-Nebenversionen auf RDS anzuzeigen:
```
aws rds describe-db-engine-versions --engine db2-se
aws rds describe-db-engine-versions --engine db2-ae
```
Amazon RDS unterstützt auch Upgrade-Rollout-Richtlinien zur Verwaltung automatischer Upgrades kleinerer Versionen für mehrere Datenbankressourcen und AWS-Konten. Weitere Informationen finden Sie unter [Verwendung der AWS Organizations Upgrade-Rollout-Richtlinie für automatische Upgrades kleinerer Versionen](RDS.Maintenance.AMVU.UpgradeRollout.md).
Sie können eine beliebige aktuell unterstützte Db2-Version festlegen, wenn Sie eine DB-Instance erstellen. Sie können die Hauptversionen (wie z. B. Db2 11.5) sowie eine beliebige unterstützte Nebenversion für die angegebene Hauptversion festlegen. Wenn keine Version angegeben wird, verwendet Amazon RDS standardmäßig eine unterstützte Version - in der Regel die aktuelle Version. Wenn die Hauptversion, jedoch nicht die Unterversion, festgelegt ist, verwendet Amazon RDS standardmäßig den letzten Release der Hauptversion, die Sie festgelegt haben. Verwenden Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) AWS Command Line Interface (AWS CLI), um eine Liste der unterstützten Versionen sowie die Standardeinstellungen für neu erstellte DB-Instances anzuzeigen.
Um beispielsweise die unterstützten Engine-Versionen für Amazon RDS für Db2 aufzulisten, führen Sie den folgenden AWS CLI -Befehl aus: Ersetze es *region* durch dein AWS-Region.
Für Linux, macOS oder Unix:
```
aws rds describe-db-engine-versions \
--filters Name=engine,Values=db2-ae,db2-se \
--query "DBEngineVersions[].{Engine:Engine, EngineVersion:EngineVersion, DBParameterGroupFamily:DBParameterGroupFamily}" \
--region region
```
Für Windows:
```
aws rds describe-db-engine-versions ^
--filters Name=engine,Values=db2-ae,db2-se ^
--query "DBEngineVersions[].{Engine:Engine, EngineVersion:EngineVersion, DBParameterGroupFamily:DBParameterGroupFamily}" ^
--region region
```
Die Ausgabe dieses Befehls sieht etwa so wie im folgenden Beispiel aus:
```
[
{
"Engine": "db2-ae",
"EngineVersion": "11.5.9.0.sb00000000.r1",
"DBParameterGroupFamily": "db2-ae-11.5"
},
{
"Engine": "db2-se",
"EngineVersion": "11.5.9.0.sb00000000.r1",
"DBParameterGroupFamily": "db2-se-11.5"
}
]
```
Die standardmäßige Db2-Version kann je nach AWS-Region variieren. Um eine DB-Instance mit einer bestimmten Unterversion zu erstellen, geben Sie die Unterversion bei der Erstellung der DB-Instance an. Sie können die Standardversion AWS-Region für `db2-ae` und `db2-se` Datenbank-Engines ermitteln, indem ` describe-db-engine-versions` Sie den Befehl ausführen. Im folgenden Beispiel wird die Standardversion für `db2-ae` in USA Ost (Nord-Virginia) zurückgegeben.
Für Linux, macOS oder Unix:
```
aws rds describe-db-engine-versions \
--default-only --engine db2-ae \
--query "DBEngineVersions[].{Engine:Engine, EngineVersion:EngineVersion, DBParameterGroupFamily:DBParameterGroupFamily}" \
--region us-east-1
```
Für Windows:
```
aws rds describe-db-engine-versions ^
--default-only --engine db2-ae ^
--query "DBEngineVersions[].{Engine:Engine, EngineVersion:EngineVersion, DBParameterGroupFamily:DBParameterGroupFamily}" ^
--region us-east-1
```
Die Ausgabe dieses Befehls sieht etwa so wie im folgenden Beispiel aus:
```
[
{
"Engine": "db2-ae",
"EngineVersion": "11.5.9.0.sb00000000.r1",
"DBParameterGroupFamily": "db2-ae-11.5"
}
]
```
Mit Amazon RDS können Sie steuern, wann Ihre Db2-Instance auf eine neue, von Amazon RDS unterstützte Hauptversion aktualisiert wird. Sie können die Kompatibilität mit bestimmten Db2-Versionen aufrechterhalten, neue Versionen mit Ihrer Anwendung testen, bevor Sie diese für die Produktion bereitstellen, und Hauptversions-Upgrades zu ausgewählten Zeiten durchführen lassen.
Wenn das automatische Upgrade der Nebenversion aktiviert ist, aktualisiert Amazon RDS die DB-Instances automatisch auf die neuen Db2-Nebenversionen, da sie von Amazon RDS unterstützt werden. Dieser Patch tritt während Ihres geplanten Wartungsfensters auf. Sie können eine DB-Instance ändern, um automatische Upgrades der Nebenversion zu aktivieren oder zu deaktivieren.
Mit Ausnahme der Db2-Versionen 11.5.9.1 und 11.5.10.0 beinhalten automatische Upgrades auf neue Db2-Nebenversionen automatische Upgrades auf neue Builds und Revisionen. Führen Sie für die Versionen 11.5.9.1 und 11.5.10.0 ein manuelles Upgrade der Nebenversionen durch.
Wenn Sie sich von automatisch geplanten Upgrades abmelden, können Sie ein manuelles Upgrade auf eine der unterstützten Unterversionen durchführen, indem Sie die selben Schritte befolgen, wie bei einem Update auf eine Hauptversion. Weitere Informationen finden Sie unter [Upgrade der Engine-Version für eine DB-Instance ](USER_UpgradeDBInstance.Upgrading.md).
## Unterstützte Db2-Hauptversionen in Amazon RDS
Die Hauptversionen von RDS für Db2 stehen mindestens bis zum Ende des IBM-Supports (Standard) für die entsprechende IBM-Version unter Standard-Support zur Verfügung. In der folgenden Tabelle sind die Termine aufgeführt, anhand denen Sie Ihre Test- und Upgrade-Zyklen planen können. Wenn Amazon den Support für eine RDS-für-Db2-Version länger als ursprünglich geplant erweitert, planen wir, diese Tabelle mit dem späteren Datum zu aktualisieren.
Sie können die folgenden Daten verwenden, um Ihre Test- und Upgrade-Zyklen zu planen.
**Anmerkung**
Daten mit nur einem Monat und einem Jahr sind ungefähre Angaben und werden mit einem genauen Datum aktualisiert, wenn es bekannt ist.
Sie können die Hauptversionen Ihrer Db2-Datenbanken anzeigen, indem Sie den AWS CLI Befehl [describe-db-major-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-major-engine-versions.html) ausführen oder den API-Vorgang [Describe DBMajor EngineVersions](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBMajorEngineVersions.html) RDS verwenden.
| Db2-Hauptversion | Datum der Veröffentlichung von IBM | Datum der Veröffentlichung von RDS | Ende des IBM-Supports (Standard und Advanced Edition) | Ende des IBM-Supports (verlängert) |
| --- | --- | --- | --- | --- |
| Db2 11.5 | 27. Juni 2019 | 27. November 2023 | 30. April 2027 | 30. April 2031 |
# Lizenzierungsoptionen für Amazon RDS für Db2
Amazon RDS for Db2 bietet zwei Lizenzierungsoptionen: Bring Your Own License (BYOL) und Db2-Lizenz durch. AWS Marketplace
**Topics**
+ [Bring-Your-Own-License (BYOL) für Db2](#db2-licensing-options-byol)
+ [Db2-Lizenz über AWS Marketplace](#db2-licensing-options-marketplace)
+ [Wechseln zwischen Db2-Lizenzen](#db2-edition-license-switching)
## Bring-Your-Own-License (BYOL) für Db2
Im BYOL-Modell können Sie Ihre bestehenden Db2-Datenbank-Lizenzen verwenden, um Datenbanken in Amazon RDS bereitzustellen. Stellen Sie sicher, dass Sie eine entsprechende Db2-Datenbank-Lizenz für die DB-Instance-Klasse und die Db2-Datenbank-Edition besitzen, die Sie ausführen möchten. Außerdem müssen Sie die IBM-Richtlinien für die Lizenzierung der IBM-Datenbanksoftware in der Cloud-Computing-Umgebung befolgen.
**Anmerkung**
DB-Instance mit Multi-AZ sind „Cold Standbys“, da die Db2-Datenbank zwar installiert ist, aber nicht ausgeführt wird. Standbys sind nicht lesbar, laufen nicht und bearbeiten keine Anfragen. Weitere Informationen finden Sie unter [IBM Db2 licensing information]( https://www.ibm.com/support/customer/csol/terms/licenses#license-search) auf der IBM-Website.
In diesem Modell verwenden Sie weiterhin Ihr aktives IBM-Supportkonto und kontaktieren für Serviceanfragen zu Db2-Datenbanken IBM direkt. Wenn Sie ein Support Konto beim Fallsupport haben, können Sie sich Support bei Problemen mit Amazon RDS an uns wenden. Amazon Web Services und IBM verfügen über ein Verfahren zum Multi-Vendor-Support für Fälle, bei denen Unterstützung von beiden Organisationen benötigt wird.
Amazon RDS unterstützt das BYOL-Modell für Db2 Standard Edition und Db2 Advanced Edition.
**Topics**
+ [IBM IDs für Bring Your Own License (BYOL) für Db2](#db2-prereqs-ibm-info)
+ [Hinzufügen IBM IDs zu einer Parametergruppe für RDS für Db2-DB-Instances](#db2-licensing-options-byol-adding-ids)
+ [Integrieren mit AWS License Manager](#db2-lms-integration)
### IBM IDs für Bring Your Own License (BYOL) für Db2
Im BYOL-Modell benötigen Sie Ihre IBM Customer ID und IBM Site ID, um DB-Instances von RDS für Db2 zu erstellen, zu ändern oder wiederherzustellen. Sie müssen eine benutzerdefinierte Parametergruppe mit Ihrer IBM Customer ID und IBM Site ID erstellen, *bevor* Sie eine DB-Instance von RDS für Db2 erstellen. Weitere Informationen finden Sie unter [Hinzufügen IBM IDs zu einer Parametergruppe für RDS für Db2-DB-Instances](#db2-licensing-options-byol-adding-ids). Sie können mehrere DB-Instances von RDS für Db2 mit unterschiedlichen IBM Customer IDs und IBM Site IDs im selben AWS-Konto oder derselben AWS-Region ausführen.
**Wichtig**
Wenn wir Ihre Lizenz nicht anhand Ihrer IBM Customer ID und IBM Site ID verifizieren können, beenden wir möglicherweise alle DB-Instances, die mit diesen nicht verifizierten Lizenzen ausgeführt werden.
Wenn Sie neu bei IBM Db2 sind, müssen Sie zunächst eine Db2-Softwarelizenz bei [https://www.ibm.com/products/db2/pricing](https://www.ibm.com/products/db2/pricing) erwerben. Nach dem Kauf einer Db2-Softwarelizenz erhalten Sie einen Berechtigungsnachweis von IBM, in dem Ihre IBM Customer ID und IBM Site ID aufgeführt sind.
Wenn Sie bereits IBM Db2-Kunde sind, finden Sie Ihre IBM Customer ID und IBM Site ID auf Ihrem Berechtigungsnachweis von IBM.
Sie finden Ihre IBM Customer ID und IBM Site ID auch in Ihrem [IBM Passport Advantage Online](https://www.ibm.com/software/passportadvantage/pao_customer.html)-Konto. Nachdem Sie sich angemeldet haben, können Sie beide entweder IDs auf der Hauptseite oder auf der Seite für Software-Downloads ansehen.
### Hinzufügen IBM IDs zu einer Parametergruppe für RDS für Db2-DB-Instances
Da Sie Standardparametergruppen nicht ändern können, müssen Sie eine benutzerdefinierte Parametergruppe erstellen und diese dann so ändern, dass sie die Werte für Ihre IBM Customer ID und IBM Site ID enthält. Informationen zu Parametergruppen finden Sie unter [DB-Parametergruppen für DB-Instances von Amazon RDS](USER_WorkingWithDBInstanceParamGroups.md).
**Wichtig**
Sie müssen eine benutzerdefinierte Parametergruppe mit Ihrer IBM Customer ID und IBM Site ID erstellen, *bevor* Sie eine DB-Instance von RDS für Db2 erstellen.
Verwenden Sie die Parametereinstellungen in der folgenden Tabelle.
| Parameter | Wert |
| --- | --- |
| `rds.ibm_customer_id` | `` |
| `rds.ibm_site_id` | `` |
| `ApplyMethod` | `immediate`, `pending-reboot` |
Diese Parameter sind dynamisch, was bedeutet, dass alle Änderungen sofort übernommen werden und Sie die DB-Instance nicht neu starten müssen. Wenn Sie nicht möchten, dass die Änderungen sofort wirksam werden, können Sie `ApplyMethod` auf `pending-reboot` festlegen und angeben, dass diese Änderungen während eines Wartungsfensters vorgenommen werden sollen.
Sie können eine benutzerdefinierte Parametergruppe erstellen und ändern, indem Sie die AWS-Managementkonsole, die AWS CLI oder die Amazon-RDS-API verwenden.
#### Konsole
**So fügen Sie Ihre IBM Customer ID und IBM Site ID zu einer Parametergruppe hinzu**
1. Erstellen Sie eine neue DB-Parametergruppe. Weitere Informationen über das Erstellen einer Parametergruppe finden Sie unter [Erstellen einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Ändern Sie die von Ihnen erstellte Parametergruppe. Weitere Informationen zum Ändern einer Parametergruppe finden Sie unter [Ändern von Parametern in einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
#### AWS CLI
**So fügen Sie Ihre IBM Customer ID und IBM Site ID zu einer Parametergruppe hinzu**
1. Erstellen Sie eine benutzerdefinierte Parametergruppe, indem Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html) ausführen.
Verwenden Sie den folgenden erforderlichen Parameter:
+ `--db-parameter-group-name` – Ein Name für die Parametergruppe, die Sie erstellen.
+ `--db-parameter-group-family` – Die Db2-Engine-Edition und die Hauptversion. Zulässige Werte: `db2-se-11.5`, `db2-ae-11.5`.
+ `--description` – Eine Beschreibung für diese Parametergruppe.
Weitere Informationen über das Erstellen einer Parametergruppe finden Sie unter [Erstellen einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Ändern Sie die Parameter in der benutzerdefinierten Parametergruppe, die Sie durch Ausführen des Befehls [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html) erstellt haben.
Verwenden Sie den folgenden erforderlichen Parameter:
+ `--db-parameter-group-name` – Der Name der von Ihnen erstellten Parametergruppe.
+ `--parameters` – Ein Array von Parameternamen, Werten und der Anwendungsmethoden für die Parameteraktualisierung.
Weitere Informationen zum Ändern einer Parametergruppe finden Sie unter [Ändern von Parametern in einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
#### RDS-API
**So fügen Sie Ihre IBM Customer ID und IBM Site ID zu einer Parametergruppe hinzu**
1. Erstellen Sie eine benutzerdefinierte DB-Parametergruppe, indem Sie die API-Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html) von Amazon RDS verwenden.
Nutzen Sie die folgenden erforderlichen Parameter:
+ `DBParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`
Weitere Informationen über das Erstellen einer Parametergruppe finden Sie unter [Erstellen einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Ändern Sie die Parameter in der benutzerdefinierten Parametergruppe, die Sie mithilfe der RDS-API-Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html) erstellt haben.
Nutzen Sie die folgenden erforderlichen Parameter:
+ `DBParameterGroupName`
+ `Parameters`
Weitere Informationen zum Ändern einer Parametergruppe finden Sie unter [Ändern von Parametern in einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
Jetzt sind Sie bereit, eine DB-Instance zu erstellen und die benutzerdefinierte Parametergruppe an die DB-Instance anzufügen. Weitere Informationen erhalten Sie unter [Erstellen einer Amazon-RDS-DB-Instance](USER_CreateDBInstance.md) und [Verknüpfen einer DB-Parametergruppe mit einer DB-Instance in Amazon RDS](USER_WorkingWithParamGroups.Associating.md).
### Integrieren mit AWS License Manager
Um die Überwachung der Lizenznutzung von RDS für Db2 im BYOL-Modell zu unterstützen, lässt sich [AWS License Manager](https://aws.amazon.com/license-manager/) mit RDS für Db2 integrieren. License Manager unterstützt die Nachverfolgung von RDS for Db2-Engine-Editionen auf Basis von virtual CPUs (vCPUs). Sie können License Manager auch verwenden AWS Organizations , um alle Ihre Unternehmenskonten zentral zu verwalten.
Um die Lizenznutzung Ihrer DB-Instances von RDS für Db2 nachzuverfolgen, müssen Sie selbstverwaltete Lizenzen erstellen. Sie können selbstverwaltete Lizenzen mithilfe der AWS-Managementkonsole, der AWS License Manager CLI und der AWS License Manager API erstellen. Oder Sie können die Erstellung von selbstverwalteten Lizenzen mit CloudFormation Vorlagen automatisieren. Terraform
In diesem Fall werden Ressourcen von RDS für Db2, die mit dem Produktinformationsfilter übereinstimmen, automatisch der selbstverwalteten Lizenz zugeordnet. Die Erkennung von DB-Instances von RDS für Db2 kann bis zu 24 Stunden dauern.
Die folgende Tabelle zeigt die verfügbaren Werte für den Engine-Edition-Produktinformationsfilter für RDS für Db2.
| Wert | Description |
| --- | --- |
| `db2-se` | Db2 Standard Edition |
| `db2-ae` | Db2 Advanced Edition |
**Topics**
+ [Terminologie](#db2-lms-integration-terms)
+ [Erstellen einer selbstverwalteten Lizenz in AWS License Manager](#db2-lms-integration-tracking)
+ [Automatisieren Sie die Erstellung von selbstverwalteten Lizenzen mithilfe von Vorlagen AWS License Manager](#db2-lms-integration-templates)
+ [Einstellungen für die Erstellung von selbstverwalteten Lizenzen](#db2-settings-lms)
#### Terminologie
Auf dieser Seite wird die folgende Terminologie verwendet, wenn es um die Amazon RDS-Integration mit geht AWS License Manager.
Selbstverwaltete Lizenz
Selbstverwaltete Lizenz ist ein Begriff, der in AWS License Manager verwendet wird. Die Amazon RDS-Konsole bezeichnet die Lizenz als AWS License Manager Konfiguration. Eine selbstverwaltete Lizenz enthält Lizenzregeln, die auf den Bedingungen Ihrer Unternehmensverträge basieren. Die von Ihnen erstellten Regeln bestimmen, wie AWS Befehle verarbeitet, die Lizenzen erfordern. Bei der Erstellung einer selbstverwalteten Lizenz arbeiten Sie zur Prüfung von Unternehmensverträgen eng mit dem Compliance-Team Ihres Unternehmens zusammen. Weitere Informationen finden Sie unter [Self-managed licenses in License Manager](https://docs.aws.amazon.com/license-manager/latest/userguide/license-configurations.html).
#### Erstellen einer selbstverwalteten Lizenz in AWS License Manager
Sie können eine selbstverwaltete Lizenz mithilfe der AWS-Managementkonsole, der AWS License Manager CLI und der AWS License Manager API erstellen.
**Anmerkung**
Wenn Sie eine RDS for Db2-DB-Instance mithilfe von erstellen AWS-Managementkonsole, erstellen Sie eine selbstverwaltete Lizenz, indem Sie einen Namen für die Lizenz eingeben. Dann ordnet Amazon RDS die DB-Instance dieser Lizenz zu. (In der Amazon RDS-Konsole wird diese Lizenz als AWS License Manager Konfiguration bezeichnet.) Wenn Sie eine RDS for Db2-DB-Instance mithilfe der AWS License Manager CLI oder AWS License Manager API erstellen möchten, müssen Sie zunächst eine selbstverwaltete Lizenz mit den folgenden Schritten erstellen. Dasselbe gilt für die Wiederherstellung einer DB-Instance von RDS für Db2 auf einen bestimmten Zeitpunkt oder aus einem Snapshot.
##### Konsole
**So erstellen Sie eine selbstverwaltete Lizenz zum Nachverfolgen der Lizenznutzung Ihrer DB-Instances von RDS für Db2**
1. Wechseln Sie zu [https://console.aws.amazon.com/license-manager/](https://console.aws.amazon.com/license-manager/).
1. Erstellen Sie eine selbstverwaltete Lizenz.
Anleitungen finden Sie unter [Create a self-managed license](https://docs.aws.amazon.com/license-manager/latest/userguide/create-license-configuration.html) im *AWS License Manager -Benutzerhandbuch*.
Fügen Sie im Bedienfeld **Produktinformationen** eine Regel für einen **RDS-Produktinformationsfilter** hinzu.
Weitere Informationen finden Sie unter [ProductInformation](https://docs.aws.amazon.com/license-manager/latest/APIReference/API_ProductInformation.html) in der *AWS License Manager -API-Referenz*.
##### AWS License Manager CLI
**Anmerkung**
Dieses Verfahren verwendet einen AWS License Manager CLI-Befehl.
Führen Sie den AWS License Manager [create-license-configuration](https://docs.aws.amazon.com/cli/latest/reference/license-manager/create-license-configuration.html)Befehl aus AWS CLI, um mit dem eine selbstverwaltete Lizenz zu erstellen. Verwenden Sie die Option `--cli-input-json` oder `--cli-input-yaml`, um die Optionen an den Befehl zu übergeben.
Weitere Informationen finden Sie unter [Einstellungen für die Erstellung von selbstverwalteten Lizenzen](#db2-settings-lms).
Mit dem folgenden Befehl wird eine selbstverwaltete Lizenz für Db2 Standard Edition erstellt.
```
aws license-manager create-license-configuration --cli-input-json file://rds-db2-se.json
```
Die folgende JSON-Datei ist der Inhalt der Datei `rds-db2-se.json` aus dem vorherigen Befehl.
```
{
"Name": "rds-db2-se",
"Description": "RDS Db2 Standard Edition",
"LicenseCountingType": "vCPU",
"LicenseCountHardLimit": false,
"ProductInformationList": [
{
"ResourceType": "RDS",
"ProductInformationFilterList": [
{
"ProductInformationFilterName": "Engine Edition",
"ProductInformationFilterValue": ["db2-se"],
"ProductInformationFilterComparator": "EQUALS"
}
]
}
]
}
```
Weitere Informationen zu Produktinformationen finden Sie unter [Automatisiertes Erkennen des Ressourcenbestands](https://docs.aws.amazon.com/license-manager/latest/userguide/automated-discovery.html) im *AWS License Manager -Benutzerhandbuch*.
Weitere Informationen zum Parameter `--cli-input` finden Sie unter [Generieren der AWS CLI -Skeleton- und -Eingabeparameter aus einer JSON- oder YAML-Eingabedatei](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-skeleton.html) im *AWS CLI -Benutzerhandbuch*.
##### AWS License Manager API
**Anmerkung**
Dieses Verfahren verwendet einen AWS License Manager API-Befehl.
Verwenden Sie den [https://docs.aws.amazon.com/license-manager/latest/APIReference/API_CreateLicenseConfiguration.html](https://docs.aws.amazon.com/license-manager/latest/APIReference/API_CreateLicenseConfiguration.html) AWS License Manager API-Vorgang mit den folgenden erforderlichen Parametern, um eine selbstverwaltete Lizenz zu erstellen:
+ `Name`
+ `LicenseCountingType`
+ `ProductInformationList`
+ `ResourceType`
+ `ProductInformationFilterList`
+ `ProductInformationFilterName`
+ `ProductInformationFilterValue`
+ `ProductInformationFilterComparator`
Weitere Informationen zu den Parametern finden Sie unter [Einstellungen für die Erstellung von selbstverwalteten Lizenzen](#db2-settings-lms).
#### Automatisieren Sie die Erstellung von selbstverwalteten Lizenzen mithilfe von Vorlagen AWS License Manager
Sie können die Erstellung von selbstverwalteten Lizenzen mithilfe CloudFormation von Vorlagen automatisieren. Terraform
Mit der folgenden CloudFormation Beispielvorlage werden selbstverwaltete Lizenzen für Db2 Standard Edition auf RDS for Db2 erstellt. Aktualisieren Sie für eine Vorlage für Db2 Advanced Edition die Werte für `Name`, `Description` und `ProductInformationFilter`.
```
AWSTemplateFormatVersion: "2010-09-09"
Description: CloudFormation template to create a License Configuration for Db2 Standard Edition on RDS for Db2.
Resources:
Db2LicenseConfiguration:
Type: "AWS::LicenseManager::LicenseConfiguration"
Properties:
Name: "rds-db2-se"
Description: "Db2 Standard Edition on RDS for Db2"
LicenseCountingType: "vCPU"
LicenseCountHardLimit: false
ProductInformationList:
- ResourceType: "RDS"
ProductInformationFilterList:
- ProductInformationFilterName: "Engine Edition"
ProductInformationFilterValue:
- "db2-se"
ProductInformationFilterComparator: "EQUALS"
```
Weitere Informationen zur Verwendung CloudFormation mit Amazon RDS finden Sie unter[Amazon RDS Amazon erstellen mit AWS CloudFormation](creating-resources-with-cloudformation.md).
Mit der folgenden Terraform-Beispielvorlage werden selbstverwaltete Lizenzen für Db2 Standard Edition auf RDS für Db2 erstellt. Ersetze es *us-east-1* durch dein AWS-Region. Aktualisieren Sie für eine Vorlage für Db2 Advanced Edition die Werte für `name`, `description` und `product_information_filter`.
```
provider "aws" {
region = "us-east-1"
}
resource "aws_licensemanager_license_configuration" "rds_db2_license_config" {
name = "rds-db2-se"
description = "Db2 Standard Edition on RDS for Db2
license_counting_type = "vCPU"
license_count_hard_limit = false
product_information_list {
resource_type = "RDS"
product_information_filter {
name = "Engine Edition"
comparator = "EQUALS"
value = ["db2-se"]
}
}
}
```
*Weitere Informationen zur Verwendung von Terraform Amazon RDS finden Sie unter [Verwendung Terraform als IaC-Tool für das AWS Cloud und Bewährte Methoden für die](https://docs.aws.amazon.com/prescriptive-guidance/latest/choose-iac-tool/terraform.html) [Verwendung des AWS Terraform-Anbieters](https://docs.aws.amazon.com/prescriptive-guidance/latest/terraform-aws-provider-best-practices/introduction.html) in AWS Prescriptive Guidance.*
#### Einstellungen für die Erstellung von selbstverwalteten Lizenzen
In der folgenden Tabelle finden Sie Details zu den Einstellungen für die Erstellung von selbstverwalteten Lizenzen mithilfe der AWS License Manager CLI, der AWS License Manager API, einer CloudFormation Vorlage und einer Terraform Vorlage. Der Parametername in der folgenden Tabelle wird im Format des Namens angezeigt, der in der AWS License Manager API und der CloudFormation Vorlage verwendet wird.
| Parametername | Datentyp | Erforderlich | Description |
| --- | --- | --- | --- |
| Name | Zeichenfolge | Ja | Der Name der Lizenzkonfiguration. |
| Description | Zeichenfolge | Nein | Die Beschreibung der Lizenzkonfiguration. |
| LicenseCountingType | Zeichenfolge | Ja | Die Dimension, die zur Nachverfolgung des Lizenzbestands verwendet wird. Zulässiger Wert: `vCPU`. |
| LicenseCountHardLimit | boolesch | Nein | Gibt an, ob eine harte oder eine weiche Lizenzerzwingung verwendet wird. Wenn ein festes Limit überschritten wird, wird der Start neuer Instances blockiert. |
| ProductInformationList | Array von Objekten | Ja | Eine Liste mit Produktinformationen für eine Lizenzkonfiguration. |
| ResourceType | Zeichenfolge | Ja | Der Ressourcentyp. Zulässiger Wert: `RDS`. |
| ProductInformationFilterList | Array von Objekten | Ja | Eine Liste von Produktinformationsfiltern für eine Lizenzkonfiguration. |
| ProductInformationFilterName | Zeichenfolge | Ja | Der Name des Filtertyps, der deklariert wird. Zulässiger Wert: `Engine Edition`. |
| ProductInformationFilterValue | Zeichenfolgen-Array | Ja | Der Wert, nach dem gefiltert werden soll. Sie dürfen nur einen Wert angeben. Gültige Werte: `db2-se` oder `db2-ae`. |
| ProductInformationFilterComparator | Zeichenfolge | Ja | Der logische Operator für ProductInformationFilterName. Zulässiger Wert: EQUALS. |
## Db2-Lizenz über AWS Marketplace
Beim AWS Marketplace Modell mit durchgehender Db2-Lizenz zahlen Sie für das Abonnement von Db2-Lizenzen einen Stundensatz. Mit diesem Modell können Sie schnell mit RDS für Db2 loslegen, ohne Lizenzen erwerben zu müssen.
Um die Db2-Lizenz nutzen zu können AWS Marketplace, benötigen Sie ein aktives AWS Marketplace Abonnement für die jeweilige IBM Db2 Edition, die Sie verwenden möchten. Wenn Sie noch keine haben, [abonnieren Sie AWS Marketplace](#db2-marketplace-subscribing-registering) für diese IBM Db2-Edition.
Amazon RDS unterstützt Db2-Lizenzen AWS Marketplace für die IBM Db2 Standard Edition und die IBM Db2 Advanced Edition.
**Topics**
+ [Terminologie](#db2-marketplace-terminology)
+ [Zahlungen und Fakturierung](#db2-marketplace-billing)
+ [Abonnieren von Db2-Marketplace-Angeboten und Registrieren bei IBM](#db2-marketplace-subscribing-registering)
+ [Einholen eines privaten Angebots](#db2-marketplace-private-offer)
### Terminologie
Auf dieser Seite wird die folgende Terminologie verwendet, wenn es um die Amazon RDS-Integration mit geht AWS Marketplace.
SaaS Subscription (SaaS-Abonnement)
Bei AWS Marketplace software-as-a-service (SaaS-) Produkten wie dem pay-as-you-go Lizenzmodell wird ein nutzungsbasiertes Abonnementmodell verwendet. IBM, der Softwareanbieter für Db2, verfolgt Ihre Nutzung nach und Sie zahlen nur für Ihre tatsächliche Nutzung.
Öffentliches Angebot
Öffentliche Angebote ermöglichen es Ihnen, AWS Marketplace Produkte direkt bei der zu erwerben. AWS-Managementkonsole
Privates Angebot
Private Angebote sind ein Kaufprogramm, mit dem Verkäufer und Käufer individuelle Preise und Bedingungen für Endbenutzer-Lizenzverträge (EULA) für Einkäufe in AWS Marketplace aushandeln können.
Db2-Marketplace-Gebühren
Gebühren für die Nutzung der Db2-Softwarelizenz, die von IBM erhoben werden. Diese Servicegebühren sind abgerechnet AWS Marketplace und erscheinen auf Ihrer AWS Rechnung unter dem AWS Marketplace Abschnitt.
Amazon-RDS-Gebühren
AWS Gebühren, die für die Dienste RDS für Db2 anfallen. Davon ausgenommen sind Lizenzen bei der Nutzung AWS Marketplace für Db2-Lizenzen. Die Gebühren werden über den verwendeten Amazon RDS-Service berechnet und erscheinen auf Ihrer AWS Rechnung.
### Zahlungen und Fakturierung
RDS for Db2 ist in Db2 integriert AWS Marketplace , um stündliche pay-as-you-go Lizenzen für Db2 anzubieten. Die Gebühren für den Db2-Marketplace decken die Lizenzkosten der Db2-Software ab, die Amazon-RDS-Gebühren decken die Kosten für die Nutzung Ihrer DB-Instance von RDS für Db2 ab. Weitere Informationen zu Preisen finden Sie unter [Amazon RDS für Db2 pricing](https://aws.amazon.com/rds/db2/pricing/).
Damit keine Gebühren mehr anfallen, müssen Sie alle DB-Instances von RDS für Db2 löschen. Darüber hinaus können Sie Ihre Abonnements AWS Marketplace für Db2-Lizenzen entfernen. Wenn Sie Ihre Abonnements entfernen, ohne Ihre DB-Instances zu löschen, stellt Amazon RDS Ihnen weiterhin die Nutzung der DB-Instances in Rechnung. Weitere Informationen finden Sie unter [Löschen einer DB-Instance](USER_DeleteInstance.md).
[In der Konsole können Sie Rechnungen für Ihre RDS für Db2-DB-Instances, die eine Db2-Lizenz verwenden, einsehen und Zahlungen verwalten. AWS MarketplaceAWS Billing](https://console.aws.amazon.com/billing) Ihre Rechnungen beinhalten zwei Gebühren: eine für Ihre Nutzung der Db2-Lizenz AWS Marketplace und eine für Ihre Nutzung von Amazon RDS. Weitere Informationen zur Abrechnung finden Sie unter [Anzeigen Ihrer Rechnung](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/getting-viewing-bill.html) im *AWS Fakturierung und Kostenmanagement -Benutzerhandbuch*.
### Abonnieren von Db2-Marketplace-Angeboten und Registrieren bei IBM
Um die Db2-Lizenz nutzen zu können AWS Marketplace, müssen Sie die verwenden, AWS-Managementkonsole um die folgenden beiden Aufgaben auszuführen. Sie können diese Aufgaben nicht über die AWS CLI oder die RDS-API ausführen.
**Anmerkung**
Wenn Sie Ihre DB-Instances mithilfe der AWS CLI oder der RDS-API erstellen möchten, müssen Sie diese beiden Aufgaben zuerst ausführen.
**Topics**
+ [Aufgabe 1: Abonnieren Sie Db2 in AWS Marketplace](#db2-marketplace-subscribing)
+ [Aufgabe 2: Registrieren Ihres Abonnements bei IBM](#db2-marketplace-registering)
#### Aufgabe 1: Abonnieren Sie Db2 in AWS Marketplace
Um die Db2-Lizenz mit verwenden zu können AWS Marketplace, benötigen Sie ein aktives AWS Marketplace Abonnement für Db2. [Da Abonnements mit einer bestimmten IBM Db2 Edition verknüpft sind, müssen Sie Db2 AWS Marketplace für jede Edition von Db2 abonnieren, die Sie verwenden möchten: [IBM Db2Advanced Edition, Standard Edition](https://aws.amazon.com/marketplace/pp/prodview-w6m4yctzzy5fk). IBM Db2](https://aws.amazon.com/marketplace/pp/prodview-gbsgwalbkphv6) *Informationen zu AWS Marketplace Abonnements finden Sie im Buyer Guide unter [nutzungsbasierte SaaS-Abonnements](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-saas-products.html#saas-pricing-models).AWS Marketplace *
Wir empfehlen, dass Sie Db2 abonnieren, AWS Marketplace *bevor* Sie mit der [Erstellung einer](USER_CreateDBInstance.md) DB-Instance beginnen.
#### Aufgabe 2: Registrieren Ihres Abonnements bei IBM
Nachdem Sie Db2 in abonniert haben AWS Marketplace, schließen Sie die Registrierung Ihrer IBM-Bestellung auf der AWS Marketplace Seite für den von Ihnen ausgewählten Db2-Abonnementtyp ab. Wählen Sie auf der AWS Marketplace Seite **Kaufoptionen anzeigen** und anschließend **Konto einrichten** aus. Sie können sich entweder mit Ihrem bestehenden IBM-Konto registrieren oder ein kostenloses IBM-Konto erstellen.
### Einholen eines privaten Angebots
Sie können ein AWS Marketplace privates Angebot für Db2 bei IBM anfordern. Weitere Informationen finden Sie unter [Private offers](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-private-offers.html) im *AWS Marketplace -Käuferhandbuch*.
**Anmerkung**
Wenn Sie ein AWS Organizations Benutzer sind und ein privates Angebot erhalten haben, das für Ihre Zahler- und Mitgliedskonten ausgestellt wurde, gehen Sie wie folgt vor, um Db2 direkt für jedes Konto in Ihrer Organisation zu abonnieren.
**So holen Sie ein privates Angebot für Db2 ein**
1. Nachdem ein privates Angebot erstellt wurde, melden Sie sich bei der AWS Marketplace -Konsole an.
1. Öffnen Sie die E-Mail mit dem Link zum privaten Db2-Angebot.
1. Folgen Sie dem Link, um direkt auf das private Angebot zuzugreifen.
**Anmerkung**
Wenn Sie diesem Link folgen, bevor Sie sich beim richtigen Konto anmelden, wird der Fehler **Page note found** (404) angezeigt.
1. Lesen Sie die Nutzungsbedingungen.
1. Wählen Sie **Bedingungen akzeptieren**.
**Anmerkung**
Wenn ein AWS Marketplace privates Angebot nicht angenommen wird, werden die Db2-Servicegebühren von AWS Marketplace weiterhin zum öffentlichen Stundensatz in Rechnung gestellt.
1. Um die Angebotsdetails zu überprüfen, wählen Sie im Produktangebot die Option **Details anzeigen** aus.
Nachdem Sie das Verfahren abgeschlossen haben, können Sie Ihre DB-Instance erstellen, indem Sie die Schritte unter [Erstellen einer Amazon-RDS-DB-Instance](USER_CreateDBInstance.md) befolgen. **Vergewissern Sie sich AWS-Managementkonsole, dass Sie unter **Lizenz** die Option Through auswählen. AWS Marketplace**
## Wechseln zwischen Db2-Lizenzen
Sie können in RDS für Db2 zwischen Db2-Lizenzen wechseln. Sie können beispielsweise mit Bring-Your-Own-License (BYOL) beginnen und dann zur Db2-Lizenz über AWS Marketplace wechseln.
**Wichtig**
Wenn Sie zur Db2-Lizenz wechseln möchten, stellen Sie sicher AWS Marketplace, dass Sie über ein aktives AWS Marketplace Abonnement für die IBM Db2 Edition verfügen, die Sie verwenden möchten. Wenn nicht, [abonnieren Sie Db2 in AWS Marketplace](#db2-marketplace-subscribing-registering) zunächst für diese Db2-Edition und schließen Sie dann den Wiederherstellungsvorgang ab.
### Konsole
**So wechseln Sie zwischen Db2-Lizenzen**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Wählen Sie im Navigationsbereich **Automated backups** (Automatisierte Backups) aus.
Die automatisierten Backups werden auf der Registerkarte **Current Region (Aktuelle Region)** angezeigt.
1. Wählen Sie die DB-Instance aus, die Sie wiederherstellen möchten.
1. Wählen Sie unter **Aktionen** die Option **Wiederherstellen auf einen bestimmten Zeitpunkt** aus.
Anschließend wird das Fenster **Restore to point in time (Zu einem bestimmten Zeitpunkt wiederherstellen)** angezeigt.
1. Wählen Sie **Späteste Wiederherstellungszeit**, um auf den spätesten möglichen Zeitpunkt wiederherzustellen oder wählen Sie **Benutzerdefiniert**, um eine Zeit auszuwählen.
Geben Sie bei Auswahl von **Benutzerdefiniert** das Datum und die Uhrzeit ein, zu dem/der Sie die Instance wiederherstellen möchten.
**Anmerkung**
Zeiten werden in Ihrer lokalen Zeitzone angezeigt, die durch einen Offset von Coordinated Universal Time (UTC) angezeigt wird. UTC-5 ist beispielsweise Eastern Standard Time/Central Daylight Time.
1. Wählen Sie für **DB-Engine** die Db2-Lizenz aus, die Sie verwenden möchten.
1. Geben Sie für **DB-Instance-Kennung** den Namen der wiederhergestellten DB-Ziel-Instance ein. Der Name muss eindeutig sein.
1. Wählen Sie nach Bedarf andere Optionen wie die DB-Instance-Klasse und Speicher aus, sowie ob Sie Speicher-Autoscaling verwenden möchten.
Weitere Informationen zu den einzelnen Einstellungen finden Sie unter [Einstellungen für DB-Instances](USER_CreateDBInstance.Settings.md).
1. Wählen Sie **Wiederherstellen auf einen bestimmten Zeitpunkt** aus.
Weitere Informationen finden Sie unter [Wiederherstellen einer DB-Instance auf einen bestimmten Zeitpunkt für Amazon RDS](USER_PIT.md).
### AWS CLI
Um zwischen Db2-Lizenzen zu wechseln, führen Sie den point-in-time Befehl [restore-db-instance-to-](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-to-point-in-time.html) aus. Das folgende Beispiel stellt die neueste point-in-time Version wieder her, setzt die DB-Engine auf IBM Db2 Advanced Edition und setzt das Lizenzmodell auf Db2-Lizenz über. AWS Marketplace
Sie können andere Einstellungen festlegen. Weitere Informationen zu den einzelnen Einstellungen finden Sie unter [Einstellungen für DB-Instances](USER_CreateDBInstance.Settings.md).
**Example**
Für Linux, macOS oder Unix:
```
1. aws rds restore-db-instance-to-point-in-time \
2. --source-db-instance-identifier my_source_db_instance \
3. --target-db-instance-identifier my_target_db_instance \
4. --use-latest-restorable-time \
5. --engine db2-ae \
6. --license-model marketplace-license
```
Für Windows:
```
1. aws rds restore-db-instance-to-point-in-time ^
2. --source-db-instance-identifier my_source_db_instance ^
3. --target-db-instance-identifier my_target_db_instance ^
4. --use-latest-restorable-time ^
5. --engine db2-ae ^
6. --license-model marketplace-license
```
Weitere Informationen finden Sie unter [Wiederherstellen einer DB-Instance auf einen bestimmten Zeitpunkt für Amazon RDS](USER_PIT.md).
### RDS-API
Zum Wechseln zwischen Db2-Lizenzen rufen Sie die API-Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html) von Amazon RDS mit den folgenden Parametern auf:
+ `SourceDBInstanceIdentifier`
+ `TargetDBInstanceIdentifier`
+ `RestoreTime`
+ `Engine`
+ `LicenseModel`
Weitere Informationen finden Sie unter [Wiederherstellen einer DB-Instance auf einen bestimmten Zeitpunkt für Amazon RDS](USER_PIT.md).
# Instance-Klassen von Amazon RDS für Db2
Die Rechen- und Speicherkapazität von DB-Instances wird über deren Instance-Klasse festgelegt. Die benötigte DB-Instance-Klasse richtet sich nach Ihren Rechen- und Speicheranforderungen.
## Unterstützte Instance-Klassen von RDS für Db2
Die unterstützten Instance-Klassen von Amazon RDS für Db2 sind Untergruppen der Amazon-RDS-DB-Instance-Klassen. Eine vollständige Liste der Amazon-RDS-Instance-Klassen finden Sie unter [](Concepts.DBInstanceClass.md).
**Topics**
+ [Unterstützte Instance-Klassen von RDS für Db2 für Db2 Standard Edition](#Db2.Concepts.InstanceClasses.Supported.SE)
+ [Unterstützte Instance-Klassen von RDS für Db2 für Db2 Advanced Edition](#Db2.Concepts.InstanceClasses.Supported.AE)
### Unterstützte Instance-Klassen von RDS für Db2 für Db2 Standard Edition
In der folgenden Tabelle sind alle Instance-Klassen aufgeführt, die für die Db2 Standard Edition der Db2-Datenbankversion 11.5.9.0 unterstützt werden. Diese Instance-Klassen sind sowohl für das Modell Bring-Your-Own-License (BYOL) als auch für Db2-Lizenzen über AWS Marketplace verfügbar.
| Typ der Instance-Klasse | Instance-Klasse |
| --- | --- |
| Allzweck-Instance-Klassen mit Intel Xeon Scalable-Prozessoren der dritten Generation, SSD-Speicher und Netzwerkoptimierung | db.m6idn.large–db.m6idn.8xlarge |
| Allzweck-Instance-Klassen, die mit Intel Xeon Scalable-Prozessoren der dritten Generation betrieben werden | db.m6in.large–db.m6in.8xlarge |
| Allzweck-Instance-Klassen | db.m7i.large–db.m7i.8xlarge db.m6i.large–db.m6i.8xlarge |
| Speicheroptimierte Instanzklassen mit lokaler NVMe Basis SSDs, angetrieben von Intel Xeon Scalable Prozessoren der 3. Generation | db.x2iedn.xlarge |
| Arbeitsspeicheroptimierte Instance-Klassen, die mit Intel Xeon Scalable-Prozessoren der dritten Generation betrieben werden | db.r6idn.large–db.r6idn.4xlarge db.r6in.large–db.r6in.4xlarge |
| Arbeitsspeicheroptimierte Instance-Klassen | db.r7i.large–db.r7i.8xlarge db.r6i.large–db.r6i.4xlarge |
| Instance-Klassen mit Spitzenleistung | db.t3.small–db.t3.2xlarge |
### Unterstützte Instance-Klassen von RDS für Db2 für Db2 Advanced Edition
In der folgenden Tabelle sind alle Instance-Klassen aufgeführt, die für die Db2 Advanced Edition der Db2-Datenbankversion 11.5.9.0 unterstützt werden. Diese Instance-Klassen sind sowohl für das Modell Bring-Your-Own-License (BYOL) als auch für Db2-Lizenzen über AWS Marketplace verfügbar.
| Typ der Instance-Klasse | Instance-Klasse |
| --- | --- |
| Allzweck-Instance-Klassen mit Intel Xeon Scalable-Prozessoren der dritten Generation, SSD-Speicher und Netzwerkoptimierung | db.m6idn.large–db.m6idn.32xlarge |
| Allzweck-Instance-Klassen, die mit Intel Xeon Scalable-Prozessoren der dritten Generation betrieben werden | db.m6in.large–db.m6in.32xlarge |
| Allzweck-Instance-Klassen | db.m6i.large–db.m7i.48xlarge db.m7i.large–db.m7i.48xlarge |
| Speicheroptimierte Instanzklassen mit lokaler NVMe Basis SSDs, die von Intel Xeon Scalable Prozessoren der 3. Generation angetrieben werden | db.x2iedn.xlarge–db.x2iedn.32xlarge |
| Arbeitsspeicheroptimierte Instance-Klassen, die mit Intel Xeon Scalable-Prozessoren der dritten Generation betrieben werden | db.r6idn.large–db.r6idn.32xlarge db.r6in.8xlarge–db.r6in.32xlarge |
| Arbeitsspeicheroptimierte Instance-Klassen | db.r6i.large–db.r7i.48xlarge db.r7i.large–db.r7i.48xlarge |
| Instance-Klassen mit Spitzenleistung | db.t3.small–db.t3.2xlarge |
# Standardrollen in Amazon RDS für Db2
RDS für Db2 fügt die folgenden sechs Rollen hinzu und weist sie der `master_user_role` mit der Option `ADMIN` zu. Wenn die Datenbank bereitgestellt wird, gewährt RDS für Db2 dem Hauptbenutzer `master_user_role`. Der Hauptbenutzer kann diese Rollen wiederum anderen Benutzern, Gruppen oder Rollen mit nativen `GRANT`-Anweisungen zuweisen, indem er eine Verbindung zur Datenbank herstellt.
+ **DBA** – RDS für Db2 erstellt diese leere Rolle mit `DATAACCESS`-Autorisierung. Der Hauptbenutzer kann dieser Rolle weitere Autorisierungen oder Berechtigungen hinzufügen und die Rolle dann anderen Benutzern, Gruppen oder Rollen zuweisen.
+ **DBA\$1RESTRICTED** – RDS für Db2 erstellt diese leere Rolle. Der Hauptbenutzer kann dieser Rolle weitere Berechtigungen hinzufügen und die Rolle dann anderen Benutzern, Gruppen oder Rollen zuweisen.
+ **DEVELOPER** – RDS für Db2 erstellt diese leere Rolle mit `DATAACCESS`-Autorisierung. Der Hauptbenutzer kann dieser Rolle weitere Autorisierungen oder Berechtigungen hinzufügen und die Rolle dann anderen Benutzern, Gruppen oder Rollen zuweisen.
+ **ROLE\$1NULLID\$1PACKAGES** – RDS für Db2 gewährt dieser Rolle `EXECUTE`-Berechtigungen für `ALL NULLID`-Pakete, die bei der Ausführung von `CREATE DATABASE` an Db2 gebunden waren.
+ **ROLE\$1PROCEDURES** – RDS für Db2 gewährt dieser Rolle `EXECUTE`-Berechtigungen für alle `SYSIBM`-Vorgänge.
+ **ROLE\$1TABLESPACES** – RDS für Db2 gewährt `USAGE`-Berechtigungen für Tabellenbereiche, die mit dem Befehl `CREATE DATABASE` erstellt wurden.
# Parameter von Amazon RDS für Db2
In Amazon RDS für Db2 werden drei Typen von Parametern verwendet: Konfigurationsparameter für den Datenbankmanager, Registrierungsvariablen und Datenbankkonfigurationsparameter. Sie können die ersten beiden Typen mithilfe der Parametergruppen und den letzten Typ mithilfe der gespeicherten Prozedur [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param) verwalten.
Standardmäßig verwendet eine DB-Instance von RDS für Db2 eine DB-Parametergruppe, die für eine Db2-Datenbank und eine DB-Instance spezifisch ist. Diese Parametergruppe enthält Parameter für die Datenbank-Engine IBM Db2, insbesondere die Konfigurationsparameter für den Datenbankmanager und die Registrierungsvariablen. Weitere Informationen zum Arbeiten mit Parametergruppen finden Sie unter [Parametergruppen für Amazon RDS](USER_WorkingWithParamGroups.md).
Datenbankkonfigurationsparameter von RDS für Db2 werden auf die Standardwerte der von Ihnen ausgewählten Speicher-Engine festgelegt. Weitere Informationen zu den Db2-Parametern finden Sie unter [Db2-Datenbankkonfigurationsparameter](https://www.ibm.com/docs/en/db2/11.5?topic=parameters-database-configuration) in der IBM Db2-Dokumentation.
**Topics**
+ [Anzeigen der Parameter in Parametergruppen](#db2-viewing-parameter-group-parameters)
+ [Anzeigen aller Parameter mit Db2-Befehlen](#db2-viewing-parameters-db2-commands)
+ [Ändern der Parameter in Parametergruppen](#db2-modifying-parameter-group-parameters)
+ [Ändern der Datenbankkonfigurationsparameter mit Db2-Befehlen](#db2-modifying-parameters-db2-commands)
## Anzeigen der Parameter in Parametergruppen
Die Konfigurationsparameter für den Datenbankmanager und die Registrierungsvariablen werden in Parametergruppen festgelegt. Sie können die Database Manager-Konfigurationsparameter und die Registrierungsvariablen für eine bestimmte Db2-Version anzeigen, indem Sie die AWS-Managementkonsole AWS CLI, oder die RDS-API verwenden.
### Konsole
**So können Sie die Parameterwerte für eine DB-Parametergruppe ansehen**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Wählen Sie im Navigationsbereich **Parameter groups (Parametergruppen)** aus.
Die verfügbaren DB-Parametergruppen erscheinen in einer Liste.
1. Wählen Sie den Namen der Parametergruppe, um deren Parameterliste anzuzeigen.
### AWS CLI
Sie können die Konfigurationsparameter für den Datenbankmanager und die Registrierungsvariablen für eine Db2-Version durch Ausführen des Befehls [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-engine-default-parameters.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-engine-default-parameters.html) anzeigen. Geben Sie einen der folgenden Werte für die Option `--db-parameter-group-family` an:
+ `db2-ae-11.5`
+ `db2-se-11.5`
Um beispielsweise die Parameter für Db2 Standard Edition 11.5 anzuzeigen, führen Sie den folgenden Befehl aus:
```
aws rds describe-engine-default-parameters --db-parameter-group-family db2-se-11.5
```
Die Ausgabe dieses Befehls sieht etwa so wie im folgenden Beispiel aus:
```
{
"EngineDefaults": {
"Parameters": [
{
"ParameterName": "agent_stack_sz",
"ParameterValue": "1024",
"Description": "You can use this parameter to determine the amount of memory that is allocated by Db2 for each agent thread stack.",
"Source": "engine-default",
"ApplyType": "static",
"DataType": "integer",
"AllowedValues": "256-32768",
"IsModifiable": false
},
{
"ParameterName": "agentpri",
"ParameterValue": "-1",
"Description": "This parameter controls the priority given to all agents and to other database manager instance processes and threads by the operating system scheduler. This priority determines how CPU time is allocated to the database manager processes, agents, and threads relative to other processes and threads running on the machine.",
"Source": "engine-default",
"ApplyType": "static",
"DataType": "integer",
"AllowedValues": "1-99",
"IsModifiable": false
},
...
]
}
}
```
Führen Sie den folgenden Befehl aus, um nur die änderbaren Parameter für Db2 Standard Edition 11.5 aufzulisten:
Für Linux, macOS oder Unix:
```
aws rds describe-engine-default-parameters \
--db-parameter-group-family db2-se-11.5 \
--query 'EngineDefaults.Parameters[?IsModifiable==`true`].{ParameterName:ParameterName, DefaultValue:ParameterValue}'
```
Für Windows:
```
aws rds describe-engine-default-parameters ^
--db-parameter-group-family db2-se-11.5 ^
--query 'EngineDefaults.Parameters[?IsModifiable==`true`].{ParameterName:ParameterName, DefaultValue:ParameterValue}'
```
### RDS-API
Verwenden Sie den Vorgang [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) mit dem folgenden erforderlichen Parameter, um die Parameterwerte für eine DB-Parametergruppe anzuzeigen.
+ `DBParameterGroupName`
## Anzeigen aller Parameter mit Db2-Befehlen
Sie können die Einstellungen der Konfigurationsparameter für den Datenbankmanager, die Datenbankkonfigurationsparameter und die Registrierungsvariablen mithilfe von Db2-Befehlen anzeigen.
**So zeigen Sie die Einstellungen an**
1. Stellen Sie eine Verbindung zu Ihrer Db2-Datenbank her. Ersetzen Sie im folgenden Beispiel *database\$1name**master\$1username*, und *master\$1password* durch Ihre Daten.
```
db2 "connect to database_name user master_username using master_password"
```
1. Suchen Sie nach der unterstützten Db2-Version.
```
db2 "select service_level, fixpack_num from table(sysproc.env_get_inst_info()) as instanceinfo"
```
1. Zeigen Sie die Parameter für eine bestimmte Db2-Version an.
+ Führen Sie den folgenden Befehl aus, um die Konfigurationsparameter für den Datenbankmanager anzuzeigen:
```
db2 "select cast(substr(name,1,24) as varchar(24)) as name, case
when value_flags = 'NONE' then '' else value_flags end flags,
cast(substr(value,1,64) as varchar(64)) as current_value
from sysibmadm.dbmcfg
order by name asc with UR"
```
+ Führen Sie den folgenden Befehl aus, um alle Ihre Datenbankkonfigurationsparameter anzuzeigen:
```
db2 "select cast(substr(name,1,24) as varchar(24)) as name, case
when value_flags = 'NONE' then '' else value_flags end flags,
cast(substr(value,1,64) as varchar(64)) as current_value
from table(db_get_cfg(null)) order by name asc, member asc with UR"
```
+ Führen Sie den folgenden Befehl aus, um die aktuell festgelegten Registrierungsvariablen anzuzeigen:
```
db2 "select cast(substr(reg_var_name,1,50) as varchar(50)) as reg_var_name,
cast(substr(reg_var_value,1,50) as varchar(50)) as reg_var_value,
level from table(env_get_reg_variables(null))
order by reg_var_name,member with UR"
```
## Ändern der Parameter in Parametergruppen
Sie können die Database Manager-Konfigurationsparameter und die Registrierungsvariablen in benutzerdefinierten Parametergruppen ändern, indem Sie die AWS-Managementkonsole AWS CLI, oder die RDS-API verwenden. Weitere Informationen finden Sie unter [DB-Parametergruppen für DB-Instances von Amazon RDS](USER_WorkingWithDBInstanceParamGroups.md).
### Konsole
**So ändern Sie die Konfigurationsparameter für den Datenbankmanager und die Registrierungsvariablen**
1. Erstellen Sie eine benutzerdefinierte Parametergruppe. Weitere Informationen über das Erstellen einer Parametergruppe finden Sie unter [Erstellen einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Ändern Sie die Parameter in dieser benutzerdefinierten Parametergruppe. Weitere Informationen zum Ändern einer Parametergruppe finden Sie unter [Ändern von Parametern in einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
### AWS CLI
**So ändern Sie die Konfigurationsparameter für den Datenbankmanager und die Registrierungsvariablen**
1. Erstellen Sie eine benutzerdefinierte Parametergruppe, indem Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html) ausführen.
Verwenden Sie den folgenden erforderlichen Parameter:
+ `--db-parameter-group-name` – Ein Name für die Parametergruppe, die Sie erstellen.
+ `--db-parameter-group-family` – Die Db2-Engine-Edition und die Hauptversion. Zulässige Werte: `db2-se-11.5`, `db2-ae-11.5`.
+ `--description` – Eine Beschreibung für diese Parametergruppe.
Weitere Informationen über das Erstellen einer Parametergruppe finden Sie unter [Erstellen einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Ändern Sie die Parameter in der benutzerdefinierten Parametergruppe, die Sie durch Ausführen des Befehls [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html) erstellt haben.
Verwenden Sie den folgenden erforderlichen Parameter:
+ `--db-parameter-group-name` – Der Name der von Ihnen erstellten Parametergruppe.
+ `--parameters` – Ein Array von Parameternamen, Werten und der Anwendungsmethoden für die Parameteraktualisierung.
Weitere Informationen zum Ändern einer Parametergruppe finden Sie unter [Ändern von Parametern in einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
### RDS-API
**So ändern Sie die Konfigurationsparameter für den Datenbankmanager und die Registrierungsvariablen**
1. Erstellen Sie eine benutzerdefinierte DB-Parametergruppe, indem Sie den Vorgang [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html) verwenden.
Nutzen Sie die folgenden erforderlichen Parameter:
+ `DBParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`
Weitere Informationen über das Erstellen einer Parametergruppe finden Sie unter [Erstellen einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Ändern Sie die Parameter in der benutzerdefinierten Parametergruppe, die Sie mithilfe des Vorgangs [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html) erstellt haben.
Nutzen Sie die folgenden erforderlichen Parameter:
+ `DBParameterGroupName`
+ `Parameters`
Weitere Informationen zum Ändern einer Parametergruppe finden Sie unter [Ändern von Parametern in einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
## Ändern der Datenbankkonfigurationsparameter mit Db2-Befehlen
Sie können die Datenbankkonfigurationsparameter mit Db2-Befehlen ändern.
**So ändern Sie die Datenbankkonfigurationsparameter**
1. Stellen Sie eine Verbindung mit der Datenbank `rdsadmin` her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Ändern Sie die Datenbankkonfigurationsparameter, indem Sie die gespeicherte Prozedur `rdsadmin.update_db_param` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param).
```
db2 "call rdsadmin.update_db_param(
'database_name',
'parameter_to_modify',
'changed_value',
'restart_database')"
```
# EBCDIC-Sortierung für Db2-Datenbanken auf Amazon RDS
Amazon RDS für Db2 unterstützt die EBCDIC-Sortierung für Db2-Datenbanken. Sie können eine EBCDIC-Sortierreihenfolge für eine Datenbank nur dann angeben, wenn Sie die Datenbank mithilfe der gespeicherten [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database)-Prozedur von Amazon RDS erstellen.
Wenn Sie eine DB-Instance von RDS für Db2 mithilfe der AWS-Managementkonsole, der AWS CLI oder der RDS-API erstellen, können Sie einen Datenbanknamen angeben. Wenn Sie einen Datenbanknamen angeben, erstellt Amazon RDS eine Datenbank mit der Standardsortierung `SYSTEM`. Wenn Sie eine Datenbank mit EBCDIC-Sortierung erstellen müssen, geben Sie beim Erstellen einer DB-Instance keinen Datenbanknamen an.
Die Sortierung für eine Datenbank in RDS für Db2 wird zum Zeitpunkt der Erstellung festgelegt und ist unveränderlich.
**So erstellen Sie eine Db2-Datenbank mit EBCDIC-Sortierung**
1. Wenn Sie keine DB-Instance von RDS für Db2 haben, erstellen Sie eine DB-Instance, geben aber keinen Datenbanknamen an. Sie können eine DB-Instance mithilfe der AWS-Managementkonsole, der AWS CLI oder der RDS-API erstellen. Weitere Informationen finden Sie unter [Erstellen einer DB-Instance](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
1. Erstellen Sie eine Db2-Datenbank und legen Sie die Sortieroption auf einen EBCDIC-Wert fest, indem Sie die gespeicherte Prozedur `rdsadmin.create_database` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).
**Wichtig**
Nach dem Erstellen einer Datenbank mit der gespeicherten Prozedur kann die Sortierreihenfolge nicht mehr geändert werden. Wenn Sie möchten, dass eine Datenbank eine andere Sortierreihenfolge verwendet, löschen Sie die Datenbank, indem Sie die gespeicherte Prozedur [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database) aufrufen. Erstellen Sie dann eine Datenbank mit der erforderlichen Sortierreihenfolge.
# Lokale Zeitzone für DB-Instances von Amazon RDS für Db2
Die Zeitzone für eine Amazon-RDS-DB-Instance, die Db2 ausführt, wird standardmäßig eingestellt. Die Standardeinstellung ist Coordinated Universal Time (UTC). Sie können die Zeitzone für Ihre DB-Instance stattdessen auf eine lokale Zeitzone einstellen, damit sie mit der Zeitzone Ihrer Anwendungen übereinstimmt.
Sie legen die Zeitzone bei der Erstellung Ihrer DB-Instance fest. Sie können die DB-Instance mit der AWS-Managementkonsole, der RDS-API oder der AWS CLI erstellen. Weitere Informationen finden Sie unter [Erstellen einer DB-Instance](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
Wenn Ihre DB-Instance Teil einer Multi-AZ-Bereitstellung ist, bleibt Ihre Zeitzone bei einem Failover auf die von Ihnen festgelegte lokale Zeitzone eingestellt.
Sie können Ihre DB-Instance auf einen bestimmten, von Ihnen festgelegten Zeitpunkt wiederherstellen. Die Uhrzeit wird in Ihrer lokalen Zeitzone angezeigt. Weitere Informationen finden Sie unter [Wiederherstellen einer DB-Instance auf einen bestimmten Zeitpunkt für Amazon RDS](USER_PIT.md).
Beim Festlegen der lokalen Zeitzone für Ihre DB-Instance gelten folgende Beschränkungen:
+ Sie können die Zeitzone einer vorhandenen DB-Instance von Amazon RDS für Db2 nicht ändern.
+ Sie können einen Snapshot aus einer DB-Instance in einer Zeitzone nicht in eine DB-Instance in einer anderen Zeitzone wiederherstellen.
+ Es wird dringend davon abgeraten, eine Sicherungsdatei aus einer Zeitzone für eine andere Zeitzone wiederherzustellen. Wenn Sie eine Backup-Datei von einer Zeitzone in einer anderen Zeitzone wiederherstellen, müssen Sie überprüfen, wie sich die Änderung der Zeitzone auf Ihre Abfragen und Anwendungen auswirkt.
## Verfügbare Zeitzonen
Sie können die folgenden Werte für die Einstellung der Zeitzone verwenden:
| Bereich | Zeitzone |
| --- | --- |
| Afrika | Africa/Cairo, Africa/Casablanca, Africa/Harare, Africa/Lagos, Africa/Luanda, Africa/Monrovia, Africa/Nairobi, Africa/Tripoli, Africa/Windhoek |
| Amerika | America/Araguaina, America/Argentina/Buenos\$1Aires, America/Asuncion, America/Bogota, America/Caracas, America/Chicago, America/Chihuahua, America/Cuiaba, America/Denver, America/Detroit, America/Fortaleza, America/Godthab, America/Guatemala, America/Halifax, America/Lima, America/Los\$1Angeles, America/Manaus, America/Matamoros, America/Mexico\$1City, America/Monterrey, America/Montevideo, America/New\$1York, America/Phoenix, America/Santiago, America/Sao\$1Paulo, America/Tijuana, America/Toronto |
| Asien | Asia/Amman, Asia/Ashgabat, Asia/Baghdad, Asia/Baku, Asia/Bangkok, Asia/Beirut, Asia/Calcutta, Asia/Damascus, Asia/Dhaka, Asia/Hong\$1Kong, Asia/Irkutsk, Asia/Jakarta, Asia/Jerusalem, Asia/Kabul, Asia/Karachi, Asia/Kathmandu, Asia/Kolkata, Asia/Krasnoyarsk, Asia/Magadan, Asia/Manila, Asia/Muscat, Asia/Novosibirsk, Asia/Rangoon, Asia/Riyadh, Asia/Seoul, Asia/Shanghai, Asia/Singapore, Asia/Taipei, Asia/Tehran, Asia/Tokyo, Asia/Ulaanbaatar, Asia/Vladivostok, Asia/Yakutsk, Asia/Yerevan |
| Atlantik | Atlantic/Azores, Atlantic/Cape\$1Verde |
| Australien | Australia/Adelaide, Australia/Brisbane, Australia/Darwin, Australia/Eucla, Australia/Hobart, Australia/Lord\$1Howe, Australia/Perth, Australia/Sydney |
| Brasilien | Brazil/DeNoronha, Brazil/East |
| Kanada | Canada/Newfoundland, Canada/Saskatchewan |
| Etc | Etc/GMT-3 |
| Europa | Europe/Amsterdam, Europe/Athens, Europe/Berlin, Europe/Dublin, Europe/Helsinki, Europe/Kaliningrad, Europe/London, Europe/Madrid, Europe/Moscow, Europe/Paris, Europe/Prague, Europe/Rome, Europe/Sarajevo, Europe/Stockholm |
| Pazifik | Pacific/Apia, Pacific/Auckland, Pacific/Chatham, Pacific/Fiji, Pacific/Guam, Pacific/Honolulu, Pacific/Kiritimati, Pacific/Marquesas, Pacific/Samoa, Pacific/Tongatapu, Pacific/Wake |
| USA | US/Alaska, US/Central, US/East-Indiana, US/Eastern, US/Pacific |
| UTC | UTC |
# Voraussetzungen für das Erstellen einer DB-Instance von Amazon RDS für Db2
Im Folgenden werden die Voraussetzungen für das Erstellen einer DB-Instance erläutert.
**Topics**
+ [Administratorkonto](#db2-prereqs-admin-account)
+ [Weitere Überlegungen](#db2-prereqs-additional-considerations)
## Administratorkonto
Wenn Sie eine DB-Instance erstellen, müssen Sie ein Administratorkonto für die Instance festlegen. Amazon RDS erteilt diesem lokalen Datenbankadministratorkonto `DBADM`-Autorität.
Das Administratorkonto weist die folgenden Merkmale, Funktionen und Einschränkungen auf:
+ Ist ein lokaler Benutzer und kein AWS-Konto.
+ Hat keine Berechtigungen auf Db2-Instance-Ebene wie `SYSADM`, `SYSMAINT` oder `SYSCTRL`.
+ Kann eine Db2-Instance nicht anhalten oder starten.
+ Kann eine Db2-Datenbank nicht entfernen, wenn Sie den Namen beim Erstellen der DB-Instance angegeben haben.
+ Hat vollen Zugriff auf die Db2-Datenbank, einschließlich Katalogtabellen und Ansichten.
+ Kann mithilfe von gespeicherten Amazon-RDS-Prozeduren lokale Benutzer und Gruppen erstellen.
+ Kann Befugnisse und Berechtigungen gewähren und entziehen.
Das Administratorkonto kann folgende Aufgaben ausführen:
+ DB-Instances erstellen, ändern oder löschen
+ DB-Snapshots erstellen
+ Initiieren Sie point-in-time Wiederherstellungen.
+ Automatisierte Backups von DB-Snapshots erstellen
+ Manuelle Backups von DB-Snapshots erstellen
+ Andere Amazon-RDS-Features verwenden
## Weitere Überlegungen
Bevor Sie eine DB-Instance erstellen, sollten Sie die folgenden Punkte berücksichtigen:
+ Jede DB-Instance von Amazon RDS für Db2 kann bis zu 50 Db2-Datenbanken hosten. Weitere Informationen finden Sie unter [Mehrere Datenbanken auf einer DB-Instance von Amazon RDS für Db2](db2-multiple-databases.md).
+ Anfänglicher Datenbankname
+ Wenn Sie bei der Erstellung der DB-Instance keinen Datenbanknamen angeben, erstellt Amazon RDS keine Datenbank.
+ Geben Sie unter den folgenden Umständen keinen Datenbanknamen an:
+ Sie möchten den Parameter `db2_compatibility_vector` ändern. Weitere Informationen finden Sie unter [Festlegen des Parameters db2\$1compatibility\$1vector](db2-known-issues-limitations.md#db2-known-issues-limitations-db2-compatibility-vector).
+ Im Modell „Bring-Your-Own-License (BYOL)“ müssen Sie zunächst eine benutzerdefinierte Parametergruppe erstellen, die Ihre IBM Customer ID und Ihre IBM Site ID enthält. Weitere Informationen finden Sie unter [Bring-Your-Own-License (BYOL) für Db2](db2-licensing.md#db2-licensing-options-byol).
+ Beim AWS Marketplace Db2-Lizenzmodell benötigen Sie ein aktives AWS Marketplace Abonnement für die jeweilige IBM Db2 Edition, die Sie verwenden möchten. Wenn Sie noch keine haben, [abonnieren Sie Db2 in AWS Marketplace](db2-licensing.md#db2-marketplace-subscribing-registering) für die IBM Db2-Edition, die Sie verwenden möchten. Weitere Informationen finden Sie unter [Db2-Lizenz über AWS Marketplace](db2-licensing.md#db2-licensing-options-marketplace).
# Mehrere Datenbanken auf einer DB-Instance von Amazon RDS für Db2
Sie können auf einer einzelnen DB-Instance von RDS für Db2 mehrere Datenbanken erstellen, indem Sie die gespeicherte Prozedur [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database) aufrufen. Eine einzelne DB-Instance von RDS für Db2 ist auf 50 Datenbanken beschränkt. Diese Zahl umfasst Datenbanken sowohl im aktivierten als auch im deaktivierten Zustand.
**Anmerkung**
Wenn Sie mehrere Datenbanken auf einer DB-Instance von RDS für Db2 benötigen, die vor dem 15. November 2024 erstellt wurde, müssen Sie die DB-Instance neu starten, um die Unterstützung für mehrere Datenbanken zu aktivieren.
Standardmäßig aktiviert Amazon RDS alle Datenbanken, die Sie erstellen. Um die Speicherressourcen zu optimieren, können Sie Datenbanken, die Sie selten verwenden, jedoch deaktivieren und später bei Bedarf wieder aktivieren. Weitere Informationen erhalten Sie unter [Deaktivieren einer Datenbank](db2-managing-databases.md#db2-deactivating-database) und [Aktivieren einer Datenbank](db2-managing-databases.md#db2-activating-database).
Die Anzahl der aktivierten Datenbanken auf einer DB-Instance hängt von den verfügbaren Speicherressourcen auf dem Server ab. Die Speicherressourcen unterscheiden sich basierend auf der DB-Instance-Klasse und der für die Datenbank konfigurierten Speichermenge. Weitere Informationen zu DB-Instance-Klassen finden Sie unter [](Concepts.DBInstanceClass.md). Weitere Informationen zum Aktualisieren des Speichers für eine Datenbank von RDS für Db2 finden Sie unter [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param).
Wir empfehlen Ihnen, für allgemeine Datenbankaufgaben, Betriebssystemanforderungen und andere Amazon-RDS-Automatisierungsaufgaben wie Sicherungen eine DB-Instance-Klasse mit 2 GB Arbeitsspeicher zu wählen. Weitere Informationen zum Ändern der DB-Instance-Klasse finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md).
Darüber hinaus empfiehlt IBM mindestens 1 GB Speicher für jede aktive Datenbank. Weitere Informationen finden Sie unter [Disk and memory requirements](https://www.ibm.com/docs/en/db2/11.5?topic=servers-disk-memory-requirements) in der IBM-Dokumentation.
Sie können die maximal zulässige Anzahl aktiver Datenbanken für eine DB-Instance mit der folgenden Formel berechnen:
```
Active database limit = (total server memory - 2 GB) / 1 GB
```
Das folgende Beispiel zeigt die maximal zulässige Anzahl aktiver Datenbanken für eine DB-Instance mit der DB-Instance-Klasse db.m6i.xlarge:
```
Active database limit = (total server memory - 2 GB) / 1 GB
= (16 GB - 2 GB) / 1 GB
= 14 databases
```
Wenn Amazon RDS eine Datenbank nach einem Absturz wiederherstellt, aktiviert es die Datenbank, sofern sie zuvor aktiv war. In bestimmten Fällen, z. B. wenn Sie eine DB-Instance-Klasse auf eine niedrigere Speicherkonfiguration ändern, ist möglicherweise nicht genügend Speicher vorhanden, um alle Datenbanken auf der DB-Instance zu aktivieren. In diesen Fällen aktiviert Amazon RDS Datenbanken in der Reihenfolge ihrer Erstellung.
**Anmerkung**
Alle Datenbanken, die Amazon RDS aufgrund unzureichenden Speichers nicht aktivieren kann, bleiben deaktiviert.
# Herstellen einer Verbindung mit Ihrer Db2-DB-Instance
Nachdem Amazon RDS Ihre DB-Instance von Amazon RDS für Db2 bereitgestellt hat, können Sie die Verbindung zu dieser über eine beliebige Standard-SQL-Clientanwendung herstellen. Da Amazon RDS ein verwalteter Service ist, können Sie sich nicht als `SYSADM`, `SYSCTRL`, `SECADM` oder `SYSMAINT` anmelden.
Sie können eine Verbindung zu einer DB-Instance herstellen, auf der die Datenbank-Engine IBM Db2 ausgeführt wird, indem Sie IBM Db2 CLP, IBM CLPPlus, DBeaver oder IBM Db2 Data Management Console verwenden.
**Anmerkung**
Die Verbindung zu einer Db2-Datenbank kann fehlschlagen, wenn Ihre DB-Instance von RDS für Db2 nicht über ausreichend Arbeitsspeicher verfügt. Weitere Informationen finden Sie unter [Fehler bei der Datenbankverbindung](db2-troubleshooting.md#db2-database-connection-error).
**Topics**
+ [Ermitteln des Endpunkts Ihrer DB-Instance von Amazon RDS für Db2](db2-finding-instance-endpoint.md)
+ [Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit IBM Db2 CLP](db2-connecting-with-clp-client.md)
+ [Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit IBM CLPPlus](db2-connecting-with-ibm-clpplus-client.md)
+ [Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit DBeaver](db2-connecting-with-dbeaver.md)
+ [Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md)
+ [Überlegungen zu Sicherheitsgruppen mit Amazon RDS für Db2](db2-security-groups-considerations.md)
# Ermitteln des Endpunkts Ihrer DB-Instance von Amazon RDS für Db2
Jede Amazon-RDS-DB-Instance hat einen Endpunkt und jeder Endpunkt hat einen DNS-Namen und eine Portnummer für die DB-Instance. Um eine Verbindung mir Ihrer DB-Instance von Amazon RDS für Db2 mit einer SQL-Client-Anwendung herzustellen, benötigen Sie den DNS-Namen und die Portnummer für Ihre DB-Instance.
Sie können den Endpunkt für eine DB-Instance finden, indem Sie den AWS-Managementkonsole oder den verwenden AWS CLI.
## Konsole
**So ermitteln Sie den Endpunkt einer DB-Instance von RDS für Db2**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Wählen Sie in der oberen rechten Ecke der Konsole die Ihrer DB-Instance AWS-Region aus.
1. Suchen Sie nach dem DNS-Namen und der Portnummer für Ihre DB-Instance von RDS für Db2.
1. Wählen Sie **Databases (Datenbanken)** aus, um eine Liste Ihrer DB-Instances anzuzeigen.
1. Wählen Sie den Namen der DB-Instance von RDS für Db2 aus, um Details zur Instance anzuzeigen.
1. Kopieren Sie auf der Registerkarte **Connectivity & security (Anbindung und Sicherheit)** den Endpunkt. Notieren Sie sich auch die Portnummer. Sie benötigen sowohl den Endpunkt als auch die Portnummer, um die Verbindung zur DB-Instance herzustellen.
![\[Die Registerkarte Konnektivität und Sicherheit für eine DB-Instance, auf der der Endpunkt und der Port angezeigt werden.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/db2-connectivity-security.png)
## AWS CLI
Führen Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) aus, um den Endpunkt einer DB-Instance von RDS für Db2 zu ermitteln. Im folgenden Beispiel ersetzen Sie ihn *database-1* durch den Namen Ihrer DB-Instance.
Für Linux, macOS oder Unix:
```
aws rds describe-db-instances \
--db-instance-identifier database-1 \
--query 'DBInstances[].{DBInstanceIdentifier:DBInstanceIdentifier,DBName:DBName,Endpoint:Endpoint}' \
--output json
```
Für Windows:
```
aws rds describe-db-instances ^
--db-instance-identifier database-1 ^
--query 'DBInstances[].{DBInstanceIdentifier:DBInstanceIdentifier,DBName:DBName,Endpoint:Endpoint}' ^
--output json
```
Die Ausgabe dieses Befehls sieht etwa so aus. Die Linie `Address` in der Ausgabe enthält den DNS-Namen.
```
[
{
"DBInstanceIdentifier": "database-1",
"DBName": "DB2DB",
"Endpoint": {
"Address": "database-1.123456789012.us-east-2.amazonaws.com",
"Port": 50000,
"HostedZoneId": "Z2OC4A7DETW6VH"
}
}
]
```
# Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit IBM Db2 CLP
Sie können ein Befehlszeilen-Dienstprogramm wie IBM Db2 CLP verwenden, um eine Verbindung zu DB-Instances von Amazon RDS für Db2 herzustellen. Dieses Dienstprogramm ist Teil von IBM Data Server Runtime Client. Informationen zum Herunterladen des Clients** **von IBM Fix Centralfinden Sie unter [IBM Data Server Client Packages Version 11.5 Mod 8 Fix Pack 0](https://www.ibm.com/support/pages/node/6830885) im IBM-Support.
**Topics**
+ [Terminologie](#db2-connecting-ibm-clp-terms)
+ [Installieren des Clients](#db2-connecting-ibm-clp-install-client)
+ [Herstellen einer Verbindung mit einer DB-Instance](#db2-connecting-ibm-clp-connect-db-instance)
+ [Fehlerbehebung bei Verbindungen mit Ihrer DB-Instance von RDS für Db2](#db2-troubleshooting-connections-clp)
## Terminologie
Die folgenden Begriffe erläutern die Befehle, die beim [Herstellen einer Verbindung mit Ihrer DB-Instance von RDS für Db2](#db2-connecting-ibm-clp-connect-db-instance) verwendet werden.
**catalog tcpip node**
Dieser Befehl registriert einen Remote-Datenbankknoten bei einem lokalen Db2-Client, wodurch der Knoten für die Client-Anwendung zugänglich wird. Um einen Knoten zu katalogisieren, geben Sie Informationen wie den Hostnamen, die Portnummer und das Kommunikationsprotokoll des Servers an. Der katalogisierte Knoten stellt dann einen Zielserver dar, auf dem sich eine oder mehrere Remote-Datenbanken befinden. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [CATALOG TCPIP/TCPIP4/TCPIP6 NODE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-catalog-tcpip-node).
**catalog database**
Dieser Befehl registriert eine Remote-Datenbank bei einem lokalen Db2-Client, wodurch die Datenbank für die Client-Anwendung zugänglich wird. Um eine Datenbank zu katalogisieren, geben Sie Informationen wie den Alias der Datenbank, den Knoten, auf dem sie sich befindet, und den Authentifizierungstyp an, der für die Verbindung mit der Datenbank erforderlich ist. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [CATALOG DATABASE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-catalog-database).
## Installieren des Clients
Installieren Sie nach [downloading the package for Linux](#db2-downloading-package) den Client mit Root- oder Administratorberechtigungen.
**Anmerkung**
Um den Client auf AIX oder Windows zu installieren, gehen Sie genauso vor, ändern Sie jedoch die Befehle für Ihr Betriebssystem.
**So installieren Sie den Client unter Linux**
1. Führen Sie den Befehl **`./db2_install -f sysreq`** aus und wählen Sie **`yes`**, um die Lizenz zu akzeptieren.
1. Wählen Sie den Ort, an dem der Client installiert werden soll.
1. Lauf **`clientInstallDir/instance/db2icrt -s client`*instance\$1name***. *instance\$1name*Ersetzen Sie durch einen gültigen Betriebssystembenutzer aufLinux. Unter Linux ist der Name der Db2-DB-Instance an den Betriebssystem-Benutzernamen gebunden.
Mit diesem Befehl wird ein **`sqllib`**-Verzeichnis im Home-Verzeichnis des angegebenen Benutzers unter Linux erstellt.
## Herstellen einer Verbindung mit einer DB-Instance
Sie benötigen den DNS-Namen und die Portnummer Ihrer DB-Instance von RDS für Db2, um sich mit ihr zu verbinden. Informationen dazu, wie Sie diese ermitteln, finden Sie unter [Ermitteln des Endpunkts](db2-finding-instance-endpoint.md). Sie müssen auch den Datenbanknamen, den Hauptbenutzernamen und das Hauptpasswort kennen, die Sie bei der Erstellung Ihrer DB-Instance von RDS für Db2 definiert haben. Informationen dazu, wie Sie diese ermitteln, finden Sie unter [Erstellen einer DB-Instance](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
**So verbinden Sie eine DB-Instance von RDS für Db2 mit IBM Db2 CLP**
1. Melden Sie sich mit dem Benutzernamen an, den Sie bei der Client-Installation von IBM Db2 CLP angegeben haben.
1. Katalogisieren Sie Ihre DB-Instance von RDS für Db2. Ersetzen Sie im folgenden Beispiel, *node\$1name**dns\$1name*, und *port* durch einen Namen für den Knoten im lokalen Katalog, den DNS-Namen für Ihre DB-Instance und die Portnummer.
```
1. db2 catalog TCPIP node node_name remote dns_name server port
```
**Beispiel**
```
db2 catalog TCPIP node remnode remote database-1.123456789012.us-east-1.amazonaws.com server 50000
```
1. Katalogisieren Sie die Datenbank `rdsadmin` und Ihre Datenbank. Auf diese Weise können Sie eine Verbindung zur Datenbank `rdsadmin` herstellen, um einige Verwaltungsaufgaben mithilfe von gespeicherten Amazon-RDS-Prozeduren auszuführen. Weitere Informationen finden Sie unter [Verwalten Ihrer DB-Instance von RDS für Db2](db2-administering-db-instance.md).
Ersetzen Sie *database\$1alias* im folgenden Beispiel den Namen des im vorherigen Schritt definierten Knotens und *database\$1name* den Namen Ihrer Datenbank durch Aliase für diese Datenbank, und durch Aliase für diese Datenbank. *node\$1name* `server_encrypt`verschlüsselt Ihren Benutzernamen und Ihr Passwort über das Netzwerk.
```
db2 catalog database rdsadmin [ as database_alias ] at node node_name authentication server_encrypt
db2 catalog database database_name [ as database_alias ] at node node_name authentication server_encrypt
```
**Beispiel**
```
db2 catalog database rdsadmin at node remnode authentication server_encrypt
db2 catalog database testdb as rdsdb2 at node remnode authentication server_encrypt
```
1. Stellen Sie eine Verbindung zu Ihrer Datenbank von RDS für Db2 her. Ersetzen Sie im folgenden Beispiel *rds\$1database\$1alias**master\$1username*, und *master\$1password* durch den Namen Ihrer Datenbank, den Master-Benutzernamen und das Master-Passwort Ihrer RDS for Db2-DB-Instance.
```
db2 connect to rds_database_alias user master_username using master_password
```
Die Ausgabe dieses Befehls sieht etwa so aus:
```
Database Connection Information
Database server = DB2/LINUXX8664 11.5.9.0
SQL authorization ID = ADMIN
Local database alias = TESTDB
```
1. Führen Sie Abfragen aus und sehen Sie sich die Ergebnisse an. Das folgende Beispiel zeigt eine SQL-Anweisung, die die von Ihnen erstellte Datenbank auswählt.
```
db2 "select current server from sysibm.dual"
```
Die Ausgabe dieses Befehls sieht etwa so aus:
```
1
------------------
TESTDB
1 record(s) selected.
```
## Fehlerbehebung bei Verbindungen mit Ihrer DB-Instance von RDS für Db2
Wenn Sie die folgende `NULLID`-Fehlermeldung erhalten, deutet dies in der Regel darauf hin, dass Ihre Client- und Serverversionen von RDS für Db2 nicht übereinstimmen. Informationen zu den unterstützten Db2-Client-Versionen finden Sie in der IBM Db2-Dokumentation unter [Supported combinations of clients, drivers and server levels](https://www.ibm.com/docs/en/db2/11.5?topic=communications-supported-combinations-clients-drivers-server-levels).
```
db2 "select * from syscat.tables"
SQL0805N Package "NULLID.SQLC2O29 0X4141414141454A69" was not found.
SQLSTATE=51002
```
Nachdem Sie diesen Fehler erhalten haben, müssen Sie Pakete von Ihrem älteren Db2-Client an eine von RDS für Db2 unterstützte Db2-Serverversion binden.
**So binden Sie Pakete von einem älteren Db2-Client an einen neueren Db2-Server**
1. Suchen Sie die Bindungsdateien auf dem Client-Computer. In der Regel befinden sich diese Dateien im Verzeichnis **bnd** des Db2-Client-Installationspfads und haben die Erweiterung **.bnd**.
1. Stellen Sie eine Verbindung zum Db2-Server her. Ersetzen Sie im folgenden Beispiel *database\$1name* durch den Namen Ihres Db2-Servers. Ersetzen Sie *master\$1username* und *master\$1password* durch Ihre Informationen. Dieser Benutzer hat die Autorität über `DBADM`.
```
db2 connect to database_name user master_username using master_password
```
1. Um diese Pakete zu binden, führen Sie den `bind`-Befehl aus.
1. Navigieren Sie zu dem Verzeichnis, in dem sich die Bindungsdateien auf dem Client-Computer befinden.
1. Führen Sie den `bind`-Befehl für jede Datei aus.
Die folgenden Optionen sind erforderlich:
+ `blocking all` – Bindet alle Pakete in der Bindungsdatei in einer einzigen Datenbankanfrage.
+ `grant public` – Gestattet `public`, das Paket auszuführen.
+ `sqlerror continue` – Gibt an, dass der `bind`-Prozess auch dann fortgesetzt wird, wenn Fehler auftreten.
Weitere Informationen zum Befehl `bind` finden Sie in der IBM Db2-Dokumentation und unter [BIND command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-bind).
1. Stellen Sie sicher, dass die Bindung erfolgreich war, indem Sie entweder die Katalogansicht `syscat.package` abfragen oder die nach dem Befehl `bind` zurückgegebene Meldung überprüfen.
Weitere Informationen finden Sie unter [Bindungsdatei und Paketnamenliste DB2 v11.5 im IBM Support](https://www.ibm.com/support/pages/node/6190455).
# Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit IBM CLPPlus
Sie können ein Dienstprogramm wie IBM CLPPlus für die Verbindung mit einer DB-Instance von Amazon RDS für Db2 verwenden. Dieses Dienstprogramm ist Teil von IBM Data Server Runtime Client. Informationen zum Herunterladen des Clients** **von IBM Fix Centralfinden Sie unter [IBM Data Server Client Packages Version 11.5 Mod 8 Fix Pack 0](https://www.ibm.com/support/pages/node/6830885) im IBM-Support.
**Wichtig**
Es wird empfohlen, IBM CLPPlus unter einem Betriebssystem auszuführen, das grafische Benutzeroberflächen wie macOS, Windows oder Linux mit Desktop unterstützt. Wenn Sie Headless Linux ausführen, verwenden Sie switch **-nw** mit CLPPlus-Befehlen.
**Topics**
+ [Installieren des Clients](#db2-connecting-ibm-clpplus-install-client)
+ [Herstellen einer Verbindung mit einer DB-Instance](#db2-connecting-ibm-clpplus-connect-db-instance)
+ [CLOB-Daten aus gespeicherten Prozeduren abrufen DB2](#db2-connecting-ibm-clpplus-retrieve-clob-data)
## Installieren des Clients
Nachdem Sie das Paket für Linux heruntergeladen haben, installieren Sie den Client.
**Anmerkung**
Um den Client auf AIX oder Windows zu installieren, gehen Sie genauso vor, ändern Sie jedoch die Befehle für Ihr Betriebssystem.
**So installieren Sie den Client unter Linux**
1. Führen Sie **`./db2_install`**.
1. Lauf **`clientInstallDir/instance/db2icrt -s client`*instance\$1name***. *instance\$1name*Ersetzen Sie durch einen gültigen Betriebssystembenutzer aufLinux. Unter Linux ist der Name der Db2-DB-Instance an den Betriebssystem-Benutzernamen gebunden.
Mit diesem Befehl wird ein **`sqllib`**-Verzeichnis im Home-Verzeichnis des angegebenen Benutzers unter Linux erstellt.
## Herstellen einer Verbindung mit einer DB-Instance
Sie benötigen den DNS-Namen und die Portnummer Ihrer DB-Instance von RDS für Db2, um sich mit ihr zu verbinden. Informationen dazu, wie Sie diese ermitteln, finden Sie unter [Ermitteln des Endpunkts](db2-finding-instance-endpoint.md). Sie müssen auch den Datenbanknamen, den Hauptbenutzernamen und das Hauptpasswort kennen, die Sie bei der Erstellung Ihrer DB-Instance von RDS für Db2 definiert haben. Informationen dazu, wie Sie diese ermitteln, finden Sie unter [Erstellen einer DB-Instance](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
**So verbinden Sie eine DB-Instance von RDS für Db2 mit IBM CLPPlus**
1. Überprüfen Sie die Befehlssyntax. Ersetzen Sie im folgenden Beispiel *clientDir* durch den Speicherort, an dem der Client installiert ist.
```
cd clientDir/bin
./clpplus -h
```
1. Konfigurieren Sie Ihren Db2-Server. Ersetzen Sie *dsn\$1name* im folgenden Beispiel,, und *port* durch den DSN-Namen*endpoint*, den Datenbanknamen, den Endpunkt und den Port für Ihre RDS for Db2-DB-Instance. *database\$1name* Weitere Informationen finden Sie unter [Ermitteln des Endpunkts Ihrer DB-Instance von Amazon RDS für Db2](db2-finding-instance-endpoint.md).
```
db2cli writecfg add -dsn dsn_name -database database_name -host endpoint -port port -parameter "Authentication=SERVER_ENCRYPT"
```
1. Stellen Sie eine Verbindung mit Ihrer DB-Instance von RDS für Db2 her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *dsn\$1name* durch den Master-Benutzernamen und den DSN-Namen.
```
./clpplus -nw master_username@dsn_name
```
1. Ein Java Shell-Fenster wird geöffnet. Geben Sie das Hauptpasswort für Ihre DB-Instance von RDS für Db2 ein.
**Anmerkung**
Wenn kein Java Shell-Fenster geöffnet wird, führen Sie `./clpplus -nw` aus, um dasselbe Befehlszeilenfenster zu verwenden.
```
Enter password: *********
```
Eine Verbindung wird hergestellt und die Ausgabe ist ähnlich dem folgenden Beispiel:
```
Database Connection Information :
---------------------------------
Hostname = database-1.abcdefghij.us-east-1.rds.amazonaws.com
Database server = DB2/LINUXX8664 SQL110590
SQL authorization ID = admin
Local database alias = DB2DB
Port = 50000
```
1. Führen Sie Abfragen aus und sehen Sie sich die Ergebnisse an. Das folgende Beispiel zeigt eine SQL-Anweisung, die die von Ihnen erstellte Datenbank auswählt.
```
SQL > select current server from sysibm.dual;
```
Die Ausgabe dieses Befehls sieht etwa so aus:
```
1
--------------------
DB2DB
SQL>
```
## CLOB-Daten aus gespeicherten Prozeduren abrufen DB2
Gespeicherte Prozeduren wie rdsadmin.db2pd\$1command geben Ergebnisse in CLOB-Spalten zurück, die bis zu 2 GB an Daten unterstützen. DB2 CLP begrenzt die CLOB-Ausgabe jedoch auf 8 KB (8192 Byte) und kürzt alle Daten, die diesen Schwellenwert überschreiten. Verwenden Sie stattdessen CLPPLUS, um die vollständige Ausgabe abzurufen.
1. Rufen Sie die Task-ID (task\$1id) ab
```
db2 "select task_id, task_type, database_name, lifecycle, varchar(bson_to_json(task_input_params), 500) as task_params,
cast(task_output as varchar(500)) as task_output, CREATED_AT, LAST_UPDATED_AT from table(rdsadmin.get_task_status(null,null,null))"
```
1. Führen Sie den CLPPLUS-Befehl aus
Nachdem Sie die task\$1id abgerufen haben, führen Sie den folgenden Befehl an der Unix-Eingabeaufforderung aus (ersetzen Sie TASK\$1ID durch die tatsächliche numerische Aufgaben-ID):
```
$ (echo "select task_output from table(rdsadmin.get_task_status(task_id,null,null));" ; echo "disconnect;" ; echo "exit;") | clpplus -nw -silent masteruser/MasterUserPassword@hostname:port_num/rdsadmin
```
# Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit DBeaver
Sie können Drittanbieter-Tools wie DBeaver verwenden, um eine Verbindung zu DB-Instances von Amazon RDS für Db2 herzustellen. Informationen zum Herunterladen dieses Dienstprogramms finden Sie unter [DBeaver-Community](https://dbeaver.io/).
Sie benötigen den DNS-Namen und die Portnummer Ihrer DB-Instance von RDS für Db2, um sich mit ihr zu verbinden. Informationen dazu, wie Sie diese ermitteln, finden Sie unter [Ermitteln des Endpunkts](db2-finding-instance-endpoint.md). Sie müssen auch den Datenbanknamen, den Hauptbenutzernamen und das Hauptpasswort kennen, die Sie bei der Erstellung Ihrer DB-Instance von RDS für Db2 definiert haben. Informationen dazu, wie Sie diese ermitteln, finden Sie unter [Erstellen einer DB-Instance](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
**So verbinden Sie eine DB-Instance von RDS für Db2 mit DBeaver**
1. Starten **DBeaver**.
1. Wählen Sie in der Werkzeugleiste das Symbol **Neue Verbindung** und dann **Db2 für LUW**.
![\[Das Menü, das die Engine-Typen in DBeaver auflistet.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/dbeaver-add-connection.png)
1. Geben Sie im Fenster **Mit einer Datenbank verbinden** Informationen für Ihre DB-Instance von RDS für Db2 ein.
1. Geben Sie die folgenden Informationen ein:
+ Geben Sie unter **Host** den DNS-Namen der DB-Instance ein.
+ Geben Sie unter **Port** die Portnummer für die DB-Instance ein.
+ Geben Sie unter **Datenbank** den Namen Ihrer Datenbank ein.
+ Geben Sie in das Feld **Username (Benutzername)** den Namen des Datenbankadministrators für Ihre DB-Instance ein.
+ Geben Sie unter **Passwort** das Passwort des Datenbankadministrators für die DB-Instance an.
1. Wählen Sie **Passwort speichern** aus.
1. Wählen Sie **Treibereinstellungen** aus.
![\[Das Fenster Mit einer Datenbank verbinden mit verschiedenen Verbindungseinstellungen in DBeaver.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/dbeaver-connect-database.png)
1. Geben Sie im Fenster **Treiber bearbeiten** zusätzliche Sicherheitseigenschaften an.
1. Wählen Sie die Registerkarte **Treibereigenschaften** aus.
1. Fügen Sie zwei **Benutzereigenschaften** hinzu.
1. Öffnen Sie das Kontextmenü (rechte Maustaste) für wählen Sie dann **Neue Eigenschaft hinzufügen**.
1. Fügen Sie als **Eigenschaftsname** **encryptionAlgorithm** hinzu und wählen Sie dann **OK** aus.
1. Wählen Sie die Zeile **encryptionAlgorithm** und dann die Spalte **Wert** aus und fügen Sie **2** hinzu.
1. Öffnen Sie das Kontextmenü (rechte Maustaste) für wählen Sie dann **Neue Eigenschaft hinzufügen**.
1. Fügen Sie als **Eigenschaftsname** **securityMechanism** hinzu und wählen Sie dann **OK** aus.
1. Wählen Sie die Zeile **securityMechanism** und dann die Spalte **Wert** aus und fügen Sie **7** hinzu.
1. Wählen Sie **OK** aus.
![\[Die Registerkarte Treibereigenschaften im Fenster Treiber bearbeiten in DBeaver.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/dbeaver-driver-properties-tab.png)
1. Wählen Sie im Fenster **Mit einer Datenbank verbinden** die Option **Verbindung testen** aus. Wenn auf Ihrem Computer kein DB2 JBDC-Treiber installiert ist, wird der Treiber automatisch heruntergeladen.
1. Wählen Sie **OK** aus.
1. Wählen Sie **Finish** (Abschließen).
1. Wählen Sie auf der Registerkarte **Datenbanknavigation** den Namen der Datenbank aus. Sie können jetzt Objekte erkunden.
Sie können jetzt SQL-Befehle ausführen.
**So führen Sie SQL-Befehle aus und sehen sich die Ergebnisse an**
1. Wählen Sie im oberen Menü **SQL** aus. Dadurch wird ein SQL-Skriptfenster geöffnet.
1. Geben Sie im Fenster **Skript** einen SQL-Befehl ein.
1. Um den Befehl auszuführen, wählen Sie die Schaltfläche **SQL-Abfrage ausführen** aus.
1. Sehen Sie sich im Bereich mit den SQL-Ergebnissen die Ergebnisse Ihrer SQL-Abfragen an.
![\[Fenster, das zeigt, wie Sie in DBeaver einen SQL-Befehl ausführen und die Ergebnisse anzeigen.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/dbeaver-sql-run-example.png)
# Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit IBM Db2 Data Management Console
Sie können mit IBM Db2 Data Management Console eine Verbindung zu Ihrer DB-Instance von Amazon RDS für Db2 herstellen. IBM Db2 Data Management Console kann mehrere DB-Instances von RDS für Db2 verwalten und überwachen.
**Anmerkung**
Sie benötigen einen Linux- oder Windows-Computer mit Amazon EC2, der sich in derselben VPC und Sicherheitsgruppe befindet wie Ihre DB-Instance von RDS für Db2. Die VPC und die Sicherheitsgruppe steuern die Verbindung zu Ihrer DB-Instance über das interne Netzwerk.
IBM Db2 Data Management Console erfordert eine Repository-Db2-Datenbank zum Speichern von Metadaten und Leistungsmetriken, kann aber nicht automatisch eine Repository-Datenbank für RDS für Db2 erstellen. Stattdessen müssen Sie zunächst eine Repository-Datenbank erstellen, um eine oder mehrere DB-Instances von RDS für Db2 zu überwachen. Anschließend können Sie IBM Db2 Data Management Console installieren und über IBM Db2 Data Management Console eine Verbindung mit Ihrer DB-Instance von RDS für Db2 herstellen.
**Topics**
+ [Schritt 1: Erstellen einer Repository-Datenbank zur Überwachung von DB-Instances](#db2-creating-repo-db-monitoring-dmc)
+ [Schritt 2: Installieren und Einrichten von IBM Db2 Data Management Console](#db2-install-setup-dmc)
+ [Schritt 3: Konfigurieren der Repository-Datenbank und Verbinden mit DB-Instances von RDS für Db2](#db2-connecting-db-instances-with-dmc)
+ [Verwenden von IBM Db2 Data Management Console](#db2-using-dmc)
## Schritt 1: Erstellen einer Repository-Datenbank zur Überwachung von DB-Instances
Sie können eine vorhandene DB-Instance von RDS für Db2 mit der richtigen Größe als Repository für IBM Db2 Data Management Console zur Überwachung anderer DB-Instances von RDS für Db2 verwenden. Da der Administratorbenutzer jedoch keine `SYSCTRL`-Autorität hat, um Pufferpools und Tablespaces zu erstellen, schlägt die Repository-Erstellung von IBM Db2 Data Management Console zum Erstellen einer Repository-Datenbank fehl. Stattdessen müssen Sie eine Repository-Datenbank erstellen. Diese Repository-Datenbank überwacht Ihre DB-Instances von RDS für Db2.
Sie können eine Repository-Datenbank auf zwei verschiedene Arten erstellen. Sie können eine Datenbank von RDS für Db2 und anschließend manuell einen Pufferpool, einen Benutzer-Tablespace und einen temporären System-Tablespace erstellen. Alternativ können Sie eine separate Amazon-EC2-Instance erstellen, um eine Repository-Datenbank von IBM Db2 Data Management Console zu hosten.
**Topics**
+ [Manuelles Erstellen eines Pufferpools, eines Benutzer-Tablespace und eines temporären System-Tablespace](#db2-manually-creating-dmc)
+ [Erstellen einer Amazon-EC2-Instance als Host für ein IBM Db2 Data Management Console-Repository](#db2-creating-ec2-dmc)
### Manuelles Erstellen eines Pufferpools, eines Benutzer-Tablespace und eines temporären System-Tablespace
**So erstellen Sie einen Pufferpool, einen Benutzer-Tablespace und einen temporären System-Tablespace**
1. Stellen Sie eine Verbindung zur Datenbank `rdsadmin` her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Erstellen Sie einen Pufferpool für IBM Db2 Data Management Console. Im folgenden Beispiel *database\$1name* ersetzen Sie es durch den Namen des Repositorys, das Sie für IBM Db2 Data Management Console die Überwachung Ihres RDS für DB2-DB-Instances erstellt haben.
```
db2 "call rdsadmin.create_bufferpool('database_name',
'BP4CONSOLE', 1000, 'Y', 'Y', 32768)"
```
1. Erstellen Sie einen Benutzer-Tablespace für IBM Db2 Data Management Console. Ersetzen Sie es im folgenden Beispiel *database\$1name* durch den Namen des Repositorys, das Sie erstellt haben, IBM Db2 Data Management Console um Ihren RDS für Db2-DB-Instances zu überwachen.
```
db2 "call rdsadmin.create_tablespace('database_name',
'TS4CONSOLE', 'BP4CONSOLE', 32768)"
```
1. Erstellen Sie einen temporären System-Tablespace für IBM Db2 Data Management Console. Ersetzen Sie es im folgenden Beispiel *database\$1name* durch den Namen des Repositorys, das Sie erstellt haben, IBM Db2 Data Management Console um Ihren RDS für Db2-DB-Instances zu überwachen.
```
db2 "call rdsadmin.create_tablespace('database_name',
'TS4CONSOLE_TEMP', 'BP4CONSOLE', 32768, 0, 0, 'S')"
```
Sie können jetzt IBM Db2 Data Management Console installieren. Weitere Informationen zur Installation und Einrichtung finden Sie unter [Schritt 2: Installieren und Einrichten von IBM Db2 Data Management Console](#db2-install-setup-dmc).
### Erstellen einer Amazon-EC2-Instance als Host für ein IBM Db2 Data Management Console-Repository
Sie können eine separate Amazon Elastic Compute Cloud (Amazon EC2)-Instance erstellen, um ein IBM Db2 Data Management Console-Repository zu hosten. Informationen zum Erstellen einer Amazon-EC2-Instance finden Sie unter [Tutorial: Erste Schritte mit Amazon-EC2-Instances für Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html) im *Amazon-EC2-Benutzerhandbuch*.
## Schritt 2: Installieren und Einrichten von IBM Db2 Data Management Console
Nachdem Sie einen Pufferpool, einen Benutzer-Tablespace und einen temporären System-Tablespace erstellt haben, können Sie mit der Installation und Einrichtung von IBM Db2 Data Management Console beginnen.
**Wichtig**
Sie benötigen einen Linux- oder Windows-Computer mit Amazon EC2, der sich in derselben VPC und Sicherheitsgruppe befindet wie Ihre DB-Instance von RDS für Db2. Die VPC und die Sicherheitsgruppe steuern die Verbindung zu Ihrer DB-Instance über das interne Netzwerk. Außerdem müssen Sie bereits [eine Repository-Datenbank für IBM Db2 Data Management Console erstellt](#db2-creating-repo-db-monitoring-dmc) haben.
**So können Sie IBM Db2 Data Management Console installieren und einrichten**
1. Laden Sie IBM Db2 Data Management Console unter [IBM Db2 Data Management Console Version 3.1x releases](https://www.ibm.com/support/pages/ibm-db2-data-management-console-version-31x-releases-new-features-and-enhancements) auf der IBM-Support-Website herunter.
1. Installieren IBM Db2 Data Management Console.
1. Öffnen Sie IBM Db2 Data Management Console und verwenden Sie die IP-Adresse Ihres Amazon-EC2-Computers und die Portnummer, die Sie für die HTTP- oder HTTPS-Verbindung mit Ihrer Amazon-EC2-Instance verwendet haben. Verwenden Sie beispielsweise `http://xx.xx.xx.xx:11080` oder `https://xx.xx.xx.xx.11081`. Ersetzen Sie `xx.xx.xx.xx` durch die IP-Adresse Ihres Amazon-EC2-Computers. `11080` und `11081` sind die Standardports für HTTP- und HTTPS-Verbindungen.
1. (Optional) Wenn Sie Port 80 oder 443 auf Ihrer Amazon-EC2-Instance verwenden möchten, können Sie entweder Apache httpd oder einen Nginx-HTTP-Server als Proxy des IBM Db2 Data Management Console-Ports für Port 80 oder 443 zu verwenden. Weitere Informationen finden Sie unter [Apache HTTP Server Project](https://httpd.apache.org) und auf der [Nginx-Website](https://nginx.org/en/).
Um eine Verbindung mit IBM Db2 Data Management Console zuzulassen, müssen Sie die Regeln für eingehenden Datenverkehr in Ihrer Sicherheitsgruppe bearbeiten. Wenn Sie einen Proxy verwenden, ändern Sie den TCP/IP Port 80 oder 443, um zu den IBM Db2 Data Management Console Ports umzuleiten. Wenn Sie keinen Proxy verwenden, ändern Sie den TCP/IP Port 80 oder 443 auf die Standardports 11080 (HTTP) oder 11081 (HTTPS).
Sie können sich jetzt bei IBM Db2 Data Management Console anmelden, um die Repository-Datenbank zu konfigurieren und eine Verbindung zu Ihren DB-Instances von RDS für Db2 herzustellen. Weitere Informationen finden Sie unter [Konfigurieren der Repository-Datenbank und Verbinden mit DB-Instances](#db2-connecting-db-instances-with-dmc).
## Schritt 3: Konfigurieren der Repository-Datenbank und Verbinden mit DB-Instances von RDS für Db2
Wenn Sie zum ersten Mal eine Verbindung mit der Repository-Datenbank herstellen, konfiguriert IBM Db2 Data Management Console automatisch das Repository. Nachdem die Repository-Datenbank konfiguriert wurde, können Sie Datenbankverbindungen zu IBM Db2 Data Management Console hinzufügen.
Sie benötigen den DNS-Namen und die Portnummer Ihrer DB-Instance von RDS für Db2, um sich mit ihr zu verbinden. Informationen dazu, wie Sie diese ermitteln, finden Sie unter [Ermitteln des Endpunkts](db2-finding-instance-endpoint.md). Sie müssen auch den Datenbanknamen, den Hauptbenutzernamen und das Hauptpasswort kennen, die Sie bei der Erstellung Ihrer DB-Instance von RDS für Db2 definiert haben. Informationen dazu, wie Sie diese ermitteln, finden Sie unter [Erstellen einer DB-Instance](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating). Wenn Sie eine Verbindung über das Internet herstellen, lassen Sie Datenverkehr zum Datenbankport zu. Weitere Informationen finden Sie unter [Erstellen einer DB-Instance](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
**So verbinden Sie DB-Instances von RDS für Db2 mit IBM Db2 Data Management Console**
1. Melden Sie sich bei IBM Db2 Data Management Console mit den Anmeldeinformationen an, die Sie bei der Installation festgelegt haben.
1. Konfigurieren Sie das Repository.
1. Geben Sie im Abschnitt **Verbindung und Datenbank** die folgenden Informationen für Ihre DB-Instance von RDS für Db2 ein:
+ Geben Sie unter **Host** den DNS-Namen der DB-Instance ein.
+ Geben Sie unter **Port** die Portnummer für die DB-Instance ein.
+ Geben Sie unter **Datenbank** den Namen Ihrer Datenbank ein.
![\[Der Abschnitt Verbindung und Datenbank in IBM Db2 Data Management Console mit den Feldern Host, Port und Datenbank.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/ibm-dmc-connection-database.png)
1. Geben Sie im Abschnitt **Sicherheit und Anmeldeinformationen** die folgenden Informationen für Ihre DB-Instance von RDS für Db2 ein:
+ Wählen Sie als **Sicherheitstyp** die Option **Verschlüsselter Benutzer und Passwort** aus.
+ Geben Sie in das Feld **Username (Benutzername)** den Namen des Datenbankadministrators für Ihre DB-Instance ein.
+ Geben Sie unter **Passwort** das Passwort des Datenbankadministrators für die DB-Instance an.
1. Wählen Sie **Test connection (Verbindung testen)** aus.
**Anmerkung**
Wenn die Verbindung nicht erfolgreich ist, überprüfen Sie anhand der Regeln für eingehenden Datenverkehr in Ihrer Sicherheitsgruppe, ob der Datenbankport geöffnet ist. Weitere Informationen finden Sie unter [Überlegungen zu Sicherheitsgruppen mit Amazon RDS für Db2](db2-security-groups-considerations.md).
Wenn Sie in RDS für Db2 nicht [manuell einen Pufferpool, einen Benutzer-Tablespace und einen temporären System-Tablespace erstellt](#db2-manually-creating-dmc) haben, wird möglicherweise die folgende Fehlermeldung angezeigt:
![\[Fehlermeldung zu fehlenden Berechtigungen für die Operationen.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/ibm-dmc-error-message.png)
Stellen Sie sicher, dass Sie eine Puffertabelle, einen Tablespace und Objekte für ein IBM Db2 Data Management Console-Repository erstellt haben, um Ihre DB-Instance von RDS für Db2 zu überwachen. Alternativ können Sie eine Db2-DB-Instance von Amazon EC2 verwenden, um ein IBM Db2 Data Management Console-Repository zur Überwachung Ihrer DB-Instance von RDS für Db2 zu hosten. Weitere Informationen finden Sie unter [Schritt 1: Erstellen einer Repository-Datenbank zur Überwachung von DB-Instances](#db2-creating-repo-db-monitoring-dmc).
1. Nachdem Sie Ihre Verbindung erfolgreich getestet haben, wählen Sie **Weiter** aus.
![\[Der Abschnitt Sicherheit und Anmeldeinformationen in IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/ibm-dmc-security-credential.png)
Wenn IBM Db2 Data Management Console den Pufferpool, den Benutzer-Tablespace und den temporären System-Tablespace in der DB-Instance von RDS für Db2 gefunden hat, konfiguriert IBM Db2 Data Management Console automatisch die Repository-Datenbank. Wenn Sie Ihre Db2-Instance auf Ihrer Amazon-EC2-Instance als Repository-Datenbank verwenden, erstellt IBM Db2 Data Management Console automatisch den Pufferpool und andere Objekte.
1. Wählen Sie im Opt-in-Fenster **Statistikereignisüberwachung festlegen** die Option **Weiter**.
1. (Optional) Fügen Sie eine neue Verbindung hinzu. Wenn Sie eine andere DB-Instance von RDS für Db2 für die Verwaltung und Überwachung verwenden möchten, fügen Sie eine Verbindung zu einer DB-Instance von RDS für Db2 hinzu, die kein Repository ist.
1. Geben Sie im Abschnitt **Verbindung und Datenbank** die folgenden Informationen für Ihre DB-Instance von RDS für Db2 ein, die Sie zur Verwaltung und Überwachung verwenden möchten:
+ Geben Sie als **Verbindungsname** die Db2-Datenbank-ID ein.
+ Geben Sie unter **Host** den DNS-Namen der DB-Instance ein.
+ Geben Sie unter **Port** die Portnummer für die DB-Instance ein.
+ Geben Sie unter **Datenbank** den Namen Ihrer Datenbank ein.
![\[Der Abschnitt Verbindung und Datenbank für eine neue Verbindung in IBM Db2 Data Management Console mit den Feldern Host, Port und Datenbank.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/ibm-dmc-new-connection-database.png)
1. Wählen Sie im Abschnitt **Sicherheit und Anmeldeinformationen**** **die Option **Erfassung von Überwachungsdaten aktivieren** aus.
1. Geben Sie die folgenden Informationen für Ihre DB-Instance von RDS für Db2 ein:
+ Geben Sie in das Feld **Username (Benutzername)** den Namen des Datenbankadministrators für Ihre DB-Instance ein.
+ Geben Sie unter **Passwort** das Passwort des Datenbankadministrators für die DB-Instance an.
1. Wählen Sie **Test connection (Verbindung testen)** aus.
1. Nachdem Sie Ihre Verbindung erfolgreich getestet haben, wählen Sie **Speichern** aus.
![\[Der Abschnitt Sicherheit und Anmeldeinformationen für eine neue Verbindung in IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/ibm-dmc-new-security-credential.png)
Nachdem die Verbindung hinzugefügt wurde, wird ein Fenster ähnlich dem folgenden angezeigt. Dieses Fenster zeigt an, dass Ihre Datenbank erfolgreich konfiguriert wurde.
![\[Fenster, das anzeigt, dass die Datenbank erfolgreich in IBM Db2 Data Management Console konfiguriert wurde.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/ibm-dmc-configuration-success.png)
1. Wählen Sie **Gehe zu Datenbanken**. Es wird ein Datenbankfenster ähnlich dem folgenden angezeigt. Dieses Fenster ist ein Dashboard, das Metriken, Status und Verbindungen anzeigt.
![\[Das Übersichtsfenster Datenbanken in IBM Db2 Data Management Console.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/ibm-dmc-database-view.png)
Sie können nun mit IBM Db2 Data Management Console beginnen.
## Verwenden von IBM Db2 Data Management Console
Sie können IBM Db2 Data Management Console für die folgenden Arten von Aufgaben verwenden:
+ Mehrere DB-Instances von RDS für Db2 verwalten
+ SQL-Befehle ausführen
+ Daten und Datenbankobjekte erkunden, erstellen oder ändern
+ `EXPLAIN PLAN`-Anweisungen in SQL erstellen
+ Abfragen optimieren
**So führen Sie SQL-Befehle aus und sehen sich die Ergebnisse an**
1. Wählen Sie in der linken Navigationsleiste die Option **SQL**.
1. Geben Sie einen SQL-Befehl ein.
1. Wählen Sie **Alle ausführen**.
1. Um die Ergebnisse anzuzeigen, wählen Sie die Registerkarte **Ergebnisse**.
![\[Das Fenster Datenbank, das zeigt, wie Sie in IBM Db2 Data Management Console einen SQL-Befehl ausführen und die Ergebnisse anzeigen.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/ibm-dmc-sql-run-example.png)
# Überlegungen zu Sicherheitsgruppen mit Amazon RDS für Db2
Ihrer DB-Instance von Amazon RDS für Db2 muss eine Sicherheitsgruppe zugeordnet sein, die die erforderlichen IP-Adressen und die Netzwerkkonfiguration enthält, um eine Verbindung mit Ihrer DB-Instance herzustellen. Ihre DB-Instance von RDS für Db2 verwendet möglicherweise die Standardsicherheitsgruppe. Wenn Sie beim Erstellen der DB-Instance von RDS für Db2 eine standardmäßige, nicht konfigurierte Sicherheitsgruppe zugewiesen haben, verhindert die Firewall Internet-Verbindungsversuche. Informationen zum Erstellen einer neuen Sicherheitsgruppe finden Sie unter [Zugriffskontrolle mit Sicherheitsgruppen](Overview.RDSSecurityGroups.md).
Nachdem Sie die neue Sicherheitsgruppe erstellt haben, ändern Sie Ihre DB-Instance, um ihr die Sicherheitsgruppe zuzuordnen. Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md).
Sie können die Sicherheitsstufe mithilfe von SSL erhöhen, um Verbindungen zu Ihrer DB-Instance zu verschlüsseln. Weitere Informationen finden Sie unter [Verwendung SSL/TLS mit einer Amazon RDS for Db2-DB-Instance](Db2.Concepts.SSL.md).
# Sichern von Verbindungen der DB-Instance von Amazon RDS für Db2
Amazon RDS für Db2 unterstützt Methoden zur Verbesserung der Sicherheit Ihrer DB-Instance von RDS für Db2.
**Topics**
+ [Verwendung SSL/TLS mit einer Amazon RDS for Db2-DB-Instance](Db2.Concepts.SSL.md)
+ [Verwenden der Kerberos-Authentifizierung für Amazon RDS für Db2](db2-kerberos.md)
# Verwendung SSL/TLS mit einer Amazon RDS for Db2-DB-Instance
SSL ist ein Branchen-Standardprotokoll, das für den Schutz von Netzwerkverbindungen zwischen Client und Server verwendet wird. Nach SSL-Version 3.0 wurde der Name in TLS geändert, aber wir bezeichnen das Protokoll häufig immer noch als SSL. Amazon RDS unterstützt die SSL-Verschlüsselung für DB-Instances von Amazon RDS für Db2. Die Nutzung der SSL/TLS, you can encrypt a connection between your application client and your RDS for Db2 DB instance. SSL/TLS Unterstützung ist AWS-Regionen für RDS for Db2 in allen Versionen verfügbar.
Um die SSL/TLS Verschlüsselung für eine RDS for Db2-DB-Instance zu aktivieren, fügen Sie die Db2-SSL-Option zu der Parametergruppe hinzu, die der DB-Instance zugeordnet ist. Amazon RDS verwendet einen zweiten Port, wie von Db2 gefordert, für SSL/TLS Verbindungen. Auf diese Weise können sowohl Klartext- als auch SSL-verschlüsselte Kommunikation gleichzeitig zwischen einer DB-Instance und einem Db2-Client erfolgen. Sie können z. B. den Port mit Klartext-Kommunikation verwenden, um mit anderen Ressourcen innerhalb einer VPC zu kommunizieren, und den Port mit SSL-verschlüsselter Kommunikation, um mit Ressourcen außerhalb der VPC zu kommunizieren.
**Topics**
+ [Eine SSL/TLS Verbindung herstellen](#db2-creating-ssl-connection)
+ [Herstellen einer Verbindung mit dem Db2-Datenbankserver](#db2-connecting-to-server-ssl)
## Eine SSL/TLS Verbindung herstellen
Um eine SSL/TLS Verbindung herzustellen, wählen Sie eine Zertifizierungsstelle (CA) aus, laden Sie ein Zertifikatspaket für alle AWS-Regionen herunter und fügen Sie Parameter zu einer benutzerdefinierten Parametergruppe hinzu.
### Schritt 1: Auswählen einer Zertifizierungsstelle (CA) und Herunterladen eines Zertifikats
Wählen Sie eine Zertifizierungsstelle (CA) aus und laden Sie ein Zertifikatpaket für alle AWS-Regionen herunter. Weitere Informationen finden Sie unter [](UsingWithRDS.SSL.md).
### Schritt 2: Aktualisieren von Parametern in einer benutzerdefinierten Parametergruppe
**Wichtig**
Wenn Sie das Modell Bring-Your-Own-License (BYOL) für RDS für Db2 verwenden, ändern Sie die benutzerdefinierte Parametergruppe, die Sie für Ihre IBM Customer ID und IBM Site ID erstellt haben. Wenn Sie ein anderes Lizenzmodell für RDS für Db2 verwenden, gehen Sie wie folgt vor, um Parameter zu einer benutzerdefinierten Parametergruppe hinzuzufügen. Weitere Informationen finden Sie unter [Lizenzierungsoptionen für Amazon RDS für Db2](db2-licensing.md).
Sie können Standardparametergruppen für DB-Instances von RDS für Db2 nicht ändern. Daher müssen Sie eine benutzerdefinierte Parametergruppe erstellen, diese ändern und sie dann Ihren DB-Instances von RDS für Db2 anfügen. Informationen zu Parametergruppen finden Sie unter [DB-Parametergruppen für DB-Instances von Amazon RDS](USER_WorkingWithDBInstanceParamGroups.md).
Verwenden Sie die Parametereinstellungen in der folgenden Tabelle.
| Parameter | Wert |
| --- | --- |
| DB2COMM | TCPIP,SSL oder SSL |
| SSL\$1SVCENAME | |
**So aktualisieren Sie Parameter in einer benutzerdefinierten Parametergruppe**
1. Erstellen Sie eine benutzerdefinierte Parametergruppe, indem Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html) ausführen.
Verwenden Sie den folgenden erforderlichen Parameter:
+ `--db-parameter-group-name` – Ein Name für die Parametergruppe, die Sie erstellen.
+ `--db-parameter-group-family` – Die Db2-Engine-Edition und die Hauptversion. Zulässige Werte: `db2-se-11-5`, `db2-ae-11.5`.
+ `--description` – Eine Beschreibung für diese Parametergruppe.
Weitere Informationen über das Erstellen einer Parametergruppe finden Sie unter [Erstellen einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Ändern Sie die Parameter in der benutzerdefinierten Parametergruppe, die Sie durch Ausführen des Befehls [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html) erstellt haben.
Verwenden Sie den folgenden erforderlichen Parameter:
+ `--db-parameter-group-name` – Der Name der von Ihnen erstellten Parametergruppe.
+ `--parameters` – Ein Array von Parameternamen, Werten und der Anwendungsmethoden für die Parameteraktualisierung.
Weitere Informationen zum Ändern einer Parametergruppe finden Sie unter [Ändern von Parametern in einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
1. Ordnen Sie die Parametergruppe zur DB-Instance von RDS für Db2 zu. Weitere Informationen finden Sie unter [Verknüpfen einer DB-Parametergruppe mit einer DB-Instance in Amazon RDS](USER_WorkingWithParamGroups.Associating.md).
## Herstellen einer Verbindung mit dem Db2-Datenbankserver
Die Anleitungen für die Herstellung einer Verbindung mit Ihrem Db2-Datenbankserver sind sprachspezifisch.
------
#### [ Java ]
**So stellen Sie eine Verbindung mit Ihrem Db2-Datenbankserver mithilfe von Java her**
1. Laden Sie den JDBC-Treiber herunter. Weitere Informationen finden Sie unter [DB2 JDBC-Treiberversionen und Downloads](https://www.ibm.com/support/pages/db2-jdbc-driver-versions-and-downloads) in der IBM Support-Dokumentation.
1. Erstellen Sie eine Shell-Skriptdatei mit dem folgenden Inhalt. Dieses Skript fügt alle Zertifikate aus dem Paket zu einem Java KeyStore hinzu.
**Wichtig**
Vergewissern Sie sich, dass `keytool` im Pfad des Skripts vorhanden ist, damit das Skript diesen finden kann. Wenn Sie einen Db2-Client verwenden, befindet sich `keytool` unter `~sqlib/java/jdk64/jre/bin`.
```
#!/bin/bash
PEM_FILE=$1
PASSWORD=$2
KEYSTORE=$3
# number of certs in the PEM file
CERTS=$(grep 'END CERTIFICATE' $PEM_FILE| wc -l)
for N in $(seq 0 $(($CERTS - 1))); do
ALIAS="${PEM_FILE%.*}-$N"
cat $PEM_FILE |
awk "n==$N { print }; /END CERTIFICATE/ { n++ }" |
keytool -noprompt -import -trustcacerts -alias $ALIAS -keystore $KEYSTORE -storepass $PASSWORD
done
```
1. Verwenden Sie den folgenden Befehl, um das Shell-Skript auszuführen und die Datei PEM mit dem Zertifikatpaket in einen Java KeyStore zu importieren. *shell\$1file\$1name.sh*Ersetzen Sie es durch den Namen Ihrer Shell-Skriptdatei und *password* durch das Passwort für Ihre. Java KeyStore
```
./shell_file_name.sh global-bundle.pem password truststore.jks
```
1. Führen Sie den folgenden Befehl aus, um eine Verbindung mit dem Db2-Server herzustellen. Ersetzen Sie die folgenden Platzhalter im Beispiel durch Ihre Angaben zur DB-Instance von RDS für Db2.
+ *ip\$1address*— Die IP-Adresse für Ihren DB-Instance-Endpunkt.
+ *port*— Die Portnummer für die SSL-Verbindung. Dies kann eine beliebige Portnummer sein, mit Ausnahme der Nummer, die für den Nicht-SSL-Port verwendet wird.
+ *database\$1name*— Der Name Ihrer Datenbank in Ihrer DB-Instance.
+ *master\$1username*— Der Master-Benutzername für Ihre DB-Instance.
+ *master\$1password*— Das Master-Passwort für Ihre DB-Instance.
```
export trustStorePassword=MyPassword
java -cp ~/dsdriver/jdbc_sqlj_driver/linuxamd64/db2jcc4.jar \
com.ibm.db2.jcc.DB2Jcc -url \
"jdbc:db2://ip_address:port/database_name:\
sslConnection=true;sslTrustStoreLocation=\
~/truststore.jks;\
sslTrustStorePassword=${trustStorePassword};\
sslVersion=TLSv1.2;\
encryptionAlgorithm=2;\
securityMechanism=7;" \
-user master_username -password master_password
```
------
#### [ Node.js ]
**So stellen Sie eine Verbindung mit Ihrem Db2-Datenbankserver mithilfe von Node.js her**
1. Installieren Sie die **node-ibm\$1db**-Treiber: Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [Installieren des node-ibm\$1db-Treibers auf Linux- und UNIX-Systemen](https://www.ibm.com/docs/en/db2/11.5?topic=nodejs-installing-node-db-driver-linux-unix-systems).
1. Erstellen Sie eine JavaScript-Datei anhand des folgenden Inhalts. Ersetzen Sie die folgenden Platzhalter im Beispiel durch Ihre Angaben zur DB-Instance von RDS für Db2.
+ *ip\$1address*— Die IP-Adresse für Ihren DB-Instance-Endpunkt.
+ *master\$1username*— Der Master-Benutzername für Ihre DB-Instance.
+ *master\$1password*— Das Master-Passwort für Ihre DB-Instance.
+ *database\$1name*— Der Name Ihrer Datenbank in Ihrer DB-Instance.
+ *port*— Die Portnummer für die SSL-Verbindung. Dies kann eine beliebige Portnummer sein, mit Ausnahme der Nummer, die für den Nicht-SSL-Port verwendet wird.
```
var ibmdb = require("ibm_db");
const hostname = "ip_address";
const username = "master_username";
const password = "master_password";
const database = "database_name";
const port = "port";
const certPath = "/root/qa-bundle.pem";
ibmdb.open("DRIVER={DB2};DATABASE=" + database + ";HOSTNAME=" + hostname + ";UID=" + username + ";PWD=" + password + ";PORT=" + port + ";PROTOCOL=TCPIP;SECURITY=SSL;SSLServerCertificate=" + certPath + ";", function (err, conn){
if (err) return console.log(err);
conn.close(function () {
console.log('done');
});
});
```
1. Verwenden Sie den folgenden Befehl, um die Datei JavaScript auszuführen.
```
node ssl-test.js
```
------
#### [ Python ]
**So stellen Sie eine Verbindung mit Ihrem Db2-Datenbankserver mithilfe von Python her**
1. Erstellen Sie eine Python-Datei mit folgendem Inhalt: Ersetzen Sie die folgenden Platzhalter im Beispiel durch Ihre Angaben zur DB-Instance von RDS für Db2.
+ *port*— Die Portnummer für die SSL-Verbindung. Dies kann eine beliebige Portnummer sein, mit Ausnahme der Nummer, die für den Nicht-SSL-Port verwendet wird.
+ *master\$1username*— Der Master-Benutzername für Ihre DB-Instance.
+ *master\$1password*— Das Master-Passwort für Ihre DB-Instance.
+ *database\$1name*— Der Name Ihrer Datenbank in Ihrer DB-Instance.
+ *ip\$1address*— Die IP-Adresse für Ihren DB-Instance-Endpunkt.
```
import click
import ibm_db
import sys
port = port;
master_user_id = "master_username" # Master id used to create your DB instance
master_password = "master_password" # Master password used to create your DB instance
db_name = "database_name" # If not given "db-name'
vpc_customer_private_ip = "ip_address" # Hosts end points - Customer private IP Addressicert_path = "/root/ssl/global-bundle.pem" # cert path
@click.command()
@click.option("--path", help="certificate path")
def db2_connect(path):
try:
conn = ibm_db.connect(f"DATABASE={db_name};HOSTNAME={vpc_customer_private_ip};PORT={port};
PROTOCOL=TCPIP;UID={master_user_id};PWD={master_password};SECURITY=ssl;SSLServerCertificate={path};", "", "")
try:
ibm_db.exec_immediate(conn, 'create table tablename (a int);')
print("Query executed successfully")
except Exception as e:
print(e)
finally:
ibm_db.close(conn)
sys.exit(1)
except Exception as ex:
print("Trying to connect...")
if __name__ == "__main__":
db2_connect()
```
1. Erstellen Sie das folgende Shell-Skript, das die von Ihnen erstellte Datei Python ausführt. Ersetzen Sie *python\$1file\$1name.py* durch den Namen Ihrer Python-Skriptdatei.
```
#!/bin/bash
PEM_FILE=$1
# number of certs in the PEM file
CERTS=$(grep 'END CERTIFICATE' $PEM_FILE| wc -l)
for N in $(seq 0 $(($CERTS - 1))); do
ALIAS="${PEM_FILE%.*}-$N"
cert=`cat $PEM_FILE | awk "n==$N { print }; /END CERTIFICATE/ { n++ }"`
cat $PEM_FILE | awk "n==$N { print }; /END CERTIFICATE/ { n++ }" > $ALIAS.pem
python3 --path $ALIAS.pem
output=`echo $?`
if [ $output == 1 ]; then
break
fi
done
```
1. Führen Sie den folgenden Befehl aus, um die Datei PEM mit dem Zertifikatpaket zu importieren und das Shell-Skript auszuführen. *shell\$1file\$1name.sh*Ersetzen Sie durch den Namen Ihrer Shell-Skriptdatei.
```
./shell_file_name.sh global-bundle.pem
```
------
#### [ Db2-CLP ]
**So stellen Sie eine Verbindung mit Ihrem Db2-Datenbankserver mithilfe von Db2 CLP her**
1. Um eine Verbindung zu Ihrer Db2-Instance herzustellenDb2 CLP, benötigen Sie GSKit, die Sie bei [IBM Fix Central](https://www.ibm.com/support/fixcentral/swg/selectFixes?parent=Security+Systems&product=ibm/Tivoli/IBM+Global+Security+Kit&release=All&platform=All&function=fixId&fixids=8.0.*&source=fc) herunterladen können. Zur Verwendung von Db2 CLP benötigen Sie außerdem den IBM Db2-Client, den Sie vom IBM Support unter [Herunterladen der Clients und Treiber der ersten Version 11.5](https://www.ibm.com/support/pages/download-initial-version-115-clients-and-drivers) herunterladen können.
1. Erstellen Sie einen Keystore.
```
gsk8capicmd_64 -keydb -create -db "directory/keystore-filename" -pw "changeThisPassword" -type pkcs12 -stash
```
1. Importieren Sie die Zertifikatpakete in den Keystore.
```
gsk8capicmd_64 -cert -import -file global-bundle.pem -target directory/keystore-filename> -target_stashed
```
1. Aktualisieren Sie die Db2-Instance-Konfiguration.
```
db2 update dbm cfg using SSL_CLNT_KEYDB keystore-filename SSL_CLNT_STASH keystore stash file immediate
```
1. Katalogisieren Sie den Knoten und die Datenbank.
```
db2 catalog tcpip node ssluse1 REMOTE endpoint SERVER ssl_svcename security ssl
db2 catalog database testdb as ssltest at node ssluse1
```
1. Stellen Sie eine Verbindung zur Datenbank her.
```
db2 connect to ssltest user username using password
```
------
# Verwenden der Kerberos-Authentifizierung für Amazon RDS für Db2
Sie können die Kerberos-Authentifizierung verwenden, um Benutzer zu authentifizieren, wenn diese sich mit Ihrer DB-Instance von Amazon RDS für Db2 verbinden. In dieser Konfiguration arbeitet Ihre DB-Instance mit AWS Directory Service for Microsoft Active Directory, auch genannt AWS Managed Microsoft AD. Sie fügen die Domain und andere Informationen Ihres AWS Managed Microsoft AD Verzeichnisses zu Ihrer RDS for Db2-DB-Instance hinzu. Wenn sich Benutzer mit einer RDS for Db2-DB-Instance authentifizieren, die der vertrauenswürdigen Domäne hinzugefügt wurde, werden Authentifizierungsanforderungen an das AWS Managed Microsoft AD Verzeichnis weitergeleitet, mit dem Sie sie erstellt haben. Directory Service
Wenn Sie alle Ihre Anmeldeinformationen im selben Verzeichnis aufbewahren, können Sie Zeit und Mühe sparen. Mit diesem Ansatz haben Sie einen zentralen Ort für die Speicherung und Verwaltung von Anmeldedaten für mehrere DB-Instances. Die Verwendung eines Verzeichnisses kann auch Ihr allgemeines Sicherheitsprofil verbessern.
Außerdem können Sie von Ihrem eigenen On-Premises Microsoft Active Directory auf Anmeldeinformationen zugreifen. Dazu erstellen Sie eine vertrauensvolle Domain-Beziehung, damit das AWS Managed Microsoft AD -Verzeichnis Ihrem On-Premises Microsoft Active Directory vertraut. Auf diese Weise können Ihre Benutzer auf Ihre DB-Instances von RDS für Db2 mit derselben Windows-Oberfläche für das Single Sign-On (SSO) zugreifen, die sie auch für den Zugriff auf Workloads in Ihrem On-Premises-Netzwerk verwenden.
[Weitere Informationen finden Sie unter Was ist? Directory Service](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/what_is.html) im *AWS Directory Service Administratorhandbuch*.
Informationen zur Kerberos-Authentifizierung finden Sie unter den folgenden Themen:
**Topics**
+ [Einrichten der Kerberos-Authentifizierung für DB-Instances von Amazon RDS für Db2](db2-kerberos-setting-up.md)
+ [Herstellen einer Verbindung zu Amazon RDS für Db2 mit Kerberos-Authentifizierung](db2-kerberos-connecting.md)
## Verfügbarkeit von Regionen und Versionen
Die Verfügbarkeit von Funktionen und der Support variieren zwischen bestimmten Versionen der einzelnen Datenbank-Engines und in allen AWS-Regionen. Weitere Hinweise zur Versions- und Regionsverfügbarkeit von RDS für Db2 mit Kerberos-Authentifizierung finden Sie unter [Unterstützte Regionen und DB-Engines für die Kerberos-Authentifizierung in Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.KerberosAuthentication.md).
**Anmerkung**
Die Kerberos-Authentifizierung wird für DB-Instance-Klassen, die für DB-Instances von RDS für Db2 veraltet sind, nicht unterstützt. Weitere Informationen finden Sie unter [Instance-Klassen von Amazon RDS für Db2](Db2.Concepts.General.InstanceClasses.md).
## Übersicht über die Kerberos-Authentifizierung für DB-Instances von RDS für Db2
Führen Sie die folgenden allgemeinen Schritte aus, die später noch ausführlicher beschrieben werden, um die Kerberos-Authentifizierung für eine DB-Instance von RDS für Db2 einzurichten:
1. Wird verwendet AWS Managed Microsoft AD , um ein AWS Managed Microsoft AD Verzeichnis zu erstellen. Sie können das AWS-Managementkonsole, das AWS Command Line Interface (AWS CLI) oder verwenden, Directory Service um das Verzeichnis zu erstellen. Weitere Informationen finden Sie unter [AWS Managed Microsoft AD Verzeichnis erstellen](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_getting_started_create_directory.html) im *AWS Directory Service Administratorhandbuch*.
1. Erstellen Sie eine AWS Identity and Access Management (IAM-) Rolle, die die verwaltete IAM-Richtlinie verwendet. `AmazonRDSDirectoryServiceAccess` Die IAM-Rolle erlaubt, dass Amazon RDS Aufrufe an Ihr Verzeichnis schickt.
Damit die IAM-Rolle Zugriff gewährt, muss der Endpunkt AWS -Security-Token-Service (AWS STS) in der für Sie richtigen AWS-Region Weise aktiviert sein. AWS-Konto AWS STS Endpoints sind standardmäßig in allen aktiv AWS-Regionen, und Sie können sie ohne weitere Aktionen verwenden. Weitere Informationen finden Sie unter [Aktivierung und Deaktivierung AWS STSAWS-Region im *IAM-Benutzerhandbuch*](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html#sts-regions-activate-deactivate).
1. Erstellen oder ändern Sie eine RDS for Db2-DB-Instance mithilfe der AWS-Managementkonsole AWS CLI, der oder der RDS-API mit einer der folgenden Methoden:
+ Erstellen Sie mithilfe der Konsole, des [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)Befehls oder der Operation [Create DBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) API eine neue RDS for Db2-DB-Instance. Detaillierte Anweisungen finden Sie unter [Erstellen einer Amazon-RDS-DB-Instance](USER_CreateDBInstance.md).
+ Ändern Sie eine vorhandene DB-Instance von RDS für Db2 mit der Konsole, dem Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) oder der API-Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html). Detaillierte Anweisungen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md).
+ Stellen Sie eine DB-Instance von RDS für Db2 aus einem DB-Snapshot über die Konsole, den Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html) oder die API-Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html) wieder her. Detaillierte Anweisungen finden Sie unter [Wiederherstellen auf eine DB-Instance](USER_RestoreFromSnapshot.md).
+ Stellen Sie point-in-time mithilfe der Konsole, des [https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-to-point-in-time.html](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-to-point-in-time.html)Befehls oder der [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html)API-Operation eine RDS for Db2-DB-Instance auf a wieder her. Detaillierte Anweisungen finden Sie unter [Wiederherstellen einer DB-Instance auf einen bestimmten Zeitpunkt für Amazon RDS](USER_PIT.md).
Sie können die DB-Instance in derselben Amazon Virtual Private Cloud (VPC) wie das Verzeichnis oder in einer anderen AWS-Konto oder VPC lokalisieren. Wenn Sie die DB-Instance von RDS für Db2 erstellen oder ändern, gehen Sie wie folgt vor:
+ Geben Sie den Domänenbezeichner (`d-*`-Bezeichner) an, der beim Erstellen Ihres Verzeichnisses generiert wurde.
+ Geben Sie außerdem den Namen der IAM-Rolle an, die Sie erstellt haben.
+ Stellen Sie sicher, dass die Sicherheitsgruppe der DB-Instance eingehenden Datenverkehr von der Sicherheitsgruppe des Verzeichnisses empfangen kann.
1. Konfigurieren Sie Ihren Db2-Client und stellen Sie sicher, dass der Datenverkehr zwischen dem Client-Host und Directory Service für die folgenden Ports fließen kann:
+ TCP/UDP-Port 53 – DNS
+ TCP 88 – Kerberos-Authentifizierung
+ TCP 389 – LDAP
+ TCP 464 – Kerberos-Authentifizierung
## Verwalten einer DB-Instance in einer Domäne
Sie können die AWS-Managementkonsole, oder die RDS-API verwenden AWS CLI, um Ihre DB-Instance und ihre Beziehung zu Ihrer Microsoft Active Directory zu verwalten. Sie können z. B. ein Active Directory zuordnen, um die Kerberos-Authentifizierung zu aktivieren. Sie können die Zuordnung für ein Active Directory auch entfernen, um die Kerberos-Authentifizierung zu deaktivieren. Sie können auch eine DB-Instance, die extern von einem Microsoft Active Directory authentifiziert werden soll, in ein anderes verschieben.
Sie können z. B. den CLI-Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) ausführen, um Folgendes durchzuführen:
+ Erneut versuchen, die Kerberos-Authentifizierung für eine fehlgeschlagene Mitgliedschaft zu aktivieren, indem Sie die Verzeichnis-ID der aktuellen Mitgliedschaft für die `--domain`-Option angeben
+ Die Kerberos-Authentifizierung auf einer DB-Instance deaktivieren, indem Sie `none` für die `--domain`-Option angeben
+ Eine DB-Instance von einer Domain in eine andere verschieben, indem Sie die Domain-ID der neuen Domain für die `--domain`-Option angeben
### Grundlegendes zur Domänenmitgliedschaft
Nachdem Sie Ihre DB-Instance erstellt oder geändert haben, wird sie Mitglied der Domäne. Sie können den Status der Domain-Mitgliedschaft in der Konsole oder durch Ausführen des Befehls [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) anzeigen. Der Status der DB-Instance kann einer der folgenden sein:
+ `kerberos-enabled` – Für die DB-Instance ist die Kerberos-Authentifizierung aktiviert.
+ `enabling-kerberos`— AWS ist dabei, die Kerberos Authentifizierung für diese DB-Instance zu aktivieren.
+ `pending-enable-kerberos` – Das Aktivieren der Kerberos-Authentifizierung ist für diese DB-Instance ausstehend.
+ `pending-maintenance-enable-kerberos`— AWS wird versuchen, die Kerberos Authentifizierung auf der DB-Instance während des nächsten geplanten Wartungsfensters zu aktivieren.
+ `pending-disable-kerberos` – Das Deaktivieren der Kerberos-Authentifizierung ist für diese DB-Instance ausstehend.
+ `pending-maintenance-disable-kerberos`— AWS wird versuchen, die Kerberos Authentifizierung auf der DB-Instance während des nächsten geplanten Wartungsfensters zu deaktivieren.
+ `enable-kerberos-failed` – Ein Konfigurationsproblem verhinderte, dass AWS die Kerberos-Authentifizierung auf der DB-Instance aktivierte. Beheben Sie das Konfigurationsproblem, bevor Sie den Befehl zum Ändern der DB-Instance erneut ausgeben.
+ `disabling-kerberos`— AWS ist dabei, die Kerberos Authentifizierung für diese DB-Instance zu deaktivieren.
Eine Anfrage zur Aktivierung der Kerberos-Authentifizierung kann wegen eines Netzwerkverbindungsproblems oder einer falschen IAM-Rolle fehlschlagen. In einigen Fällen kann der Versuch, die Kerberos-Authentifizierung zu aktivieren, fehlschlagen, wenn Sie eine DB-Instance erstellen oder ändern. Wenn dies passiert, stellen Sie sicher, dass Sie die richtige IAM-Rolle verwenden, und ändern Sie dann die DB-Instance, um der Domain beizutreten.
# Einrichten der Kerberos-Authentifizierung für DB-Instances von Amazon RDS für Db2
Sie verwenden AWS Directory Service for Microsoft Active Directory (AWS Managed Microsoft AD), um die Kerberos Authentifizierung für eine RDS for Db2-DB-Instance einzurichten. Gehen Sie folgendermaßen vor, um die Kerberos-Authentifizierung einzurichten:
**Topics**
+ [Schritt 1: Erstellen Sie ein Verzeichnis mit AWS Managed Microsoft AD](#db2-kerberos-setting-up.create-directory)
+ [Schritt 2: Erstellen einer Vertrauensstellung](#db2-kerberos-setting-up-create-forest-trust)
+ [Schritt 3: Erstellen Sie eine IAM-Rolle, auf die Amazon RDS zugreifen kann Directory Service](#db2-kerberos-setting-up-create-iam-role)
+ [Schritt 4: Anlegen und Konfigurieren von Benutzern](#db2-kerberos-setting-up.create-users)
+ [Schritt 5: Erstellen Sie eine Administratorgruppe für RDS für Db2 in AWS Managed Microsoft AD](#db2-kerberos-setting-up-vpc-peering)
+ [Schritt 6: Ändern des DB-Parameters](#db2-kerberos-setting-up-modify-db-parameter)
+ [Schritt 7: Erstellen oder Ändern einer DB-Instance von RDS für Db2](#db2-kerberos-setting-up-create-modify)
+ [Schritt 8: Rufen Sie die Active Directory-Gruppen-SID ab in PowerShell](#db2-kerberos-setting-up-retrieve-ad-group-sid)
+ [Schritt 9: Fügen Sie SID zu GroupName Zuordnungen zu Ihrer RDS for Db2-DB-Instance hinzu](#db2-kerberos-setting-up-add-sid-group-mapping)
+ [Schritt 10: Konfigurieren eines Db2-Clients](#db2-kerberos-setting-up-create-logins)
## Schritt 1: Erstellen Sie ein Verzeichnis mit AWS Managed Microsoft AD
Directory Service erstellt ein vollständig verwaltetes Active Directory im AWS Cloud. Wenn Sie ein AWS Managed Microsoft AD Verzeichnis erstellen, Directory Service erstellt zwei Domänencontroller und DNS-Server für Sie. Die Verzeichnisserver werden in verschiedenen Subnetzen in einer VPC erstellt. Diese Redundanz hilft sicherzustellen, dass Ihr Verzeichnis verfügbar bleibt, auch wenn ein Fehler auftritt.
Wenn Sie ein AWS Managed Microsoft AD Verzeichnis erstellen, Directory Service führt in Ihrem Namen die folgenden Aufgaben aus:
+ Richtet ein Active Directory in Ihrer VPC ein.
+ Erstellt ein Konto für den Verzeichnisadministrator mit dem Benutzernamen `Admin` und dem angegebenen Passwort. Mit diesem Konto verwalten Sie das Verzeichnis.
**Wichtig**
Stellen Sie sicher, dass Sie dieses Passwort speichern. Directory Service speichert dieses Passwort nicht und es kann nicht abgerufen oder zurückgesetzt werden.
+ Erstellt eine Sicherheitsgruppe für die Verzeichniscontroller. Die Sicherheitsgruppe muss die Kommunikation mit der DB-Instance von RDS für Db2 zulassen.
AWS Erstellt beim Start AWS Directory Service for Microsoft Active Directory eine Organisationseinheit (OU), die alle Objekte Ihres Verzeichnisses enthält. Diese OU erhält den NetBIOS-Namen, den Sie beim Erstellen des Verzeichnisses eingegeben haben, und befindet sich im Domänenstamm. Der Domänenstamm gehört und wird von verwaltet AWS.
Das `Admin` Konto, das mit Ihrem AWS Managed Microsoft AD Verzeichnis erstellt wurde, verfügt über Berechtigungen für die gängigsten Verwaltungsaktivitäten Ihrer Organisationseinheit:
+ Erstellen, Aktualisieren oder Löschen von Benutzern
+ Hinzufügen von Ressourcen zu Ihrer Domain, etwa Datei- oder Druckserver, und anschließendes Gewähren der zugehörigen Ressourcenberechtigungen für Benutzer in der OU
+ Erstellen Sie zusätzliche OUs Container.
+ Delegieren von Befugnissen.
+ Wiederherstellen von gelöschten Objekten aus dem Active Directory-Papierkorb.
+ Ausführen der Module von Active Directory und Domain Name Service (DNS) für Windows PowerShell auf dem Directory Service.
Das `Admin`-Konto hat auch die Berechtigung, die folgenden domänenweiten Aktivitäten durchzuführen:
+ Verwalten von DNS-Konfigurationen (Hinzufügen, Entfernen oder Aktualisieren von Datensätzen, Zonen und Weiterleitungen).
+ Aufrufen von DNS-Ereignisprotokollen.
+ Anzeigen von Sicherheitsereignisprotokollen.
**Um ein Verzeichnis zu erstellen mit AWS Managed Microsoft AD**
1. Melden Sie sich bei an AWS-Managementkonsole und öffnen Sie die Directory Service Konsole unter [https://console.aws.amazon.com/directoryservicev2/](https://console.aws.amazon.com/directoryservicev2/).
1. Wählen Sie **Verzeichnis einrichten**.
1. Wähle **AWS Managed Microsoft AD**. AWS Managed Microsoft AD ist die einzige Option, die derzeit für die Verwendung mit Amazon RDS unterstützt wird.
1. Wählen Sie ******Weiter****** aus.
1. Geben Sie auf der Seite ******Enter directory information (Verzeichnisinformationen eingeben)****** die folgenden Informationen ein:
+ **Edition** – Wählen Sie die Edition aus, die Ihre Anforderungen erfüllt.
+ **DNS-Name des Verzeichnisses**** – **Der vollständig qualifizierte Namen für das Verzeichnis, z. B. `corp.example.com`.
+ **NetBIOS-Name des Verzeichnisses**** – **Ein optionaler Kurzname für das Verzeichnis, z. B. `CORP`.
+ **Verzeichnisbeschreibung** – Eine optionale Beschreibung des Verzeichnisses.
+ **Administratorpasswort**** **– Das Passwort für den Verzeichnisadministrator. Während des Verzeichniserstellungsprozesses wird ein Administratorkonto mit dem Benutzernamen `Admin` und diesem Passwort angelegt.
Das Passwort für den Verzeichnisadministrator darf nicht das Wort "admin" enthalten. Beachten Sie beim Passwort die Groß- und Kleinschreibung und es muss 8 bis 64 Zeichen lang sein. Zudem muss es mindestens ein Zeichen aus dreien der vier folgenden Kategorien enthalten:
+ Kleinbuchstaben (a–z)
+ Großbuchstaben (A–Z)
+ Zahlen (0–9)
+ Nicht-alphanumerische Zeichen (\$1\$1@\$1\$1%^&\$1\$1-\$1=`\$1\$1()\$1\$1[]:;"'<>,.?/)
+ Passwort bestätigen – Geben Sie das Administratorpasswort erneut ein.
**Wichtig**
Stellen Sie sicher, dass Sie dieses Passwort speichern. Directory Service speichert dieses Passwort nicht und es kann nicht abgerufen oder zurückgesetzt werden.
1. Wählen Sie **Weiter** aus.
1. Geben Sie auf der Seite **Choose VPC and subnets (VPC und Subnetze wählen)** die folgenden Informationen an.
+ **VPC** – Wählen Sie die VPC für das Verzeichnis aus. Sie können die DB-Instance von RDS für Db2 in derselben VPC oder in einer anderen VPC erstellen.
+ **Subnetze** – Wählen Sie die Subnetze für die Verzeichnis-Server aus. Die beiden Subnetze müssen zu verschiedenen Availability-Zonen gehören.
1. Wählen Sie **Weiter** aus.
1. Überprüfen Sie die Verzeichnisinformationen. Wenn Änderungen erforderlich sind, klicken Sie auf **Previous (Zurück)** und nehmen Sie die Änderungen vor. Wenn die Informationen richtig sind, wählen Sie **Create directory (Verzeichnis erstellen)**.
![\[Das Fenster Überprüfen und erstellen während der Verzeichniserstellung in der Directory Service Konsole.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/db2-create-ADS-directory.png)
Es dauert einige Minuten, bis das Verzeichnis erstellt wurde. Wenn es erfolgreich erstellt wurde, ändert sich der Wert **Status** in **Active (Aktiv)**.
Um Informationen über das Verzeichnis anzuzeigen, wählen Sie die Verzeichnis-ID unter **Verzeichnis-ID** aus. Notieren Sie sich den Wert **Directory ID**. Sie benötigen diesen Wert, wenn Sie die DB-Instance von RDS für Db2 erstellen oder modifizieren.
![\[Der Abschnitt mit den Verzeichnisdetails mit der Verzeichnis-ID in der Directory Service Konsole.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/db2-ADS-directory-details.png)
## Schritt 2: Erstellen einer Vertrauensstellung
Wenn Sie nur AWS Managed Microsoft AD verwenden möchten, fahren Sie mit fort[Schritt 3: Erstellen Sie eine IAM-Rolle, auf die Amazon RDS zugreifen kann Directory Service](#db2-kerberos-setting-up-create-iam-role).
Um die Kerberos-Authentifizierung mithilfe Ihres selbstverwalteten Active Directory zu aktivieren, müssen Sie eine Gesamtstruktur-Vertrauensstellung zwischen Ihrem selbstverwalteten Active Directory und dem einrichten. Eine Gesamtvertrauensstellung ist eine Vertrauensstellung zwischen einem Microsoft AD und einem selbstverwalteten Active Directory, das im vorherigen Schritt AWS Managed Microsoft AD erstellt wurde. Die Vertrauensstellung kann auch bidirektional erfolgen, wobei beide Active Directories einander vertrauen. Weitere Informationen zum Einrichten von Gesamtvertrauensstellungen mithilfe Directory Service von finden Sie unter [Wann sollte eine Vertrauensstellung erstellt](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_tutorial_setup_trust.html) werden? im *AWS Directory Service Administration Guide*.
## Schritt 3: Erstellen Sie eine IAM-Rolle, auf die Amazon RDS zugreifen kann Directory Service
Damit Amazon RDS Directory Service für Sie anrufen kann, AWS-Konto benötigen Sie eine IAM-Rolle, die die verwaltete IAM-Richtlinie verwendet. `AmazonRDSDirectoryServiceAccess` Diese Rolle ermöglicht es Amazon RDS, Aufrufe an Directory Service durchzuführen.
Wenn Sie mit dem eine DB-Instance erstellen AWS-Managementkonsole und Ihr Konsolen-Benutzerkonto über die `iam:CreateRole` entsprechende Berechtigung verfügt, erstellt die Konsole automatisch die benötigte IAM-Rolle. In diesem Fall lautet der Rollenname `rds-directoryservice-kerberos-access-role`. Andernfalls müssen Sie die IAM-Rolle manuell erstellen. Wenn Sie diese IAM-Rolle erstellen`Directory Service`, wählen Sie die AWS verwaltete Richtlinie aus und hängen Sie `AmazonRDSDirectoryServiceAccess` sie an.
Weitere Informationen zum Erstellen von IAM-Rollen für einen Dienst finden Sie unter [Erstellen einer Rolle zum Delegieren von Berechtigungen an einen AWS Dienst](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) im *IAM-Benutzerhandbuch*.
**Anmerkung**
Die für die Windows-Authentifizierung für RDS für Microsoft SQL Server verwendete IAM-Rolle kann nicht für RDS für Db2 verwendet werden.
Alternativ können Sie Richtlinien mit den erforderlichen Berechtigungen erstellen, anstatt die verwaltete Richtlinie `AmazonRDSDirectoryServiceAccess` zu verwenden. In diesem Fall muss die IAM-Rolle die folgende IAM-Vertrauensrichtlinie haben:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": [
"directoryservice.rds.amazonaws.com",
"rds.amazonaws.com"
]
},
"Action": "sts:AssumeRole"
}
]
}
```
------
Die Rolle muss auch über die folgende IAM-Rollenrichtlinie verfügen:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"ds:DescribeDirectories",
"ds:AuthorizeApplication",
"ds:UnauthorizeApplication",
"ds:GetAuthorizedApplicationDetails"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
```
------
## Schritt 4: Anlegen und Konfigurieren von Benutzern
Sie können das Tool Active Directory Users and Computers zum Erstellen von Benutzern verwenden. Dies ist eines der Active Directory Domain Services- und Active Directory Lightweight Directory Services-Tools. Weitere Informationen finden Sie unter [Add Users and Computers to the Active Directory domain](https://learn.microsoft.com/en-us/troubleshoot/windows-server/identity/create-an-active-directory-server#add-users-and-computers-to-the-active-directory-domain) in der Microsoft-Dokumentation. In diesem Fall handelt es sich bei Benutzern um Einzelpersonen oder andere Entitäten, z. B. um ihre Computer, die Teil der Domain sind und deren Identitäten im Verzeichnis verwaltet werden.
Um Benutzer in einem Directory Service Verzeichnis zu erstellen, müssen Sie mit einer Windows basierten Amazon EC2 EC2-Instance verbunden sein, die Mitglied des Directory Service Verzeichnisses ist. Gleichzeitig müssen Sie als Benutzer angemeldet sein, der über Berechtigungen zum Erstellen von Benutzern verfügt. Weitere Informationen finden Sie unter [Erstellen eines Benutzers](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_manage_users_groups_create_user.html) im *AWS Directory Service Administration Guide*.
## Schritt 5: Erstellen Sie eine Administratorgruppe für RDS für Db2 in AWS Managed Microsoft AD
RDS für Db2 unterstützt keine Kerberos-Authentifizierung für den Hauptbenutzer oder die beiden reservierten Amazon-RDS-Benutzer `rdsdb` und `rdsadmin`. Stattdessen müssen Sie eine neue Gruppe namens `masterdba` in AWS Managed Microsoft AD erstellen. Weitere Informationen finden Sie unter [Create a Group Account in Active Directory](https://learn.microsoft.com/en-us/windows/security/operating-system-security/network-security/windows-firewall/create-a-group-account-in-active-directory) in der Microsoft-Dokumentation. Alle Benutzer, die Sie zu dieser Gruppe hinzufügen, verfügen über Hauptbenutzerberechtigungen.
Nachdem Sie die Kerberos-Authentifizierung aktiviert haben, verliert der Hauptbenutzer die Rolle `masterdba`. Infolgedessen kann der Hauptbenutzer nicht auf die Mitgliedschaft in der lokalen Benutzergruppe der Instance zugreifen, es sei denn, Sie deaktivieren die Kerberos-Authentifizierung. Um weiterhin die Anmeldung mit Hauptbenutzer und Passwort zu verwenden, erstellen Sie einen Benutzer auf AWS Managed Microsoft AD mit demselben Namen dem des Hauptbenutzers. Fügen Sie diesen Benutzer dann zur Gruppe `masterdba` hinzu.
## Schritt 6: Ändern des DB-Parameters
Wenn Sie AWS Managed Microsoft AD nur verwenden möchten, fahren Sie mit fort[Schritt 7: Erstellen oder Ändern einer DB-Instance von RDS für Db2Schritt 7: Erstellen oder Ändern einer DB-Instance](#db2-kerberos-setting-up-create-modify).
Um die Kerberos-Authentifizierung mit Ihrem selbstverwalteten Active Directory zu aktivieren, müssen Sie den Parameter `rds.active_directory_configuration` in Ihrer Parametergruppe auf `AWS_MANAGED_AD_WITH_TRUST` festlegen. Standardmäßig ist dieser Parameter auf Nur `AWS_MANAGED_AD` für die Verwendung von AWS Managed Microsoft AD festgelegt.
Weitere Informationen zum Ändern von DB-Parametern finden Sie unter [Ändern der Parameter in Parametergruppen](db2-supported-parameters.md#db2-modifying-parameter-group-parameters).
## Schritt 7: Erstellen oder Ändern einer DB-Instance von RDS für Db2
Erstellen oder ändern Sie eine DB-Instance von RDS für Db2 für die Verwendung mit Ihrem Verzeichnis. Sie können die AWS-Managementkonsole, die AWS CLI oder die RDS-API verwenden, um eine DB-Instance einem Verzeichnis zuzuordnen. Sie können dafür eine der folgenden Möglichkeiten auswählen:
+ Erstellen Sie eine neue DB-Instance von RDS für Db2 mit der Konsole, dem Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) oder der RDS-API-Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html). Detaillierte Anweisungen finden Sie unter [Erstellen einer Amazon-RDS-DB-Instance](USER_CreateDBInstance.md).
+ Ändern Sie eine vorhandene RDS for Db2-DB-Instance mithilfe der Konsole, des [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html)Befehls oder der Operation [Modify DBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) API. Detaillierte Anweisungen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md).
+ Stellen Sie eine DB-Instance von RDS für Db2 aus einem DB-Snapshot über die Konsole, den Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-db-snapshot.html) oder die API-Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html) wieder her. Detaillierte Anweisungen finden Sie unter [Wiederherstellen auf eine DB-Instance](USER_RestoreFromSnapshot.md).
+ Stellen Sie eine RDS for Db2-DB-Instance point-in-time mithilfe der Konsole, des [https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-to-point-in-time.html](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-to-point-in-time.html)Befehls oder der [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html)API-Operation wieder her. Detaillierte Anweisungen finden Sie unter [Wiederherstellen einer DB-Instance auf einen bestimmten Zeitpunkt für Amazon RDS](USER_PIT.md).
Die Kerberos-Authentifizierung wird nur für DB-Instances von RDS für Db2 in einer VPC unterstützt. Die DB-Instance kann sich in derselben VPC wie das Verzeichnis oder in einer anderen VPC befinden. Die DB-Instance muss eine Sicherheitsgruppe verwenden, die eingehenden und ausgehenden Datenverkehr innerhalb der VPC des Verzeichnisses ermöglicht, damit die DB-Instance mit dem Verzeichnis kommunizieren kann.
### Konsole
Wenn Sie die Konsole verwenden, um eine DB-Instance zu erstellen, zu ändern oder wiederherzustellen, wählen Sie im Abschnitt **Datenbank-Authentifizierung** die Option **Passwort- und Kerberos-Authentifizierung** aus. Dann wählen Sie **Verzeichnis durchsuchen**. Wählen Sie das Verzeichnis aus oder wählen Sie **Verzeichnis erstellen**, um den Directory Service zu verwenden.
![\[Der Abschnitt Datenbank-Authentifizierung mit der Passwort- und Kerberos-Authentifizierung, die in der Amazon-RDS-Konsole ausgewählt wurde.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/db2-database-authentication-directory.png)
### AWS CLI
Wenn Sie den verwenden AWS CLI, sind die folgenden Parameter erforderlich, damit die DB-Instance das von Ihnen erstellte Verzeichnis verwenden kann:
+ Für den Parameter `--domain` verwenden Sie die Domain-Kennung („`d-*`“-Kennung), der beim Erstellen des Verzeichnisses generiert wurde.
+ Verwenden Sie für den `--domain-iam-role-name`-Parameter die von Ihnen erstellte Rolle, die die verwaltete IAM-Richtlinie `AmazonRDSDirectoryServiceAccess` verwendet.
Das folgende Beispiel ändert eine DB-Instance zur Verwendung eines Verzeichnisses. Ersetzen Sie im Beispiel die folgenden Platzhalter mit Ihren eigenen Werten:
+ *db\$1instance\$1name*— Der Name Ihrer RDS for Db2-DB-Instance.
+ *directory\$1id*— Die ID des AWS Directory Service for Microsoft Active Directory Verzeichnisses, das Sie erstellt haben.
+ *role\$1name*— Der Name der IAM-Rolle, die Sie erstellt haben.
```
aws rds modify-db-instance --db-instance-identifier db_instance_name --domain d-directory_id --domain-iam-role-name role_name
```
**Wichtig**
Wenn Sie eine DB-Instance zur Aktivierung der Kerberos-Authentifizierung ändern, starten Sie die DB-Instance neu, nachdem Sie die Änderung vorgenommen haben.
## Schritt 8: Rufen Sie die Active Directory-Gruppen-SID ab in PowerShell
Eine Sicherheits-ID (SID) wird verwendet, um einen Sicherheitsprinzipal oder eine Sicherheitsgruppe eindeutig zu identifizieren. Wenn eine Sicherheitsgruppe oder ein Konto in Active Directory erstellt wird, weist Active Directory der Gruppe eine SID zu. Um die SID der AD-Sicherheitsgruppe aus Active Directory abzurufen, verwenden Sie das cmdlet `Get-ADGroup` auf einem Windows-Client-Computer, der Teil der Active-Directory-Domain ist. Der Parameter `Identity` gibt den Namen der Active-Directory-Gruppe an, für die Sie die SID benötigen.
Im folgenden Beispiel wird die SID der Active-Directory-Gruppe `adgroup1` zurückgegeben.
```
C:\Users\Admin> Get-ADGroup -Identity adgroup1 | select SID
SID
-----------------------------------------------
S-1-5-21-3168537779-1985441202-1799118680-1612
```
Sie müssen diese Zuordnung für alle Gruppen generieren, die für die Datenbank relevant sind.
## Schritt 9: Fügen Sie SID zu GroupName Zuordnungen zu Ihrer RDS for Db2-DB-Instance hinzu
Sie müssen die SID zu den im vorherigen Schritt erstellten GroupName Zuordnungen zu Ihrer RDS for Db2-DB-Instance hinzufügen. Rufen Sie für jede Zuordnung die folgende gespeicherte Prozedur auf. Ersetzen Sie das *SID* und durch Ihre *group\$1name* eigenen Informationen.
```
db2 connect to rdsadmin
db2 "call rdsadmin.set_sid_group_mapping(?, 'SID','group_name')"
```
Weitere Informationen finden Sie unter [rdsadmin.set\$1sid\$1group\$1mapping](db2-sp-granting-revoking-privileges.md#db2-sp-set-sid-group-mapping).
Weitere Informationen zum Überprüfen des Aufgabenstatus finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
## Schritt 10: Konfigurieren eines Db2-Clients
**So konfigurieren Sie einen Db2-Client**
1. Erstellen Sie eine **/etc/krb5.conf**-Datei (oder eine vergleichbare Datei), um auf die Domain zu verweisen.
**Anmerkung**
Erstellen Sie für Windows-Betriebssysteme eine **C:\$1windows\$1krb5.ini**-Datei.
1. Stellen Sie sicher, dass der Datenverkehr zwischen dem Client-Host und fließen kann Directory Service. Verwenden Sie ein Netzwerk-Dienstprogramm wie Netcat für die folgenden Aufgaben:
1. Überprüfen Sie den Datenverkehr über DNS für Port 53.
1. Überprüfen Sie den Datenverkehr TCP/UDP für Port 53 und fürKerberos, einschließlich der Ports 88 und 464 für Directory Service.
1. Stellen Sie sicher, dass der Datenverkehr zwischen dem Client-Host und der DB-Instance über den Datenbank-Port fließen kann. Sie können den Befehl `db2` verwenden, um eine Verbindung herzustellen und auf die Datenbank zuzugreifen.
Das folgende Beispiel ist der Inhalt der Datei /etc/krb5.conf für: AWS Managed Microsoft AD
```
[libdefaults]
default_realm = EXAMPLE.COM
[realms]
EXAMPLE.COM = {
kdc = example.com
admin_server = example.com
}
[domain_realm]
.example.com = EXAMPLE.COM
example.com = EXAMPLE.COM
```
# Herstellen einer Verbindung zu Amazon RDS für Db2 mit Kerberos-Authentifizierung
Verwenden Sie die folgende Vorgehensweise, um eine Verbindung zu Ihrer DB-Instance von Amazon RDS für Db2 mit Kerberos-Authentifizierung herzustellen.
**So stellen Sie eine Verbindung zu RDS für Db2 mit Kerberos-Authentifizierung her**
1. Führen Sie an einer Eingabeaufforderung den folgenden -Befehl aus. Im folgenden Beispiel ersetzen Sie es *username* durch Ihren Microsoft Active Directory Benutzernamen.
```
kinit username
```
1. Wenn die DB-Instance von RDS für Db2 eine öffentlich zugängliche VPC verwendet, fügen Sie die IP-Adresse für Ihren DB-Instance-Endpunkt zu Ihrer `/etc/hosts`-Datei auf dem Amazon-EC2-Client hinzu. Das folgenden Beispiel ruft die IP-Adresse ab und fügt sie dann zur `/etc/hosts`-Datei hinzu.
```
% dig +short Db2-endpoint.AWS-Region.rds.amazonaws.com
;; Truncated, retrying in TCP mode.
ec2-34-210-197-118.AWS-Region.compute.amazonaws.com.
34.210.197.118
% echo "34.210.197.118 Db2-endpoint.AWS-Region.rds.amazonaws.com" >> /etc/hosts
```
1. Verwenden Sie den folgenden Befehl, um sich bei einer DB-Instance von RDS für Db2 anzumelden, die mit Active Directory verknüpft ist. *database\$1name*Ersetzen Sie durch den Namen Ihrer RDS for Db2-Datenbank.
```
db2 connect to database_name
```
# Verwalten Ihrer DB-Instance von Amazon RDS für Db2
Dieses Thema behandelt die häufigsten Verwaltungsaufgaben, die Sie mit einer DB-Instance von Amazon RDS für Db2 ausführen. Einige Aufgaben sind für alle DB-Instances von Amazon RDS gleich. Andere Aufgaben sind spezifisch für RDS für Db2.
Die folgenden Aufgaben sind für alle RDS-Datenbanken gleich. Es gibt auch spezielle Aufgaben für RDS für Db2, z. B. die Verbindung zu einer Datenbank von RDS für Db2 mit einem Standard-SQL-Client.
| Aufgabenbereich | Relevante Dokumentation |
| --- | --- |
| **Instance-Klassen, Speicher und PIOPS** Wenn Sie eine Produktionsinstance erstellen, erfahren Sie, wie Instance-Klassen, Speichertypen und bereitgestellte IOPS in Amazon RDS funktionieren. | [](Concepts.DBInstanceClass.md) [Amazon-RDS-Speichertypen](CHAP_Storage.md#Concepts.Storage) |
| **Multi-AZ-Bereitstellungen** Bei einer DB-Instance für die Produktion sollten Multi-AZ-Bereitstellungen eingesetzt werden. Multi-AZ-Bereitstellungen bieten eine erhöhte Verfügbarkeit, eine längere Lebensdauer von Daten sowie eine höhere Fehlertoleranz für DB-Instances. | [Konfigurieren und Verwalten einer Multi-AZ-Bereitstellung für Amazon RDS](Concepts.MultiAZ.md) |
| **Amazon VPC** Wenn Sie AWS-Konto über eine standardmäßige Virtual Private Cloud (VPC) verfügen, wird Ihre DB-Instance automatisch in der Standard-VPC erstellt. Wenn Ihr Konto über keine Standard-VPC verfügt und Sie die DB-Instance in einer VPC erstellen möchten, müssen Sie zunächst die VPC und Subnetz-Gruppen erstellen. | [Arbeiten mit einer DB-Instance in einer VPC](USER_VPC.WorkingWithRDSInstanceinaVPC.md) |
| **Sicherheitsgruppen** Standardmäßig verwenden DB-Instances eine Firewall, die den Zugriff verhindert. Stellen Sie sicher, dass Sie eine Sicherheitsgruppe mit den korrekten IP-Adressen und Netzwerkkonfigurationen erstellen, um auf die DB-Instance zugreifen zu können. | [Zugriffskontrolle mit Sicherheitsgruppen](Overview.RDSSecurityGroups.md) |
| **Parametergruppen** Da Ihre DB-Instance von RDS für Db2 erfordert, dass Sie die Parameter `rds.ibm_customer_id` und `rds.ibm_site_id` hinzufügen, erstellen Sie vor der DB-Instance eine Parametergruppe. Wenn Ihre DB-Instance weitere spezifische Datenbankparameter erfordert, fügen Sie diese ebenfalls zu dieser Parametergruppe hinzu, bevor Sie die DB-Instance erstellen. | [Hinzufügen IBM IDs zu einer Parametergruppe für RDS für Db2-DB-Instances](db2-licensing.md#db2-licensing-options-byol-adding-ids) [Parametergruppen für Amazon RDS](USER_WorkingWithParamGroups.md) |
| **Optionsgruppen** Wenn Ihre DB-Instance bestimmte Datenbankoptionen erfordert, erstellen Sie eine Optionsgruppe, bevor Sie die DB-Instance erstellen. | [Optionen für DB-Instances von Amazon RDS für Db2](Db2.Options.md) |
| **Herstellen einer Verbindung mit einer DB-Instance** Nachdem Sie eine Sicherheitsgruppe erstellt und diese einer DB-Instance zugeordnet haben, können Sie mithilfe einer beliebigen standardmäßigen SQL-Client-Anwendung wie IBM Db2 CLP eine Verbindung mit dieser DB-Instance herstellen. | [Herstellen einer Verbindung mit Ihrer Db2-DB-Instance](USER_ConnectToDb2DBInstance.md) |
| **Backup und Wiederherstellung** Sie können Ihre DB-Instance so konfigurieren, dass sie automatische Speicher-Backups oder manuelle Speicher-Snapshots vornimmt. Aus diesen Backups oder Snapshots können Sie dann Instances wiederherstellen. | [Sichern, Wiederherstellen und Exportieren von Daten](CHAP_CommonTasks.BackupRestore.md) |
| **Überwachung** Sie können eine DB-Instance von RDS für Db2 mit IBM Db2 Data Management Console überwachen. Sie können eine RDS for Db2-DB-Instance auch mithilfe von CloudWatch Amazon RDS-Metriken, Ereignissen und erweiterter Überwachung überwachen. | [Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md) [Anzeigen von Metriken in der Amazon-RDS-Konsole](USER_Monitoring.md) [Anzeigen von Amazon-RDS-Ereignissen](USER_ListEvents.md) [Überwachen von Betriebssystem-Metriken mithilfe von „Enhanced Monitoring“·(Erweiterte·Überwachung)](USER_Monitoring.OS.md) |
| **Protokolldateien** Sie können auf die Protokolldateien für Ihre DB-Instance von RDS für Db2 zugreifen. | [Überwachen von Amazon RDS-Protokolldateien](USER_LogAccess.md) |
**Topics**
+ [Ausführen allgemeiner Systemaufgaben für DB-Instances von Amazon RDS für Db2](db2-performing-common-system-tasks-db-instances.md)
+ [Ausführen allgemeiner Datenbank-Aufgaben für DB-Instances von Amazon RDS für Db2](db2-performing-common-database-tasks-db-instances.md)
# Ausführen allgemeiner Systemaufgaben für DB-Instances von Amazon RDS für Db2
Sie können bestimmte allgemeine Datenbankadministrator-Aufgaben durchführen, die mit dem System auf Ihren DB-Instances von Amazon RDS zusammenhängen, die Db2 ausführen. Um eine verwaltete Service-Erfahrung zu bieten, stellt Amazon RDS keinen Shell-Zugriff zu DB-Instances bereit und beschränkt den Zugriff auf bestimmte Systemprozeduren und -tabellen, die erweiterte Sonderrechte erfordern.
Informationen zum Gewähren und Widerrufen von Berechtigungen und zum Anhängen an die Remote-Datenbank für RDS für Db2 finden Sie in den folgenden Themen.
**Topics**
+ [Gewähren und Widerrufen von Berechtigungen für RDS für Db2](db2-granting-revoking-privileges.md)
+ [Anfügen an die Remote-DB-Instance von RDS für Db2](db2-attaching-to-remote.md)
## Erstellen eines benutzerdefinierten Datenbank-Endpunkts
Wenn Sie zu Amazon RDS for Db2 migrieren, können Sie einen benutzerdefinierten Datenbank-Endpunkt verwenden, URLs um Änderungen an Ihrer Anwendung zu minimieren. Wenn Sie beispielsweise `db2.example.com` als Ihren aktuellen DNS-Eintrag verwenden, können Sie ihn zu Amazon Route 53 hinzufügen. In Route 53 können Sie private gehostete Zonen verwenden, um Ihren aktuellen DNS-Datenbankendpunkt einem Datenbankendpunkt von RDS für Db2 zuzuordnen. Informationen zum Hinzufügen eines benutzerdefinierten `A`- oder `CNAME`-Datensatzes für einen Datenbankendpunkt von Amazon RDS finden Sie unter [Registrierung und Management von Domains mit Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar.html) im *Entwicklerhandbuch zu Amazon Route 53*.
**Anmerkung**
Wenn Sie Ihre Domain nicht auf Route 53 übertragen können, können Sie Ihren DNS-Anbieter verwenden, um einen `CNAME`-Eintrag für die Datenbankendpunkt-URL von RDS für Db2 zu erstellen. Schlagen Sie dazu in der Dokumentation Ihres DNS-Anbieters nach.
# Gewähren und Widerrufen von Berechtigungen für RDS für Db2
Benutzer erhalten Zugriff auf Datenbanken, wenn sie Mitglied von Gruppen sind, die Datenbanken zugeordnet sind.
Gehen Sie wie folgt vor, um Berechtigungen zu gewähren oder zu widerrufen und somit den Zugriff auf Ihre Datenbank zu steuern.
Bei diesen Verfahren wird IBM Db2 CLP auf einem lokalen Computer verwendet, um eine Verbindung zu einer DB-Instance von RDS für Db2 herzustellen. Achten Sie darauf, den TCPIP-Knoten und die Datenbank zu katalogisieren, um eine Verbindung zu Ihrer DB-Instance von RDS für Db2 herzustellen, die auf Ihrem lokalen Computer ausgeführt wird. Weitere Informationen finden Sie unter [Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit IBM Db2 CLP](db2-connecting-with-clp-client.md).
**Topics**
+ [Gewähren von Benutzerzugriff auf Ihre Datenbank](#db2-granting-user-access)
+ [Ändern des Passworts eines Benutzers](#db2-changing-user-password)
+ [Hinzufügen von Gruppen zu einem Benutzer](#db2-adding-group-to-user)
+ [Entfernen von Gruppen von einem Benutzer](#db2-removing-groups-from-user)
+ [Entfernen eines Benutzers](#db2-removing-user)
+ [Auflisten von Benutzern](#db2-listing-users-database)
+ [Erstellen einer Rolle](#db2-creating-role)
+ [Gewähren einer Rolle](#db2-granting-role)
+ [Widerrufen einer Rolle](#db2-revoking-role)
+ [Entfernen einer Rolle](#db2-dropping-role)
+ [Gewähren einer Datenbankautorisierung](#db2-granting-dbadmin-auth)
+ [Widerrufen der Datenbankautorisierung](#db2-revoking-dbadmin-auth)
## Gewähren von Benutzerzugriff auf Ihre Datenbank
**So gewähren Sie einem Benutzer Zugriff auf Ihre Datenbank**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. 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 Ausgabe dieses Befehls sieht etwa so aus:
```
Database Connection Information
Database server = DB2/LINUXX8664 11.5.8.0
SQL authorization ID = ADMIN
Local database alias = RDSADMIN
```
1. Fügen Sie Ihrer Autorisierungsliste einen Benutzer hinzu, indem Sie `rdsadmin.add_user` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.add\$1user](db2-sp-granting-revoking-privileges.md#db2-sp-add-user).
```
db2 "call rdsadmin.add_user(
'username',
'password',
'group_name,group_name')"
```
1. (Optional) Fügen Sie dem Benutzer weitere Gruppen hinzu, indem Sie `rdsadmin.add_groups` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.add\$1groups](db2-sp-granting-revoking-privileges.md#db2-sp-add-groups).
```
db2 "call rdsadmin.add_groups(
'username',
'group_name,group_name')"
```
1. Bestätigen Sie die Berechtigungen, die dem Benutzer zur Verfügung stehen. Ersetzen Sie im folgenden Beispiel *rds\$1database\$1alias**master\$1user*, und *master\$1password* durch Ihre eigenen Informationen. Ersetzen Sie es auch *username* durch den Benutzernamen des Benutzers.
```
db2 terminate
db2 connect to rds_database_alias user master_user using master_password
db2 "SELECT SUBSTR(AUTHORITY,1,20) AUTHORITY, D_USER, D_GROUP, D_PUBLIC
FROM TABLE (SYSPROC.AUTH_LIST_AUTHORITIES_FOR_AUTHID ('username', 'U') ) AS T
ORDER BY AUTHORITY"
```
Die Ausgabe dieses Befehls sieht etwa so aus:
```
AUTHORITY D_USER D_GROUP D_PUBLIC
-------------------- ------ ------- --------
ACCESSCTRL N N N
BINDADD N N N
CONNECT N N N
CREATETAB N N N
CREATE_EXTERNAL_ROUT N N N
CREATE_NOT_FENCED_RO N N N
CREATE_SECURE_OBJECT N N N
DATAACCESS N N N
DBADM N N N
EXPLAIN N N N
IMPLICIT_SCHEMA N N N
LOAD N N N
QUIESCE_CONNECT N N N
SECADM N N N
SQLADM N N N
SYSADM * N *
SYSCTRL * N *
SYSMAINT * N *
SYSMON * N *
WLMADM N N N
```
1. Gewähren Sie der Gruppe, zu der Sie den Benutzer hinzugefügt haben, die Rollen `ROLE_NULLID_PACKAGES`, `ROLE_TABLESPACES` und `ROLE_PROCEDURES` von RDS für Db2. Weitere Informationen finden Sie unter [Standardrollen in Amazon RDS für Db2](db2-default-roles.md).
**Anmerkung**
Wir erstellen DB-Instances von RDS für Db2 im `RESTRICTIVE`-Modus. Daher gewähren die Rollen `ROLE_NULLID_PACKAGES`, `ROLE_TABLESPACES` und `ROLE_PROCEDURES` von RDS für Db2 Ausführungsberechtigungen für `NULLID`-Pakete für IBM Db2 CLP und Dynamic SQL. Diese Rollen gewähren auch Benutzerberechtigungen für Tablespaces.
1. Stellen Sie eine Verbindung zu Ihrer Db2-Datenbank her. Ersetzen Sie im folgenden Beispiel *database\$1name**master\$1user*, und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to database_name user master_user using master_password
```
1. Gewähren Sie einer Gruppe die Rolle `ROLE_NULLED_PACKAGES`. Ersetzen Sie im folgenden Beispiel *group\$1name* durch den Namen der Gruppe, zu der Sie die Rolle hinzufügen möchten.
```
db2 "grant role ROLE_NULLID_PACKAGES to group group_name"
```
1. Gewähren Sie derselben Gruppe die Rolle `ROLE_TABLESPACES`. Im folgenden Beispiel *group\$1name* ersetzen Sie es durch den Namen der Gruppe, zu der Sie die Rolle hinzufügen möchten.
```
db2 "grant role ROLE_TABLESPACES to group group_name"
```
1. Gewähren Sie derselben Gruppe die Rolle `ROLE_PROCEDURES`. Im folgenden Beispiel *group\$1name* ersetzen Sie es durch den Namen der Gruppe, zu der Sie die Rolle hinzufügen möchten.
```
db2 "grant role ROLE_PROCEDURES to group group_name"
```
1. Gewähren Sie der Gruppe, zu der Sie den Benutzer hinzugefügt haben, die Berechtigungen `connect`, `bindadd`, `createtab` und `IMPLICIT_SCHEMA`. Im folgenden Beispiel *group\$1name* ersetzen Sie es durch den Namen der zweiten Gruppe, zu der Sie den Benutzer hinzugefügt haben.
```
db2 "grant usage on workload SYSDEFAULTUSERWORKLOAD to public"
db2 "grant connect, bindadd, createtab, implicit_schema on database to group group_name"
```
1. Wiederholen Sie Schritt 4–6 für jede weitere Gruppe, zu der Sie den Benutzer hinzugefügt haben.
1. Testen Sie den Zugriff des Benutzers, indem Sie als Benutzer eine Verbindung herstellen, eine Tabelle erstellen, Werte in die Tabelle einfügen und Daten aus der Tabelle zurückgeben. Ersetzen Sie im folgenden Beispiel *rds\$1database\$1alias**username*, und *password* durch den Namen der Datenbank sowie den Benutzernamen und das Passwort des Benutzers.
```
db2 connect to rds_database_alias user username using password
db2 "create table t1(c1 int not null)"
db2 "insert into t1 values (1),(2),(3),(4)"
db2 "select * from t1"
```
## Ändern des Passworts eines Benutzers
**So ändern Sie das Passwort eines Benutzers**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Ändern Sie das Passwort, indem Sie `rdsadmin.change_password` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.change\$1password](db2-sp-granting-revoking-privileges.md#db2-sp-change-password).
```
db2 "call rdsadmin.change_password(
'username',
'new_password')"
```
## Hinzufügen von Gruppen zu einem Benutzer
**So fügen Sie Gruppen zu einem Benutzer hinzu**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Fügen Sie einem Benutzer Gruppen hinzu, indem Sie `rdsadmin.add_groups` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.add\$1groups](db2-sp-granting-revoking-privileges.md#db2-sp-add-groups).
```
db2 "call rdsadmin.add_groups(
'username',
'group_name,group_name')"
```
## Entfernen von Gruppen von einem Benutzer
**So entfernen Sie Gruppen von einem Benutzer**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Entfernen Sie Gruppen, indem Sie `rdsadmin.remove_groups` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.remove\$1groups](db2-sp-granting-revoking-privileges.md#db2-sp-remove-groups).
```
db2 "call rdsadmin.remove_groups(
'username',
'group_name,group_name')"
```
## Entfernen eines Benutzers
**So entfernen Sie einen Benutzer aus der Autorisierungsliste**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Entfernen Sie einen Benutzer aus Ihrer Autorisierungsliste, indem Sie `rdsadmin.remove_user` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.remove\$1user](db2-sp-granting-revoking-privileges.md#db2-sp-remove-user).
```
db2 "call rdsadmin.remove_user('username')"
```
## Auflisten von Benutzern
Rufen Sie die gespeicherte Prozedur `rdsadmin.list_users` auf, um Benutzer in einer Autorisierungsliste aufzulisten. Weitere Informationen finden Sie unter [rdsadmin.list\$1users](db2-sp-granting-revoking-privileges.md#db2-sp-list-users).
```
db2 "call rdsadmin.list_users()"
```
## Erstellen einer Rolle
Sie können die gespeicherte Prozedur [rdsadmin.create\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-create-role) verwenden, um eine Rolle zu erstellen.
**So erstellen Sie eine Rolle**
1. Stellen Sie eine Verbindung zur Datenbank `rdsadmin` her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Stellen Sie Db2 für die Ausgabe von Inhalten ein.
```
db2 set serveroutput on
```
1. Erstellen Sie eine Rolle. Weitere Informationen finden Sie unter [rdsadmin.create\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-create-role).
```
db2 "call rdsadmin.create_role(
'database_name',
'role_name')"
```
1. Stellen Sie Db2 so ein, dass kein Inhalt ausgegeben wird.
```
db2 set serveroutput off
```
## Gewähren einer Rolle
Sie können die gespeicherte Prozedur [rdsadmin.grant\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-grant-role) verwenden, um einer Rolle, einem Benutzer oder einer Gruppe eine Rolle zuzuweisen.
**So weisen Sie eine Rolle zu**
1. Stellen Sie eine Verbindung zur Datenbank `rdsadmin` her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Stellen Sie Db2 für die Ausgabe von Inhalten ein.
```
db2 set serveroutput on
```
1. Weisen Sie eine Rolle zu. Weitere Informationen finden Sie unter [rdsadmin.grant\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-grant-role).
```
db2 "call rdsadmin.grant_role(
'database_name',
'role_name',
'grantee',
'admin_option')"
```
1. Stellen Sie Db2 so ein, dass kein Inhalt ausgegeben wird.
```
db2 set serveroutput off
```
## Widerrufen einer Rolle
Sie können die gespeicherte Prozedur [rdsadmin.revoke\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-revoke-role) verwenden, um eine Rolle für eine Rolle, einen Benutzer oder eine Gruppe zu widerrufen.
**So widerrufen Sie eine Rolle**
1. Stellen Sie eine Verbindung zur Datenbank `rdsadmin` her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Widerrufen Sie eine Rolle. Weitere Informationen finden Sie unter [rdsadmin.revoke\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-revoke-role).
```
db2 "call rdsadmin.revoke_role(
?,
'database_name',
'role_name',
'grantee')"
```
## Entfernen einer Rolle
Sie können die gespeicherte Prozedur [rdsadmin.drop\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-drop-role) verwenden, um eine Rolle zu entfernen.
**So entfernen Sie eine Rolle**
1. Stellen Sie eine Verbindung zur Datenbank `rdsadmin` her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Entfernen Sie eine Rolle. Weitere Informationen finden Sie unter [rdsadmin.drop\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-drop-role).
```
db2 "call rdsadmin.drop_role(
?,
'database_name',
'role_name')"
```
## Gewähren einer Datenbankautorisierung
Der Hauptbenutzer, der über eine `DBADM`-Autorisierung verfügt, kann einer Rolle, einem Benutzer oder einer Gruppe die Berechtigung `DBADM`, `ACCESSCTRL` oder `DATAACCESS` gewähren.
**So gewähren Sie eine Datenbankautorisierung**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Gewähren Sie einem Benutzer Zugriff, indem Sie `rdsadmin.dbadm_grant` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.dbadm\$1grant](db2-sp-granting-revoking-privileges.md#db2-sp-dbadm-grant).
```
db2 "call rdsadmin.dbadm_grant(
?,
'database_name,
'authorization',
'grantee')"
```
**Beispiel für einen Anwendungsfall**
Das folgende Verfahren führt Sie durch das Erstellen einer Rolle, das Gewähren der Berechtigung `DBADM` für die Rolle, das Zuweisen der Rolle zu einem Benutzer und das Gewähren der Rolle für eine Gruppe.
****
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Erstellen Sie eine Rolle namens `PROD_ROLE` für eine Datenbank namens `TESTDB`. Weitere Informationen finden Sie unter [rdsadmin.create\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-create-role).
```
db2 "call rdsadmin.create_role(
'TESTDB',
'PROD_ROLE')"
```
1. Weisen Sie die Rolle dann einem Benutzer namens `PROD_USER` zu. `PROD_USER` erhält die Administratorberechtigung zur Zuweisung von Rollen. Weitere Informationen finden Sie unter [rdsadmin.grant\$1role](db2-sp-granting-revoking-privileges.md#db2-sp-grant-role).
```
db2 "call rdsadmin.grant_role(
?,
'TESTDB',
'PROD_ROLE',
'USER PROD_USER',
'Y')"
```
1. (Optional) Geben Sie zusätzliche Autorisierungen oder Berechtigungen ein. Im folgenden Beispiel wird einer Rolle namens `PROD_ROLE` die Berechtigung `DBADM` für die Datenbank `FUNDPROD` gewährt. Weitere Informationen finden Sie unter [rdsadmin.dbadm\$1grant](db2-sp-granting-revoking-privileges.md#db2-sp-dbadm-grant).
```
db2 "call rdsadmin.dbadm_grant(
?,
'FUNDPROD',
'DBADM',
'ROLE PROD_ROLE')"
```
1. Beenden Sie Ihre Sitzung.
```
db2 terminate
```
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `TESTDB`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to TESTDB user master_username using master_password
```
1. Fügen Sie der Rolle weitere Autorisierungen hinzu.
```
db2 "grant connect, implicit_schema on database to role PROD_ROLE"
```
1. Gewähren Sie einer Gruppe die Rolle `PROD_ROLE`.
```
db2 "grant role PROD_ROLE to group PRODGRP"
```
Benutzer, die der Gruppe `PRODGRP` angehören, können jetzt Aktionen wie das Herstellen einer Verbindung zur Datenbank `TESTDB`, das Erstellen von Tabellen oder das Erstellen von Schemas ausführen.
## Widerrufen der Datenbankautorisierung
Der Hauptbenutzer, der über eine `DBADM`-Autorisierung verfügt, kann einer Rolle, einem Benutzer oder einer Gruppe die Berechtigung `DBADM`, `ACCESSCTRL` oder `DATAACCESS` entziehen.
**So widerrufen Sie die Datenbankautorisierung**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Widerrufen Sie den Benutzerzugriff, indem Sie `rdsadmin.dbadm_revoke` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.dbadm\$1revoke](db2-sp-granting-revoking-privileges.md#db2-sp-dbadm-revoke).
```
db2 "call rdsadmin.dbadm_revoke(
?,
'database_name,
'authorization',
'grantee')"
```
# Anfügen an die Remote-DB-Instance von RDS für Db2
Gehen Sie wie folgt vor, um Elemente an Ihre Remote-DB-Instance von RDS für Db2 anzufügen und `get snapshot`-Vorgänge auszuführen.
**So fügen Sie Elemente an die Remote-DB-Instance von RDS für Db2 an**
1. Führen einer clientseitigen IBM Db2 CLP-Sitzung aus. Informationen zur Katalogisierung Ihrer DB-Instance und Datenbank von RDS für Db2 finden Sie unter [Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit IBM Db2 CLP](db2-connecting-with-clp-client.md). Notieren Sie sich den Hauptbenutzernamen und das Hauptpasswort für Ihre DB-Instance von RDS für Db2.
1. Fügen Sie Elemente an die DB-Instance von RDS für DB2 an. Ersetzen Sie im folgenden Beispiel *node\$1name**master\$1username*, und *master\$1password* durch den TCPIP-Knotennamen, den Sie katalogisiert haben, sowie den Master-Benutzernamen und das Master-Passwort für Ihre RDS for Db2-DB-Instance.
```
db2 attach to node_name user master_username using master_password
```
Nachdem Sie die Anbindung an die Remote-DB-Instance von RDS für Db2 durchgeführt haben, können Sie die folgenden Befehle und andere `get snapshot`-Befehle ausführen. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [GET SNAPSHOT command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-get-snapshot).
```
db2 list applications
db2 get snapshot for all databases
db2 get snapshot for database manager
db2 get snapshot for all applications
```
# Ausführen allgemeiner Datenbank-Aufgaben für DB-Instances von Amazon RDS für Db2
Sie können bestimmte allgemeine DBA-Aufgaben durchführen, die mit den Datenbanken auf Ihren DB-Instances von Amazon RDS für Db2 zusammenhängen. Um eine verwaltete Service-Erfahrung zu bieten, ermöglicht Amazon RDS keinen Shell-Zugriff auf DB-Instances. Außerdem kann der Hauptbenutzer keine Befehle oder Dienstprogramme ausführen, für die `SYSADM`-, `SYSMAINT`- oder `SYSCTRL`-Berechtigungen erforderlich sind.
Weitere Informationen zu allgemeinen Aufgaben für Pufferpools, Datenbanken und Tablespaces finden Sie in den folgenden Themen.
**Topics**
+ [Allgemeine Aufgaben für Pufferpools](db2-managing-buffer-pools.md)
+ [Häufige Aufgaben in Bezug auf Datenbanken](db2-managing-databases.md)
+ [Häufige Aufgaben in Bezug auf Tablespaces](db2-managing-tablespaces.md)
# Allgemeine Aufgaben für Pufferpools
Sie können Pufferpools für eine Datenbank von RDS für Db2 erstellen, ändern oder entfernen. Das Erstellen, Ändern oder Entfernen von Pufferpools erfordert eine höhere `SYSADM`- oder `SYSCTRL`-Autoritätsebene, die dem Hauptbenutzer nicht zur Verfügung steht. Verwenden Sie stattdessen gespeicherte Amazon-RDS-Prozeduren.
Sie können Pufferpools auch leeren.
**Topics**
+ [Erstellen eines Pufferpools](#db2-creating-buffer-pool)
+ [Ändern eines Pufferpools](#db2-altering-buffer-pool)
+ [Entfernen eines Pufferpools](#db2-dropping-buffer-pool)
+ [Leeren der Pufferpools](#db2-flushing-buffer-pools)
## Erstellen eines Pufferpools
Rufen Sie die gespeicherte Prozedur `rdsadmin.create_bufferpool` auf, um einen Pufferpool für Ihre Datenbank von RDS für Db2 zu erstellen. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [CREATE BUFFERPOOL statement](https://www.ibm.com/docs/en/db2/11.5?topic=statements-create-bufferpool).
**So erstellen Sie einen Pufferpool**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Erstellen Sie einen Pufferpool, indem Sie `rdsadmin.create_bufferpool` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.create\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-create-buffer-pool).
```
db2 "call rdsadmin.create_bufferpool(
'database_name',
'buffer_pool_name',
buffer_pool_size,
'immediate',
'automatic',
page_size,
number_block_pages,
block_size)"
```
## Ändern eines Pufferpools
Rufen Sie die gespeicherte Prozedur `rdsadmin.alter_bufferpool` auf, um einen Pufferpool für Ihre Datenbank von RDS für Db2 zu ändern. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [ALTER BUFFERPOOL statement](https://www.ibm.com/docs/en/db2/11.5?topic=statements-alter-bufferpool).
**So ändern Sie einen Pufferpool**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Ändern Sie einen Pufferpool, indem Sie `rdsadmin.alter_bufferpool` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.alter\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-alter-buffer-pool).
```
db2 "call rdsadmin.alter_bufferpool(
'database_name',
'buffer_pool_name',
buffer_pool_size,
'immediate',
'automatic',
change_number_blocks,
number_block_pages,
block_size)"
```
## Entfernen eines Pufferpools
Rufen Sie die gespeicherte Prozedur `rdsadmin.drop_bufferpool` auf, um einen Pufferpool für Ihre Datenbank von RDS für Db2 zu entfernen. Weitere Informationen finden Sie unter [Dropping buffer pools](https://www.ibm.com/docs/en/db2/11.5?topic=pools-dropping-buffer) in der IBM Db2-Dokumentation.
**Wichtig**
Stellen Sie sicher, dass dem Pufferpool, den Sie entfernen möchten, keine Tablespaces zugewiesen sind.
**So entfernen Sie einen Pufferpool**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Entfernen Sie einen Pufferpool, indem Sie `rdsadmin.drop_bufferpool` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.drop\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-drop-buffer-pool).
```
db2 "call rdsadmin.drop_bufferpool(
'database_name',
'buffer_pool_name')"
```
## Leeren der Pufferpools
Sie können die Pufferpools leeren, um einen Prüfpoint zu erzwingen, sodass RDS für Db2 Seiten aus dem Arbeitsspeicher in den Speicher schreibt.
**Anmerkung**
Sie müssen die Pufferpools nicht leeren. Db2 schreibt Protokolle synchron, bevor es Transaktionen bestätigt. Die modifizierten Seiten befinden sich möglicherweise noch in einem Pufferpool, aber Db2 schreibt sie asynchron in den Speicher. Selbst wenn das System unerwartet heruntergefahren wird, führt Db2 beim Neustart der Datenbank automatisch eine Wiederherstellung nach einem Absturz durch. Während der Wiederherstellung nach einem Absturz schreibt Db2 festgeschriebene Änderungen in die Datenbank oder macht Änderungen für nicht festgeschriebene Transaktionen rückgängig.
**So leeren Sie die Pufferpools**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zu Ihrer Db2-Datenbank her. Ersetzen Sie im folgenden Beispiel *rds\$1database\$1alias*, *master\$1username* und *master\$1password* durch Ihre Informationen.
```
db2 connect to rds_database_alias user master_username using master_password
```
1. Leeren Sie die Pufferpools.
```
db2 flush bufferpools all
```
# Häufige Aufgaben in Bezug auf Datenbanken
Sie können Datenbanken auf Ihrer DB-Instance von RDS für Db2 erstellen, löschen oder wiederherstellen. Das Erstellen, Löschen oder Wiederherstellen von Datenbanken erfordert eine höhere `SYSADM`-Autoritätsebene, die dem Hauptbenutzer nicht zur Verfügung steht. Verwenden Sie stattdessen gespeicherte Amazon-RDS-Prozeduren.
Sie können auch allgemeine Verwaltungsaufgaben wie Überwachung, Wartung und Erfassung von Informationen über Ihre Datenbanken ausführen.
**Topics**
+ [Erstellen einer Datenbank](#db2-creating-database)
+ [Konfigurieren von Einstellungen für eine Datenbank](#db2-configuring-database)
+ [Ändern von Datenbankparametern](#db2-modifying-db-parameters)
+ [Konfigurieren der Aufbewahrung von Protokollen](#db2-configuring-log-retention)
+ [Auflisten von Protokollinformationen](#db2-listing-log-information)
+ [Verwenden Sie eine fein abgestufte Zugriffskontrolle (FGAC)](#db2-using-fine-grained-access-control)
+ [Deaktivieren einer Datenbank](#db2-deactivating-database)
+ [Aktivieren einer Datenbank](#db2-activating-database)
+ [Reaktivieren einer Datenbank](#db2-reactivating-database)
+ [Löschen einer Datenbank.](#db2-dropping-database)
+ [Sichern einer Datenbank](#db2-backing-up-database)
+ [Archivprotokolle nach Amazon S3 kopieren](#db2-copying-archive-logs-to-s3)
+ [Wiederherstellen einer Datenbank](#db2-restoring-database)
+ [Auflisten von Datenbanken](#db2-listing-databases)
+ [Sammeln von Informationen zu Datenbanken](#db2-collecting-info-db)
+ [Erzwingen, dass Anwendungen von Datenbanken entfernt werden](#db2-forcing-application-off-db)
+ [Generieren von Leistungsberichten](#db2-generating-performance-reports)
## Erstellen einer Datenbank
Rufen Sie die gespeicherte Prozedur `rdsadmin.create_database` auf, um eine Datenbank auf Ihrer DB-Instance von RDS für Db2 zu erstellen. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [CREATE DATABASE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-create-database).
**Anmerkung**
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).
**So erstellen Sie eine Datenbank**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Erstellen Sie eine Datenbank, indem Sie `rdsadmin.create_database` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).
```
db2 "call rdsadmin.create_database(
'database_name',
'database_page_size',
'database_code_set',
'database_territory',
'database_collation',
'database_autoconfigure_str',
'database_non-restrictive')"
```
1. (Optional) Erstellen Sie weitere Datenbanken, indem Sie für jede Datenbank, die Sie erstellen möchten, `rdsadmin.create_database` aufrufen. Jede Db2-DB-Instance kann bis zu 50 Datenbanken enthalten. Weitere Informationen finden Sie unter [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).
```
db2 "call rdsadmin.create_database('database_name')"
```
1. (Optional) Vergewissern Sie sich, dass Ihre Datenbank mithilfe einer der folgenden Methoden erstellt wurde:
+ Rufen Sie die Seite `rdsadmin.list_databases` auf. Weitere Informationen finden Sie unter [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases).
+ Führen Sie den folgenden SQL-Befehl aus:
```
db2 "select varchar(r.task_type,25) as task_type, r.database_name,
varchar(r.lifecycle,15) as lifecycle, r.created_at, r.database_name,
varchar(bson_to_json(task_input_params),256) as input_params,
varchar(r.task_output,1024) as task_output
from table(rdsadmin.get_task_status(null,null,'create_database'))
as r order by created_at desc"
```
## Konfigurieren von Einstellungen für eine Datenbank
Rufen Sie die gespeicherte Prozedur `rdsadmin.set_configuration` auf, um die Einstellungen für eine Datenbank auf Ihrer DB-Instance von RDS für Db2 zu konfigurieren. Sie könnten beispielsweise die Anzahl der Puffer oder Puffermanipulatoren konfigurieren, die während eines Wiederherstellungsvorgangs erstellt werden sollen.
**So konfigurieren Sie die Einstellungen für eine Datenbank**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. (Optional) Überprüfen Sie Ihre aktuellen Konfigurationseinstellungen, indem Sie `rdsadmin.show_configuration` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.show\$1configuration](db2-sp-managing-databases.md#db2-sp-show-configuration).
```
db2 "call rdsadmin.show_configuration('name')"
```
1. Konfigurieren Sie die Einstellungen für die Datenbank, indem Sie `rdsadmin.set_configuration` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.set\$1configuration](db2-sp-managing-databases.md#db2-sp-set-configuration).
```
db2 "call rdsadmin.set_configuration(
'name',
'value')"
```
## Ändern von Datenbankparametern
In Amazon RDS für Db2 werden drei Typen von Parametern verwendet: Konfigurationsparameter für den Datenbankmanager, Registrierungsvariablen und Datenbankkonfigurationsparameter. Sie können die ersten beiden Typen mithilfe der Parametergruppen und den letzten Typ mithilfe der gespeicherten Prozedur [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param) aktualisieren.
**Anmerkung**
Sie können nur die Werte vorhandener Parameter ändern. Sie können keine neuen Parameter hinzufügen, die RDS für Db2 nicht unterstützt.
Weitere Informationen zu diesen Parametern und zur Änderung ihrer Werte finden Sie unter [Parameter von Amazon RDS für Db2](db2-supported-parameters.md).
## Konfigurieren der Aufbewahrung von Protokollen
Rufen Sie die gespeicherte Prozedur `rdsadmin.set_archive_log_retention` auf, um zu konfigurieren, wie lange Amazon RDS Protokolldateien für Ihre Datenbank von RDS für Db2 aufbewahrt.
**So konfigurieren die Aufbewahrung von Protokollen für eine Datenbank**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. (Optional) Überprüfen Sie Ihre aktuelle Konfiguration für die Aufbewahrung von Protokollen, indem Sie`rdsadmin.show_archive_log_retention` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.show\$1archive\$1log\$1retention](db2-sp-managing-databases.md#db2-sp-show-archive-log-retention).
```
db2 "call rdsadmin.show_archive_log_retention(
?,
'database_name')"
```
1. Konfigurieren Sie die Aufbewahrung von Protokollen für die Datenbank, indem Sie `rdsadmin.set_archive_log_retention` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.set\$1archive\$1log\$1retention](db2-sp-managing-databases.md#db2-sp-set-archive-log-retention).
```
db2 "call rdsadmin.set_archive_log_retention(
?,
'database_name',
'archive_log_retention_hours')"
```
## Auflisten von Protokollinformationen
Rufen Sie die gespeicherte Prozedur `rdsadmin.list_archive_log_information` auf, um Details zu Archivprotokolldateien aufzulisten, einschließlich Angaben zur genutzten Gesamtspeichergröße.
**So listen Sie Protokollinformationen für eine Datenbank auf**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Erhalten Sie eine Liste mit Informationen zu Protokolldateien, indem Sie `rdsadmin.list_archive_log_information` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.list\$1archive\$1log\$1information](db2-sp-managing-databases.md#db2-sp-list-archive-log-information).
```
db2 "call rdsadmin.list_archive_log_information(
?,
'database_name')"
```
## Verwenden Sie eine fein abgestufte Zugriffskontrolle (FGAC)
Rufen Sie die gespeicherte Prozedur auf, um den Zugriff auf Tabellendaten in einer Datenbank auf einer RDS for Db2-DB-Instance mithilfe detaillierter Zugriffskontrollbefehle zu steuern. `rdsadmin.fgac_command` Möglicherweise möchten Sie FGAC verwenden, um den Zugriff auf Daten auf der Grundlage von Benutzerrollen oder Datenattributen zu beschränken. Sie könnten beispielsweise den Zugriff auf Gesundheitsdaten von Patienten auf der Grundlage der Art der Daten oder auf bestimmte medizinische Leistungserbringer einschränken.
**Um den Zugriff auf Tabellendaten in einer Datenbank mithilfe einer detaillierten Zugriffskontrolle zu steuern**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Führen Sie verschiedene detaillierte Befehle zur Zugriffskontrolle aus, indem Sie aufrufen. `rdsadmin.fgac_command` Weitere Informationen finden Sie unter [rdsadmin.fgac\$1commandParameters](db2-sp-managing-databases.md#db2-sp-fgac-command).
```
db2 "call rdsadmin.fgac_command(
?,
'database_name',
'fgac_command')"
```
## Deaktivieren einer Datenbank
Rufen Sie die gespeicherte Prozedur `rdsadmin.deactivate_database` auf, um eine Datenbank auf Ihrer DB-Instance von RDS für Db2 zu deaktivieren.
Standardmäßig aktiviert Amazon RDS die Datenbank, wenn Sie sie auf Ihrer DB-Instance von RDS für Db2 erstellen. Sie können selten verwendete Datenbanken deaktivieren, um Speicherressourcen zu schonen.
**So deaktivieren Sie eine Datenbank**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Deaktivieren Sie eine Datenbank, indem Sie `rdsadmin.deactivate_database` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.deactivate\$1database](db2-sp-managing-databases.md#db2-sp-deactivate-database).
```
db2 "call rdsadmin.deactivate_database(
?,
'database_name')"
```
## Aktivieren einer Datenbank
Rufen Sie die gespeicherte Prozedur `rdsadmin.activate_database` auf, um eine Datenbank auf einer eigenständigen DB-Instance von RDS für Db2 zu aktivieren.
Standardmäßig aktiviert Amazon RDS die Datenbank, wenn Sie sie auf Ihrer DB-Instance von RDS für Db2 erstellen. Sie können selten verwendete Datenbanken deaktivieren, um Speicherressourcen zu schonen, und eine deaktivierte Datenbank später wieder aktivieren.
**So aktivieren Sie eine Datenbank**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Aktivieren Sie eine Datenbank, indem Sie `rdsadmin.activate_database` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.activate\$1database](db2-sp-managing-databases.md#db2-sp-activate-database).
```
db2 "call rdsadmin.activate_database(
?,
'database_name')"
```
## Reaktivieren einer Datenbank
Rufen Sie die gespeicherte Prozedur `rdsadmin.reactivate_database` auf, um eine Datenbank auf einer replizierten Quell-DB-Instance von RDS für Db2 zu reaktivieren. 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.
Sie können diese gespeicherte Prozedur auch aufrufen, um eine Datenbank auf einer eigenständigen DB-Instance von RDS für Db2 zu reaktivieren, nachdem Sie Änderungen an den Datenbankkonfigurationen vorgenommen haben. Oder Sie könnten eine Datenbank auf einer eigenständigen DB-Instance von RDS für Db2 reaktivieren, indem Sie zuerst die gespeicherte Prozedur `rdsadmin.deactivate_database` und dann die gespeicherte Prozedur `rdsadmin.activate_database` aufrufen. Weitere Informationen erhalten Sie unter [Deaktivieren einer Datenbank](#db2-deactivating-database) und [Aktivieren einer Datenbank](#db2-activating-database).
**So reaktivieren Sie eine Datenbank**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Reaktivieren Sie eine Datenbank, indem Sie `rdsadmin.reactivate_database` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.reactivate\$1database](db2-sp-managing-databases.md#db2-sp-reactivate-database).
```
db2 "call rdsadmin.reactivate_database(
?,
'database_name')"
```
## Löschen einer Datenbank.
Rufen Sie die gespeicherte Prozedur `rdsadmin.drop_database` auf, um eine Datenbank von Ihrer DB-Instance von RDS für Db2 zu löschen. Weitere Informationen finden Sie unter [Löschen von Datenbanken](https://www.ibm.com/docs/en/db2/11.5?topic=databases-dropping) in der IBM Db2-Dokumentation.
**Anmerkung**
Sie können eine Datenbank nur dann durch Aufrufen der gespeicherten Prozedur löschen, wenn bestimmte Bedingungen erfüllt sind. Weitere Informationen erhalten Sie unter [Nutzungshinweise](db2-sp-managing-databases.md#db2-sp-drop-database-usage-notes) für `rdsadmin.drop_database`.
**So löschen Sie eine Datenbank**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Löschen Sie eine Datenbank, indem Sie `rdsadmin.drop_database` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database).
```
db2 "call rdsadmin.drop_database('database_name')"
```
## Sichern einer Datenbank
Rufen Sie die `rdsadmin.backup_database` gespeicherte Prozedur auf, um eine Datenbank in Ihrer RDS for Db2-DB-Instance in Amazon S3 zu sichern. Weitere Informationen finden Sie in der IBM Db2 Dokumentation unter [dem Befehl BACKUP DATABASE](https://www.ibm.com/docs/en/db2/11.5.x?topic=commands-backup-database).
**Anmerkung**
Diese gespeicherte Prozedur verwendet die Integration mit Amazon S3. Stellen Sie sicher, dass Sie die Integration konfiguriert haben, bevor Sie fortfahren. Weitere Informationen finden Sie unter [Integration einer DB-Instance von Amazon RDS für Db2 mit Amazon S3](db2-s3-integration.md).
**Um eine Datenbank zu sichern**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Erstellen Sie einen VPC-Gateway-Endpunkt für S3. Wenn Sie bereits einen VPC-Gateway-Endpunkt für S3 haben, fahren Sie mit Schritt 4 fort.
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 finden Sie unter [Schritt 1: Erstellen eines VPC-Gateway-Endpunkts für Amazon S3](db2-troubleshooting.md#db2-creating-endpoint).
1. Bestätigen Sie den VPC-Gateway-Endpunkt für S3. Weitere Informationen finden Sie unter [Schritt 2: Überprüfen, ob der VPC-Gateway-Endpunkt für Amazon S3 vorhanden ist](db2-troubleshooting.md#db2-confirming-endpoint).
1. Sichern Sie eine Datenbank, indem Sie anrufen`rdsadmin.backup_database`. Weitere Informationen finden Sie unter [rdsadmin.backup\$1database](db2-sp-managing-databases.md#db2-sp-backup-database).
```
db2 "call rdsadmin.backup_database(
?,
'database_name',
's3_bucket_name',
's3_prefix',
'backup_type',
'compression_option',
'util_impact_priority',
'num_files',
'parallelism',
'num_buffers')"
```
1. Beenden Sie Ihre Verbindung.
```
terminate
```
1. (Optional) Vergewissern Sie sich, dass die Sicherungsdateien in Ihren Amazon S3 S3-Bucket unter hochgeladen wurden*s3\$1prefix/dbi\$1resource\$1id/db\$1name*. Wenn die Dateien nicht unter angezeigt werden*s3\$1prefix/dbi\$1resource\$1id/db\$1name*, überprüfen Sie den Status der Sicherung Ihrer Datenbank, um Probleme zu identifizieren. Weitere Informationen finden Sie unter [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). Wenn Sie identifizierte Probleme nicht lösen können, wenden Sie sich an den [AWS Support](https://aws.amazon.com/premiumsupport/).
1. (Optional) Nach Abschluss der Sicherung auf Amazon S3 können Sie die Sicherung auf einer RDS for Db2-DB-Instance oder an einem anderen Ort, z. B. einem lokalen Server, wiederherstellen. Informationen zur Wiederherstellung auf einer RDS for Db2-DB-Instance finden Sie unter. [Wiederherstellen einer Datenbank](#db2-restoring-database)
## Archivprotokolle nach Amazon S3 kopieren
Db2-Archivprotokolle können jetzt von Ihrer RDS for Db2-DB-Instance nach Amazon S3 kopiert werden. Die Archivprotokolle `rdsadmin.backup_database` können in Kombination mit dem nativen Backup, das mit erstellt wurde, verwendet werden, um die Datenbank auf einer anderen RDS für Db2-Instance oder EC2-Datenbank wiederherzustellen und zu einem bestimmten Zeitpunkt weiterzuleiten.
Bevor Sie diese Funktion konfigurieren, verwenden Sie die gespeicherte Prozedur, `rdsadmin.backup_database` um RDS für die Db2-Datenbank einzurichten.
Diese Funktion funktioniert auf der DB-Instance-Ebene von RDS for Db2, obwohl das Kopieren von Archivprotokollen pro Datenbank aktiviert oder deaktiviert werden kann.
**So konfigurieren Sie das Kopieren von Archivprotokollen nach Amazon S3**
1. Stellen Sie mithilfe des Master-Benutzernamens und des Master-Passworts für Ihre RDS for Db2-DB-Instance eine Connect zur `rdsadmin` Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Richten Sie die Sicherung des Archivprotokolls auf S3 ein, indem Sie aufrufen[rdsadmin.set\$1configuration](db2-sp-managing-databases.md#db2-sp-set-configuration).
```
db2 "call rdsadmin.set_configuration(
'name',
'value')"
```
**Beispiel:**
```
db2 "call rdsadmin.set_configuration('ARCHIVE_LOG_COPY_TARGET_S3_ARN', 'arn:aws:s3:::my_rds_db2_backups/archive-log-copy/')"
```
1. Aktivieren Sie das Kopieren von Archivprotokollen für eine Datenbank, indem Sie aufrufen`rdsadmin.enable_archive_log_copy`. *database\$1name*Ersetzen Sie es durch Ihren Datenbanknamen.
```
db2 "call rdsadmin.enable_archive_log_copy(?, 'database_name')"
```
1. Rufen Sie auf ähnliche Weise auf, um das Kopieren von Archivprotokollen für eine Datenbank zu deaktivieren`rdsadmin.disable_archive_log_copy`.
```
db2 "call rdsadmin.disable_archive_log_copy(?, 'database_name')"
```
1. Bestätigen Sie den Status des Kopierens des Archivprotokolls, indem Sie anrufen`rdsadmin.list_databases`.
```
db2 "select * from table(rdsadmin.list_databases())"
```
**Beispielausgabe:**
```
DATABASE_NAME CREATE_TIME DATABASE_UNIQUE_ID ARCHIVE_LOG_RETENTION_HOURS ARCHIVE_LOG_COPY ARCHIVE_LOG_LAST_UPLOAD_FILE ARCHIVE_LOG_LAST_UPLOAD_FILE_TIME ARCHIVE_LOG_COPY_STATUS
--------------- -------------------------- -------------------------------------------------- --------------------------- ---------------- ---------------------------- --------------------------------- ------------------------------
RDSADMIN 2026-01-06-02.03.42.569069 RDSADMIN 0 DISABLED - - -
FOO 2026-01-06-02.13.42.885650 F0D81C7E-7213-4565-B376-4F33FCF420E3 7 ENABLED S0006536.LOG 2026-01-28-19.15.10.000000 UPLOADING
CODEP 2026-01-14-19.42.42.508476 106EEF95-6E30-4FFF-85AE-B044352DF095 0 DISABLED - - -
...
```
## Wiederherstellen einer Datenbank
Rufen Sie die gespeicherte Prozedur `rdsadmin.restore_database` auf, um eine Datenbank aus einem Amazon-S3-Bucket in Ihre DB-Instance von RDS für Db2 zu verschieben. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [RESTORE DATABASE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-restore-database).
**So stellen Sie eine Datenbank wieder her**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. (Optional) Überprüfen Sie Ihre aktuellen Konfigurationseinstellungen, um den Wiederherstellungsvorgang zu optimieren, indem Sie `rdsadmin.show_configuration` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.show\$1configuration](db2-sp-managing-databases.md#db2-sp-show-configuration).
```
db2 "call rdsadmin.show_configuration('name')"
```
1. Konfigurieren Sie die Einstellungen, um den Wiederherstellungsvorgang zu optimieren, indem Sie `rdsadmin.set_configuration` aufrufen. Das explizite Festlegen dieser Werte kann beim Wiederherstellen von Datenbanken mit großen Datenmengen die Leistung verbessern. Weitere Informationen finden Sie unter [rdsadmin.set\$1configuration](db2-sp-managing-databases.md#db2-sp-set-configuration).
```
db2 "call rdsadmin.set_configuration(
'name',
'value')"
```
1. Stellen Sie die Datenbank wieder her, indem Sie `rdsadmin.restore_database` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database).
```
db2 "call rdsadmin.restore_database(
?,
'database_name',
's3_bucket_name',
's3_prefix',
restore_timestamp,
'backup_type')"
```
1. (Optional) Vergewissern Sie sich, dass Ihre Datenbank wiederhergestellt wurde, indem Sie `rdsadmin.list_databases` aufrufen und überprüfen, ob die wiederhergestellte Datenbank aufgeführt ist. Weitere Informationen finden Sie unter [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases).
1. Schalten Sie die Datenbank wieder online und wenden Sie zusätzliche Transaktionsprotokolle an, indem Sie `rdsadmin.rollforward_database` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.rollforward\$1database](db2-sp-managing-databases.md#db2-sp-rollforward-database).
```
db2 "call rdsadmin.rollforward_database(
?,
'database_name',
's3_bucket_name',
s3_prefix,
'rollforward_to_option',
'complete_rollforward')"
```
1. (Optional) Überprüfen Sie den Status der gespeicherten Prozedur `rdsadmin.rollforward_database`, indem Sie die gespeicherte Prozedur [rdsadmin.rollforward\$1status](db2-sp-managing-databases.md#db2-sp-rollforward-status) aufrufen.
1. Wenn Sie `complete_rollforward` im vorherigen Schritt auf `FALSE` gesetzt haben, müssen Sie die Datenbank abschließend online schalten, indem Sie `rdsadmin.complete_rollforward` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.complete\$1rollforward](db2-sp-managing-databases.md#db2-sp-complete-rollforward).
```
db2 "call rdsadmin.complete_rollforward(
?,
'database_name')"
```
1. (Optional) Überprüfen Sie den Status der gespeicherten Prozedur `rdsadmin.complete_rollforward`, indem Sie die gespeicherte Prozedur [rdsadmin.rollforward\$1status](db2-sp-managing-databases.md#db2-sp-rollforward-status) aufrufen.
## Auflisten von Datenbanken
Sie können alle Datenbanken auflisten, die auf Amazon RDS für Db2 ausgeführt werden, indem Sie die benutzerdefinierte Funktion `rdsadmin.list_databases` aufrufen.
**So listen Sie Ihre Datenbanken auf**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Listen Sie Ihre Datenbanken auf, indem Sie `rdsadmin.list_databases` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases).
```
db2 "select * from table(rdsadmin.list_databases())"
```
## Sammeln von Informationen zu Datenbanken
Rufen Sie die gespeicherte Prozedur `rdsadmin.db2pd_command` auf, um Informationen über eine Datenbank auf einer DB-Instance von RDS für Db2 zu sammeln. Diese Informationen können Ihnen bei der Überwachung Ihrer Datenbanken oder bei der Behebung von Fehlern behilflich sein.
**So sammeln Sie Informationen zu einer Datenbank**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Sammeln Sie Informationen zur Datenbank, indem Sie `rdsadmin.db2pd_command` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.db2pd\$1command](db2-sp-managing-databases.md#db2-sp-db2pd-command).
```
db2 "call rdsadmin.db2pd_command('db2pd_cmd')"
```
## Erzwingen, dass Anwendungen von Datenbanken entfernt werden
Rufen Sie die gespeicherte Prozedur `rdsadmin.force_application` auf, um zu erzwingen, dass Anwendungen aus einer Datenbank auf Ihrer DB-Instance von RDS für Db2 entfernt werden. Bevor Sie Wartungsarbeiten an Ihren Datenbanken durchführen, erzwingen Sie, dass Anwendungen von Ihren Datenbanken entfernt werden.
**So erzwingen Sie, dass Anwendungen aus einer Datenbank entfernt werden**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Erzwingen Sie, dass Anwendungen aus einer Datenbank entfernt werden, indem Sie `rdsadmin.force_application` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.force\$1application](db2-sp-managing-databases.md#db2-sp-force-application).
```
db2 "call rdsadmin.force_application(
?,
'applications')"
```
## Generieren von Leistungsberichten
Sie können Leistungsberichte mithilfe einer Prozedur oder eines Skripts generieren. Informationen zur Verwendung einer Prozedur finden Sie in der IBM Db2-Dokumentation unter [DBSUMMARY procedure – Generate a summary report of system and application performance metrics](https://www.ibm.com/docs/en/db2/11.5?topic=mm-dbsummary-procedure-generate-summary-report-system-application-performance-metrics).
Das Verzeichnis `~sqllib/sample/perf` von Db2 umfasst eine `db2mon.sh`-Datei. Durch die Ausführung des Skripts wird ein kostengünstiger, umfangreicher SQL-Metrikbericht erstellt. Informationen zum Herunterladen der `db2mon.sh`-Datei und der zugehörigen Skriptdateien finden Sie im Verzeichnis [https://github.com/IBM/db2-samples/tree/master/perf](https://github.com/IBM/db2-samples/tree/master/perf) im IBM-GitHub-Repository db2-samples.
**So generieren Sie Leistungsberichte mithilfe des Skripts**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zu Ihrer Db2-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Erstellen Sie einen Pufferpool mit dem Namen `db2monbp` und einer Seitengröße von 4 096, indem Sie `rdsadmin.create_bufferpool` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.create\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-create-buffer-pool).
```
db2 "call rdsadmin.create_bufferpool('database_name','db2monbp',4096)"
```
1. Erstellen Sie einen temporären Tablespace mit dem Namen `db2montmptbsp`, der den `db2monbp`-Pufferpool verwendet, indem Sie `rdsadmin.create_tablespace` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.create\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-create-tablespace).
```
db2 "call rdsadmin.create_tablespace('database_name',\
'db2montmptbsp','db2monbp',4096,1000,100,'T')"
```
1. Öffnen Sie das Skript `db2mon.sh` und ändern Sie die Zeile, die sich auf die Verbindung zur Datenbank bezieht.
1. Entfernen Sie die folgende Zeile.
```
db2 -v connect to $dbName
```
1. Ersetzen Sie die Zeile im vorherigen Schritt durch die folgende Zeile. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch den Master-Benutzernamen und das Master-Passwort für Ihre RDS for Db2-DB-Instance.
```
db2 -v connect to $dbName user master_username using master_password
```
1. Entfernen Sie die folgenden Zeilen.
```
db2 -v create bufferpool db2monbp
db2 -v create user temporary tablespace db2montmptbsp bufferpool db2monbp
db2 -v drop tablespace db2montmptbsp
db2 -v drop bufferpool db2monbp
```
1. Führen Sie das Skript `db2mon.sh` aus, um in bestimmten Intervallen einen Bericht auszugeben. *absolute\$1path*Ersetzen Sie im folgenden Beispiel durch den vollständigen Pfad zur Skriptdatei, *rds\$1database\$1alias* durch den Namen Ihrer Datenbank und *seconds* durch die Anzahl der Sekunden (0 bis 3600) zwischen der Berichtsgenerierung.
```
absolute_path/db2mon.sh rds_database_alias seconds | tee -a db2mon.out
```
**Beispiele**
Das folgende Beispiel zeigt, dass sich die Skriptdatei im Verzeichnis `perf` unter dem Verzeichnis `home` befindet.
```
/home/db2inst1/sqllib/samples/perf/db2mon.sh rds_database_alias seconds | tee -a db2mon.out
```
1. Löschen Sie den Pufferpool und den Tablespace, die für die Datei `db2mon.sh` erstellt wurden. Ersetzen Sie im folgenden Beispiel und durch den Master-Benutzernamen *master\$1username* und *master\$1password* das Master-Passwort für Ihre RDS for Db2-DB-Instance. *database\$1name*Ersetzen Sie durch den Namen Ihrer Datenbank. Weitere Informationen erhalten Sie unter [rdsadmin.drop\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-drop-tablespace) und [rdsadmin.drop\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-drop-buffer-pool).
```
db2 connect to rdsadmin user master_username using master_password
db2 "call rdsadmin.drop_tablespace('database_name','db2montmptbsp')"
db2 "call rdsadmin.drop_bufferpool('database_name','db2monbp')"
```
## Verwalten des Speichers
Db2 verwendet automatischen Speicher, um den physischen Speicher für Datenbankobjekte wie Tabellen, Indizes und temporäre Dateien zu verwalten. Anstatt Speicherplatz manuell zuzuweisen und zu verfolgen, welche Speicherpfade verwendet werden, ermöglicht die automatische Speicherung dem Db2-System, Speicherpfade nach Bedarf zu erstellen und zu verwalten. Dies kann die Verwaltung von Db2-Datenbanken vereinfachen und die Wahrscheinlichkeit von Problemen aufgrund menschlicher Fehler verringern. Weitere Informationen finden Sie unter [Automatic storage](https://www.ibm.com/docs/en/db2/11.5?topic=overview-automatic-storage) in der IBM Db2-Dokumentation.
Mit RDS für Db2 können Sie die Speichergröße dynamisch erhöhen, indem Sie die logischen Volumes und das Dateisystem automatisch erweitern. Weitere Informationen finden Sie unter [Arbeiten mit Speicher für Amazon RDS-DB-Instances](USER_PIOPS.StorageTypes.md).
# Häufige Aufgaben in Bezug auf Tablespaces
Sie können Tablespaces für eine Datenbank von RDS für Db2 erstellen, ändern, umbenennen oder löschen. Das Erstellen, Ändern, Umbenennen oder Löschen von Tablespaces erfordert eine höhere `SYSADM`-Autoritätsebene, die dem Hauptbenutzer nicht zur Verfügung stehen. Verwenden Sie stattdessen gespeicherte Amazon-RDS-Prozeduren.
**Topics**
+ [Erstellen eines Tablespaces](#db2-creating-tablespace)
+ [Ändern eines Tablespaces](#db2-altering-tablespace)
+ [Umbenennen eines Tablespaces](#db2-renaming-tablespace)
+ [Löschen eines Tablespaces](#db2-dropping-tablespace)
+ [Prüfen des Status eines Tablespaces](#db2-checking-tablespaces-procedure)
+ [Generieren detaillierter Informationen zu Tablespaces](#db2-tablespaces-info-db2pd)
+ [Auflisten des Status und der Speichergruppe für einen Tablespace](#db2-state-storage-group-tablespace-sql)
+ [Auflisten der Tablespaces einer Tabelle](#db2-return-tablespaces-sql)
+ [Auflisten von Tablespace-Containern](#db2-listing-tablespace-containers)
## Erstellen eines Tablespaces
Rufen Sie die gespeicherte Prozedur `rdsadmin.create_tablespace` auf, um einen Tablespace für Ihre Datenbank von RDS für Db2 zu erstellen. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [CREATE TABLESPACE statement](https://www.ibm.com/docs/en/db2/11.5?topic=statements-create-tablespace).
**Wichtig**
Um einen Tablespace zu erstellen, müssen Sie über einen Pufferpool mit derselben Seitengröße verfügen, den Sie mit dem Tablespace verknüpfen können. Weitere Informationen finden Sie unter [Allgemeine Aufgaben für Pufferpools](db2-managing-buffer-pools.md).
**So erstellen Sie einen Tablespace**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Erstellen Sie einen Tablespace, indem Sie `rdsadmin.create_tablespace` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.create\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-create-tablespace).
```
db2 "call rdsadmin.create_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_initial_size,
tablespace_increase_size,
'tablespace_type')"
```
## Ändern eines Tablespaces
Rufen Sie die gespeicherte Prozedur `rdsadmin.alter_tablespace` auf, um einen Tablespace für Ihre Datenbank von RDS für Db2 zu ändern. Sie können diese gespeicherte Prozedur verwenden, um den Pufferpool eines Tablespaces zu ändern, die sogenannte „High Water Mark“ zu senken oder einen Tablespace online zu schalten. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [ALTER TABLESPACE statement](https://www.ibm.com/docs/en/db2/11.5?topic=statements-alter-tablespace).
**So ändern Sie einen Tablespace**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Ändern Sie einen Tablespace, indem Sie `rdsadmin.alter_tablespace` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.alter\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-alter-tablespace).
```
db2 "call rdsadmin.alter_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
buffer_pool_size,
tablespace_increase_size,
'max_size', 'reduce_max',
'reduce_stop',
'reduce_value',
'lower_high_water',
'lower_high_water_stop',
'switch_online')"
```
## Umbenennen eines Tablespaces
Rufen Sie die gespeicherte Prozedur `rdsadmin.rename_tablespace` auf, um den Namen eines Tablespaces für Ihre Datenbank von RDS für Db2 zu ändern. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [RENAME TABLESPACE statement](https://www.ibm.com/docs/en/db2/11.5?topic=statements-rename-tablespace).
**So benennen Sie einen Tablespaces um**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Benennen Sie einen Tablespace um, indem Sie `rdsadmin.rename_tablespace` aufrufen. Weitere Informationen, einschließlich der Einschränkungen, die für Tablespace-Namen gelten, finden Sie unter [rdsadmin.rename\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-rename-tablespace).
```
db2 "call rdsadmin.rename_tablespace(
'database_name',
'source_tablespace_name',
'target_tablespace_name')"
```
## Löschen eines Tablespaces
Rufen Sie die gespeicherte Prozedur `rdsadmin.drop_tablespace` auf, um einen Tablespace von Ihrer Datenbank von RDS für Db2 zu löschen. Bevor Sie einen Tablespace löschen, löschen Sie zunächst alle Objekte im Tablespace, z. B. Tabellen, Indizes oder große Objekte (). LOBs Weitere Informationen finden Sie unter [Löschen von Tablespaces](https://www.ibm.com/docs/en/db2/11.5?topic=spaces-dropping-table) in der IBM Db2-Dokumentation.
**So löschen Sie einen Tablespace**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und durch Ihre *master\$1password* eigenen Informationen.
```
db2 "connect to rdsadmin user master_username using master_password"
```
1. Löschen Sie einen Tablespace, indem Sie `rdsadmin.drop_tablespace` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.drop\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-drop-tablespace).
```
db2 "call rdsadmin.drop_tablespace(
'database_name',
'tablespace_name')"
```
## Prüfen des Status eines Tablespaces
Sie können den Status eines Tablespaces mithilfe der `cast`-Funktion überprüfen.
**So überprüfen Sie den Status eines Tablespaces**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zu Ihrer Db2-Datenbank her. Ersetzen Sie im folgenden Beispiel *rds\$1database\$1alias**master\$1username*, und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to rds_database_alias user master_username using master_password
```
1. Generieren Sie eine Ausgabe zur Übersicht.
Für eine Ausgabe zur Übersicht:
```
db2 "select cast(tbsp_id as smallint) as tbsp_id,
cast(tbsp_name as varchar(35)) as tbsp_name,
cast(tbsp_type as varchar(3)) as tbsp_type,
cast(tbsp_state as varchar(10)) as state,
cast(tbsp_content_type as varchar(8)) as contents from table(mon_get_tablespace(null,-1)) order by tbsp_id"
```
## Generieren detaillierter Informationen zu Tablespaces
Mithilfe der Funktion `cast` können Sie Informationen über einen Tablespace für ein Mitglied oder alle Mitglieder generieren.
**So generieren Sie detaillierte Informationen zu Tablespaces**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zu Ihrer Db2-Datenbank her. Ersetzen Sie im folgenden Beispiel *rds\$1database\$1alias**master\$1username*, und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to rds_database_alias user master_username using master_password
```
1. Generieren Sie Details zu allen Tablespaces in der Datenbank für ein Mitglied oder für alle Mitglieder.
Für ein Mitglied:
```
db2 "select cast(member as smallint) as member,
cast(tbsp_id as smallint) as tbsp_id,
cast(tbsp_name as varchar(35)) as tbsp_name,
cast(tbsp_type as varchar(3)) as tbsp_type,
cast(tbsp_state as varchar(10)) as state,
cast(tbsp_content_type as varchar(8)) as contents,
cast(tbsp_total_pages as integer) as total_pages,
cast(tbsp_used_pages as integer) as used_pages,
cast(tbsp_free_pages as integer) as free_pages,
cast(tbsp_page_top as integer) as page_hwm,
cast(tbsp_page_size as integer) as page_sz,
cast(tbsp_extent_size as smallint) as extent_sz,
cast(tbsp_prefetch_size as smallint) as prefetch_sz,
cast(tbsp_initial_size as integer) as initial_size,
cast(tbsp_increase_size_percent as smallint) as increase_pct,
cast(storage_group_name as varchar(12)) as stogroup from table(mon_get_tablespace(null,-1)) order by member, tbsp_id "
```
Für alle Mitglieder:
```
db2 "select cast(member as smallint) as member
cast(tbsp_id as smallint) as tbsp_id,
cast(tbsp_name as varchar(35)) as tbsp_name,
cast(tbsp_type as varchar(3)) as tbsp_type,
cast(tbsp_state as varchar(10)) as state,
cast(tbsp_content_type as varchar(8)) as contents,
cast(tbsp_total_pages as integer) as total_pages,
cast(tbsp_used_pages as integer) as used_pages,
cast(tbsp_free_pages as integer) as free_pages,
cast(tbsp_page_top as integer) as page_hwm,
cast(tbsp_page_size as integer) as page_sz,
cast(tbsp_extent_size as smallint) as extent_sz,
cast(tbsp_prefetch_size as smallint) as prefetch_sz,
cast(tbsp_initial_size as integer) as initial_size,
cast(tbsp_increase_size_percent as smallint) as increase_pct,
cast(storage_group_name as varchar(12)) as stogroup from table(mon_get_tablespace(null,-2)) order by member, tbsp_id "
```
## Auflisten des Status und der Speichergruppe für einen Tablespace
Sie können den Status und die Speichergruppe für einen Tablespace auflisten, indem Sie eine SQL-Anweisung ausführen.
Führen Sie die folgende SQL-Anweisung aus, um den Status und die Speichergruppe für einen Tablespace aufzulisten:
```
db2 "SELECT varchar(tbsp_name, 30) as tbsp_name,
varchar(TBSP_STATE, 30) state,
tbsp_type,
varchar(storage_group_name,30) storage_group
FROM TABLE(MON_GET_TABLESPACE('',-2)) AS t"
```
## Auflisten der Tablespaces einer Tabelle
Sie können die Tablespaces für eine Tabelle auflisten, indem Sie eine SQL-Anweisung ausführen.
Führen Sie die folgende SQL-Anweisung aus, um die Tablespaces einer Tabelle aufzulisten. Ersetzen Sie im folgenden Beispiel *SCHEMA\$1NAME* und *TABLE\$1NAME* durch die Namen Ihres Schemas und Ihrer Tabelle:
```
db2 "SELECT
VARCHAR(SD.TBSPACE,30) AS DATA_SPACE,
VARCHAR(SL.TBSPACE,30) AS LONG_SPACE,
VARCHAR(SI.TBSPACE,30) AS INDEX_SPACE
FROM
SYSCAT.DATAPARTITIONS P
JOIN SYSCAT.TABLESPACES SD ON SD.TBSPACEID = P.TBSPACEID
LEFT JOIN SYSCAT.TABLESPACES SL ON SL.TBSPACEID = P.LONG_TBSPACEID
LEFT JOIN SYSCAT.TABLESPACES SI ON SI.TBSPACEID = P.INDEX_TBSPACEID
WHERE
TABSCHEMA = 'SCHEMA_NAME'
AND TABNAME = 'TABLE_NAME'"
```
## Auflisten von Tablespace-Containern
Sie können alle Tablespace-Container oder bestimmte Tablespace-Container auflisten, indem Sie den Befehl `cast` verwenden.
**So listen Sie die Tablespace-Container für einen Tablespace auf**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zu Ihrer Db2-Datenbank her. Ersetzen Sie im folgenden Beispiel *rds\$1database\$1alias**master\$1username*, und *master\$1password* durch Ihre eigenen Informationen:
```
db2 connect to rds_database_alias user master_username using master_password
```
1. Generieren Sie eine Liste aller Tablespace-Container in der Datenbank oder bestimmter Tablespace-Container.
Für alle Tablespace-Container:
```
db2 "select cast(member as smallint) as member,
cast(tbsp_name as varchar(35)) as tbsp_name,
cast(container_id as smallint) as id,
cast(container_name as varchar(60)) as container_path, container_type as type from table(mon_get_container(null,-2)) order by member,tbsp_id,container_id"
```
Für bestimmte Tablespace-Container:
```
db2 "select cast(member as smallint) as member,
cast(tbsp_name as varchar(35)) as tbsp_name,
cast(container_id as smallint) as id,
cast(container_name as varchar(60)) as container_path, container_type as type from table(mon_get_container('TBSP_1',-2)) order by member, tbsp_id,container_id"
```
# Integration einer DB-Instance von Amazon RDS für Db2 mit Amazon S3
Sie können Dateien mit gespeicherten Amazon-RDS-Prozeduren zwischen Ihrer DB-Instance von Amazon RDS für Db2 und einem Amazon Simple Storage Service (Amazon S3)-Bucket übertragen. Weitere Informationen finden Sie unter [Referenz für gespeicherte Prozeduren von RDS für Db2](db2-stored-procedures.md).
**Anmerkung**
Die DB-Instance und der Amazon-S3-Bucket müssen sich in der gleichen AWS-Region befinden.
Damit RDS für Db2 in Amazon S3 integriert werden kann, benötigt Ihre DB-Instance Zugriff auf einen Amazon-S3-Bucket, indem sich Ihr RDS für Db2 befindet. Wenn Sie noch über keinen S3-Bucket verfügen, [erstellen Sie einen Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket-overview.html).
**Topics**
+ [Schritt 1: Erstellen einer IAM-Richtlinie](#db2-creating-iam-policy)
+ [Schritt 2: Erstellen einer IAM-Rolle und Anfügen der IAM-Richtlinie](#db2-creating-iam-role)
+ [Schritt 3: Hinzufügen Ihrer IAM-Rolle zu Ihrer DB-Instance von RDS für Db2](#db2-adding-iam-role)
## Schritt 1: Erstellen einer IAM-Richtlinie
In diesem Schritt erstellen Sie eine AWS Identity and Access Management (IAM-) Richtlinie mit den erforderlichen Berechtigungen, um Dateien von Ihrem Amazon S3 S3-Bucket auf Ihre RDS-DB-Instance zu übertragen. In diesem Schritt wird davon ausgegangen, dass Sie bereits einen S3-Bucket erstellt haben. Weitere Informationen finden Sie unter [Erstellen eines Buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) im *Benutzerhandbuch für Amazon S3*.
Notieren Sie sich vor dem Erstellen der Richtlinie die folgenden Informationen:
+ Amazon-Ressourcenname (ARN) Ihres Buckets
+ Der ARN für Ihren AWS Key Management Service (AWS KMS) -Schlüssel, falls Ihr Bucket SSE-S3 Verschlüsselung verwendetSSE-KMS.
Die IAM-Richtlinie, die Sie erstellen, sollte die folgenden Informationen enthalten. *\$1amzn-s3-demo-bucket\$1*Ersetzen Sie es durch den Namen Ihres S3-Buckets.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowS3BucketAccess",
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt",
"s3:PutObject",
"s3:GetObject",
"s3:AbortMultipartUpload",
"s3:ListBucket",
"s3:GetObjectVersion",
"s3:ListMultipartUploadParts",
"s3:GetBucketAcl",
"s3:GetBucketLocation"
],
"Resource": [
"arn:aws:s3:::${amzn-s3-demo-bucket}/*",
"arn:aws:s3:::${amzn-s3-demo-bucket}"
]
},
{
"Effect": "Allow",
"Action": [
"s3:ListAllMyBuckets"
],
"Resource": [
"*"
]
}
]
}
```
------
Sie können eine IAM-Richtlinie erstellen, indem Sie das AWS-Managementkonsole oder das AWS Command Line Interface (AWS CLI) verwenden.
### Konsole
**So erstellen Sie eine IAM-Richtlinie, die Amazon RDS Zugriff auf Ihren Amazon-S3-Bucket gewährt**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. Wählen Sie im Navigationsbereich **Richtlinien**.
1. Wählen Sie **Richtlinie erstellen** und anschließend die Option **JSON**.
1. Fügen Sie Aktionen nach Dienst hinzu. Um Dateien aus einem Amazon-S3-Bucket an Amazon RDS zu übertragen, müssen Sie Bucket- und Objektberechtigungen auswählen.
1. Erweitern Sie **Resources** (Ressourcen). Sie müssen Ihre Bucket- und Objektressourcen angeben.
1. Wählen Sie **Weiter** aus.
1. Geben Sie unter **Richtlinienname** einen Namen für diese Richtlinie ein.
1. (Optional) Geben Sie im Feld **Description (Beschreibung)** eine Beschreibung für diese Richtlinie ein.
1. Wählen Sie **Richtlinie erstellen** aus.
### AWS CLI
**So erstellen Sie eine IAM-Richtlinie, die Amazon RDS Zugriff auf Ihren Amazon-S3-Bucket gewährt**
1. Erstellen Sie eine JSON-Datei, die das folgende JSON-Richtliniendokument enthält. *\$1amzn-s3-demo-bucket\$1*Ersetzen Sie es durch den Namen Ihres S3-Buckets.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowS3BucketAccess",
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt",
"s3:PutObject",
"s3:GetObject",
"s3:AbortMultipartUpload",
"s3:ListBucket",
"s3:GetObjectVersion",
"s3:ListMultipartUploadParts",
"s3:GetBucketAcl",
"s3:GetBucketLocation"
],
"Resource": [
"arn:aws:s3:::${amzn-s3-demo-bucket}/*",
"arn:aws:s3:::${amzn-s3-demo-bucket}"
]
},
{
"Effect": "Allow",
"Action": [
"s3:ListAllMyBuckets"
],
"Resource": [
"*"
]
}
]
}
```
------
1. Führen Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/iam/create-policy.html](https://docs.aws.amazon.com/cli/latest/reference/iam/create-policy.html) aus. Ersetzen Sie im folgenden Beispiel *iam\$1policy\$1name* und *iam\$1policy\$1file\$1name* durch einen Namen für Ihre IAM-Richtlinie und den Namen der JSON-Datei, die Sie in Schritt 1 erstellt haben.
Für Linux, macOS oder Unix:
```
aws iam create-policy \
--policy-name iam_policy_name \
--policy-document '{
"Version": "2012-10-17" ,
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt",
"s3:PutObject",
"s3:GetObject",
"s3:AbortMultipartUpload",
"s3:ListBucket",
"s3:DeleteObject",
"s3:GetObjectVersion",
"s3:ListMultipartUploadParts"
],
"Resource": [
"arn:aws:s3:::s3_bucket_name/*",
"arn:aws:s3:::s3_bucket_name"
]
}
]
}'
```
Für Windows:
```
aws iam create-policy ^
--policy-name iam_policy_name ^
--policy-document '{
"Version": "2012-10-17" ,
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:AbortMultipartUpload",
"s3:ListBucket",
"s3:DeleteObject",
"s3:GetObjectVersion",
"s3:ListMultipartUploadParts"
],
"Resource": [
"arn:aws:s3:::s3_bucket_name/*",
"arn:aws:s3:::s3_bucket_name"
]
}
]
}'
```
1. Nach der Erstellung der Richtlinie notieren Sie sich den ARN der Richtlinie. Sie benötigen den ARN für [Schritt 2: Erstellen einer IAM-Rolle und Anfügen der IAM-Richtlinie](#db2-creating-iam-role).
Informationen zum Erstellen einer IAM-Richtlinie finden Sie unter [Erstellen von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) im IAM-Benutzerhandbuch.
## Schritt 2: Erstellen einer IAM-Rolle und Anfügen der IAM-Richtlinie
In diesem Schritt wird davon ausgegangen, dass Sie die IAM-Richtlinie in [Schritt 1: Erstellen einer IAM-Richtlinie](#db2-creating-iam-policy) erstellt haben. In diesem Schritt erstellen Sie eine IAM-Rolle für Ihre DB-Instance von RDS für Db2 und fügen dann Ihre IAM-Richtlinie an die Rolle an.
Sie können eine IAM-Rolle für Ihre DB-Instance erstellen, indem Sie den AWS-Managementkonsole oder den verwenden. AWS CLI
### Konsole
**So erstellen Sie eine IAM-Rolle und fügen ihr die IAM-Richtlinie an**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. Wählen Sie im Navigationsbereich **Rollen** aus.
1. Wählen Sie **Create role** (Rolle erstellen) aus.
1. Wählen Sie für **Typ vertrauenswürdiger Entitäten** die Option **AWS-Service** aus.
1. Wählen Sie für **Service oder Anwendungsfall** die Option **RDS** und dann **RDS – ********Rolle zur Datenbank hinzufügen** aus.
1. Wählen Sie **Weiter** aus.
1. Suchen Sie unter **Berechtigungsrichtlinien** nach dem Namen der von Ihnen erstellten IAM-Richtlinie und wählen Sie ihn aus.
1. Wählen Sie **Weiter** aus.
1. Geben Sie für **Role name** (Rollenname) einen Rollennamen ein.
1. (Optional) Geben Sie unter **Role description** (Rollenbeschreibung) eine Beschreibung für die neue Rolle ein.
1. Wählen Sie **Rolle erstellen** aus.
### AWS CLI
**So erstellen Sie eine IAM-Rolle und fügen ihr die IAM-Richtlinie an**
1. Erstellen Sie eine JSON-Datei, die das folgende JSON-Richtliniendokument enthält:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "rds.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
1. Führen Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/iam/create-role.html](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role.html) aus. Ersetzen Sie im folgenden Beispiel *iam\$1role\$1name* und *iam\$1assume\$1role\$1policy\$1file\$1name* durch einen Namen für Ihre IAM-Rolle und den Namen der JSON-Datei, die Sie in Schritt 1 erstellt haben.
Für Linux, macOS oder Unix:
```
aws iam create-role \
--role-name iam_role_name \
--assume-role-policy-document '{
"Version": "2012-10-17" ,
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "rds.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}'
```
Für Windows:
```
aws iam create-role ^
--role-name iam_role_name ^
--assume-role-policy-document '{
"Version": "2012-10-17" ,
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "rds.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}'
```
1. Notieren Sie nach dem Erstellen der Rolle den ARN der Rolle. Sie benötigen den ARN für [Schritt 3: Hinzufügen Ihrer IAM-Rolle zu Ihrer DB-Instance von RDS für Db2](#db2-adding-iam-role).
1. Führen Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/iam/attach-role-policy.html](https://docs.aws.amazon.com/cli/latest/reference/iam/attach-role-policy.html) aus. Ersetzen Sie im folgenden Beispiel durch den *iam\$1policy\$1arn* ARN der IAM-Richtlinie, die Sie in [Schritt 1: Erstellen einer IAM-Richtlinie](#db2-creating-iam-policy) erstellt haben. *iam\$1role\$1name*Ersetzen Sie ihn durch den Namen der IAM-Rolle, die Sie gerade erstellt haben.
Für Linux, macOS oder Unix:
```
aws iam attach-role-policy \
--policy-arn iam_policy_arn \
--role-name iam_role_name
```
Für Windows:
```
aws iam attach-role-policy ^
--policy-arn iam_policy_arn ^
--role-name iam_role_name
```
Weitere Informationen finden Sie unter [Erstellen einer Rolle zum Delegieren von Berechtigungen an einen IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html) im *IAM-Benutzerhandbuch*.
## Schritt 3: Hinzufügen Ihrer IAM-Rolle zu Ihrer DB-Instance von RDS für Db2
In diesem Schritt fügen Sie Ihre IAM-Rolle zu Ihrer DB-Instance von RDS für Db2 hinzu. Beachten Sie die folgenden Voraussetzungen:
+ Sie müssen Zugriff auf eine IAM-Rolle haben, der die Amazon-S3-Berechtigungsrichtlinie angefügt ist.
+ Sie können jeweils nur eine IAM-Rolle zu Ihrer DB-Instance von RDS für Db2 hinzufügen.
+ Ihre DB-Instance von RDS für Db2 muss sich im Status **Verfügbar** befinden.
Sie können Ihrer DB-Instance eine IAM-Rolle hinzufügen, indem Sie den AWS-Managementkonsole oder den verwenden. AWS CLI
### Konsole
**So fügen Sie eine IAM-Rolle zu Ihrer DB-Instance von RDS für Db2 hinzu**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Wählen Sie im Navigationsbereich **Datenbanken** aus.
1. Wählen Sie den Namen Ihrer DB-Instance von RDS für Db2 aus.
1. Auf der**Konnektivität & Sicherheit**Scrollen Sie nach unten zum**IAM-Rollen verwalten**unten auf der Seite.
1. Wählen Sie unter **IAM-Rollen zu dieser Instance hinzufügen** die Rolle aus, die Sie in [Schritt 2: Erstellen einer IAM-Rolle und Anfügen der IAM-Richtlinie](#db2-creating-iam-role) erstellt haben.
1. Wählen Sie unter **Feature (Funktion)** die Option **S3\$1INTEGRATION** aus.
1. Wählen Sie **Rolle hinzufügen** aus.
![\[Das Feature S3_INTEGRATION wird zur IAM-Rolle für eine DB-Instance hinzugefügt.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/db2-s3-integration-role.png)
### AWS CLI
Um zu Ihrer DB-Instance von RDS für Db2 eine IAM-Rolle hinzuzufügen, führen Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/add-role-to-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/add-role-to-db-instance.html) aus. Ersetzen Sie im folgenden Beispiel, *region**db\$1instance\$1name*, und *iam\$1role\$1arn* durch den Namen der Instanz, AWS-Region in der Ihre DB-Instance existiert, den Namen Ihrer DB-Instance und den ARN der IAM-Rolle, in [Schritt 2: Erstellen einer IAM-Rolle und Anfügen der IAM-Richtlinie](#db2-creating-iam-role) der Sie erstellt haben.
Für Linux, macOS oder Unix:
```
aws rds add-role-to-db-instance \
--region $region \
--db-instance-identifier $db_instance_name \
--feature-name S3_INTEGRATION \
--role-arn $iam_role_arn \
```
Für Windows:
```
aws rds add-role-to-db-instance ^
--region $region \
--db-instance-identifier db_instance_name ^
--feature-name S3_INTEGRATION ^
--role-arn iam_role_arn ^
```
Führen Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) aus, um zu bestätigen, dass die Rolle erfolgreich zu Ihrer DB-Instance von RDS für Db2 hinzugefügt wurde. Ersetzen Sie im folgenden Beispiel *db\$1instance\$1name* durch den Namen Ihrer DB-Instance.
Für Linux, macOS oder Unix:
```
aws rds describe-db-instances \
--filters "Name=db-instance-id,Values=db_instance_name" \
--query 'DBInstances[].AssociatedRoles'
```
Für Windows:
```
aws rds describe-db-instances ^
--filters "Name=db-instance-id,Values=db_instance_name" ^
--query 'DBInstances[].AssociatedRoles'
```
Die Ausgabe dieses Befehls sieht etwa so aus:
```
[
[
{
"RoleArn": "arn:aws:iam::0123456789012:role/rds-db2-s3-role",
"FeatureName": "S3_INTEGRATION",
"Status": "ACTIVE"
}
]
]
```
# Migrieren von Daten zu Amazon RDS für Db2
Sie können selbstverwaltete Db2-Datenbanken mit AWS oder mit nativen Db2-Tools zu Amazon RDS für Db2 migrieren.
Informationen zum Migrieren Ihrer Db2-Datenbank zu Amazon RDS für Db2 mithilfe von AWS-Services finden Sie unter [Nutzung von AWS-Services zur Migration von Daten von Db2 zu Amazon RDS für Db2](db2-migration-approaches.md).
Informationen zum Migrieren Ihrer Db2-Datenbank zu Amazon RDS für Db2 mithilfe von nativen Db2-Tools finden Sie unter [Verwendung nativer Db2-Tools zur Migration von Daten von Db2 zu Amazon RDS für Db2](db2-native-db2-tools.md).
# Nutzung von AWS-Services zur Migration von Daten von Db2 zu Amazon RDS für Db2
In Amazon RDS gibt es mehrere Möglichkeiten, Daten von einer Db2-Datenbank zu Amazon RDS für Db2 zu migrieren. Sie können eine einmalige Migration Ihrer Db2-Datenbank von Linux-, AIX-, oder Windows-Umgebungen zu Amazon RDS für Db2 durchführen. Um Ausfallzeiten zu minimieren, können Sie eine Migration fast ohne Ausfallzeiten durchführen. Sie können Ihre Daten migrieren, indem Sie sie in Amazon S3 speichern und sie tabellenweise in Ihre Db2-Datenbank laden. Sie können auch eine synchrone Migration per Replikation durchführen oder AWS Database Migration Service verwenden.
Bei einmaligen Migrationen für Linux-basierte Db2-Datenbanken unterstützt Amazon RDS nur Offline- und Online-Backups. Amazon RDS unterstützt keine inkrementellen oder Delta-Sicherungen. Für Migrationen von Linux-basierten Db2-Datenbanken fast ohne Ausfallzeiten benötigt Amazon RDS Online-Sicherungen. Wir empfehlen, Online-Sicherungen für Migrationen fast ohne Ausfallzeiten zu verwenden, und Offline-Sicherungen für Migrationen zu nutzen, die Ausfallzeiten bewältigen können.
**Topics**
+ [Migration von Linux zu Linux für Amazon RDS für Db2](db2-one-time-migration-linux.md)
+ [Migrieren von Linux zu Linux fast ohne Ausfallzeit für Amazon RDS für Db2](db2-near-zero-downtime-migration.md)
+ [Synchrone Migration von Linux zu Linux für Amazon RDS für Db2](db2-synchronous-migration-linux.md)
+ [Migration von AIX oder Windows zu Linux für Amazon RDS für Db2](db2-one-time-migration-aix-windows-linux.md)
+ [Migrieren von Db2-Daten über Amazon S3 zu Amazon RDS für Db2](db2-migration-load-from-s3.md)
+ [Migrieren zu Amazon RDS für Db2 mit AWS Database Migration Service (AWS DMS)](db2-migration-amazon-dms.md)
# Migration von Linux zu Linux für Amazon RDS für Db2
Bei diesem Migrationsansatz sichern Sie Ihre selbstverwaltete Db2-Datenbank in einem Amazon-S3-Bucket. Anschließend verwenden Sie gespeicherte Amazon-RDS-Prozeduren, um Ihre Db2-Datenbank auf einer DB-Instance von Amazon RDS für Db2 wiederherzustellen. Weitere Informationen zur Verwendung von Amazon S3 finden Sie unter [Integration einer DB-Instance von Amazon RDS für Db2 mit Amazon S3](db2-s3-integration.md).
Sicherung und Wiederherstellung für RDS für Db2 folgen den IBM Db2-unterstützten Upgrade-Pfaden und Einschränkungen. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [Supported upgrade paths for Db2 servers](https://www.ibm.com/docs/en/db2/11.5?topic=servers-supported-upgrade-paths-db2) und [Upgrade restrictions for Db2 servers](https://www.ibm.com/docs/en/db2/11.5?topic=servers-upgrade-restrictions).
**Topics**
+ [Einschränkungen und Empfehlungen für die systemeigene Wiederherstellung](#db2-linux-migration-limitations)
+ [Sichern Ihrer Datenbank in Amazon S3](#db2-linux-backing-up-database)
+ [Erstellen einer automatischen Standardspeichergruppe](#db2-linux-creating-auto-storage-group)
+ [Wiederherstellen Ihrer Db2-Datenbank](#db2-linux-restoring-db2-database)
## Einschränkungen und Empfehlungen für die systemeigene Wiederherstellung
Die folgenden Einschränkungen und Empfehlungen gelten für die Verwendung der systemeigenen Wiederherstellung:
+ Amazon RDS unterstützt nur die Migration von lokalen Versionen von Db2, die den unterstützten Versionen von RDS für Db2 entsprechen. Weitere Informationen zu unterstützten Versionen finden Sie unter [Upgrade-Management für Amazon RDS Db2-Instances](Db2.Concepts.VersionMgmt.Supported.md).
+ Amazon RDS unterstützt nur Offline- und Online-Sicherungen für die native Wiederherstellung. Amazon RDS unterstützt weder inkrementelle noch Delta-Sicherungen.
+ Sie können keine Wiederherstellung aus einem Amazon S3 S3-Bucket in einer anderen Region als der Region durchführen AWS-Region , in der sich Ihre RDS for Db2-DB-Instance befindet.
+ Amazon S3 begrenzt die Größe von Dateien, die in einen Amazon S3-Bucket hochgeladen werden können, auf 5 TB. Wenn die Sicherungsdatei Ihrer Datenbank größer als 5 TB ist, müssen Sie die Sicherungsdatei in kleinere Dateien aufteilen.
+ Amazon RDS unterstützt keine externen Routinen ohne Fencing und keine inkrementellen oder Delta-Wiederherstellungen.
+ Sie können nicht aus einer verschlüsselten Quelldatenbank wiederherstellen, aber Sie können eine verschlüsselte Amazon RDS DB-Instance wiederherstellen.
Der Wiederherstellungsprozess unterscheidet sich je nach Ihrer Konfiguration.
Wenn Sie diese Option `USE_STREAMING_RESTORE` wählen`TRUE`, streamt Amazon RDS Ihr Backup während der Wiederherstellung direkt aus Ihrem S3-Bucket. Durch Streaming werden die Speicheranforderungen erheblich reduziert. Sie müssen lediglich Speicherplatz bereitstellen, der entweder der Größe des Backups oder der Größe der Originaldatenbank entspricht oder größer ist, je nachdem, welcher Wert größer ist.
Wenn Sie diese Option festlegen `USE_STREAMING_RESTORE``FALSE`, lädt Amazon RDS zuerst das Backup auf Ihre RDS for Db2-DB-Instance herunter und extrahiert dann das Backup. Für die Extraktion ist zusätzlicher Speicherplatz erforderlich. Sie müssen Speicherplatz bereitstellen, der mindestens der Summe aus der Größe des Backups und der Größe der Originaldatenbank entspricht.
Die maximale Größe der wiederhergestellten Datenbank entspricht der maximal unterstützten Datenbankgröße abzüglich des Speicherplatzes, der während des Wiederherstellungsvorgangs für die temporäre Speicherung erforderlich ist.
## Sichern Ihrer Datenbank in Amazon S3
Um Ihre Datenbank auf Amazon S3 zu sichern, benötigen Sie die folgenden AWS Komponenten:
+ *Einen Amazon-S3-Bucket zum Speichern Ihrer Sicherungsdateien*: Laden Sie alle Sicherungsdateien hoch, die Sie zu Amazon RDS migrieren möchten. Wir empfehlen Ihnen, Offline-Sicherungen für Migrationen zu verwenden, die mit Ausfallzeit umgehen können. Wenn Sie bereits über einen S3-Bucket verfügen, können Sie diesen verwenden. Wenn Sie über keinen S3-Bucket verfügen, gehen Sie zu [Einen Bucket erstellen](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) im *Amazon-S3-Benutzerhandbuch*.
**Anmerkung**
Wenn Ihre Datenbank groß ist und die Übertragung in einen S3-Bucket viel Zeit in Anspruch nehmen würde, können Sie ein AWS Snow Family Gerät bestellen und AWS die Sicherung durchführen lassen. Nachdem Sie Ihre Dateien auf das Gerät kopiert und dieses an das Snow-Family-Team zurückgegeben haben, überträgt das Team Ihre gesicherten Bilder an Ihren S3-Bucket. Weitere Informationen finden Sie in der [AWS Snow Family -Dokumentation](https://docs.aws.amazon.com/snowball/).
+ *Eine IAM-Rolle für den Zugriff auf den S3-Bucket*: Wenn Sie bereits eine IAM-Rolle haben, können Sie diese Rolle verwenden. Wenn dies nicht der Fall ist, wechseln Sie zu [Schritt 2: Erstellen einer IAM-Rolle und Anfügen der IAM-Richtlinie](db2-s3-integration.md#db2-creating-iam-role).
+ *Eine IAM-Richtlinie mit Vertrauensbeziehungen und Berechtigungen, die Ihrer IAM-Rolle zugeordnet sind*: Weitere Informationen finden Sie unter [Schritt 1: Erstellen einer IAM-Richtlinie](db2-s3-integration.md#db2-creating-iam-policy).
+ *Die IAM-Rolle, die Ihrer DB-Instance von RDS für Db2 hinzugefügt wurde*: Weitere Informationen finden Sie unter [Schritt 3: Hinzufügen Ihrer IAM-Rolle zu Ihrer DB-Instance von RDS für Db2](db2-s3-integration.md#db2-adding-iam-role).
## Erstellen einer automatischen Standardspeichergruppe
Ihre Quelldatenbank muss eine automatische Standardspeichergruppe haben. Wenn Ihre Datenbank über keine automatische Standardspeichergruppe verfügt, müssen Sie eine erstellen.
**So erstellen Sie eine automatische Standardspeichergruppe**
1. Stellen Sie eine Verbindung zur Quelldatenbank her. Im folgenden Beispiel *source\$1database* ersetzen Sie es durch den Namen Ihrer Datenbank.
```
db2 connect to source_database
```
1. Erstellen Sie eine automatische Speichergruppe und legen Sie sie als Standard fest. Im folgenden Beispiel *storage\$1path* ersetzen Sie es durch den absoluten Pfad zu dem Ort, an dem sich die Speichergruppe befindet.
```
db2 "create stogroup IBMSTOGROUP ON storage_path set as default"
```
1. Beenden Sie Backend-Prozesse.
```
db2 terminate
```
1. Deaktivieren Sie die Datenbank und beenden Sie alle Datenbankdienste. Ersetzen Sie im folgenden Beispiel *source\$1database* durch den Namen der Datenbank, für die Sie die Speichergruppe erstellt haben.
```
db2 deactivate db source_database
```
1. Sichern Sie die Datenbank. Im folgenden Beispiel *source\$1database* ersetzen Sie es durch den Namen der Datenbank, für die Sie die Speichergruppe erstellt haben. *file\$1system\$1path*Ersetzen Sie es durch den absoluten Pfad zu dem Ort, an dem Sie die Datenbank sichern möchten.
```
db2 backup database source_database to file_system_path
```
## Wiederherstellen Ihrer Db2-Datenbank
Nachdem Sie Ihre Datenbank auf Amazon S3 gesichert und eine automatische Speichergruppe erstellt haben, können Sie Ihre Db2-Datenbank auf Ihrer DB-Instance von RDS für Db2 wiederherstellen.
**So stellen Sie Ihre Db2-Datenbank aus Ihrem Amazon S3 S3-Bucket auf Ihrer RDS for Db2-DB-Instance wieder her**
1. Stellen Sie eine Verbindung mit Ihrer DB-Instance von RDS für Db2 her. Weitere Informationen finden Sie unter [Herstellen einer Verbindung mit Ihrer Db2-DB-Instance](USER_ConnectToDb2DBInstance.md).
1. (Optional) Um sicherzustellen, dass Ihre Datenbank mit den optimalen Einstellungen konfiguriert ist, überprüfen Sie die Werte für die folgenden Parameter, indem Sie Folgendes aufrufen: [rdsadmin.show\$1configuration](db2-sp-managing-databases.md#db2-sp-show-configuration)
+ `RESTORE_DATABASE_NUM_BUFFERS`
+ `RESTORE_DATABASE_PARALLELISM`
+ `RESTORE_DATABASE_NUM_MULTI_PATHS`
+ `USE_STREAMING_RESTORE`
Verwenden Sie diese [rdsadmin.set\$1configuration](db2-sp-managing-databases.md#db2-sp-set-configuration) Option, um diese Werte nach Bedarf zu ändern. Die korrekte Konfiguration dieser Parameter kann die Leistung bei der Wiederherstellung von Datenbanken mit großen Datenmengen erheblich verbessern. Für die meisten Migrationsszenarien empfehlen wir die Einstellung `USE_STREAMING_RESTORE` auf, `TRUE` da dadurch die Speicheranforderungen reduziert und die Wiederherstellungsgeschwindigkeit verbessert werden kann.
1. Stellen Sie Ihre Datenbank wieder her, indem Sie `rdsadmin.restore_database` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database).
# Migrieren von Linux zu Linux fast ohne Ausfallzeit für Amazon RDS für Db2
Mit diesem Migrationsansatz migrieren Sie eine Linux-basierte Db2-Datenbank von einer selbstverwalteten Db2-Datenbank (Quelle) zu Amazon RDS für Db2. Dieser Ansatz verursacht nur minimale oder keine Ausfälle oder Ausfallzeiten bei Anwendung oder Benutzern. Dieser Ansatz sichert Ihre Datenbank und stellt sie mit Protokollwiedergabe wieder her, wodurch Unterbrechungen des laufenden Betriebs vermieden werden und eine hohe Verfügbarkeit Ihrer Datenbank gewährleistet wird.
Um eine Migration fast ohne Ausfallzeit zu ermöglichen, implementiert RDS für Db2 eine Wiederherstellung mit Protokollwiedergabe. Bei diesem Ansatz wird eine Sicherung Ihrer selbstverwalteten Linux-basierten Db2-Datenbank auf dem Server von RDS für Db2 wiederhergestellt. Mit gespeicherten Amazon-RDS-Prozeduren wenden Sie dann nachfolgende Transaktionsprotokolle an, um die Datenbank auf den neuesten Stand zu bringen.
**Topics**
+ [Einschränkungen und Empfehlungen für eine Migration fast ohne Ausfallzeit](#db2-near-zero-downtime-migration-limitations)
+ [Sichern Ihrer Datenbank in Amazon S3](#db2-near-zero-downtime-backing-up-database)
+ [Erstellen einer automatischen Standardspeichergruppe](#db2-near-zero-migration-creating-auto-storage-group)
+ [Migrieren Ihrer Db2-Datenbank](#db2-migrating-db2-database)
## Einschränkungen und Empfehlungen für eine Migration fast ohne Ausfallzeit
Die folgenden Einschränkungen und Empfehlungen gelten für die Migration fast ohne Ausfallzeit:
+ Für eine Migration fast ohne Ausfallzeit benötigt Amazon RDS eine Online-Sicherung. Das liegt daran, dass Amazon RDS Ihre Datenbank beim Hochladen Ihrer archivierten Transaktionsprotokolle im Status „Rollforward pending“ hält. Weitere Informationen finden Sie unter [Migrieren Ihrer Db2-Datenbank](#db2-migrating-db2-database).
+ Sie können keine Wiederherstellung aus einem Amazon S3 S3-Bucket in einer anderen Region als der Region durchführen AWS-Region , in der sich Ihre RDS for Db2-DB-Instance befindet.
+ Amazon S3 begrenzt die Größe von Dateien, die in einen S3-Bucket hochgeladen werden können, auf 5 TB. Wenn die Sicherungsdatei Ihrer Datenbank größer als 5 TB ist, müssen Sie die Sicherungsdatei in kleinere Dateien aufteilen.
+ Amazon RDS unterstützt keine externen Routinen ohne Fencing und keine inkrementellen oder Delta-Wiederherstellungen.
+ Sie können nicht aus einer verschlüsselten Quelldatenbank wiederherstellen, aber Sie können eine verschlüsselte Amazon RDS DB-Instance wiederherstellen.
Der Wiederherstellungsprozess unterscheidet sich je nach Ihrer Konfiguration.
Wenn Sie diese Option `USE_STREAMING_RESTORE` wählen`TRUE`, streamt Amazon RDS Ihr Backup während der Wiederherstellung direkt aus Ihrem S3-Bucket. Durch Streaming werden die Speicheranforderungen erheblich reduziert. Sie müssen lediglich Speicherplatz bereitstellen, der entweder der Größe des Backups oder der Größe der Originaldatenbank entspricht oder größer ist, je nachdem, welcher Wert größer ist.
Wenn Sie diese Option festlegen `USE_STREAMING_RESTORE``FALSE`, lädt Amazon RDS zuerst das Backup auf Ihre RDS for Db2-DB-Instance herunter und extrahiert dann das Backup. Für die Extraktion ist zusätzlicher Speicherplatz erforderlich. Sie müssen Speicherplatz bereitstellen, der mindestens der Summe aus der Größe des Backups und der Größe der Originaldatenbank entspricht.
Die maximale Größe der wiederhergestellten Datenbank entspricht der maximal unterstützten Datenbankgröße abzüglich des Speicherplatzes, der während des Wiederherstellungsvorgangs für die temporäre Speicherung erforderlich ist.
## Sichern Ihrer Datenbank in Amazon S3
Um Ihre Datenbank auf Amazon S3 zu sichern, benötigen Sie die folgenden AWS Komponenten:
+ *Einen Amazon-S3-Bucket zum Speichern Ihrer Sicherungsdateien*: Laden Sie alle Sicherungsdateien hoch, die Sie zu Amazon RDS migrieren möchten. Für eine Migration fast ohne Ausfallzeit benötigt Amazon RDS eine Online-Sicherung. Wenn Sie bereits über einen S3-Bucket verfügen, können Sie diesen verwenden. Wenn Sie über keinen S3-Bucket verfügen, gehen Sie zu [Einen Bucket erstellen](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) im *Amazon-S3-Benutzerhandbuch*.
**Anmerkung**
Wenn Ihre Datenbank groß ist und die Übertragung in einen S3-Bucket lange dauern würde, können Sie ein AWS Snow Family Gerät bestellen und AWS die Sicherung durchführen lassen. Nachdem Sie Ihre Dateien auf das Gerät kopiert und dieses an das Snow-Family-Team zurückgegeben haben, überträgt das Team Ihre gesicherten Bilder an Ihren S3-Bucket. Weitere Informationen finden Sie in der [AWS Snow Family -Dokumentation](https://docs.aws.amazon.com/snowball/).
+ *Eine IAM-Rolle für den Zugriff auf den S3-Bucket*: Wenn Sie bereits eine AWS Identity and Access Management (IAM-) Rolle haben, können Sie diese Rolle verwenden. Wenn dies nicht der Fall ist, wechseln Sie zu [Schritt 2: Erstellen einer IAM-Rolle und Anfügen der IAM-Richtlinie](db2-s3-integration.md#db2-creating-iam-role).
+ *Eine IAM-Richtlinie mit Vertrauensbeziehungen und Berechtigungen, die Ihrer IAM-Rolle zugeordnet sind*: Weitere Informationen finden Sie unter [Schritt 1: Erstellen einer IAM-Richtlinie](db2-s3-integration.md#db2-creating-iam-policy).
+ *Die IAM-Rolle, die Ihrer DB-Instance von RDS für Db2 hinzugefügt wurde*: Weitere Informationen finden Sie unter [Schritt 3: Hinzufügen Ihrer IAM-Rolle zu Ihrer DB-Instance von RDS für Db2](db2-s3-integration.md#db2-adding-iam-role).
## Erstellen einer automatischen Standardspeichergruppe
Ihre Quelldatenbank muss eine automatische Standardspeichergruppe haben. Wenn Ihre Datenbank über keine automatische Standardspeichergruppe verfügt, müssen Sie eine erstellen.
**So erstellen Sie eine automatische Standardspeichergruppe**
1. Stellen Sie eine Verbindung zur Quelldatenbank her. Ersetzen Sie im folgenden Beispiel durch *source\$1database* den Namen Ihrer Datenbank.
```
db2 connect to source_database
```
1. Erstellen Sie eine automatische Speichergruppe und legen Sie sie als Standard fest. Im folgenden Beispiel *storage\$1path* ersetzen Sie es durch den absoluten Pfad zu dem Ort, an dem sich die Speichergruppe befindet.
```
db2 "create stogroup IBMSTOGROUP ON storage_path set as default"
```
1. Beenden Sie Backend-Prozesse.
```
db2 terminate
```
## Migrieren Ihrer Db2-Datenbank
Nachdem Sie eine Migration ohne Ausfallzeiten eingerichtet haben, sind Sie bereit, Ihre Db2-Datenbank von Ihrem Amazon S3 S3-Bucket auf Ihre RDS for Db2-DB-Instance zu migrieren.
**Um eine Migration von Backup-Dateien von Ihrem Amazon S3 S3-Bucket zu Ihrer RDS for Db2-DB-Instance ohne Ausfallzeiten durchzuführen**
1. Veranlassen Sie eine Online-Sicherung Ihrer Quelldatenbank. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [BACKUP DATABASE command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-backup-database).
1. Kopieren Sie die Sicherung Ihrer Datenbank in einen Amazon-S3-Bucket. Weitere Informationen zu Amazon S3 finden Sie im [Benutzerhandbuch zu Amazon Simple Storage Service](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html).
1. Stellen Sie mit *master\$1username* und *master\$1password* für Ihre RDS for Db2-DB-Instance eine Connect zum `rdsadmin` Server her.
```
db2 connect to rdsadmin user master_username using master_password
```
1. (Optional) Um sicherzustellen, dass Ihre Datenbank mit den optimalen Einstellungen konfiguriert ist, überprüfen Sie die Werte für die folgenden Parameter, indem Sie Folgendes aufrufen[rdsadmin.show\$1configuration](db2-sp-managing-databases.md#db2-sp-show-configuration):
+ `RESTORE_DATABASE_NUM_BUFFERS`
+ `RESTORE_DATABASE_PARALLELISM`
+ `RESTORE_DATABASE_NUM_MULTI_PATHS`
+ `USE_STREAMING_RESTORE`
Verwenden Sie diese [rdsadmin.set\$1configuration](db2-sp-managing-databases.md#db2-sp-set-configuration) Option, um diese Werte nach Bedarf zu ändern. Die korrekte Konfiguration dieser Parameter kann die Leistung bei der Wiederherstellung von Datenbanken mit großen Datenmengen erheblich verbessern. Für die meisten Migrationsszenarien empfehlen wir die Einstellung `USE_STREAMING_RESTORE` auf, `TRUE` da dadurch die Speicheranforderungen reduziert und die Wiederherstellungsgeschwindigkeit verbessert werden kann.
1. Stellen Sie die Sicherung auf dem Server von RDS für Db2 wieder her, indem Sie `rdsadmin.restore_database` aufrufen. Setzen Sie `backup_type` auf `ONLINE`. Weitere Informationen finden Sie unter [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database).
1. Kopieren Sie Ihre Archivprotokolle von Ihrem Quellserver in Ihren S3-Bucket. Weitere Informationen finden Sie unter [Archive logging](https://www.ibm.com/docs/en/db2/11.5?topic=logging-archive) in der IBM Db2-Dokumentation.
1. Wenden Sie Archivprotokolle so oft wie nötig an, indem Sie `rdsadmin.rollforward_database` aufrufen. Legen Sie `complete_rollforward` auf `FALSE` fest, um die Datenbank im Zustand `ROLL-FORWARD PENDING` zu halten. Weitere Informationen finden Sie unter [rdsadmin.rollforward\$1database](db2-sp-managing-databases.md#db2-sp-rollforward-database).
1. Nachdem Sie alle Archivprotokolle angewendet haben, schalten Sie die Datenbank online, indem Sie `rdsadmin.complete_rollforward` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.complete\$1rollforward](db2-sp-managing-databases.md#db2-sp-complete-rollforward).
1. Sie können zwischen den Anwendungsverbindungen zum Server von RDS für Db2 wechseln, indem Sie entweder Ihre Anwendungsendpunkte für die Datenbank aktualisieren oder die DNS-Endpunkte so aktualisieren, dass sie den Datenverkehr zum Server von RDS für Db2 umleiten. Sie können auch das Db2-Feature zur automatischen Umleitung von Clients für Ihre selbstverwaltete Db2-Datenbank mit dem Datenbankendpunkt von RDS für Db2 verwenden. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [Automatic client reroute description and setup](https://www.ibm.com/docs/en/db2/11.5?topic=reroute-configuring-automatic-client).
1. (Optional) Fahren Sie Ihre Quelldatenbank herunter.
# Synchrone Migration von Linux zu Linux für Amazon RDS für Db2
Mit dieser Migrationsmethode richten Sie eine Replikation zwischen der selbstverwalteten Db2-Datenbank und der DB-Instance von Amazon RDS für Db2 ein. Die an der selbstverwalteten Datenbank vorgenommenen Änderungen werden nahezu in Echtzeit auf die DB-Instance von RDS für Db2 repliziert. Diese Methode kann für kontinuierliche Verfügbarkeit sorgen und Ausfallzeiten während der Migration minimieren.
# Migration von AIX oder Windows zu Linux für Amazon RDS für Db2
Bei diesem Migrationsansatz verwenden Sie native Db2-Tools, um Ihre selbstverwaltete Db2-Datenbank in einem Amazon-S3-Bucket zu sichern. Zu den systemeigenen Db2-Tools gehören das Dienstprogramm `export`, der Systembefehl `db2move` oder der Systembefehl `db2look`. Ihre Db2-Datenbank kann entweder selbstverwaltet sein oder in Amazon Elastic Compute Cloud (Amazon EC2) verwaltet werden. Sie können Daten von Ihrem AIX- oder Windows-System in Ihren Amazon-S3-Bucket verschieben. Verwenden Sie dann einen Db2-Client, um Daten direkt aus dem S3-Bucket in Ihre Datenbank von Amazon RDS für Db2 zu laden. Die Ausfallzeit hängt von der Größe Ihrer Datenbank ab. Weitere Informationen zur Verwendung von Amazon S3 finden Sie unter [Integration einer DB-Instance von Amazon RDS für Db2 mit Amazon S3](db2-s3-integration.md).
**So migrieren Sie Ihre Db2-Datenbank zu RDS für Db2**
1. Bereiten Sie die Sicherung Ihrer Datenbank vor. Konfigurieren Sie auf Ihrem selbstverwalteten Db2-System ausreichend Speicherplatz für die Sicherung.
1. Sichern Sie Ihre Datenbank.
1. Führen Sie den [Systembefehl db2look](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2look-db2-statistics-ddl-extraction-tool) aus, um die DDL-Datei (Data Definition Language) für alle Objekte zu extrahieren.
1. Führen Sie entweder das [Db2-Exportdienstprogramm](https://www.ibm.com/docs/en/db2/11.5?topic=utility-exporting-data), den [Systembefehl db2move](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2move-database-movement-tool)oder eine [CREATE EXTERNAL TABLE-Anweisung](https://www.ibm.com/docs/en/db2/11.5?topic=statements-create-table-external) aus, um die Db2-Tabellendaten in den Speicher auf Ihrem Db2-System zu entladen.
1. Verschieben Sie Ihre Sicherung in einen Amazon S3-Bucket. Weitere Informationen finden Sie unter [Integration einer DB-Instance von Amazon RDS für Db2 mit Amazon S3](db2-s3-integration.md).
**Anmerkung**
Wenn Ihre Datenbank groß ist und die Übertragung an einen S3-Bucket viel Zeit in Anspruch nehmen würde, können Sie ein AWS Snow Family-Gerät bestellen und AWS mit der Sicherung beauftragen. Nachdem Sie Ihre Dateien auf das Gerät kopiert und dieses an das Snow-Family-Team zurückgegeben haben, überträgt das Team Ihre gesicherten Bilder an Ihren S3-Bucket. Weitere Informationen finden Sie in der [AWS Snow Family-Dokumentation](https://docs.aws.amazon.com/snowball/).
1. Verwenden Sie einen Db2-Client, um Daten direkt aus Ihrem S3-Bucket in Ihre Datenbank von RDS für Db2 zu laden. Weitere Informationen finden Sie unter [Migrieren mit Amazon S3](db2-migration-load-from-s3.md).
# Migrieren von Db2-Daten über Amazon S3 zu Amazon RDS für Db2
Bei diesem Migrationsansatz speichern Sie zunächst Daten aus einer einzelnen Tabelle in einer Datendatei, die Sie in einen Amazon-S3-Bucket platzieren. Anschließend verwenden Sie den [LOAD-Befehl](https://www.ibm.com/docs/en/db2/11.5?topic=commands-load), um die Daten aus dieser Datendatei in eine Tabelle in Ihrer Datenbank von Amazon RDS für Db2 zu laden. Weitere Informationen zur Verwendung von Amazon S3 finden Sie unter [Integration einer DB-Instance von Amazon RDS für Db2 mit Amazon S3](db2-s3-integration.md).
**Topics**
+ [Speichern Ihrer Daten in Amazon S3](#db2-migration-load-from-s3-saving-data-file)
+ [Laden Ihrer Daten in Tabellen von RDS für Db2](#db2-migration-load-from-s3-into-db-table)
## Speichern Ihrer Daten in Amazon S3
Um Daten aus einer einzelnen Tabelle in Amazon S3 zu speichern, verwenden Sie ein Datenbank-Dienstprogramm und extrahieren Sie die Daten damit aus Ihrem Datenbankmanagementsystem (DBMS) in eine CSV-Datei. Laden Sie dann die Datendatei in Amazon S3 hoch.
Zum Speichern von Datendateien auf Amazon S3 benötigen Sie die folgenden AWS Komponenten:
+ *Einen Amazon-S3-Bucket zum Speichern Ihrer Sicherungsdateien*: Wenn Sie bereits über einen S3-Bucket verfügen, können Sie diesen Bucket verwenden. Wenn Sie über keinen S3-Bucket verfügen, gehen Sie zu [Einen Bucket erstellen](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) im *Amazon-S3-Benutzerhandbuch*.
+ *Eine IAM-Rolle für den Zugriff auf den S3-Bucket*: Wenn Sie bereits eine IAM-Rolle haben, können Sie diese Rolle verwenden. Wenn dies nicht der Fall ist, wechseln Sie zu [Schritt 2: Erstellen einer IAM-Rolle und Anfügen der IAM-Richtlinie](db2-s3-integration.md#db2-creating-iam-role).
+ *Eine IAM-Richtlinie mit Vertrauensbeziehungen und Berechtigungen, die Ihrer IAM-Rolle zugeordnet sind*: Weitere Informationen finden Sie unter [Schritt 1: Erstellen einer IAM-Richtlinie](db2-s3-integration.md#db2-creating-iam-policy).
+ *Die IAM-Rolle, die Ihrer DB-Instance von RDS für Db2 hinzugefügt wurde*: Weitere Informationen finden Sie unter [Schritt 3: Hinzufügen Ihrer IAM-Rolle zu Ihrer DB-Instance von RDS für Db2](db2-s3-integration.md#db2-adding-iam-role).
## Laden Ihrer Daten in Tabellen von RDS für Db2
Nachdem Sie Ihre Datendateien in Amazon S3 gespeichert haben, können Sie die Daten aus diesen Dateien in einzelne Tabellen auf Ihrer DB-Instance von RDS für Db2 laden.
**So laden Sie Ihre Db2-Tabellendaten in Ihre DB-Datenbanktabelle von RDS für Db2**
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur `rdsadmin`-Datenbank her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre eigenen Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Katalogisieren Sie einen Alias für den Speicherzugriff, der auf den Amazon-S3-Bucket verweist, in dem Ihre gespeicherten Dateien untergebracht sind. Notieren Sie sich diesen Alias, um ihn im nächsten Schritt zur Hand zu haben. Sie müssen diesen Schritt nur einmal ausführen, wenn Sie mehrere Tabellen aus Datendateien laden möchten, die im selben Amazon-S3-Bucket gespeichert sind.
Im folgenden Beispiel wird ein Alias mit dem Namen katalogisiert*my\$1s3\$1alias*, der einem Benutzer mit dem Namen *jorge\$1souza* Zugriff auf einen Bucket mit dem Namen *amzn-s3-demo-bucket* gewährt.
```
db2 "call rdsadmin.catalog_storage_access(?, 'my_s3_alias', 'amzn-s3-demo-bucket', 'USER', 'jorge_souza')"
```
Weitere Informationen zu dieser gespeicherten Prozedur finden Sie unter [rdsadmin.catalog\$1storage\$1access](db2-sp-managing-storage-access.md#db2-sp-catalog-storage-access).
1. Führen Sie den `LOAD`-Befehl mit dem Speicherzugriff-Alias, der auf Ihren Amazon-S3-Bucket verweist.
**Anmerkung**
Wenn der `LOAD`-Befehl einen Fehler zurückgibt, müssen Sie möglicherweise einen VPC-Gateway-Endpunkt für Amazon S3 erstellen und ausgehende Regeln zur Sicherheitsgruppe hinzufügen. Weitere Informationen finden Sie unter [I/O Fehler in der Datei](db2-troubleshooting.md#db2-file-input-output-error).
Im folgenden Beispiel werden Daten aus einer Datendatei mit dem Namen *my\$1s3\$1datafile.csv* in eine Tabelle mit dem Namen *my\$1db2\$1table* geladen. Das Beispiel geht davon aus, dass sich die Datendatei in dem Amazon S3 S3-Bucket befindet, auf den der Aliasname *my\$1s3\$1alias* verweist.
```
db2 "load from db2remote://my_s3_alias//my_s3_datafile.csv of DEL insert into my_db2_table";
```
Im folgenden Beispiel wird LOBs aus einer Datendatei mit dem Namen *my\$1table1\$1export.ixf* in eine Tabelle mit dem Namen geladen*my\$1db2\$1table*. Das Beispiel geht davon aus, dass sich die Datendatei in dem Amazon S3 S3-Bucket befindet, auf den der Aliasname *my\$1s3\$1alias* verweist.
```
db2 "call sysproc.admin_cmd('load from "db2remote://my_s3_alias//my_table1_export.ixf" of ixf
lobs from "db2remote://my_s3_alias//" xml from "db2remote://my_s3_alias//"
modified by lobsinfile implicitlyhiddeninclude identityoverride generatedoverride periodoverride transactionidoverride
messages on server
replace into "my_schema"."my_db2_table"
nonrecoverable
indexing mode incremental allow no access')"
```
Wiederholen Sie diesen Schritt für jede Datendatei im Amazon-S3-Bucket, die Sie in eine Tabelle in Ihrer DB-Instance von RDS für Db2 laden möchten.
Weitere Informationen zum `LOAD`-Befehl finden Sie unter [ LOAD-Befehl](https://www.ibm.com/docs/en/db2/11.5?topic=commands-load).
# Migrieren zu Amazon RDS für Db2 mit AWS Database Migration Service (AWS DMS)
Sie können AWS DMS für einmalige Migrationen verwenden und dann eine Synchronisierung von Db2 unter Linux, Unix (wie AIX) und Windows zu Amazon RDS für Db2 durchführen. Weitere Informationen finden Sie unter [Was ist AWS Database Migration Service?](https://docs.aws.amazon.com/dms/latest/userguide/Welcome.html).
# Verwendung nativer Db2-Tools zur Migration von Daten von Db2 zu Amazon RDS für Db2
Mit verschiedenen nativen Db2-Tools, -Dienstprogrammen und -Befehlen können Sie Daten direkt von einer Db2-Datenbank zu einer Datenbank von Amazon RDS für Db2 verschieben. Um diese systemeigenen Db2-Tools verwenden zu können, müssen Sie in der Lage sein, Ihren Client-Computer mit einer DB-Instance von RDS für Db2 zu verbinden. Weitere Informationen finden Sie unter [Verbinden eines Client-Computers mit einer DB-Instance von Amazon RDS für Db2](db2-connecting-client-rds.md).
**Anmerkung**
Eine andere Möglichkeit, Ihre Daten zu verschieben, besteht darin, sie zuerst in einem Amazon-S3-Bucket zu speichern und dann den `LOAD`-Befehl zu verwenden, um diese Daten in eine Tabelle in Ihrer Datenbank von RDS für Db2 zu übertragen. Diese Methode bietet aufgrund der guten Netzwerkkonnektivität zwischen RDS für Db2 und S3 die beste Leistung bei der Migration großer Datenmengen. Weitere Informationen finden Sie unter [Migrieren von Db2-Daten über Amazon S3 zu Amazon RDS für Db2](db2-migration-load-from-s3.md).
| Name des Tools | Anwendungsfall | Einschränkungen |
| --- | --- | --- |
| [db2look](db2-native-db2-tools-db2look.md) | Kopieren von Metadaten aus einer selbstverwalteten Db2-Datenbank in eine Datenbank von RDS für Db2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
| [IMPORT](db2-native-db2-tools-import.md)-Befehl | Migrieren kleiner Tabellen und Tabellen mit großen Objekten (LOBs) von einem Client-Computer zur DB-Instance von RDS für Db2. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
| [Dienstprogramm INGEST](db2-native-db2-tools-ingest.md) | Kontinuierliches Streamen von Daten aus Dateien und Pipes *ohne* große Objekte (LOBs) auf dem Client-Computer zur DB-Instance von RDS für Db2. Unterstützt die Operationen `INSERT` und `MERGE`. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
| [INSERT](db2-native-db2-tools-insert.md)-Befehl | Kopieren von Daten in kleinen Tabellen aus einer selbstverwalteten Db2-Datenbank in eine Datenbank von RDS für Db2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
| [LOAD CLIENT](db2-native-db2-tools-load.md)-Befehl | Migrieren kleiner Tabellen *ohne* große Objekte (LOBs) von einem Client-Computer zur DB-Instance von RDS für Db2. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
# Verbinden eines Client-Computers mit einer DB-Instance von Amazon RDS für Db2
Um eines der nativen Db2-Tools zum Verschieben von Daten aus einer Db2-Datenbank in eine Datenbank von Amazon RDS für Db2 zu verwenden, müssen Sie zuerst Ihren Client-Computer mit einer DB-Instance von RDS für Db2 verbinden.
Beim Client-Computer kann es sich um folgende handeln:
+ Amazon Elastic Compute Cloud (Amazon EC2)-Instance auf Linux, Windows oder macOS. Diese Instance sollte sich in derselben Virtual Private Cloud (VPC) wie Ihre RDS for Db2-DB-Instance befinden AWS Cloud9, oder. AWS CloudShell
+ Selbstverwaltete Db2-Instance in einer Amazon-EC2-Instance. Die Instances sollten sich in derselben VPC befinden.
+ Selbstverwaltete Db2-Instance in einer Amazon-EC2-Instance. Die Instanzen können unterschiedlich sein, VPCs wenn Sie VPC-Peering aktiviert haben. Weitere Informationen finden Sie unter [Erstellen einer VPC-Peering-Verbindung](https://docs.aws.amazon.com/vpc/latest/peering/create-vpc-peering-connection.html) im *Handbuch zu Amazon Virtual Private Cloud (VPC)-Peering*.
+ Lokaler Computer, der Linux, Windows oder macOS in einer selbstverwalteten Umgebung ausführt. Sie müssen entweder über eine öffentliche Verbindung zu RDS für Db2 verfügen oder die VPN-Konnektivität zwischen selbstverwalteten Db2-Instances und AWS aktivieren.
Um Ihren Client-Computer mit Ihrer DB-Instance von RDS für Db2 zu verbinden, melden Sie sich bei Ihrem Client-Computer mit IBM Db2 Data Management Console an. Weitere Informationen erhalten Sie unter [Erstellen einer Amazon-RDS-DB-Instance](USER_CreateDBInstance.md) und [IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md).
Sie können AWS Database Migration Service (AWS DMS) verwenden, um Abfragen in der Datenbank auszuführen, einen SQL-Ausführungsplan auszuführen und die Datenbank zu überwachen. Weitere Informationen finden Sie unter [Was ist der AWS Database Migration Service?](https://docs.aws.amazon.com/dms/latest/userguide/Welcome.html) im *AWS Database Migration Service Benutzerhandbuch*.
Nachdem Sie Ihren Client-Computer erfolgreich mit Ihrer DB-Instance von RDS für Db2 verbunden haben, können Sie jedes native Db2-Tool zum Kopieren von Daten verwenden. Weitere Informationen finden Sie unter [Verwendung nativer Db2-Tools zur Migration von Daten von Db2 zu Amazon RDS für Db2](db2-native-db2-tools.md).
# Kopieren von Datenbank-Metadaten von Db2 nach Amazon RDS für Db2 mit db2look
`db2look` ist ein systemeigenes Db2-Tool, das DDL-Dateien, Objekte, Autorisierungen, Konfigurationen, WLM und Datenbanklayouts extrahiert. Sie können `db2look` verwenden, um Datenbank-Metadaten aus einer selbstverwalteten Db2-Datenbank in eine Datenbank von Amazon RDS für Db2 zu kopieren. Weitere Informationen finden Sie unter [Mimicking databases using db2look](https://www.ibm.com/docs/en/db2/11.5?topic=tools-db2look) in der IBM Db2-Dokumentation.
**So kopieren Sie Datenbank-Metadaten**
1. Führen Sie das Tool `db2look` auf Ihrem selbstverwalteten Db2-System aus, um die DDL-Datei zu extrahieren. Ersetzen Sie im folgenden Beispiel *database\$1name* durch den Namen Ihrer Db2-Datenbank.
```
db2look -d database_name -e -l -a -f -wlm -cor -createdb -printdbcfg -o db2look.sql
```
1. Wenn Ihr Client-Computer Zugriff auf die (selbstverwaltete Db2-)Quelldatenbank und die DB-Instance von RDS für Db2 hat, können Sie die Datei `db2look.sql` auf dem Client-Computer erstellen, indem Sie sie direkt an die Remote-Instance anhängen. Katalogisieren Sie anschließend die selbstverwaltete Db2-Remote-Instance.
1. Katalogisieren Sie den Knoten. Ersetzen Sie im folgenden Beispiel *dns\$1ip\$1address* und *port* durch den DNS-Namen oder die IP-Adresse und die Portnummer der selbstverwalteten Db2-Datenbank.
```
db2 catalog tcpip node srcnode REMOTE dns_ip_address server port
```
1. Katalogisieren Sie die Datenbank. Ersetzen Sie im folgenden Beispiel *source\$1database\$1name* und *source\$1database\$1alias* durch den Namen der selbstverwalteten Db2-Datenbank und den Alias, den Sie für diese Datenbank verwenden möchten.
```
db2 catalog database source_database_name as source_database_alias at node srcnode \
authentication server_encrypt
```
1. Hängen Sie sie an die Quelldatenbank an. Ersetzen Sie im folgenden Beispiel *source\$1database\$1alias*, *user\$1id* und *user\$1password* durch den Alias, den Sie im vorherigen Schritt erstellt haben, sowie durch die Benutzer-ID und das Kennwort für die selbstverwaltete Db2-Datenbank.
```
db2look -d source_database_alias -i user_id -w user_password -e -l -a -f -wlm \
-cor -createdb -printdbcfg -o db2look.sql
```
1. Wenn Sie vom Client-Computer aus nicht auf die selbstverwaltete Db2-Remote-Datenbank zugreifen können, kopieren Sie die Datei `db2look.sql` auf den Client-Computer. Katalogisieren Sie dann die DB-Instance von RDS für Db2.
1. Katalogisieren Sie den Knoten. Ersetzen Sie im folgenden Beispiel *dns\$1ip\$1address* und *port* durch den DNS-Namen oder die IP-Adresse und die Portnummer der DB-Instance von RDS für Db2.
```
db2 catalog tcpip node remnode REMOTE dns_ip_address server port
```
1. Katalogisieren Sie die Datenbank. Ersetzen Sie im folgenden Beispiel *rds\$1database\$1name* und *rds\$1database\$1alias* durch den Namen der Datenbank von RDS für Db2 und den Alias, den Sie für diese Datenbank verwenden möchten.
```
db2 catalog database rds_database_name as rds_database_alias at node remnode \
authentication server_encrypt
```
1. Katalogisieren Sie die Admin-Datenbank, die RDS für Db2 verwaltet. Sie können diese Datenbank nicht verwenden, um Daten zu speichern.
```
db2 catalog database rdsadmin as rdsadmin at node remnode authentication server_encrypt
```
1. Erstellen Sie Pufferpools und Tablespaces. Der Administrator hat keine Rechte zum Erstellen von Pufferpools oder Tablespaces. Sie können jedoch gespeicherte Amazon-RDS-Prozeduren verwenden, um sie zu erstellen.
1. Suchen Sie in der Datei `db2look.sql` nach den Namen und Definitionen der Pufferpools und Tablespaces.
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zu Amazon RDS her. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch Ihre Informationen.
```
db2 connect to rdsadmin user master_username using master_password
```
1. Erstellen Sie einen Pufferpool, indem Sie `rdsadmin.create_bufferpool` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.create\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-create-buffer-pool).
```
db2 "call rdsadmin.create_bufferpool(
'database_name',
'buffer_pool_name',
buffer_pool_size,
'immediate',
'automatic',
page_size,
number_block_pages,
block_size)"
```
1. Erstellen Sie einen Tablespace, indem Sie `rdsadmin.create_tablespace` aufrufen. Weitere Informationen finden Sie unter [rdsadmin.create\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-create-tablespace).
```
db2 "call rdsadmin.create_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_initial_size,
tablespace_increase_size,
'tablespace_type')"
```
1. Wiederholen Sie die Schritte c oder d für jeden zusätzlichen Pufferpool oder Tablespace, den Sie hinzufügen möchten.
1. Beenden Sie Ihre Verbindung.
```
db2 terminate
```
1. Erstellen Sie Tabellen und Objekte.
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur Ihrer Datenbank von RDS für Db2 her. Ersetzen Sie im folgenden Beispiel *rds\$1database\$1name*, *master\$1username* und *master\$1password* durch Ihre Informationen.
```
db2 connect to rds_database_name user master_username using master_password
```
1. Führen Sie die Datei `db2look.sql` aus.
```
db2 -tvf db2look.sql
```
1. Beenden Sie Ihre Verbindung.
```
db2 terminate
```
# Importieren von Daten aus einem Client-Computer in Amazon RDS für Db2 mit dem Befehl IMPORT
Sie können den `IMPORT`-Befehl von einem Client-Computer aus verwenden, um Ihre Daten in den Server von Amazon RDS für Db2 zu importieren.
**Wichtig**
Die Methode per `IMPORT`-Befehl ist hilfreich, um kleine Tabellen zu migrieren und Tabellen, die große Objekte (LOBs) enthalten. Der Befehl `IMPORT` ist aufgrund der Protokollierungsvorgänge `INSERT` und `DELETE` langsamer als das `LOAD`-Dienstprogramm. Wenn Ihre Netzwerkbandbreite zwischen dem Client-Computer und RDS für Db2 begrenzt ist, empfehlen wir Ihnen, einen anderen Migrationsansatz zu verwenden. Weitere Informationen finden Sie unter [Verwendung nativer Db2-Tools zur Migration von Daten von Db2 zu Amazon RDS für Db2](db2-native-db2-tools.md).
**So importieren Sie Daten in den Server von RDS für Db2**
1. Melden Sie sich über die IBM Db2 Data Management Console bei Ihrem Client-Computer an. Weitere Informationen finden Sie unter [Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md).
1. Katalogisieren Sie die Datenbank von RDS für Db2 auf dem Client-Computer.
1. Katalogisieren Sie den Knoten. Ersetzen Sie im folgenden Beispiel *dns\$1ip\$1address* und *port* durch den DNS-Namen oder die IP-Adresse und die Portnummer der selbstverwalteten Db2-Datenbank.
```
db2 catalog tcpip node srcnode REMOTE dns_ip_address server port
```
1. Katalogisieren Sie die Datenbank. Ersetzen Sie im folgenden Beispiel *source\$1database\$1name* und *source\$1database\$1alias* durch den Namen der selbstverwalteten Db2-Datenbank und den Alias, den Sie für diese Datenbank verwenden möchten.
```
db2 catalog database source_database_name as source_database_alias at node srcnode \
authentication server_encrypt
```
1. Hängen Sie sie an die Quelldatenbank an. Ersetzen Sie im folgenden Beispiel *source\$1database\$1alias*, *user\$1id* und *user\$1password* durch den Alias, den Sie im vorherigen Schritt erstellt haben, sowie durch die Benutzer-ID und das Kennwort für die selbstverwaltete Db2-Datenbank.
```
db2look -d source_database_alias -i user_id -w user_password -e -l -a -f -wlm \
-cor -createdb -printdbcfg -o db2look.sql
```
1. Generieren Sie die Datendatei mithilfe des ` EXPORT`-Befehls auf Ihrem selbstverwalteten Db2-System. Ersetzen Sie im folgenden Beispiel *directory* durch das Verzeichnis auf Ihrem Client-Computer, in dem sich Ihre Datendatei befindet. Ersetzen Sie *file\$1name* und *table\$1name* durch den Namen der Datendatei und den Namen der Tabelle.
```
db2 "export to /directory/file_name.txt of del lobs to /directory/lobs/ \
modified by coldel\| select * from table_name"
```
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur Ihrer Datenbank von RDS für Db2 her. Ersetzen Sie im folgenden Beispiel **rds\$1database\$1alias**, *master\$1username,* und *master\$1password* durch Ihre Informationen.
```
db2 connect to rds_database_alias user master_username using master_password
```
1. Verwenden Sie den `IMPORT`-Befehl, um Daten aus einer Datei auf dem Client-Computer in die Remotedatenbank von RDS für Db2 zu importieren. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [IMPORT command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-import). Ersetzen Sie im folgenden Beispiel *directory* und *file\$1name* durch das Verzeichnis auf Ihrem Client-Computer, in dem sich Ihre Datendatei befindet, und durch den Namen der Datendatei. Ersetzen Sie *SCHEMA\$1NAME* und *TABLE\$1NAME* durch den Namen Ihres Schemas und Ihrer Tabelle.
```
db2 "IMPORT from /directory/file_name.tbl OF DEL LOBS FROM /directory/lobs/ \
modified by coldel\| replace into SCHEMA_NAME.TABLE_NAME"
```
1. Beenden Sie Ihre Verbindung.
```
db2 terminate
```
# Importieren von Daten aus einem Client-Computer in Amazon RDS für Db2 mit dem Befehl LOAD
Sie können den `LOAD CLIENT`-Befehl verwenden, um Daten aus einer Datei auf einem Client-Computer auf den Server von RDS für Db2 zu laden. Da keine SSH-Konnektivität zum Server von RDS für Db2 besteht, können Sie den `LOAD CLIENT`-Befehl entweder auf Ihrem selbst verwalteten Db2-Server oder auf Ihrem Db2-Client-Computer verwenden.
**Wichtig**
Die Methode per `LOAD CLIENT`-Befehl ist nützlich für die Migration kleiner Tabellen. Wenn Ihre Netzwerkbandbreite zwischen dem Client und RDS für Db2 begrenzt ist, empfehlen wir Ihnen, einen anderen Migrationsansatz zu verwenden. Weitere Informationen hierzu finden Sie unter [Verwendung nativer Db2-Tools zur Migration von Daten von Db2 zu Amazon RDS für Db2](db2-native-db2-tools.md).
Wenn Ihre Datendatei Verweise auf große Objektdateinamen enthält, funktioniert der `LOAD`-Befehl nicht, da sich große Objekte (LOBs) auf dem Db2-Server befinden müssen. Wenn Sie versuchen, LOBs vom Client-Computer auf den Server von RDS für Db2 zu laden, erhalten Sie die Fehlermeldung SQL3025N. Verwenden Sie stattdessen den [IMPORT Befehl](db2-native-db2-tools-import.md).
**So laden Sie Daten in den Server von RDS für Db2**
1. Melden Sie sich über die IBM Db2 Data Management Console bei Ihrem Client-Computer an. Weitere Informationen finden Sie unter [Herstellen einer Verbindung zu Ihrer DB-Instance von RDS für Db2 mit IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md).
1. Katalogisieren Sie die Datenbank von RDS für Db2 auf dem Client-Computer.
1. Katalogisieren Sie den Knoten. Ersetzen Sie im folgenden Beispiel *dns\$1ip\$1address* und *port* durch den DNS-Namen oder die IP-Adresse und die Portnummer der selbstverwalteten Db2-Datenbank.
```
db2 catalog tcpip node srcnode REMOTE dns_ip_address server port
```
1. Katalogisieren Sie die Datenbank. Ersetzen Sie im folgenden Beispiel *source\$1database\$1name* und *source\$1database\$1alias* durch den Namen der selbstverwalteten Db2-Datenbank und den Alias, den Sie für diese Datenbank verwenden möchten.
```
db2 catalog database source_database_name as source_database_alias at node srcnode \
authentication server_encrypt
```
1. Hängen Sie sie an die Quelldatenbank an. Ersetzen Sie im folgenden Beispiel *source\$1database\$1alias*, *user\$1id* und *user\$1password* durch den Alias, den Sie im vorherigen Schritt erstellt haben, sowie durch die Benutzer-ID und das Kennwort für die selbstverwaltete Db2-Datenbank.
```
db2look -d source_database_alias -i user_id -w user_password -e -l -a -f -wlm \
-cor -createdb -printdbcfg -o db2look.sql
```
1. Generieren Sie die Datendatei mithilfe des `EXPORT`-Befehls auf Ihrem selbstverwalteten Db2-System. Ersetzen Sie im folgenden Beispiel *directory* durch das Verzeichnis auf Ihrem Client-Computer, in dem sich Ihre Datendatei befindet. Ersetzen Sie *file\$1name* und *TABLE\$1NAME* durch den Namen der Datendatei und den Namen der Tabelle.
```
db2 "export to /directory/file_name.txt of del modified by coldel\| \
select * from TPCH.TABLE_NAME"
```
1. Stellen Sie mithilfe des Hauptbenutzernamens und Hauptpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung zur Ihrer Datenbank von RDS für Db2 her. Ersetzen Sie im folgenden Beispiel **rds\$1database\$1alias**, *master\$1username* und *master\$1password* durch Ihre Informationen.
```
db2 connect to rds_database_alias user master_username using master_password
```
1. Verwenden Sie den `LOAD`-Befehl, um Daten aus einer Datei auf dem Client-Computer in die Remotedatenbank von RDS für Db2 zu laden. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [LOAD command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-load). Ersetzen Sie im folgenden Beispiel *directory* durch das Verzeichnis auf Ihrem Client-Computer, in dem sich Ihre Datendatei befindet. Ersetzen Sie *file\$1name* und *TABLE\$1NAME* durch den Namen der Datendatei und den Namen der Tabelle.
```
db2 "LOAD CLIENT from /directory/file_name.txt \
modified by coldel\| replace into TPCH.TABLE_NAME \
nonrecoverable without prompting"
```
1. Beenden Sie Ihre Verbindung.
```
db2 terminate
```
# Importieren von Daten aus Db2 in Amazon RDS für Db2 mit dem Befehl INSERT
Sie können den Befehl `INSERT` von einem selbstverwalteten Db2-Server aus verwenden, um Ihre Daten in eine Datenbank von Amazon RDS für Db2 einzufügen. Bei diesem Migrationsansatz verwenden Sie einen Spitznamen für die Remote-DB-Instance von RDS für Db2. Ihre selbstverwaltete Db2-Datenbank (Quelle) muss in der Lage sein, eine Verbindung zur Datenbank (Ziel) von RDS für Db2 herzustellen.
**Wichtig**
Die Methode per `INSERT`-Befehl ist nützlich für die Migration kleiner Tabellen. Wenn Ihre Netzwerkbandbreite zwischen Ihrer selbst verwalteten Db2-Datenbank und der Datenbank von RDS für Db2 begrenzt ist, empfehlen wir Ihnen, einen anderen Migrationsansatz zu verwenden. Weitere Informationen finden Sie unter [Verwendung nativer Db2-Tools zur Migration von Daten von Db2 zu Amazon RDS für Db2](db2-native-db2-tools.md).
**So kopieren Sie Daten aus einer selbstverwalteten Db2-Datenbank in eine Datenbank von RDS für Db2**
1. Katalogisieren Sie die DB-Instance von RDS für Db2 auf der selbstverwalteten Db2-Instance.
1. Katalogisieren Sie den Knoten. Ersetzen Sie im folgenden Beispiel *dns\$1ip\$1address* und *port* durch den DNS-Namen oder die IP-Adresse und die Portnummer der selbstverwalteten Db2-Datenbank.
```
db2 catalog tcpip node remnode REMOTE dns_ip_address SERVER port
```
1. Katalogisieren Sie die Datenbank. Ersetzen Sie im folgenden Beispiel *rds\$1database\$1name* durch den Namen der Datenbank auf Ihrer DB-Instance von RDS für Db2.
```
db2 catalog database rds_database_name as remdb at node remnode \
authentication server_encrypt
```
1. Aktivieren Sie „Verbund“ auf der selbstverwalteten Db2-Instance. Ersetzen Sie im folgenden Beispiel *source\$1database\$1name* durch den Namen Ihrer Datenbank auf der selbstverwalteten Db2-Instance.
```
db2 update dbm cfg using FEDERATED YES source_database_name
```
1. Erstellen Sie Tabellen auf der DB-Instance von RDS für Db2.
1. Katalogisieren Sie den Knoten. Ersetzen Sie im folgenden Beispiel *dns\$1ip\$1address* und *port* durch den DNS-Namen oder die IP-Adresse und die Portnummer der selbstverwalteten Db2-Datenbank.
```
db2 catalog tcpip node srcnode REMOTE dns_ip_address server port
```
1. Katalogisieren Sie die Datenbank. Ersetzen Sie im folgenden Beispiel *source\$1database\$1name* und *source\$1database\$1alias* durch den Namen der selbstverwalteten Db2-Datenbank und den Alias, den Sie für diese Datenbank verwenden möchten.
```
db2 catalog database source_database_name as source_database_alias at node srcnode \
authentication server_encrypt
```
1. Hängen Sie sie an die Quelldatenbank an. Ersetzen Sie im folgenden Beispiel *source\$1database\$1alias*, *user\$1id* und *user\$1password* durch den Alias, den Sie im vorherigen Schritt erstellt haben, sowie durch die Benutzer-ID und das Kennwort für die selbstverwaltete Db2-Datenbank.
```
db2look -d source_database_alias -i user_id -w user_password -e -l -a -f -wlm \
-cor -createdb -printdbcfg -o db2look.sql
```
1. Richten Sie die Verbundoption ein und erstellen Sie auf der selbstverwalteten Db2-Instance einen Spitznamen für die Datenbanktabelle von RDS für Db2.
1. Stellen Sie eine Verbindung mit Ihrer lokalen Datenbank her. Ersetzen Sie im folgenden Beispiel *source\$1database\$1name* durch den Namen der Datenbank auf Ihrer selbstverwalteten Db2-Instance.
```
db2 connect to source_database_name
```
1. Erstellen Sie einen Wrapper für den Zugriff auf Db2-Datenquellen.
```
db2 create wrapper drda
```
1. Definieren Sie eine Datenquelle in einer Verbunddatenbank. Ersetzen Sie im folgenden Beispiel *admin* und *admin\$1password* durch Ihre Anmeldeinformationen für Ihre selbstverwaltete Db2-Instance. Ersetzen Sie *rds\$1database\$1name* durch den Namen der Datenbank auf Ihrer DB-Instance von RDS für Db2.
```
db2 "create server rdsdb2 type DB2/LUW version '11.5.9.0' \
wrapper drda authorization "admin" password "admin_password" \
options( dbname 'rds_database_name', node 'remnode')"
```
1. Ordnen Sie die Benutzer in den beiden Datenbanken zu. Ersetzen Sie im folgenden Beispiel *master\$1username* und *master\$1password* durch die Anmeldeinformationen für Ihre DB-Instance von RDS für Db2.
```
db2 "create user mapping for user server rdsdb2 \
options (REMOTE_AUTHID 'master_username', REMOTE_PASSWORD 'master_password')"
```
1. Überprüfen Sie die Verbindung zum Server von RDS für Db2.
```
db2 set passthru rdsdb2
```
1. Erstellen Sie einen Spitznamen für die Tabelle in der Remote-Datenbank von RDS für Db2. Ersetzen Sie im folgenden Beispiel *NICKNAME* und *TABLE\$1NAME* durch einen Spitznamen für die Tabelle und ihren Namen.
```
db2 create nickname REMOTE.NICKNAME for RDSDB2.TABLE_NAME.NICKNAME
```
1. Fügen Sie in die Tabelle in der Remote-Datenbank von RDS für Db2 Daten ein. Verwenden Sie den Spitznamen in einer `select`-Anweisung in der lokalen Tabelle auf der selbstverwalteten Db2-Instance. Ersetzen Sie im folgenden Beispiel *NICKNAME* und *TABLE\$1NAME* durch einen Spitznamen für die Tabelle und ihren Namen.
```
db2 "INSERT into REMOTE.NICKNAME select * from RDS2DB2.TABLE_NAME.NICKNAME"
```
# Importieren von Daten aus Db2 in Amazon RDS für Db2 mit dem Dienstprogramm INGEST
Sie können das Dienstprogramm `INGEST` verwenden, um kontinuierlich Daten aus Dateien und Pipes auf einem Client-Computer zu einer DB-Ziel-Instance von Amazon RDS für Db2 zu streamen. Das Dienstprogramm `INGEST` unterstützt `INSERT`- und `MERGE`-Operationen. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [Ingest utility](https://www.ibm.com/docs/en/db2/11.1?topic=reference-ingest-utility).
Da das Dienstprogramm `INGEST` Spitznamen unterstützt, können Sie es verwenden, um Daten aus Ihrer selbstverwalteten Db2-Datenbank in eine Datenbank von RDS für Db2 zu übertragen. Dieser Ansatz funktioniert, solange Netzwerkkonnektivität zwischen den beiden Datenbanken besteht.
**Wichtig**
Das Dienstprogramm `INGEST` unterstützt keine großen Objekte (LOBs). Verwenden Sie stattdessen den [`IMPORT`-Befehl](db2-native-db2-tools-import.md).
Um das Feature `RESTARTABLE` des Dienstprogramms `INGEST` zu verwenden, führen Sie den folgenden Befehl in der Datenbank von RDS für Db2 aus.
```
db2 "call sysproc.sysinstallobjects(‘INGEST’,‘C’,NULL,NULL)"
```
# Verbund für Amazon RDS für Db2
Sie können Ihre Datenbank von Amazon RDS für Db2 als Verbunddatenbank verwenden. Nachdem Sie den Verbund für RDS für Db2 eingerichtet haben, können Sie von Ihrer Datenbank von RDS für Db2 aus auf Daten aus mehreren Datenbanken zugreifen und diese abfragen. Der Verbund erspart Ihnen die Migration von Daten in Ihre Datenbank von RDS für Db2 und die Konsolidierung von Daten in einer einzigen Datenbank.
Wenn Sie Ihre RDS for Db2-Datenbank als Verbunddatenbank verwenden, können Sie weiterhin auf alle Funktionen von RDS for Db2 zugreifen und verschiedene Vorteile nutzen AWS-Services, während Sie Ihre Daten in verschiedenen Datenbanken speichern. Sie können sowohl einen homogenen Verbund einrichten, der verschiedene Datenbanken desselben Typs verbindet, als auch einen heterogenen Verbund, der verschiedene Datenbanken unterschiedlichen Typs verbindet.
Zunächst verbinden Sie Ihre Db2-Datenbank in RDS für Db2 mit Remote-Datenbanken. Anschließend können Sie Abfragen in allen Ihre verbundenen Datenbanken durchführen. Sie können beispielsweise eine SQL JOIN-Anweisung ausführen, die Tabellen in Ihrer RDS for Db2-Datenbank mit Tabellen in einer entfernten Db2-On-Datenbank verknüpft. z/OS
**Topics**
+ [Homogener Verbund](#db2-federation-homogeneous)
+ [Heterogener Verbund](#db2-federation-heterogeneous)
## Homogener Verbund
Sie können einen homogenen Verbund zwischen Ihrer Datenbank von RDS für Db2 und der folgenden Db2-Produktfamilie einrichten:
+ Db2 für Linux, UNIX, Windows (LUW)
+ Db2 iSeries
+ Db2 für z/OS
Der homogene Verbund von RDS für Db2 unterstützt folgende Aktionen nicht:
+ Ausführen von `CATALOG`-Befehlen zum Einrichten eines Knotenverzeichnisses und einer Remote-Datenbank in einer Host-Datenbank von RDS für Db2
+ Einrichten von Workload-Balancing (WLB) beim Verbund mit Db2 auf z/OS
+ Konfigurieren der IBM-Datenservertreiber-Konfigurationsdatei (`db2dsdriver.cfg`)
Der homogene Verbund von RDS für Db2 hat die folgenden Anforderungen:
+ Sie müssen den DRDA-Wrapper im `UNFENCED`-Modus erstellen. Andernfalls funktioniert der Verbund in RDS für Db2 nicht.
+ Sie müssen eingehenden und ausgehenden Datenverkehr von Ihrer Host-Datenbank von RDS für Db2 zu Ihren Remote-Host-Datenbanken zulassen. Weitere Informationen finden Sie unter [Ermöglichen des Zugriffs auf Ihre DB-Instance in der VPC durch Erstellen einer Sicherheitsgruppe](CHAP_SettingUp.md#CHAP_SettingUp.SecurityGroup).
**Topics**
+ [Schritt 1: Erstellen eines DRDA-Wrapper und eines Verbundservers](#db2-federation-homogeneous-create)
+ [Schritt 2: Erstellen einer Benutzerzuordnung](#db2-federation-homogeneous-map)
+ [Schritt 3: Überprüfen der Verbindung](#db2-federation-homogeneous-check)
### Schritt 1: Erstellen eines DRDA-Wrapper und eines Verbundservers
Für einen homogenen Verbund erstellen Sie einen DRDA-Wrapper und einen Verbundserver. Die Verbindung zum Remote-Host verwendet `HOST`, `PORT` und `DBNAME`.
Wählen Sie eine der folgenden Methoden, je nach Typ Ihrer Remote-Db2-Datenbank:
+ **Datenbank von Db2 für Linux, UNIX und Windows (LUX)** – Führen Sie die folgenden SQL-Befehle aus. Im folgenden Beispiel *server\$1name* ersetzen Sie es durch den Namen des Servers, den Sie für den Verbund verwenden werden. *db2\$1version*Ersetzen Sie durch die Version Ihrer entfernten Db2-Datenbank. Ersetzen Sie *username* und *password* durch Ihre Anmeldeinformationen für die entfernte Db2-Datenbank, zu der Sie eine Verbindung herstellen möchten. Ersetzen Sie *db\$1name**dns\$1name*, und *port* durch die entsprechenden Werte für die entfernte Db2-Datenbank, zu der Sie eine Verbindung herstellen möchten.
```
create wrapper drda options(DB2_FENCED 'N');
create server server_name type DB2/LUW wrapper drda version 'db2_version' authorization "master_username" password "master_password" options (add DBNAME 'db_name',add HOST 'dns_name',add PORT 'port');
```
**Beispiel**
```
create wrapper drda options(DB2_FENCED 'N');
create server SERVER1 type DB2/LUW wrapper drda version '11.5' authorization "sysuser" password "******" options (add DBNAME 'TESTDB2',add HOST 'ip-123-45-67-899.us-west-1.compute.internal',add PORT '25010');
```
+ **Db2 iSeries** – Führen Sie die folgenden SQL-Befehle aus. [Ersetzen Sie im folgenden Beispiel *wrapper\$1name* und *library\$1name* durch einen Namen für Ihren DRDA-Wrapper und die Wrapper-Bibliotheksdatei.](https://www.ibm.com/docs/en/db2/11.5?topic=wrapper-db2-library-files) *server\$1name*Ersetzen Sie es durch den Namen des Servers, den Sie für den Verbund verwenden werden. *db2\$1version*Ersetzen Sie durch die Version Ihrer entfernten Db2-Datenbank. Ersetzen Sie *username* und *password* durch Ihre Anmeldeinformationen für die entfernte Db2-Datenbank, zu der Sie eine Verbindung herstellen möchten. Ersetzen Sie *dns\$1name**port*, und *db\$1name* durch die entsprechenden Werte für die entfernte Db2-Datenbank, zu der Sie eine Verbindung herstellen möchten.
```
create wrapper wrapper_name library 'library name' options(DB2_FENCED 'N');
create server server_name type db2/mvs version db2_version wrapper wrapper_name authorization "sername" password "password" options (HOST 'dns_name', PORT 'port', DBNAME 'db_name');
```
**Beispiel**
```
create wrapper WRAPPER1 library 'libdb2drda.so' options(DB2_FENCED 'N');
create server SERVER1 type db2/mvs version 11 wrapper WRAPPER1 authorization "sysuser" password "******" options (HOST 'test1.123.com', PORT '446', DBNAME 'STLEC1');
```
+ **Db2 für z/OS** – Führen Sie die folgenden SQL-Befehle aus. [Ersetzen Sie im folgenden Beispiel *wrapper\$1name* und *library\$1name* durch einen Namen für Ihren DRDA-Wrapper und die Wrapper-Bibliotheksdatei.](https://www.ibm.com/docs/en/db2/11.5?topic=wrapper-db2-library-files) *server\$1name*Ersetzen Sie es durch den Namen des Servers, den Sie für den Verbund verwenden werden. *db2\$1version*Ersetzen Sie durch die Version Ihrer entfernten Db2-Datenbank. Ersetzen Sie *username* und *password* durch Ihre Anmeldeinformationen für die entfernte Db2-Datenbank, zu der Sie eine Verbindung herstellen möchten. Ersetzen Sie *dns\$1name**port*, und *db\$1name* durch die entsprechenden Werte für die entfernte Db2-Datenbank, zu der Sie eine Verbindung herstellen möchten.
```
create wrapper wrapper_name library 'library_name' options(DB2_FENCED 'N');
create server server_name type db2/mvs version db2_version wrapper wrapper_name authorization "username" password "password" options (HOST 'dns_name', PORT 'port', DBNAME 'db_name');
```
**Beispiel**
```
create wrapper WRAPPER1 library 'libdb2drda.so' OPTIONS(DB2_FENCED 'N');
create server SERVER1 type db2/mvs version 11 wrapper WRAPPER1 authorization "sysuser" password "******" options (HOST 'test1.123.com', PORT '446', DBNAME 'STLEC1');
```
### Schritt 2: Erstellen einer Benutzerzuordnung
Erstellen Sie eine Benutzerzuordnung, um Ihren Verbundserver mit Ihrem Datenquellenserver zu verknüpfen, indem Sie den folgenden SQL-Befehl ausführen. Ersetzen Sie im folgenden Beispiel *server\$1name* durch den Namen des Fremdservers, auf dem Sie Operationen ausführen möchten. Dies ist der Server, den Sie in [Schritt 1](#db2-federation-homogeneous-create) erstellt haben. Ersetzen Sie *username* und *password* durch Ihre Anmeldeinformationen für diesen Remoteserver.
```
create user mapping for user server server_name options (REMOTE_AUTHID 'username', REMOTE_PASSWORD 'password');
```
Weitere Informationen finden Sie unter [User mappings](https://www.ibm.com/docs/en/db2/11.5?topic=systems-user-mappings) in der IBM Db2-Dokumentation.
### Schritt 3: Überprüfen der Verbindung
Vergewissern Sie sich, dass die Einrichtung Ihres Verbunds erfolgreich war, indem Sie die Verbindung überprüfen. Öffnen Sie eine Sitzung, um native SQL-Befehle mit dem Befehl SET PASSTHRU an Ihre Remote-Datenquelle zu senden, und erstellen Sie dann eine Tabelle auf dem Remote-Datenserver.
1. Öffnen und schließen Sie eine Sitzung, um SQL an eine Datenquelle zu senden. Im folgenden Beispiel *server\$1name* ersetzen Sie es durch den Namen des Servers, den Sie in Schritt 1 für den Verbund erstellt haben.
```
set passthru server_name;
```
1. Erstellen Sie eine neue -Tabelle. Ersetzen Sie im folgenden Beispiel *column\$1name**data\$1type*, und *value* durch die entsprechenden Elemente für Ihre Tabelle.
```
create table table_name ( column_name data_type(value), column_name data_type(value);
```
Weitere Informationen finden Sie unter [CREATE TABLE-Anweisung](https://www.ibm.com/docs/en/db2-event-store/2.0.0?topic=statements-create-table) in der IBM Db2-Dokumentation.
1. Erstellen Sie einen Index, fügen Sie Werte für Zeilen in die Tabelle ein und setzen Sie die Verbindung zurück. Beim Zurücksetzen der Verbindung wird die Verbindung unterbrochen, die Back-End-Prozesse werden jedoch beibehalten. Ersetzen Sie im folgenden Beispiel*index\$1name*, *table\$1name**column\$1name*, und *columnx\$1value* durch Ihre Informationen.
```
create index index_name on table_name(column_name);
insert into table_name values(column1_value,column2_value,column3_value);
insert into table_name values(column1_value,column2_value,column3_value);
set passthru reset;
connect reset;
```
1. Stellen Sie eine Verbindung zu Ihrer Remote-Db2-Datenbank her, erstellen Sie einen Spitznamen für Ihren Remote-Server und führen Sie Operationen aus. Wenn Sie den Zugriff auf Daten in der Remote-Db2-Datenbank abgeschlossen haben, setzen Sie die Verbindung zurück und beenden Sie sie dann. Ersetzen Sie im folgenden Beispiel *database\$1name* durch den Namen Ihrer entfernten Db2-Datenbank. Durch einen Namen *nickname* ersetzen. Ersetzen Sie *server\$1name* und *table\$1name* durch den Namen des Remoteservers und der Tabelle auf dem Server, auf dem Sie Operationen ausführen möchten. *username*Ersetzen Sie es durch die Informationen für Ihren Remoteserver. *sql\$1command*Ersetzen Sie durch den Vorgang, der auf dem Remoteserver ausgeführt werden soll.
```
connect to database_name;
create nickname nickname for server_name."username"."table_name";
select sql_command from nickname;
connect reset;
terminate;
```
**Beispiel**
Im folgenden Beispiel wird eine Passthrough-Sitzung erstellt, um Operationen auf dem Verbundserver `testdb10` zu ermöglichen.
Als Nächstes wird die Tabelle `t1` mit drei Spalten mit unterschiedlichen Datentypen erstellt.
Anschließend erstellt das Beispiel den Index `i1_t1` für drei Spalten in der Tabelle `t1`. Dann fügt es zwei Zeilen mit Werten für diese drei Spalten ein und trennt dann die Verbindung.
Zuletzt stellt das Beispiel eine Verbindung mit der Remote-Db2-Datenbank `testdb2` her und erstellt einen Spitznamen für die Tabelle ` t1` auf dem Verbundserver `testdb10`. Es erstellt den Spitznamen mit dem Benutzernamen `TESTUSER` für diese Datenquelle. Ein SQL-Befehl gibt alle Daten aus der Tabelle `t1` aus. Das Beispiel trennt die Verbindung und beendet die Sitzung.
```
set passthru testdbl0;
create table t1 ( c1 decimal(13,0), c2 char(200), c3 int);
create index i1_t1 on t1(c3);
insert into t1 values(1,'Test',1);
insert into t1 values(2,'Test 2',2);
connect reset;
connect to testdb2;
create nickname remote_t1 for testdbl0."TESTUSER"."T1";
select * from remote_t1;
connect reset;
terminate;
```
## Heterogener Verbund
Sie können einen heterogenen Verbund zwischen Ihrer Datenbank von RDS für Db2 und anderen Datenquellen wie Oracle und Microsoft SQL Server einrichten. Eine vollständige Liste der Datenquellen, die Db2 LUW unterstützt, finden Sie unter [Data Source Support Matrix of Federation Bundled in Db2 LUW V11.5](https://www.ibm.com/support/pages/data-source-support-matrix-federation-bundled-db2-luw-v115) auf der IBM-Support-Website.
Der heterogene Verbund von RDS für Db2 unterstützt die folgenden Elemente nicht:
+ Native Wrapper für die anderen Datenquellen
+ JDBC-Wrapper für die anderen Datenquellen
+ Verbund mit Sybase-, Informix- und Teradata-Datenquellen, da für diese Datenquellen eine Clientsoftwareinstallation auf RDS für Db2 erforderlich ist
Der heterogene Verbund von RDS für Db2 hat die folgenden Anforderungen:
+ RDS für Db2 unterstützt nur die ODBC-Wrapper-Methode.
+ Wenn Sie eine explizite Definition eines Wrappers erstellen, müssen Sie die Option `DB2_FENCED` auf `'N'` setzen. Eine Liste der gültigen Wrapper-Optionen für ODBC finden Sie in der IBM Db2-Dokumentation unter [ODBC options](https://www.ibm.com/docs/en/db2/11.5?topic=options-odbc).
+ Sie müssen eingehenden und ausgehenden Datenverkehr von Ihrer Host-Datenbank von RDS für Db2 zu Ihrer Remote-Host-Datenbank zulassen. Weitere Informationen finden Sie unter [Ermöglichen des Zugriffs auf Ihre DB-Instance in der VPC durch Erstellen einer Sicherheitsgruppe](CHAP_SettingUp.md#CHAP_SettingUp.SecurityGroup).
Informationen zum Verbund mit Oracle finden Sie unter [How to query Oracle by using Db2 Federation and the ODBC driver?](https://www.ibm.com/support/pages/node/6431133) auf der IBM-Support-Website.
Informationen zu Datenquellen, die den Verbund unterstützen finden Sie unter [Data Source Support Matrix of Federation Bundled in Db2 LUW V11.5](https://www.ibm.com/support/pages/node/957245) auf der IBM-Support-Website.
**Topics**
+ [Schritt 1: Erstellen eines ODBC-Wrappers](#db2-federation-heteogenous-define-wrapper)
+ [Schritt 2: Erstellen eines Verbundservers](#db2-federation-heterogeneous-create)
+ [Schritt 3: Erstellen einer Benutzerzuordnung](#db2-federation-heterogeneous-map)
+ [Schritt 4: Überprüfen der Verbindung](#db2-federation-heterogeneous-check)
### Schritt 1: Erstellen eines ODBC-Wrappers
Erstellen Sie einen Wrapper, indem Sie den folgenden Befehl ausführen:
```
db2 "create wrapper odbc options( module '/home/rdsdb/sqllib/federation/odbc/lib/libodbc.so')"
```
### Schritt 2: Erstellen eines Verbundservers
Erstellen Sie einen Verbundserver, indem Sie den folgenden Befehl ausführen. Im folgenden Beispiel *server\$1name* ersetzen Sie es durch den Namen des Servers, den Sie für den Verbund verwenden werden. Ersetzen Sie es *wrapper\$1type* durch den entsprechenden Wrapper. *db\$1version*Ersetzen Sie durch die Version Ihrer entfernten Datenbank. Ersetzen Sie *dns\$1name**port*, und *service\$1name* durch die entsprechenden Werte für die entfernte Datenbank, zu der Sie eine Verbindung herstellen möchten.
```
db2 "create server server_name type wrapper_type version db_version options (HOST 'dns_name', PORT 'port', SERVICE_NAME 'service_name')“
```
Informationen zu Wrapper-Typen finden Sie unter [Data Source Support Matrix of Federation Bundled in Db2 LUW V11.5](https://www.ibm.com/support/pages/node/957245) auf der IBM-Support-Website.
**Beispiel**
Im folgenden Beispiel wird ein Verbundserver für eine Remote-Oracle-Datenbank erstellt.
```
db2 "create server server1 type oracle_odbc version 12.1 options (HOST 'test1.amazon.com', PORT '1521', SERVICE_NAME 'pdborcl.amazon.com')“
```
### Schritt 3: Erstellen einer Benutzerzuordnung
Erstellen Sie eine Benutzerzuordnung, um Ihren Verbundserver mit Ihrem Datenquellenserver zu verknüpfen, indem Sie den folgenden SQL-Befehl ausführen. Ersetzen Sie im folgenden Beispiel *server\$1name* durch den Namen des Remoteservers, auf dem Sie Operationen ausführen möchten. Dies ist der Server, den Sie in [Schritt 2](#db2-federation-heterogeneous-create) erstellt haben. Ersetzen Sie *username* und *password* durch Ihre Anmeldeinformationen für diesen Remoteserver.
```
create user mapping for user server server_name options (REMOTE_AUTHID 'username', REMOTE_PASSWORD 'password');
```
Weitere Informationen finden Sie unter [User mappings](https://www.ibm.com/docs/en/db2/11.5?topic=systems-user-mappings) in der IBM Db2-Dokumentation.
### Schritt 4: Überprüfen der Verbindung
Vergewissern Sie sich, dass die Einrichtung Ihres Verbunds erfolgreich war, indem Sie die Verbindung überprüfen. Öffnen Sie eine Sitzung, um native SQL-Befehle mit dem Befehl SET PASSTHRU an Ihre Remote-Datenquelle zu senden, und erstellen Sie dann eine Tabelle auf dem Remote-Datenserver.
1. Öffnen und schließen Sie eine Sitzung, um SQL an eine Datenquelle zu senden. Im folgenden Beispiel *server\$1name* ersetzen Sie es durch den Namen des Servers, den Sie in [Schritt 2](#db2-federation-heterogeneous-create) für den Verbund erstellt haben.
```
set passthru server_name;
```
1. Erstellen Sie eine neue -Tabelle. Ersetzen Sie im folgenden Beispiel *column\$1name**data\$1type*, und *value* durch die entsprechenden Elemente für Ihre Tabelle.
```
create table table_name ( column_name data_type(value), column_name data_type(value);
```
Weitere Informationen finden Sie unter [CREATE TABLE-Anweisung](https://www.ibm.com/docs/en/db2-event-store/2.0.0?topic=statements-create-table) in der IBM Db2-Dokumentation.
1. Erstellen Sie einen Index, fügen Sie Werte für Zeilen in die Tabelle ein und setzen Sie die Verbindung zurück. Beim Zurücksetzen der Verbindung wird die Verbindung unterbrochen, die Back-End-Prozesse werden jedoch beibehalten. Ersetzen Sie im folgenden Beispiel*index\$1name*, *table\$1name**column\$1name*, und *columnx\$1value* durch Ihre Informationen.
```
create index index_name on table_name(column_name);
insert into table_name values(column1_value,column2_value,column3_value);
insert into table_name values(column1_value,column2_value,column3_value);
set passthru reset;
connect reset;
```
1. Stellen Sie eine Verbindung zu Ihrer Remote-Db2-Datenbank her, erstellen Sie einen Spitznamen für Ihren Remote-Server und führen Sie Operationen aus. Wenn Sie den Zugriff auf Daten in der Remote-Db2-Datenbank abgeschlossen haben, setzen Sie die Verbindung zurück und beenden Sie sie dann. Ersetzen Sie im folgenden Beispiel *database\$1name* durch den Namen Ihrer entfernten Db2-Datenbank. Durch einen Namen *nickname* ersetzen. Ersetzen Sie *server\$1name* und *table\$1name* durch den Namen des Remoteservers und der Tabelle auf dem Server, auf dem Sie Operationen ausführen möchten. *username*Ersetzen Sie es durch die Informationen für Ihren Remoteserver. *sql\$1command*Ersetzen Sie durch den Vorgang, der auf dem Remoteserver ausgeführt werden soll.
```
connect to database_name;
create nickname nickname for server_name."username"."table_name";
select sql_command from nickname;
connect reset;
terminate;
```
**Beispiel**
Im folgenden Beispiel wird eine Passthrough-Sitzung erstellt, um Operationen auf dem Verbundserver `testdb10` zu ermöglichen.
Als Nächstes wird die Tabelle `t1` mit drei Spalten mit unterschiedlichen Datentypen erstellt.
Anschließend erstellt das Beispiel den Index `i1_t1` für drei Spalten in der Tabelle `t1`. Dann fügt es zwei Zeilen mit Werten für diese drei Spalten ein und trennt dann die Verbindung.
Zuletzt stellt das Beispiel eine Verbindung mit der Remote-Db2-Datenbank `testdb2` her und erstellt einen Spitznamen für die Tabelle ` t1` auf dem Verbundserver `testdb10`. Es erstellt den Spitznamen mit dem Benutzernamen `TESTUSER` für diese Datenquelle. Ein SQL-Befehl gibt alle Daten aus der Tabelle `t1` aus. Das Beispiel trennt die Verbindung und beendet die Sitzung.
```
set passthru testdbl0;
create table t1 ( c1 decimal(13,0), c2 char(200), c3 int);
create index i1_t1 on t1(c3);
insert into t1 values(1,'Test',1);
insert into t1 values(2,'Test 2',2);
connect reset;
connect to testdb2;
create nickname remote_t1 for testdbl0."TESTUSER"."T1";
select * from remote_t1;
connect reset;
terminate;
```
# Arbeiten mit Replikaten für Amazon RDS für Db2
RDS für Db2 unterstützt die Erstellung von Replikatdatenbanken, um Leseskalierung und Notfallwiederherstellungs-Funktionen bereitzustellen. Sie können Replikate in zwei Modi erstellen: schreibgeschützte Replikate zum Auslagern von Lese-Workloads und Standby-Replikate für die regionsübergreifende Notfallwiederherstellung. RDS für Db2 verwendet für die Replikation die High Availability Disaster Recovery (HADR)-Technologie von IBM Db2. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [High availability disaster recovery (HADR)](https://www.ibm.com/docs/en/db2/11.5?topic=server-high-availability-disaster-recovery-hadr).
Eine *Db2-Replikat*-datenbank ist eine physische Kopie Ihrer primären Datenbank. Ein Db2-Replikat im schreibgeschützten Modus wird als *Lesereplikat* bezeichnet. Ein Db2-Replikat im Standby-Modus wird als *Standby-Replikat* bezeichnet. Db2 lässt keine Schreibvorgänge in einem Replikat zu, aber Sie können ein Replikat heraufstufen, um es beschreibbar zu machen. Das hochgestufte Replikat weist die replizierten Daten bis zu dem Punkt auf, an dem die Anforderung zum Hochstufen ausgegeben wurde. Weitere Informationen finden Sie unter [Hochstufen eines Lesereplikats zur eigenständigen DB-Instance](USER_ReadRepl.Promote.md).
Eine Zusammenfassung der Funktionen und Verhaltensweisen von Replikaten von RDS für Db2 finden Sie unter [Unterschiede zwischen Lesereplikaten für DB-Engines](USER_ReadRepl.Overview.Differences.md).
## Lese- und Standby-Replikate
Wenn Sie ein Db2-Replikat erstellen oder ändern, können Sie es in einen der folgenden Modi versetzen:
**Read-only**
Dies ist die Standardeinstellung. HADR überträgt und wendet Änderungen aus der Quelldatenbank auf alle Lesereplikat-Datenbanken an. Für schreibgeschützte Replikate ist die Db2-Umgebungsvariable `DB2_HADR_ROS` auf `ON` gesetzt. Die Isolationsstufe für Leseabfragen in der Replikatdatenbank ist `Uncommitted Read`. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [Isolation level on the active standby database](https://www.ibm.com/docs/en/db2/11.5?topic=standby-isolation-level-active-database).
Allgemeine Hinweise zu Read Replicas, die für alle DB-Engines gelten, finden Sie unter [Arbeiten mit DB-Instance-Lesereplikaten](USER_ReadRepl.md). Weitere Informationen zu Db2 HADR finden Sie in der IBM Db2-Dokumentation unter [High availability disaster recovery (HADR)](https://www.ibm.com/docs/en/db2/11.5?topic=server-high-availability-disaster-recovery-hadr).
**Standby**
Für Standby-Replikate wird die Db2-Umgebungsvariable `DB2_HADR_ROS` auf `OFF` gesetzt, damit die Replikatdatenbanken keine Benutzerverbindungen akzeptieren. Die primäre Verwendung für Standby-Replikate ist die überregionale Notfallwiederherstellung.
Ein Standby-Replikat kann keine schreibgeschützte Workload bereitstellen. Das Standby-Replikat hat keine Archivprotokolle.
Sie können bis zu drei Replikate aus einer Quell-DB-Instance erstellen. Sie können eine Kombination aus schreibgeschützten und Standby-DB-Replikaten für dieselbe Quell-DB-Instance erstellen. Nachdem Sie ein Replikat erstellt haben, können Sie den Replikatmodus ändern. Weitere Informationen finden Sie unter [Ändern des Replikatmodus von RDS für Db2](db2-replicas-changing-replica-mode.md).
Überprüfen Sie vor dem Erstellen der Replikate, ob alle Voraussetzungen erfüllt sind. Weitere Informationen finden Sie unter [Anforderungen und Überlegungen zur Sicherung und Wiederherstellung von Replikaten von RDS für Db2.](db2-read-replicas.limitations.md).
## Datenbankaktivierungen
Db2 HADR wird auf Datenbankebene konfiguriert. Nachdem Sie Replikate erstellt haben, wird HADR für alle Db2-Datenbanken festgelegt, einschließlich `rdsadmin`, die RDS vollständig verwaltet. Bevor Sie Db2-Replikate erstellen, müssen Sie alle Datenbanken explizit aktivieren. Andernfalls schlägt die Erstellung von Replikaten fehl und Amazon RDS gibt ein Ereignis aus. Sobald eine DB-Instance über ein oder mehrere Replikate verfügt, können Sie mit den gespeicherten Prozeduren `rdsadmin.activate_database` oder `rdsadmin.deactivate_database` keine Datenbanken mehr auf der DB-Instance aktivieren oder deaktivieren. Weitere Informationen finden Sie unter [Gespeicherte Prozeduren für Datenbanken von RDS für Db2](db2-sp-managing-databases.md).
## HADR-Konfigurationen
Sie können alle HADR-Konfigurationen für eine Datenbank anzeigen, indem Sie eine Verbindung zu der Datenbank herstellen und dann `db2 get db cfg` ausführen.
## Aufbewahrung archivierter Protokolle
Amazon RDS löscht Protokolle aus einer primären DB-Instance, wenn die folgenden Bedingungen erfüllt sind:
+ Die Protokolle sind mindestens zwei Stunden alt.
+ Die Archiveinstellung für die Aufbewahrungszeit des Protokolls ist abgelaufen.
+ Die Archivprotokolle wurden erfolgreich auf alle Replikat-DB-Instances repliziert. Diese Bedingung gilt sowohl für DB-Instances in derselben AWS-Region als auch für regionsübergreifende DB-Instances.
Weitere Informationen zum Festlegen von Aufbewahrungszeiten für Archivprotokolle finden Sie unter [rdsadmin.set\$1archive\$1log\$1retention](db2-sp-managing-databases.md#db2-sp-set-archive-log-retention).
Amazon RDS überprüft und bereinigt jede Datenbank einzeln. Wenn eine Datenbank die HADR-Verbindung verliert oder keine Informationen über die Verbindung verfügbar sind, überspringt Amazon RDS die Datenbank und löscht die Archivprotokolle nicht.
## Ausfälle während der Db2-Replikation
Wenn Sie ein Replikat erstellen, fertigt Amazon RDS einen DB-Snapshot Ihrer Quell-DB-Instance an und beginnt mit der Replikation. Wenn der DB-Snapshot-Vorgang beginnt, wird die Quell-DB-Instance kurzzeitig unterbrochen I/O . Die I/O Unterbrechung dauert in der Regel etwa eine Sekunde. Wenn es sich bei der Quell-DB-Instance jedoch um eine Multi-AZ-Bereitstellung handelt, wird die Quell-DB-Instance nicht I/O gesperrt. Dies liegt daran, dass bei Multi-AZ-Bereitstellungen der Snapshot von der sekundären DB-Instance erstellt wird.
Der DB-Snapshot wird zum Db2-Replikat. Amazon RDS legt die erforderlichen Parameter und Berechtigungen für die Quelldatenbank und das Replikat ohne Serviceunterbrechung fest. Wenn Sie ein Replikat löschen, tritt ebenfalls kein Ausfall auf.
# Anforderungen und Überlegungen zur Sicherung und Wiederherstellung von Replikaten von RDS für Db2.
Die Anforderungen an das DB2-Replikat lassen sich in mehrere Kategorien einteilen: Lizenzierung und Versionsverwaltung, Überlegungen zur Sicherung und Wiederherstellung, Replikationsverhalten und allgemeine operative Überlegungen. Machen Sie sich vor dem Erstellen eines Db2-Replikats mit den folgenden Anforderungen und Überlegungen vertraut.
## Versions- und Lizenzierungsanforderungen für Replikate von RDS für Db2
Bevor Sie ein Replikat von RDS für Db2 erstellen, sollten Sie die folgenden Informationen zu Versionen und Lizenzmodellen überprüfen:
+ **Unterstützte Versionen** – Alle Versionen von Db2 11.5 unterstützen Replikat-DB-Instances.
Quell- und Replikat-DB-Instances müssen dieselbe Hauptversion verwenden. Db2-Replikate unterstützen Nebenversions-, aber keine Hauptversions-Upgrades. Informationen zum Upgrade von DB-Instances finden Sie unter [Upgrade der Engine-Version für eine DB-Instance ](USER_UpgradeDBInstance.Upgrading.md).
**Anmerkung**
Beim Upgrade einer Quell-DB-Instance werden alle Replikate automatisch aktualisiert, um die Versionskompatibilität zu erhalten.
+ **Gültige Lizenzmodelle und Replikatmodi** — Sowohl mit der Db2 Advanced Edition (AE) als auch mit der Standard Edition (SE) können Replikate sowohl für das Bring Your Own License (BYOL) -Modell als auch für das Db2-Lizenzdurchgangsmodell im schreibgeschützten Modus oder im Standby-Modus erstellt werden. AWS Marketplace
+ **Benutzerdefinierte Parametergruppe** – Sie müssen eine benutzerdefinierte Parametergruppe für das Replikat angeben.
Für Replikate, die das BYOL-Modell verwenden, muss diese benutzerdefinierte Parametergruppe Ihre IBM Site ID und IBM Customer ID enthalten. Weitere Informationen finden Sie unter [IBM IDs für Bring Your Own License (BYOL) für Db2](db2-licensing.md#db2-prereqs-ibm-info). Sie können diese benutzerdefinierte Parametergruppe für das Replikat mithilfe der, der oder der RDS-API angeben. AWS-Managementkonsole AWS CLI
+ Die **vCPU-Anzahl** variiert je nach Replikatmodus und Lizenzmodell:
+ **Standby-Replikate** verwenden CPUs unabhängig von der Größe der DB-Instance immer zwei V.
+ **BYOL-Modell** — AWS License Manager Konfigurationen zeigen, dass RDS für Db2-DB-Instances zwei v verwendet. CPUs
+ **Db2-Lizenz pro AWS Marketplace Modell —** Die Rechnungen beziehen sich auf die Lizenzkosten für zwei v. CPUs
+ **Schreibgeschützte Replikate** verwenden dieselbe vCPU-Anzahl wie die DB-Instance-Größe.
+ **BYOL-Modell** — AWS License Manager Konfigurationen zeigen, dass RDS für Db2-DB-Instances dieselbe Anzahl von v verwendetCPUs , die der DB-Instance-Größe entspricht.
+ **Db2-Lizenz pro AWS Marketplace Modell** — Die Rechnungen beziehen sich auf die Lizenzkosten für dieselbe Anzahl von vCPUs , die der DB-Instance-Größe entsprechen.
## Überlegungen zu Sicherung und Wiederherstellung von Replikaten von RDS für Db2
Replikat-Sicherungen verhalten sich anders als Primärdatenbank-Sicherungen. Beachten Sie die folgenden Sicherungs- und Wiederherstellungsanforderungen:
+ Um Snapshots von Replikaten von RDS für Db2 zu erstellen oder automatische Sicherungen zu aktivieren, stellen Sie sicher, dass Sie den Aufbewahrungszeitraum für Sicherungen manuell festlegen. Automatische Backups sind standardmäßig nicht aktiviert.
+ Wenn Sie ein Replikat-Backup wiederherstellen, erfolgt die Wiederherstellung auf die Datenbankzeit, nicht auf die Uhrzeit, zu der das Backup erstellt wurde. Die Datenbank-Zeit bezieht sich auf die letzte angewendete Transaktionszeit der Daten im Backup. Der Unterschied ist erheblich, da ein Replikat Minuten oder Stunden hinter der Primärdatenbank zurückbleiben kann. Wenn mehrere Datenbanken vorhanden sind, verwendet RDS für Db2 die früheste Datenbankzeit.
Um den Unterschied herauszufinden, führen Sie den AWS CLI [describe-db-snapshots](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-snapshots.html)Befehl aus oder rufen Sie die DBSnapshots RDS-API-Operation [Describe](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBSnapshots.html) auf. Vergleichen Sie den Wert `SnapshotDatabaseTime` mit dem Wert `OriginalSnapshotCreateTime`. Der Wert `SnapshotDatabaseTime` ist die Datenbankzeit der Replikat-Sicherung. Der Wert `OriginalSnapshotCreateTime` ist die letzte angewendete Transaktion auf der Primärdatenbank.
Informationen zu Sicherungen und zum Wiederherstellen einer Sicherung finden Sie unter [Arbeiten mit Sicherungen für Replikate von RDS für Db2](db2-read-replicas.backups.md).
## Überlegungen zu Replikaten von RDS für Db2
Db2-Replikate verwenden die HADR-Technologie mit bestimmten Einschränkungen und Verhaltensweisen. Sehen Sie sich die folgenden replikationsbezogenen Überlegungen an:
+ Bei der Replikation wird Db2 HADR für alle Datenbanken auf der DB-Instance von RDS für Db2 verwendet.
+ Die Replikation unterstützt den Befehl `LOAD` nicht. Wenn Sie den Befehl `LOAD` von der Quell-DB-Instance aus ausführen, erhalten Sie uneinheitliche Daten.
+ RDS für Db2 repliziert die folgenden Elemente nicht:
+ Speicherzugriff. Achten Sie auf Daten, wie z. B. externe Tabellen, die auf Speicherzugriff angewiesen sind.
+ Nicht-Inline-Dateien LOBs , die nicht protokolliert werden.
+ Binärdateien externer gespeicherter Prozeduren (in C oder Java).
+ Für Standby-Replikate repliziert RDS für Db2 die folgenden Elemente:
+ Lokale Benutzer, außer Hauptbenutzern
+ Datenbank-Konfigurationsparameter
+ Bei schreibgeschützten Replikaten repliziert RDS für Db2 die folgenden Elemente:
+ Lokale Benutzer, außer Hauptbenutzern
+ SID-Gruppenzuordnungen
## Verschiedene Überlegungen zu Replikationen von RDS für Db2
Für Db2-Replikate gelten zusätzliche operative Überlegungen. Überprüfen Sie die folgenden Elemente:
+ RDS für Db2 repliziert Datenbankkonfigurationen auf die Replikate. Wenn RDS für Db2 ein Replikat hochstuft, deaktiviert und aktiviert es jede Datenbank.
+ RDS für Db2 repliziert die lokalen Benutzer, aber nicht die Hauptbenutzer, und SID-Gruppenzuordnungen an die Replikate. Sie können den Hauptbenutzer auf dem Replikat ändern. Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md).
+ Alle Datenbanken müssen sich im aktiven Zustand befinden. Informationen zum Aktivieren von Datenbanken finden Sie unter [Gespeicherte Prozeduren für Datenbanken von RDS für Db2](db2-sp-managing-databases.md).
+ Alle gespeicherten Prozeduren zum Erstellen, Löschen, Wiederherstellen oder Rollforward von Datenbanken müssen abgeschlossen sein, bevor ein Replikat erstellt werden kann. Informationen zu diesen gespeicherten Prozeduren finden Sie unter [Gespeicherte Prozeduren für Datenbanken von RDS für Db2](db2-sp-managing-databases.md).
+ Wenn das Replikat erstellt wird, setzt Amazon RDS den Parameter `blocknonlogged` auf Datenbankebene für alle Datenbanken auf der Quell-DB-Instance auf `YES`. Wenn das Quellreplikat wieder zu einer eigenständigen Instance wird, setzt Amazon RDS den Wert wieder auf `NO`. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [blocknonlogged – Block creation of tables that allow non-logged activity configuration parameter](https://www.ibm.com/docs/en/db2/11.1?topic=dcp-blocknonlogged-block-creation-tables-that-allow-non-logged-activity).
+ Wenn das Replikat erstellt wird, setzt Amazon RDS den Parameter `logindexbuild` auf Datenbankebene für alle Datenbanken auf der Quell-DB-Instance auf `YES`. Wenn das Quellreplikat wieder zu einer eigenständigen Instance wird, setzt Amazon RDS den Wert wieder auf `NO`. Weitere Informationen finden Sie in der IBM Db2-Dokumentation unter [logindexbuild – Log index pages created configuration parameter](https://www.ibm.com/docs/en/db2/11.1?topic=parameters-logindexbuild-log-index-pages-created).
# Vorbereiten der Erstellung eines Replikats von RDS für Db2
Bevor Sie ein Replikat von RDS für Db2 erstellen können, müssen Sie die folgenden Aufgaben ausführen, damit die Replikation erfolgreich verläuft. Diese Aufgaben tragen dazu bei, häufig auftretende Probleme zu vermeiden und eine optimale Leistung sicherzustellen.
## Aufgabe 1: Automatische Sicherungen aktivieren
Bevor eine DB-Instance als eine Quell-DB-Instance eingesetzt werden kann, müssen Sie automatische Sicherungen auf der Quell-DB-Instance aktivieren. Dies ist eine Voraussetzung für alle Replikaterstellungen. Weitere Informationen zum Ausführen dieses Verfahrens finden Sie unter [Aktivieren von automatisierten Backups](USER_WorkingWithAutomatedBackups.Enabling.md).
Informationen zu spezifischen Sicherungen für Db2-Replikate finden Sie unter [Arbeiten mit Sicherungen für Replikate von RDS für Db2](db2-read-replicas.backups.md).
## Aufgabe 2: Compute- und Speicherressourcen planen
Stellen Sie sicher, dass die Quell-DB-Instance und ihre Replikate in Bezug auf die Datenverarbeitungs- und Speicherkapazität die für ihre Betriebslast angemessene Größe aufweisen. Wenn ein Replikat die Kapazität von Rechen-, Netzwerk- und Speicherressourcen erreicht hat, stellt das Replikat den Empfang und die Anwendung von Änderungen aus seiner Quelle ein. Informationen zur Überwachung der Replikat-Leistung und der Ressourcennutzung finden Sie unter [Überwachen der Lesereplikation](USER_ReadRepl.Monitoring.md).
RDS für Db2 greift nicht ein, um eine hohe Replikationsverzögerung zwischen einer Quell-DB-Instance und ihren Lesereplikaten zu minimieren. Wenn Sie eine hohe Replikatverzögerung feststellen, lesen Sie die Anleitung zur Fehlerbehebung unter [Überwachen einer Db2-Replikationsverzögerung](db2-troubleshooting-replicas.md#db2-troubleshooting-replicas-lag).
Sie können die Speicher- und CPU-Ressourcen eines Replikats unabhängig von seiner Quelle und anderen Replikaten ändern. Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md).
## Aufgabe 3: Datenbanken vorbereiten
Bevor Sie ein Replikat erstellen, stellen Sie anhand der folgenden Punkte sicher, dass Ihre Datenbanken bereit sind:
+ Die DB-Instance enthält alle Datenbanken, die in der DB-Instance vorhanden sein sollen. Nach der Replikat-Erstellung können Sie keine Datenbank auf der DB-Instance mehr erstellen, löschen oder nativ wiederherstellen. Alle Aufrufe der gespeicherten Prozeduren [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database), [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database) oder [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database) schlagen fehl.
+ Alle Datenbanken auf der DB-Instance befinden sich in einem aktiven Zustand. Wenn sich eine Datenbank in einem inaktiven Zustand befindet, schlägt die Replikat-Erstellung fehl. Informationen zum Aktivieren von Datenbanken finden Sie unter [Gespeicherte Prozeduren für Datenbanken von RDS für Db2](db2-sp-managing-databases.md).
## Nächste Schritte
Nachdem Sie alle Vorbereitungsaufgaben abgeschlossen haben, können Sie ein Db2-Replikat erstellen.
+ Informationen zum Erstellen eines schreibgeschützten Replikats finden Sie unter [Erstellen eines Lesereplikats](USER_ReadRepl.Create.md).
+ Informationen zum Erstellen eines Standby-Replikats finden Sie unter [Erstellen eines Standby-Db2-Replikats](db2-read-replicas.creating-in-standby-mode.md).
# Erstellen eines Replikats von RDS für Db2 im Standby-Modus
Standardmäßig werden Db2-Replikate im schreibgeschützten Modus erstellt. Sie können ein Replikat für Notfallwiederherstellungs-Zwecke im Standby-Modus erstellen. Standby-Replikate akzeptieren keine Benutzerverbindungen, bieten jedoch schnellere Failover-Funktionen für regionsübergreifende Szenarien.
Bevor Sie ein Standby-Replikat erstellen, vergewissern Sie sich, dass Sie die Vorbereitungsaufgaben ausgeführt haben. Weitere Informationen finden Sie unter [Vorbereiten der Erstellung eines Replikats von RDS für Db2](db2-read-replicas.Configuration.md). Nachdem Sie ein Standby-Replikat erstellt haben, können Sie den Replikatmodus ändern. Weitere Informationen finden Sie unter [Ändern des Replikatmodus von RDS für Db2](db2-replicas-changing-replica-mode.md).
Sie können ein Standby-Replikat mithilfe der AWS-Managementkonsole, der oder der AWS CLI RDS-API erstellen. Informationen zum Erstellen eines schreibgeschützten Replikats finden Sie unter [Erstellen eines Lesereplikats](USER_ReadRepl.Create.md).
## Konsole
**So erstellen Sie ein Standby-Replikat aus einer Quell-DB-Instance von RDS für Db2**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Wählen Sie im Navigationsbereich **Datenbanken** aus.
1. Wählen Sie die DB-Instance von RDS für Db2 aus, die Sie als Quelle für ein Standby-Replikat verwenden möchten.
1. Wählen Sie unter **Actions (Aktionen)** **Create replica (Replikat erstellen)** aus.
1. Wählen Sie für **Replikatmodus** die Option **Standby** aus.
1. Wählen Sie die Einstellungen, die Sie verwenden möchten. Geben Sie unter **DB-Instance-Kennung** einen Namen für das Standby-Replikat ein. Passen Sie weitere Einstellungen nach Ihrem Bedarf an.
1. Wählen Sie **unter Regionen** die Region aus, AWS-Region in der das Standby-Replikat gestartet werden soll.
1. Wählen Sie die Instance-Größe und den Speichertyp aus. Wir empfehlen Ihnen, dieselbe DB-Instance-Klasse und denselben Speichertyp wie bei der Quell-DB-Instance für das Standby-Replikat zu verwenden.
1. Wählen Sie für **Multi-AZ-Bereitstellung** die Option **Standby-Instance erstellen**, um eine Standby-Version des Replikats in einer anderen Availability Zone zu erstellen, und um einen Failover-Support für das Standby-Replikat bereitzustellen.
1. Wählen Sie weitere Einstellungen aus, die Sie verwenden möchten.
1. Wählen Sie **Create replica (Replikat erstellen)**.
Auf der Seite **Datenbanken** hat das gemountete Replikat die Rolle **Replikat**.
## AWS CLI
Um ein Db2-Replikat im Standby-Modus zu erstellen, verwenden Sie den AWS CLI Befehl [create-db-instance-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) with set to. `--replica-mode` `mounted`
**Example**
Für Linux, macOS oder Unix:
```
aws rds create-db-instance-read-replica \
--db-instance-identifier my_standby_replica \
--source-db-instance-identifier my_db_instance \
--replica-mode mounted
```
Für Windows:
```
aws rds create-db-instance-read-replica ^
--db-instance-identifier my_standby_replica ^
--source-db-instance-identifier my_db_instance ^
--replica-mode mounted
```
## RDS-API
[Um ein Db2-Replikat im Standby-Modus zu erstellen, geben Sie in der RDS-API-Operation Create `ReplicaMode=mounted` an. DBInstance ReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html)
# Ändern des Replikatmodus von RDS für Db2
Sie können den Replikatmodus eines vorhandenen Db2-Replikats vom schreibgeschützten Modus in den Standby-Modus ändern und umgekehrt. Diese Flexibilität ermöglicht es Ihnen, Ihre Replikatkonfiguration an sich ändernde Anforderungen für Lese-Workloads oder Notfallwiederherstellungen anzupassen.
In den folgenden Szenarien möchten Sie möglicherweise die Replikatmodi ändern:
+ **Schreibgeschützt in Standby** – Wenn Sie keine Lesekapazität mehr benötigen, aber die Funktionen zur Notfallwiederherstellung beibehalten möchten
+ **Standby in schreibgeschützt** – Wenn Sie Lesekapazität für Berichts- oder Analytik-Workloads hinzufügen müssen
Stellen Sie vor dem Ändern des Replikatmodus sicher, dass die folgenden Bedingungen erfüllt sind:
+ Das Replikat befindet sich in einem verfügbaren Zustand.
+ Für das Replikat werden keine aktiven Wartungsvorgänge ausgeführt.
+ Sie verfügen über die erforderlichen Berechtigungen, um die DB-Instance zu ändern.
Die Wechseloperation kann einige Minuten dauern. Während der Operation ändert sich der Status der DB-Instance in **Modifying (Wird geändert)**. Weitere Hinweise zu Statusänderungen finden Sie unter [Status der Amazon RDS-DB-Instance anzeigen](accessing-monitoring.md#Overview.DBInstance.Status). Wenn Sie vom schreibgeschützten in den Standby-Modus wechseln, trennt das Replikat alle aktiven Verbindungen.
**Wichtig**
Da durch das Ändern des Replikatmodus der Dienst vorübergehend unterbrochen wird, sollten Sie die Änderung während eines Wartungsfensters planen, um die Auswirkungen auf Ihre Anwendungen so gering wie möglich zu halten.
Sie können den Replikatmodus mithilfe der AWS-Managementkonsole, der oder der AWS CLI RDS-API ändern.
## Konsole
**So ändern Sie den Replikatmodus eines Db2-Replikats**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Wählen Sie im Navigationsbereich **Datenbanken** aus.
1. Wählen Sie die Replikatdatenbank aus, die Sie ändern möchten.
1. Wählen Sie **Ändern** aus.
1. Wählen Sie für **Replikatmodus** den gewünschten Modus aus:
+ **Schreibgeschützt** – Für Lese-Workloads
+ **Standby** – Für die Notfallwiederherstellung
1. Wählen Sie die anderen Einstellungen aus, die Sie ändern möchten:
1. Klicken Sie auf **Weiter**.
1. Wählen Sie für **Scheduling of modifications (Einplanung von Änderungen)** die Option **Apply immediately (Sofort anwenden)** aus.
1. Wählen Sie **Modify DB Instance (DB-Instance ändern)** aus.
1. Überprüfen Sie nach Abschluss der Änderung den neuen Replikatmodus auf der Seite **Datenbanken**. Der Replikatstatus sollte als **Verfügbar** angezeigt werden, wenn die Änderung abgeschlossen ist.
## AWS CLI
Um ein Db2-Replikat vom schreibgeschützten Modus in den Standby-Modus zu ändern, stellen Sie im Befehl `--replica-mode` auf `mounted` ein. AWS CLI [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) Um den Modus eines Db2-Replikats von „Standby“ in „schreibgeschützt“ zu ändern, setzen Sie `--replica-mode` auf `open-read-only`.
Im folgenden Beispiel wird ein Replikat vom schreibgeschützten in den Standby-Modus versetzt:
**Example**
Für Linux, macOS oder Unix:
```
aws rds modify-db-instance \
--db-instance-identifier my_db2_replica \
--replica-mode mounted
```
Für Windows:
```
aws rds modify-db-instance ^
--db-instance-identifier my_db2_replica ^
--replica-mode mounted
```
Im folgenden Beispiel wird ein Replikat vom Standby-Modus in den schreibgeschützten Modus versetzt:
**Example**
Für Linux, macOS oder Unix:
```
aws rds modify-db-instance \
--db-instance-identifier my_db2_replica \
--replica-mode open-read-only
```
Für Windows:
```
aws rds modify-db-instance ^
--db-instance-identifier my_db2_replica ^
--replica-mode open-read-only
```
## RDS-API
[Um ein Db2-Replikat vom schreibgeschützten Modus in den Standby-Modus zu ändern, legen Sie in Modify fest. `ReplicaMode=mounted` DBInstance](AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) Um den Modus eines Db2-Replikats von „Standby“ in „schreibgeschützt“ zu ändern, legen Sie `ReplicaMode=open-read-only` fest.
Im Folgenden finden Sie ein Beispiel für einen API-Aufruf, über den der Replikatmodus von „schreibgeschützt“ in „Standby“ geändert wird:
```
{
"DBInstanceIdentifier": "my_db2_replica",
"ReplicaMode": "mounted",
"ApplyImmediately": true
}
```
Im Folgenden finden Sie ein Beispiel für einen API-Aufruf, über den der Replikatmodus von „Standby“ in „schreibgeschützt“ geändert wird:
```
{
"DBInstanceIdentifier": "my_db2_replica",
"ReplicaMode": "open-read-only",
"ApplyImmediately": true
}
```
Informationen zu den Unterschieden zwischen den Replikatmodi finden Sie unter [Arbeiten mit Replikaten für Amazon RDS für Db2](db2-replication.md). Informationen zur Behebung von Replikatproblemen finden Sie unter [Fehlerbehebung bei Problemen mit der Replikation in RDS für Db2](db2-troubleshooting-replicas.md).
# Arbeiten mit Sicherungen für Replikate von RDS für Db2
Sie können Sicherungen eines Replikats von RDS für Db2 auf die gleiche Weise erstellen und wiederherstellen wie eine Primärdatenbank. Es gibt jedoch wichtige Unterschiede in der Funktionsweise von Replikat-Sicherungen, insbesondere in Bezug auf den Zeitpunkt der Wiederherstellung und die Einstellungen für die Aufbewahrung von Sicherungen.
RDS für Db2 unterstützt für Replikate sowohl automatische Sicherungen als auch manuelle Snapshots. RDS für Db2 unterstützt keine point-in-time Wiederherstellung. Weitere Informationen über RDS-Sicherungen finden Sie unter [Sichern, Wiederherstellen und Exportieren von Daten](CHAP_CommonTasks.BackupRestore.md).
## Hauptunterschiede bei Replikat-Sicherungen
Replikat-Sicherungen unterscheiden sich in mehreren wichtigen Punkten von Primärdatenbank-Sicherungen:
+ Automatische Sicherungen sind nicht standardmäßig für Replikate aktiviert.
+ Wiederherstellungsvorgänge berücksichtigen die Datenbankzeit und nicht die Zeit der Sicherungserstellung.
+ Replikatverzögerungen können sich auf die aktuellen wiederhergestellten Daten auswirken. Weitere Informationen zum Überwachen der Replikatverzögerung finden Sie unter [Überwachen einer Db2-Replikationsverzögerung](db2-troubleshooting-replicas.md#db2-troubleshooting-replicas-lag).
## Aktivieren automatischer Sicherungen für Replikate von RDS für Db2
Im Gegensatz zu Primärdatenbanken sind bei Replikaten von RDS für Db2 standardmäßig keine automatischen Sicherungen aktiviert. Sie müssen den Aufbewahrungszeitraum für Sicherungen manuell konfigurieren, um automatische Sicherungen zu aktivieren. Sie aktivieren die automatisierte Backup, indem Sie den Aufbewahrungszeitraum für Backups auf einen Wert größer als null festlegen.
### Konsole
**So aktivieren Sie automatisierte Sicherungen sofort**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Wählen Sie im Navigationsbereich **Databases (Datenbanken)** und dann die DB-Instance, die Sie ändern möchten.
1. Wählen Sie **Modify** aus.
1. Wählen Sie unter **Aufbewahrungszeitraum für Backups** einen Wert größer als null aus, z. B. 3 Tage.
1. Klicken Sie auf **Continue**.
1. Wählen Sie **Apply immediately (Sofort anwenden)** aus.
1. Wählen Sie **DB-Instance ändern** aus, um Ihre Änderungen zu speichern und die automatisierten Sicherungen zu aktivieren.
### AWS CLI
Verwenden Sie den AWS CLI [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html)Befehl, um automatische Backups zu aktivieren.
Verwenden Sie die folgenden Parameter:
+ `--db-instance-identifier`
+ `--backup-retention-period`
+ `--apply-immediately` oder `--no-apply-immediately`
In diesem Beispiel aktivieren wir automatische Sicherungen, indem wir den Aufbewahrungszeitraum für Sicherungen auf drei Tage festlegen. Die Änderungen werden sofort übernommen.
**Example**
Für Linux, macOS oder Unix:
```
aws rds modify-db-instance \
--db-instance-identifier my_db_instance \
--backup-retention-period 3 \
--apply-immediately
```
Für Windows:
```
aws rds modify-db-instance ^
--db-instance-identifier my_db_instance ^
--backup-retention-period 3 ^
--apply-immediately
```
### RDS-API
Um automatisierte Backups zu aktivieren, verwenden Sie den DBInstance Vorgang [Modify](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) der RDS-API mit den folgenden erforderlichen Parametern:
+ `DBInstanceIdentifier`
+ `BackupRetentionPeriod`
## Wiederherstellen einer Replikat-Sicherung von RDS für Db2
Sie können die Sicherung eines Replikats von RDS für Db2 auf die gleiche Weise wiederherstellen wie die Sicherung der Primärdatenbank. Weitere Informationen finden Sie unter [Wiederherstellen auf eine DB-Instance](USER_RestoreFromSnapshot.md).
Die wichtigste Überlegung bei der Wiederherstellung von Replikat-Sicherungen besteht darin, den Unterschied zwischen Datenbankzeit und Zeit der Sicherungserstellung zu verstehen, insbesondere wenn Replikat-Verzögerungen vorliegen.
Sie können die Verzögerung bei der Replikation überwachen und sicherstellen, dass Ihre Sicherungen die erwarteten Daten enthalten. Informationen zur ReplicaLag Metrik finden Sie unter[CloudWatch Amazon-Metriken für Amazon RDS](rds-metrics.md).
### Verstehen von Zeitunterschieden
Bei der Wiederherstellung von Replikat-Sicherungen müssen Sie den Zeitpunkt bestimmen, auf den Sie die Wiederherstellung durchführen. Die Datenbank-Zeit bezieht sich auf die letzte angewendete Transaktionszeit der Daten im Backup. Wenn Sie ein Replikat-Backup wiederherstellen, erfolgt die Wiederherstellung auf die Datenbankzeit, nicht auf den Zeitpunkt, zu dem das Backup abgeschlossen wurde. Der Unterschied ist erheblich, da ein Replikat Minuten oder Stunden hinter der Primärdatenbank zurückbleiben kann. Daher kann die Datenbankzeit einer Replikat-Sicherung ein viel früherer Zeitpunkt sein als die Snapshot-Erstellungszeit.
Um den Unterschied zwischen Datenbankzeit und Erstellungszeit zu ermitteln, führen Sie den AWS CLI [describe-db-snapshots](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-snapshots.html)Befehl aus oder rufen Sie den DBSnapshots RDS-API-Vorgang [Describe](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBSnapshots.html) auf. Vergleichen Sie den Wert `SnapshotDatabaseTime` mit dem Wert `OriginalSnapshotCreateTime`. Der Wert `SnapshotDatabaseTime` ist die früheste Datenbankzeit unter allen Datenbanken der Replikat-Sicherung. Der Wert `OriginalSnapshotCreateTime` ist die letzte angewendete Transaktion auf der Primärdatenbank. Beachten Sie, dass die Replikationsverzögerungen für mehrere Datenbanken unterschiedlich sein können und dass die Datenbankzeit zwischen diesen beiden Zeitpunkten liegen kann.
Das folgende AWS CLI Beispiel zeigt den Unterschied zwischen den beiden Zeiten:
Für Linux, macOS oder Unix:
```
aws rds describe-db-snapshots \
--db-instance-identifier my_db2_replica \
--db-snapshot-identifier my_replica_snapshot
```
Für Windows:
```
aws rds describe-db-snapshots ^
--db-instance-identifier my_db2_replica ^
--db-snapshot-identifier my_replica_snapshot
```
Die Ausgabe dieses Befehls sieht etwa so aus.
```
{
"DBSnapshots": [
{
"DBSnapshotIdentifier": "my_replica_snapshot",
"DBInstanceIdentifier": "my_db2_replica",
"SnapshotDatabaseTime": "2022-07-26T17:49:44Z",
...
"OriginalSnapshotCreateTime": "2021-07-26T19:49:44Z"
}
]
}
```
# Fehlerbehebung bei Problemen mit der Replikation in RDS für Db2
In diesem Thema werden häufig auftretende Probleme bei der Replikation in RDS für Db2 beschrieben und Anleitungen zur Fehlerbehebung für schreibgeschützte und Standby-Replikate bereitgestellt. Überprüfen Sie nicht nur die folgenden Informationen zur Fehlerbehebung, sondern achten Sie vor der Erstellung von Db2-Replikaten auch darauf, dass Sie die [Anforderungen und Überlegungen](db2-read-replicas.limitations.md) befolgt und alle [Vorbereitungsschritte](db2-read-replicas.Configuration.md) abgeschlossen haben.
## Fehler bei der Replikaterstellung
Die Replikaterstellung kann aus verschiedenen Gründen fehlschlagen:
+ **Inaktive Datenbanken**: Alle Datenbanken auf der Quell-DB-Instance müssen aktiv sein, damit Replikate erstellt werden können.
Informationen zum Aktivieren von Datenbanken finden Sie unter [Gespeicherte Prozeduren für Datenbanken von RDS für Db2](db2-sp-managing-databases.md).
+ **Fehlende automatische Backups**: Für die Quell-DB-Instance müssen automatische Backups aktiviert sein.
Weitere Informationen zum Aktivieren von Backups finden Sie unter [Aktivieren automatischer Sicherungen für Replikate von RDS für Db2](db2-read-replicas.backups.md#db2-read-replicas.backups.turning-on).
+ **Probleme mit Parametergruppen**: Für Replikate sind benutzerdefinierte Parametergruppen erforderlich. Für die BYOL-Lizenzierung muss die Parametergruppe die Parameter IBM Site ID und IBM Customer ID enthalten.
Weitere Informationen finden Sie unter [IBM IDs für Bring Your Own License (BYOL) für Db2](db2-licensing.md#db2-prereqs-ibm-info).
## Überwachen einer Db2-Replikationsverzögerung
Um die Replikationsverzögerung in Amazon zu überwachen CloudWatch, sehen Sie sich die Amazon `ReplicaLag` RDS-Metrik an. Weitere Informationen zur zeitlichen Verzögerung bei der Replikation finden Sie unter [Überwachen der Lesereplikation](USER_ReadRepl.Monitoring.md) und [CloudWatch Amazon-Metriken für Amazon RDS](rds-metrics.md). Informationen zum Einrichten von CloudWatch Alarmen für Replikatverzögerungen finden Sie unter[Überwachung von Amazon RDS mit Amazon CloudWatch](monitoring-cloudwatch.md).
Wenn die Verzögerungszeit für ein schreibgeschütztes Replikat zu lang ist, fragen Sie die Tabelle `MON_GET_HADR` nach dem Status der Replikations-DB-Instance ab.
Wenn die Verzögerungszeit für ein Standby-Replikat zu lang ist, fragen Sie die Tabelle `MON_GET_HADR` nach dem Status der Quell-DB-Instance ab. Fragen Sie nicht die Replikat-DB-Instance ab, da Replikat-DB-Instances keine Benutzerverbindungen akzeptieren.
Zu den häufigsten Ursachen für eine hohe Replikationsverzögerung gehören die folgenden:
+ Unzureichende Rechenressourcen auf dem Replikat
+ Probleme mit der Netzwerkverbindung zwischen der Quelle und dem Replikat
+ Hohe Schreibaktivität in der Quelldatenbank
+ Einschränkungen der Speicherleistung auf dem Replikat
Wenn weiterhin eine hohe Replikationsverzögerung vorliegt, sollten Sie eine Skalierung der Replikatressourcen erwägen. Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md).
## Fehler bei der Db2-Replikation
Die Db2-Replikation kann sich aus einer Reihe von Gründen in einem Fehlerstatus befinden. Führen Sie die folgenden Aktionen durch:
+ Überwachen Sie die Ereignisse und den Status der DB-Instance, um sich zu vergewissern, dass die DB-Instance repliziert wird.
Weitere Informationen finden Sie unter [Arbeiten mit Amazon-RDS-Ereignisbenachrichtigungen](USER_Events.md).
+ Überprüfen Sie die Diagnoseprotokolle des Db2-Replikats in der Amazon-RDS-Konsole. Suchen Sie in den Protokollen nach Fehlern in den HADR-Meldungen. Vergleichen Sie die Protokoll-Sequenznummer mit der primären Sequenznummer.
Informationen zum Zugriff auf die Db2-Diagnoseprotokolle und zu ihrer Interpretation finden Sie unter [Datenbank-Protokolldateien von Amazon RDS für Db2](USER_LogAccess.Concepts.Db2.md). Informationen zur Db2-HADR-Konfiguration und -Fehlerbehebung finden Sie unter [Arbeiten mit Replikaten für Amazon RDS für Db2](db2-replication.md).
Wenn weiterhin Replikationsfehler auftreten, müssen Sie das Replikat möglicherweise neu erstellen.
## Verbindungsprobleme
Wenn Sie keine Verbindung mit dem Replikat herstellen können, lesen Sie die folgenden Informationen zu den Replikatmodi:
+ **Standby-Replikate**: Sie akzeptieren standardmäßig keine Benutzerverbindungen. Verwenden Sie schreibgeschützte Replikate für Lese-Workloads.
+ **Schreibgeschützte Replikate** — Überprüfen Sie Ihre Sicherheitsgruppeneinstellungen, Netzwerk- und ACLs Parametergruppenkonfigurationen.
Weitere Informationen finden Sie unter [Steuern des Datenverkehrs zu Ihren AWS -Ressourcen mithilfe von Sicherheitsgruppen](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html) im *Amazon-VPC-Benutzerhandbuch*, unter [Steuern des Datenverkehrs in Subnetzen mithilfe von Zugriffssteuerungslisten für Netzwerke](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-network-acls.html) im *Amazon-VPC-Benutzerhandbuch* und unter [Parametergruppen für Amazon RDS](USER_WorkingWithParamGroups.md).
## Leistungsprobleme
Wenn die Replikatleistung unzureichend ist, sehen Sie sich die folgenden Vorschläge an:
+ Vergewissern Sie sich, dass das Replikat über ausreichende Rechen- und Speicherressourcen verfügt.
+ Überwachen Sie die `ReplicaLag` Metrik in Amazon CloudWatch.
+ Erwägen Sie eine Hochskalierung der Replikat-DB-Instance-Klasse.
Informationen zum Ändern von Ressourcen oder Instance-Klassen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md).
Informationen zum Überwachen der Replikationsverzögerung finden Sie unter [Überwachen einer Replikationsverzögerung](USER_ReadRepl.Monitoring.md#USER_ReadRepl.Monitoring.Lag) und [CloudWatch Amazon-Metriken für Amazon RDS](rds-metrics.md). Informationen zum Einrichten von CloudWatch Alarmen für Replikatverzögerungen finden Sie unter[Überwachung von Amazon RDS mit Amazon CloudWatch](monitoring-cloudwatch.md).
# Optionen für DB-Instances von Amazon RDS für Db2
Im Folgenden sind die Optionen oder zusätzlichen Funktionen, die für Amazon-RDS-Instances verfügbar sind, auf denen die Db2-DB-Engine ausgeführt wird. Damit diese Optionen aktiviert werden, können Sie diese einer benutzerdefinierten Optionsgruppe hinzufügen und anschließend der Optionsgruppe für Ihre DB-Instance zuordnen. Weitere Informationen über das Arbeiten mit Optionsgruppen finden Sie unter [Arbeiten mit Optionsgruppen](USER_WorkingWithOptionGroups.md).
Amazon RDS unterstützt die folgenden Optionen für Db2:
| Option | Options-ID |
| --- | --- |
| [Db2-Audit-Protokollierung](Db2.Options.Audit.md) | `DB2_AUDIT` |
# Db2-Audit-Protokollierung
Mit der Db2-Audit-Protokollierung zeichnet Amazon RDS Datenbankaktivitäten auf, z. B. Benutzer, die sich bei der Datenbank anmelden, sowie in der Datenbank ausgeführte Abfragen. RDS lädt die abgeschlossenen Audit-Logs mithilfe der von Ihnen angegebenen AWS Identity and Access Management (IAM) -Rolle in Ihren Amazon S3 S3-Bucket hoch.
**Topics**
+ [Einrichten der Db2-Audit-Protokollierung](#db2-audit-setting-up)
+ [Verwalten der Db2-Audit-Protokollierung](#db2-audit-managing)
+ [Anzeigen von Audit-Protokollen](#db2-audit-viewing-logs)
+ [Fehlerbehebung für die Db2-Audit-Protokollierung](#db2-audit-troubleshooting)
## Einrichten der Db2-Audit-Protokollierung
Zum Aktivieren der Audit-Protokollierung für eine Datenbank von Amazon RDS für Db2 aktivieren Sie die Option `DB2_AUDIT` auf der DB-Instance von RDS für Db2. Konfigurieren Sie anschließend eine Audit-Richtlinie, um die Funktion für die jeweilige Datenbank zu aktivieren. Um die Option auf der DB-Instance von RDS für Db2 zu aktivieren, konfigurieren Sie die Optionseinstellungen für die Option `DB2_AUDIT`. Dazu geben Sie die Amazon-Ressourcennamen (ARNs) für Ihren Amazon S3-Bucket und die IAM-Rolle mit Zugriffsberechtigungen für Ihren Bucket an.
Führen Sie die folgenden Schritte aus, um die Db2-Audit-Protokollierung für eine Datenbank von RDS für Db2 einzurichten.
**Topics**
+ [Schritt 1: Einen Amazon-S3-Bucket erstellen](#db2-audit-create-s3-bucket)
+ [Schritt 2: Erstellen einer IAM-Richtlinie](#db2-audit-create-iam-policy)
+ [Schritt 3: Erstellen einer IAM-Rolle und Anfügen der IAM-Richtlinie](#db2-audit-create-iam-role)
+ [Schritt 4: Konfigurieren einer Optionsgruppe für die Db2-Audit-Protokollierung](#db2-audit-configure-options-group)
+ [Schritt 5: Konfigurieren der Audit-Richtlinie](#db2-audit-configure-audit-policy)
+ [Schritt 6: Überprüfen der Audit-Konfiguration](#db2-audit-check-config-status)
### Schritt 1: Einen Amazon-S3-Bucket erstellen
Erstellen Sie einen Amazon-S3-Bucket (sofern dies noch nicht erfolgt ist), in den Amazon RDS die Audit-Protokolldateien Ihrer Datenbank von RDS für Db2 hochladen kann. Für den S3-Bucket, den Sie als Ziel für die Überwachungsdateien verwenden, gelten folgende Einschränkungen:
+ Er muss sich in derselben Umgebung befinden AWS-Region wie Ihre RDS for Db2-DB-Instance.
+ Er darf nicht öffentlich zugänglich sein.
+ Der Bucket-Eigentümer muss auch der Eigentümer der IAM-Rolle sein.
Informationen zum Erstellen eines Buckets erhalten Sie unter [Erstellen eines Buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) im *Amazon-S3-Benutzerhandbuch*.
Nach dem Aktivieren der Audit-Protokollierung sendet Amazon RDS die Protokolle automatisch von Ihrer DB-Instance an die folgenden Speicherorte:
+ Protokolle auf DB-Instance-Ebene – `bucket_name/db2-audit-logs/dbi_resource_id/date_time_utc/`
+ Protokolle auf Datenbankebene – `bucket_name/db2-audit-logs/dbi_resource_id/date_time_utc/db_name/`
Notieren Sie sich den Amazon-Ressourcennamen (ARN) für Ihren Bucket. Diese Angaben werden für die nachfolgenden Schritte benötigt.
### Schritt 2: Erstellen einer IAM-Richtlinie
Erstellen Sie eine IAM-Richtlinie mit den Berechtigungen, die zum Übertragen der Audit-Protokolldateien von der DB-Instance zum Amazon-S3-Bucket erforderlich sind. In diesem Schritt wird davon ausgegangen, dass Sie bereits über einen S3-Bucket verfügen.
Erfassen Sie vor dem Erstellen der Richtlinie die folgenden Informationen:
+ Den ARN für Ihren Bucket.
+ Der ARN für Ihren AWS Key Management Service (AWS KMS) -Schlüssel, wenn Ihr Bucket SSE-KMS Verschlüsselung verwendet.
Erstellen Sie eine IAM-Richtlinie, die folgende Berechtigungen enthält:
```
"s3:ListBucket",
"s3:GetBucketAcl",
"s3:GetBucketLocation",
"s3:PutObject",
"s3:ListMultipartUploadParts",
"s3:AbortMultipartUpload",
"s3:ListAllMyBuckets"
```
**Anmerkung**
Amazon RDS benötigt die `s3:ListAllMyBuckets` Aktion intern, um zu überprüfen, ob dieselbe Person sowohl den S3-Bucket als auch die RDS for Db2-DB-Instance AWS-Konto besitzt.
Wenn Ihr Bucket SSE-KMS Verschlüsselung verwendet, geben Sie auch die folgenden Berechtigungen für Ihre IAM-Rolle und AWS KMS Ihren IAM-Schlüssel an.
Binden Sie die folgenden Berechtigungen in der Richtlinie für Ihre IAM-Rolle ein.
```
"kms:GenerateDataKey",
"kms:Decrypt"
```
Nehmen Sie die folgenden Berechtigungen in die Schlüsselrichtlinie für Ihren AWS KMS Schlüssel auf. *111122223333*Ersetzen Sie es durch Ihre Kontonummer und *AROA123456789EXAMPLE* durch Ihren IAM-Rollennamen.
```
{
"Sid": "Allow RDS role to use the key",
"Effect": "Allow",
"Principal": {
"AWS": [
"arn:aws:sts::111122223333:assumed-role/AROA123456789EXAMPLE/RDS-Db2Audit",
"arn:aws:iam::111122223333:role/AROA123456789EXAMPLE"
]
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*"
}
```
Sie können eine IAM-Richtlinie erstellen, indem Sie das AWS-Managementkonsole oder das AWS Command Line Interface ()AWS CLI verwenden.
#### Konsole
**So erstellen Sie eine IAM-Richtlinie, die Amazon RDS Zugriff auf Ihren Amazon-S3-Bucket gewährt**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. Wählen Sie im Navigationsbereich **Richtlinien**.
1. Wählen Sie **Richtlinie erstellen** und anschließend die Option **JSON**.
1. Filtern Sie unter **Aktionen hinzufügen** nach **S3**. Zugriff hinzufügen **ListBucket**GetBucketAcl****, und **GetBucketLocation**.
1. Wählen Sie unter **Eine Ressource hinzufügen** die Option **Hinzufügen** aus. Wählen Sie unter **Ressourcentyp** die Option **Bucket** aus und geben Sie den Namen Ihres Buckets ein. Wählen Sie dann **Ressource hinzufügen** aus.
1. Wählen Sie **Neue Anweisung hinzufügen** aus.
1. Filtern Sie unter **Aktionen hinzufügen** nach **S3**. Zugriff hinzufügen **PutObject**ListMultipartUploadParts****, und **AbortMultipartUpload**.
1. Wählen Sie unter **Eine Ressource hinzufügen** die Option **Hinzufügen** aus. Wählen Sie als **Ressourcentyp** **Objekt** und geben Sie ein*your bucket name/\$1*. Wählen Sie dann **Ressource hinzufügen** aus.
1. Wählen Sie **Neue Anweisung hinzufügen** aus.
1. Filtern Sie unter **Aktionen hinzufügen** nach **S3**. Zugriff hinzufügen **ListAllMyBuckets**.
1. Wählen Sie unter **Eine Ressource hinzufügen** die Option **Hinzufügen** aus. Wählen Sie unter **Ressourcentyp** die Option **Alle Ressourcen** aus. Wählen Sie dann **Ressource hinzufügen** aus.
1. Wenn Sie die Daten mit Ihren eigenen KMS-Schlüsseln verschlüsseln:
1. Wählen Sie **Neue Anweisung hinzufügen** aus.
1. Filtern Sie unter **Aktionen hinzufügen** nach „KMS“. Zugriff hinzufügen **GenerateDataKey**und **entschlüsseln.**
1. Wählen Sie unter **Eine Ressource hinzufügen** die Option **Hinzufügen** aus. Wählen Sie unter **Ressourcentyp** die Option **Alle Ressourcen** aus. Wählen Sie dann **Ressource hinzufügen** aus.
1. Wählen Sie **Weiter** aus.
1. Geben Sie unter **Richtlinienname** einen Namen für diese Richtlinie ein.
1. (Optional) Geben Sie im Feld **Description (Beschreibung)** eine Beschreibung für diese Richtlinie ein.
1. Wählen Sie **Richtlinie erstellen** aus.
#### AWS CLI
**So erstellen Sie eine IAM-Richtlinie, die Amazon RDS Zugriff auf Ihren Amazon-S3-Bucket gewährt**
1. Führen Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/iam/create-policy.html](https://docs.aws.amazon.com/cli/latest/reference/iam/create-policy.html) aus. Ersetzen Sie im folgenden Beispiel *iam\$1policy\$1name* und *amzn-s3-demo-bucket* durch einen Namen für Ihre IAM-Richtlinie und den Namen Ihres Amazon S3 S3-Ziel-Buckets.
Für Linux, macOS oder Unix:
```
aws iam create-policy \
--policy-name iam_policy_name \
--policy-document '{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "Statement1",
"Effect": "Allow",
"Action": [
"s3:ListBucket",
"s3:GetBucketAcl",
"s3:GetBucketLocation"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket"
]
},
{
"Sid": "Statement2",
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:ListMultipartUploadParts",
"s3:AbortMultipartUpload"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
},
{
"Sid": "Statement3",
"Effect": "Allow",
"Action": [
"s3:ListAllMyBuckets"
],
"Resource": [
"*"
]
},
{
"Sid": "Statement4",
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": [
"*"
]
}
]
}'
```
Für Windows:
```
aws iam create-policy ^
--policy-name iam_policy_name ^
--policy-document '{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "Statement1",
"Effect": "Allow",
"Action": [
"s3:ListBucket",
"s3:GetBucketAcl",
"s3:GetBucketLocation"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket"
]
},
{
"Sid": "Statement2",
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:ListMultipartUploadParts",
"s3:AbortMultipartUpload"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
},
{
"Sid": "Statement3",
"Effect": "Allow",
"Action": [
"s3:ListAllMyBuckets"
],
"Resource": [
"*"
]
},
{
"Sid": "Statement4",
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": [
"*"
]
}
]
}'
```
1. Nach der Erstellung der Richtlinie notieren Sie sich den ARN der Richtlinie. Sie benötigen den ARN für [Schritt 3: Erstellen einer IAM-Rolle und Anfügen der IAM-Richtlinie](#db2-audit-create-iam-role).
Informationen zum Erstellen einer IAM-Richtlinie finden Sie unter [Erstellen von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) im IAM-Benutzerhandbuch.
### Schritt 3: Erstellen einer IAM-Rolle und Anfügen der IAM-Richtlinie
In diesem Schritt wird davon ausgegangen, dass Sie die IAM-Richtlinie in [Schritt 2: Erstellen einer IAM-Richtlinie](#db2-audit-create-iam-policy) erstellt haben. In diesem Schritt erstellen Sie eine IAM-Rolle für Ihre DB-Instance von RDS für Db2 und fügen dann Ihre IAM-Richtlinie an die Rolle an.
Sie können mithilfe der Konsole oder der AWS CLI eine IAM-Rolle für die DB-Instance erstellen.
#### Konsole
**So erstellen Sie eine IAM-Rolle und fügen ihr die IAM-Richtlinie an**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. Wählen Sie im Navigationsbereich **Rollen** aus.
1. Wählen Sie **Create role** (Rolle erstellen) aus.
1. Wählen Sie für **Typ vertrauenswürdiger Entitäten** die Option **AWS-Service** aus.
1. Wählen Sie für **Service oder Anwendungsfall** die Option **RDS** und dann **RDS – Rolle zur Datenbank hinzufügen** aus.
1. Wählen Sie **Weiter** aus.
1. Suchen Sie unter **Berechtigungsrichtlinien** nach dem Namen der von Ihnen erstellten IAM-Richtlinie und wählen Sie ihn aus.
1. Wählen Sie **Weiter** aus.
1. Geben Sie für **Role name** (Rollenname) einen Rollennamen ein.
1. (Optional) Geben Sie unter **Role description** (Rollenbeschreibung) eine Beschreibung für die neue Rolle ein.
1. Wählen Sie **Rolle erstellen** aus.
#### AWS CLI
**So erstellen Sie eine IAM-Rolle und fügen ihr die IAM-Richtlinie an**
1. Führen Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/iam/create-role.html](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role.html) aus. Ersetzen Sie es im folgenden Beispiel *iam\$1role\$1name* durch einen Namen für Ihre IAM-Rolle.
Für Linux, macOS oder Unix:
```
aws iam create-role \
--role-name iam_role_name \
--assume-role-policy-document '{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "rds.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}'
```
Für Windows:
```
aws iam create-role ^
--role-name iam_role_name ^
--assume-role-policy-document '{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "rds.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}'
```
1. Notieren Sie sich nach dem Erstellen der Rolle ihren ARN. Sie benötigen diesen ARN für den nächsten Schritt: [Schritt 4: Konfigurieren einer Optionsgruppe für die Db2-Audit-Protokollierung](#db2-audit-configure-options-group).
1. Führen Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/iam/attach-role-policy.html](https://docs.aws.amazon.com/cli/latest/reference/iam/attach-role-policy.html) aus. Ersetzen Sie im folgenden Beispiel durch den *iam\$1policy\$1arn* ARN der IAM-Richtlinie, die Sie in [Schritt 2: Erstellen einer IAM-Richtlinie](#db2-audit-create-iam-policy) erstellt haben. *iam\$1role\$1name*Ersetzen Sie ihn durch den Namen der IAM-Rolle, die Sie gerade erstellt haben.
Für Linux, macOS oder Unix:
```
aws iam attach-role-policy \
--policy-arn iam_policy_arn \
--role-name iam_role_name
```
Für Windows:
```
aws iam attach-role-policy ^
--policy-arn iam_policy_arn ^
--role-name iam_role_name
```
Weitere Informationen finden Sie unter [Erstellen einer Rolle zum Delegieren von Berechtigungen an einen IAM-Benutzer](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html) im *IAM-Benutzerhandbuch*.
### Schritt 4: Konfigurieren einer Optionsgruppe für die Db2-Audit-Protokollierung
Der Prozess für das Hinzufügen der Db2-Audit-Protokollierungsoption zu einer DB-Instance von RDS für Db2 ist wie folgt:
1. Erstellen Sie eine neue Optionsgruppe oder kopieren oder ändern Sie eine bestehende Optionsgruppe.
1. Fügen Sie alle erforderlichen Optionen hinzu und konfigurieren Sie diese.
1. Ordnen Sie die Optionsgruppe der DB-Instance zu.
Nachdem Sie die Db2-Audit-Protokollierungsoption hinzugefügt haben, müssen Sie Ihre DB-Instance nicht neu starten. Sobald die Optionsgruppe aktiv ist, können Sie Überwachungen erstellen und Audit-Protokolle in Ihrem S3-Bucket speichern.
**So fügen Sie die Db2-Audit-Protokollierung zur Optionsgruppe einer DB-Instance hinzu und konfigurieren sie**
1. Wählen Sie eine der folgenden Optionen:
+ Verwenden einer vorhandenen Optionsgruppe.
+ Erstellen Sie eine benutzerdefinierte DB-Optionsgruppe und verwenden Sie sie. Weitere Informationen finden Sie unter [Erstellen einer Optionsgruppe](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create).
1. Fügen Sie der Optionsgruppe die Option **DB2\$1AUDIT** hinzu und konfigurieren Sie die Optionseinstellungen. Weitere Informationen über das Hinzufügen von Optionen finden Sie unter [Hinzufügen einer Option zu einer Optionsgruppe](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption).
+ Geben Sie unter **IAM\$1ROLE\$1ARN** den ARN der IAM-Rolle ein, die Sie in [Schritt 3: Erstellen einer IAM-Rolle und Anfügen der IAM-Richtlinie](#db2-audit-create-iam-role) erstellt haben.
+ Geben Sie unter **S3\$1BUCKET\$1ARN** den ARN des S3-Buckets ein, der für Ihre Db2-Audit-Protokolle verwendet werden soll. Der Bucket muss sich in derselben Region wie die DB-Instance von RDS für Db2 befinden. Die Richtlinie, die mit der von Ihnen eingegebenen IAM-Rolle verknüpft ist, muss die erforderlichen Vorgänge auf dieser Ressource zulassen.
1. Wenden Sie die Optionsgruppe auf eine neue oder vorhandene DB-Instance an. Wählen Sie eine der folgenden Optionen aus:
+ Wenn Sie eine neue DB-Instance erstellen, weisen Sie die Optionsgruppe beim Start der Instance zu.
+ Weisen Sie bei einer bestehenden DB-Instance die Optionsgruppe zu, indem Sie die Instance ändern und die neue Optionsgruppe anhängen. Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md).
### Schritt 5: Konfigurieren der Audit-Richtlinie
Um die Audit-Richtlinie für Ihre Datenbank von RDS für Db2 zu konfigurieren, stellen Sie mithilfe des Masterbenutzernamens und Masterpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung mit der Datenbank `rdsadmin` her. Rufen Sie dann die gespeicherte Prozedur `rdsadmin.configure_db_audit` mit dem DB-Namen Ihrer Datenbank und den entsprechenden Parameterwerten auf.
Im folgenden Beispiel wird eine Verbindung mit der Datenbank hergestellt und eine Audit-Richtlinie für `testdb` mit den Kategorien AUDIT, CHECKING, OBJMAINT, SECMAINT, SYSADMIN und VALIDATE konfiguriert. Der Statuswert `BOTH` protokolliert Erfolge und Fehlschläge und `ERROR TYPE` ist standardmäßig auf `NORMAL` festgelegt. Weitere Informationen zur Verwendung dieser gespeicherten Prozedur finden Sie unter [rdsadmin.configure\$1db\$1audit](db2-sp-managing-audit-policies.md#db2-sp-configure-db-audit).
```
db2 "connect to rdsadmin user master_user using master_password"
db2 "call rdsadmin.configure_db_audit('testdb', 'ALL', 'BOTH', ?)"
```
### Schritt 6: Überprüfen der Audit-Konfiguration
Um sich zu vergewissern, dass die Audit-Richtlinie ordnungsgemäß eingerichtet ist, überprüfen Sie den Status der Audit-Konfiguration.
Um die Konfiguration zu überprüfen, stellen Sie mithilfe des Masterbenutzernamens und Masterpassworts für Ihre DB-Instance von RDS für Db2 eine Verbindung mit der Datenbank `rdsadmin` her. Führen Sie dann die folgende SQL-Anweisung mit dem DB-Namen Ihrer Datenbank aus. Im folgenden Beispiel lautet *testdb* der DB-Name.
```
db2 "select task_id, task_type, database_name, lifecycle,
varchar(bson_to_json(task_input_params), 500) as task_params,
cast(task_output as varchar(500)) as task_output
from table(rdsadmin.get_task_status(null,'testdb','CONFIGURE_DB_AUDIT'))"
Sample Output
TASK_ID TASK_TYPE DATABASE_NAME LIFECYCLE
-------------------- -------------------- --------------- -------------
2 CONFIGURE_DB_AUDIT DB2DB SUCCESS
... continued ...
TASK_PARAMS
--------------------------------------------------------
{ "AUDIT_CATEGORY" : "ALL", "CATEGORY_SETTING" : "BOTH" }
... continued ...
TASK_OUTPUT
---------------------------------------------------
2023-12-22T20:27:03.029Z Task execution has started.
2023-12-22T20:27:04.285Z Task execution has completed successfully.
```
## Verwalten der Db2-Audit-Protokollierung
Nach dem Einrichten der Db2-Audit-Protokollierung können Sie die Audit-Richtlinie für eine bestimmte Datenbank ändern oder die Audit-Protokollierung auf Datenbankebene oder für die gesamte DB-Instance deaktivieren. Sie können auch den Amazon-S3-Bucket ändern, in den Ihre Protokolldateien hochgeladen werden.
**Topics**
+ [Ändern einer Db2-Audit-Richtlinie](#db2-audit-modifying-policy)
+ [Ändern des Speicherorts Ihrer Protokolldateien](#db2-audit-modifying-location)
+ [Deaktivieren der Db2-Audit-Protokollierung](#db2-audit-disabling)
### Ändern einer Db2-Audit-Richtlinie
Um die Audit-Richtlinie für eine bestimmte Datenbank von RDS für Db2 zu ändern, führen Sie die gespeicherte Prozedur `rdsadmin.configure_db_audit` aus. Mit dieser gespeicherten Prozedur können Sie die Kategorien, Kategorieeinstellungen und die Fehlertypkonfiguration der Audit-Richtlinie ändern. Weitere Informationen finden Sie unter [rdsadmin.configure\$1db\$1audit](db2-sp-managing-audit-policies.md#db2-sp-configure-db-audit).
### Ändern des Speicherorts Ihrer Protokolldateien
Um den Amazon-S3-Bucket zu ändern, in den Ihre Protokolldateien hochgeladen werden, führen Sie einen der folgenden Schritte aus:
+ Ändern der aktuellen Optionsgruppe, die mit der DB-Instance von RDS für Db2 verknüpft ist: Aktualisieren Sie die Einstellung `S3_BUCKET_ARN` für die Option `DB2_AUDIT`, sodass sie auf den neuen Bucket verweist. Achten Sie außerdem darauf, die IAM-Richtlinie zu aktualisieren, die mit der IAM-Rolle verknüpft ist, die anhand der Einstellung `IAM_ROLE_ARN` in der angefügten Optionsgruppe angegeben wird. Diese IAM-Richtlinie muss Ihrem neuen Bucket die erforderlichen Zugriffsberechtigungen gewähren. Weitere Informationen zu den für die IAM-Richtlinie erforderlichen Berechtigungen finden Sie unter [Eine IAM-Richtlinie erstellen](#db2-audit-create-iam-policy).
+ Verknüpfen der DB-Instance von RDS für Db2 mit einer anderen Optionsgruppe: Modifizieren Sie Ihre DB-Instance, um die ihr zugeordnete Optionsgruppe zu ändern. Vergewissern Sie sich, dass die neue Optionsgruppe mit den richtigen Einstellungen von `S3_BUCKET_ARN` und `IAM_ROLE_ARN` konfiguriert ist. Informationen zum Konfigurieren dieser Einstellungen für die Option `DB2_AUDIT` finden Sie unter [Konfigurieren einer Optionsgruppe](#db2-audit-configure-options-group).
Wenn Sie die Optionsgruppe ändern, achten Sie darauf, dass Sie die Änderungen sofort anwenden. Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md).
### Deaktivieren der Db2-Audit-Protokollierung
Um die Db2-Audit-Protokollierung zu deaktivieren, führen Sie einen der folgenden Schritte aus:
+ Deaktivieren der Audit-Protokollierung für die DB-Instance von RDS für Db2: Ändern Sie Ihre DB-Instance und entfernen Sie die Optionsgruppe mit der Option `DB2_AUDIT` daraus. Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md).
+ Deaktivieren der Audit-Protokollierung für eine bestimmte Datenbank: Beenden Sie die Audit-Protokollierung und entfernen Sie die Audit-Richtlinie, indem Sie `rdsadmin.disable_db_audit` mit dem DB-Namen Ihrer Datenbank aufrufen. Weitere Informationen finden Sie unter [rdsadmin.disable\$1db\$1audit](db2-sp-managing-audit-policies.md#db2-sp-disable-db-audit).
```
db2 "call rdsadmin.disable_db_audit(
'db_name',
?)"
```
## Anzeigen von Audit-Protokollen
Nachdem Sie die Db2-Audit-Protokollierung aktiviert haben, warten Sie mindestens eine Stunde, bevor Sie sich die Audit-Daten in Ihrem Amazon-S3-Bucket ansehen. Amazon RDS sendet die Protokolle automatisch von Ihrer DB-Instance von RDS für Db2 an die folgenden Speicherorte:
+ Protokolle auf DB-Instance-Ebene – `bucket_name/db2-audit-logs/dbi_resource_id/date_time_utc/`
+ Protokolle auf Datenbankebene – `bucket_name/db2-audit-logs/dbi_resource_id/date_time_utc/db_name/`
Im folgenden Beispiel-Screenshot der Amazon-S3-Konsole ist eine Liste von Ordnern mit Protokolldateien auf der DB-Instance-Ebene von RDS für Db2 dargestellt.
![\[Amazon-S3-Konsole mit ausgewählter Registerkarte Objekte, die eine Liste von Ordnern mit Protokolldateien auf der DB-Instance-Ebene von RDS für Db2 enthält.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/db2-instance-level-audit-logs.png)
Der folgende Beispiel-Screenshot der Amazon-S3-Konsole zeigt Protokolldateien auf Datenbankebene für die DB-Instance von RDS für Db2.
![\[Amazon-S3-Konsole mit ausgewählter Registerkarte Objekte, in der Protokolldateien auf Datenbankebene für die DB-Instance von RDS für Db2 angezeigt werden.\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/db2-database-level-audit-logs.png)
## Fehlerbehebung für die Db2-Audit-Protokollierung
Verwenden Sie die folgenden Informationen, um häufig auftretende Fehler bei der Db2-Audit-Protokollierung zu beheben.
### Die Audit-Richtlinie kann nicht konfiguriert werden
Wenn beim Aufrufen der gespeicherten Prozedur `rdsadmin.configure_db_audit` ein Fehler zurückgegeben wird, kann es sein, dass die Optionsgruppe mit der Option `DB2_AUDIT` nicht mit der DB-Instance von RDS für Db2 verknüpft ist. Ändern Sie die DB-Instance, um die Optionsgruppe hinzuzufügen, und versuchen Sie dann erneut, die gespeicherte Prozedur aufzurufen. Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md).
### Keine Daten im Amazon-S3-Bucket
Wenn Protokollierungsdaten im Amazon-S3-Bucket fehlen, überprüfen Sie Folgendes:
+ Der Amazon-S3-Bucket befindet sich in derselben Region wie die DB-Instance von RDS für Db2.
+ Die Rolle, die Sie in der Optionseinstellung `IAM_ROLE_ARN` angegeben haben, ist mit den erforderlichen Berechtigungen zum Hochladen von Protokollen in den Amazon-S3-Bucket konfiguriert. Weitere Informationen finden Sie unter [Eine IAM-Richtlinie erstellen](#db2-audit-create-iam-policy).
+ Die Einstellungen ARNs für die `S3_BUCKET_ARN` Optionen `IAM_ROLE_ARN` und sind in der Optionsgruppe, die Ihrer RDS for Db2-DB-Instance zugeordnet ist, korrekt. Weitere Informationen finden Sie unter [Konfigurieren einer Optionsgruppe](#db2-audit-configure-options-group).
Sie können den Aufgabenstatus Ihrer Audit-Protokollierungskonfiguration überprüfen, indem Sie eine Verbindung mit der Datenbank herstellen und eine SQL-Anweisung ausführen. Weitere Informationen finden Sie unter [Überprüfen der Audit-Konfiguration](#db2-audit-check-config-status).
Sie können Ereignisse auch überprüfen, um mehr darüber zu erfahren, warum Protokolle möglicherweise fehlen. Informationen zum Anzeigen von Ereignissen finden Sie unter [Anzeigen von Protokollen, Ereignissen und Streams in der Amazon-RDS-Konsole](logs-events-streams-console.md).
# Externe gespeicherte Prozeduren für Amazon RDS für Db2
Sie können externe Routinen erstellen und sie bei Ihren Datenbanken von Amazon RDS für Db2 als externe gespeicherte Prozeduren registrieren. Derzeit unterstützt RDS für Db2 nur Java-basierte Routinen als externe gespeicherte Prozeduren.
## Java-basierte externe gespeicherte Prozeduren
Java-basierte externe gespeicherte Prozeduren sind externe Java-Routinen, die Sie bei Ihrer Datenbank von RDS für Db2 als externe gespeicherte Prozesse registrieren.
**Topics**
+ [Einschränkungen für Java-basierte externe gespeicherte Prozeduren](#db2-external-stored-procedures-java-limitations)
+ [Konfigurieren von Java-basierten externen gespeicherten Prozeduren](#db2-external-stored-procedures-java-configuring)
### Einschränkungen für Java-basierte externe gespeicherte Prozeduren
Bevor Sie Ihre externe Routine entwickeln, beachten Sie die folgenden Einschränkungen.
Stellen Sie sicher, dass Sie das von Db2 bereitgestellte Java Development Kit (JDK) verwenden, um Ihre externe Routine zu erstellen. Weitere Informationen finden Sie unter [Java software support for Db2 database products](https://www.ibm.com/docs/en/db2/11.5?topic=servers-java-software-support-db2-database-products).
Ihr Java-Programm kann Dateien nur im `/tmp`-Verzeichnis erstellen und Amazon RDS unterstützt keine Aktivierung von ausführbaren oder Set User ID (SUID)-Berechtigungen für diese Dateien. Ihr Java-Programm kann auch keine Socket-Systemaufrufen oder die folgenden Systemaufrufen verwenden:
+ \$1sysctl
+ acct
+ afs\$1syscall
+ bpf
+ capset
+ chown
+ chroot
+ create\$1module
+ delete\$1module
+ fanotify\$1init
+ fanotify\$1mark
+ finit\$1module
+ fsconfig
+ fsopen
+ fspick
+ get\$1kernel\$1syms
+ getpmsg
+ init\$1module
+ mount
+ move\$1mount
+ nfsservctl
+ open\$1by\$1handle\$1at
+ open\$1tree
+ pivot\$1root
+ putpmsg
+ query\$1module
+ quotactl
+ reboot
+ security
+ setdomainname
+ setfsuid
+ sethostname
+ sysfs
+ tuxcall
+ umount2
+ uselib
+ ustat
+ vhangup
+ vserver
Weitere Einschränkungen für externe Routinen für Db2 finden Sie in der IBM Db2-Dokumentation unter [Restrictions on external routines](https://www.ibm.com/docs/en/db2/11.5?topic=routines-restrictions-external).
### Konfigurieren von Java-basierten externen gespeicherten Prozeduren
Um eine externe gespeicherte Prozedur zu konfigurieren, erstellen Sie eine JAR-Datei mit Ihrer externen Routine, installieren Sie sie in Ihrer Datenbank von RDS für Db2 und registrieren Sie sie dann als externe gespeicherte Prozedur.
**Topics**
+ [Schritt 1: Aktivieren von externen gespeicherten Prozeduren](#db2-external-stored-procedures-java-enable)
+ [Schritt 2: Installieren der JAR-Datei mit Ihrer externen Routine](#db2-external-stored-procedures-java-install-jar)
+ [Schritt 3: Registrieren der externen gespeicherten Prozedur](#db2-external-stored-procedures-java-register)
+ [Schritt 4: Validieren der externen gespeicherten Prozedur](#db2-external-stored-procedures-java-validate)
#### Schritt 1: Aktivieren von externen gespeicherten Prozeduren
Um externe gespeicherte Prozeduren zu aktivieren, legen Sie den Parameter `db2_alternate_authz_behaviour` in einer benutzerdefinierten Parametergruppe, die Ihrer DB-Instance zugeordnet ist, auf einen der folgenden Werte fest:
+ `EXTERNAL_ROUTINE_DBADM` – Erteilt implizit jedem Benutzer, jeder Gruppe oder jeder Rolle mit entsprechender `DBADM`-Autorität die Berechtigung `CREATE_EXTERNAL_ROUTINE`.
+ `EXTERNAL_ROUTINE_DBAUTH` – Erlaubt einem Benutzer mit `DBADM`-Autorität, jedem Benutzer, jeder Gruppe oder jeder Rolle die Berechtigung `CREATE_EXTERNAL_ROUTINE` zu erteilen. In diesem Fall wird keinem Benutzer, keiner Gruppe oder keiner Rolle diese Berechtigung implizit erteilt, nicht einmal einem Benutzer mit entsprechender `DBADM`-Autorität.
Weitere Informationen zu dieser Einstellung finden Sie in der IBM Db2-Dokumentation unter [GRANT (database authorities) statement](https://www.ibm.com/docs/en/db2/11.5?topic=statements-grant-database-authorities).
Sie können eine benutzerdefinierte Parametergruppe erstellen und ändern, indem Sie die AWS-Managementkonsole, die AWS CLI oder die Amazon-RDS-API verwenden.
##### Konsole
**So konfigurieren Sie den Parameter db2\$1alternate\$1authz\$1behavior in einer benutzerdefinierten Parametergruppe**
1. Erstellen Sie eine neue DB-Parametergruppe, wenn Sie eine andere benutzerdefinierte DB-Parametergruppe verwenden möchten als die, die Ihre DB-Instance verwendet. Wenn Sie das Modell Bring Your Own License (BYOL) verwenden, stellen Sie sicher, dass die neue benutzerdefinierte Parametergruppe die IBM IDs enthält. Informationen zu diesen finden Sie IDs unter[IBM IDs für Bring Your Own License (BYOL) für Db2](db2-licensing.md#db2-prereqs-ibm-info). Weitere Informationen über das Erstellen einer Parametergruppe finden Sie unter [Erstellen einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Legen Sie den Wert für den Parameter `db2_alternate_authz_behaviour` in Ihrer benutzerdefinierten Parametergruppe fest. Weitere Informationen zum Ändern einer Parametergruppe finden Sie unter [Ändern von Parametern in einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
##### AWS CLI
**So konfigurieren Sie den Parameter db2\$1alternate\$1authz\$1behavior in einer benutzerdefinierten Parametergruppe**
1. Erstellen Sie eine benutzerdefinierte Parametergruppe, indem Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html) ausführen, wenn Sie eine andere benutzerdefinierte DB-Parametergruppe verwenden möchten als die, die Ihre DB-Instance verwendet. Wenn Sie das BYOL-Modell (Bring Your Own License) verwenden, stellen Sie sicher, dass die neue benutzerdefinierte Parametergruppe die IBM IDs enthält. Informationen zu diesen finden Sie IDs unter[IBM IDs für Bring Your Own License (BYOL) für Db2](db2-licensing.md#db2-prereqs-ibm-info).
Verwenden Sie den folgenden erforderlichen Parameter:
+ `--db-parameter-group-name` – Ein Name für die Parametergruppe, die Sie erstellen.
+ `--db-parameter-group-family` – Die Db2-Engine-Edition und die Hauptversion. Gültige Werte sind `db2-se-11.5` und `db2-ae-11.5`.
+ `--description` – Die Beschreibung für diese Parametergruppe.
Weitere Informationen über das Erstellen einer Parametergruppe finden Sie unter [Erstellen einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
Das folgende Beispiel zeigt, wie Sie eine benutzerdefinierte Parametergruppe mit dem Namen `MY_EXT_SP_PARAM_GROUP` für die Parametergruppenfamilie `db2-se-11.5` erstellen.
Für Linux, macOS oder Unix:
```
aws rds create-db-parameter-group \
--region us-east-1 \
--db-parameter-group-name MY_EXT_SP_PARAM_GROUP \
--db-parameter-group-family db2-se-11.5 \
--description "test db2 external routines"
```
Für Windows:
```
aws rds create-db-parameter-group ^
--region us-east-1 ^
--db-parameter-group-name MY_EXT_SP_PARAM_GROUP ^
--db-parameter-group-family db2-se-11.5 ^
--description "test db2 external routines"
```
1. Ändern Sie den Parameter `db2_alternate_authz_behaviour` in Ihrer benutzerdefinierten Parametergruppe, indem Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html) ausführen.
Verwenden Sie den folgenden erforderlichen Parameter:
+ `--db-parameter-group-name` – Der Name der von Ihnen erstellten Parametergruppe.
+ `--parameters` – Ein Array von Parameternamen, Werten und der Anwendungsmethoden für die Parameteraktualisierung.
Weitere Informationen zum Ändern einer Parametergruppe finden Sie unter [Ändern von Parametern in einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
Das folgende Beispiel zeigt, wie Sie die Parametergruppe `MY_EXT_SP_PARAM_GROUP` ändern, indem Sie den Wert `db2_alternate_authz_behaviour` auf `EXTERNAL_ROUTINE_DBADM` festlegen.
Für Linux, macOS oder Unix:
```
aws rds modify-db-parameter-group \
--db-parameter-group-name MY_EXT_SP_PARAM_GROUP \
--parameters "ParameterName='db2_alternate_authz_behaviour',ParameterValue='EXTERNAL_ROUTINE_DBADM',ApplyMethod=immediate"
```
Für Windows:
```
aws rds modify-db-parameter-group ^
--db-parameter-group-name MY_EXT_SP_PARAM_GROUP ^
--parameters "ParameterName='db2_alternate_authz_behaviour',ParameterValue='EXTERNAL_ROUTINE_DBADM',ApplyMethod=immediate"
```
##### RDS-API
**So konfigurieren Sie den Parameter db2\$1alternate\$1authz\$1behavior in einer benutzerdefinierten Parametergruppe**
1. Erstellen Sie eine neue DB-Parametergruppe, indem Sie die Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html) der Amazon-RDS-API verwenden, wenn Sie eine andere benutzerdefinierte DB-Parametergruppe verwenden möchten als die, die Ihre DB-Instance verwendet. Wenn Sie das BYOL-Modell (Bring Your Own License) verwenden, stellen Sie sicher, dass die neue benutzerdefinierte Parametergruppe die IBM Db2 IDs enthält. Informationen zu diesen finden Sie IDs unter[IBM IDs für Bring Your Own License (BYOL) für Db2](db2-licensing.md#db2-prereqs-ibm-info).
Nutzen Sie die folgenden erforderlichen Parameter:
+ `DBParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`
Weitere Informationen über das Erstellen einer Parametergruppe finden Sie unter [Erstellen einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Creating.md).
1. Ändern Sie den Parameter `db2_alternate_authz_behaviour` in Ihrer benutzerdefinierten Parametergruppe, die Sie mithilfe der RDS-API-Operation [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html) erstellt haben.
Nutzen Sie die folgenden erforderlichen Parameter:
+ `DBParameterGroupName`
+ `Parameters`
Weitere Informationen zum Ändern einer Parametergruppe finden Sie unter [Ändern von Parametern in einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
#### Schritt 2: Installieren der JAR-Datei mit Ihrer externen Routine
Nachdem Sie Ihre Java-Routine erstellt haben, erstellen Sie die JAR-Datei und führen Sie dann `db2 "call sqlj.install_jar('file:file_path',jar_ID)"` aus, um sie in Ihrer Datenbank von RDS für Db2 zu installieren.
Das folgende Beispiel zeigt, wie Sie eine Java-Routine erstellen und sie in einer Datenbank von RDS für Db2 installieren. Das Beispiel enthält Beispielcode für eine einfache Routine, die Sie zum Testen des Prozesses verwenden können. In diesem Beispiel wird Folgendes angenommen:
+ Der Java-Code ist auf einem Server kompiliert, auf dem Db2 installiert ist. Dies ist eine bewährte Methode, da eine fehlende Kompilierung mit dem von IBM bereitgestellten JDK zu unerklärlichen Fehlern führen kann.
+ Auf dem Server ist die Datenbank von RDS für Db2 lokal katalogisiert.
Wenn Sie den Prozess mit dem folgenden Beispielcode ausprobieren möchten, kopieren Sie ihn und speichern Sie ihn dann in einer Datei mit dem Namen `MYJAVASP.java`.
```
import java.sql.*;
public class MYJAVASP
{
public static void my_JAVASP (String inparam) throws SQLException, Exception
{
try
{
// Obtain the calling context's connection details.
Connection myConn = DriverManager.getConnection("jdbc:default:connection");
String myQuery = "INSERT INTO TEST.TEST_TABLE VALUES (?, CURRENT DATE)";
PreparedStatement myStmt = myConn.prepareStatement(myQuery);
myStmt.setString(1, inparam);
myStmt.executeUpdate();
}
catch (SQLException sql_ex)
{
throw sql_ex;
}
catch (Exception ex)
{
throw ex;
}
}
```
Der folgende Befehl kompiliert die Java-Routine.
```
~/sqllib/java/jdk64/bin/javac MYJAVASP.java
```
Der folgende Befehl erstellt die JAR-Datei.
```
~/sqllib/java/jdk64/bin/jar cvf MYJAVASP.jar MYJAVASP.class
```
Die folgenden Befehle stellen eine Verbindung zur Datenbank mit dem Namen `MY_DB2_DATABASE` her und installieren die JAR-Datei.
```
db2 "connect to MY_DB2_DATABASE user master_username using master_password"
db2 "call sqlj.install_jar('file:/tmp/MYJAVASP.jar','MYJAVASP')"
db2 "call sqlj.refresh_classes()"
```
#### Schritt 3: Registrieren der externen gespeicherten Prozedur
Nachdem Sie die JAR-Datei in Ihrer Datenbank von RDS für Db2 installiert haben, registrieren Sie sie als gespeicherte Prozedur, indem Sie den Befehl `db2 CREATE PROCEDURE` oder `db2 REPLACE PROCEDURE` ausführen.
Das folgende Beispiel zeigt, wie Sie eine Verbindung zur Datenbank herstellen und die im vorherigen Schritt erstellte Java-Routine als gespeicherte Prozedur registrieren.
```
db2 "connect to MY_DB2_DATABASE user master_username using master_password"
create procedure TESTSP.MYJAVASP (in input char(6))
specific myjavasp
dynamic result sets 0
deterministic
language java
parameter style java
no dbinfo
fenced
threadsafe
modifies sql data
program type sub
external name 'MYJAVASP!my_JAVASP';
```
#### Schritt 4: Validieren der externen gespeicherten Prozedur
Verwenden Sie die folgenden Schritte, um das Beispiel einer externen gespeicherten Prozedur zu testen, die im vorherigen Schritt registriert wurde.
**So validieren Sie die externe gespeicherte Prozedur**
1. Erstellen Sie eine Tabelle wie `TEST.TEST_TABLE` im folgenden Beispiel.
```
db2 "create table TEST.TEST_TABLE(C1 char(6), C2 date)"
```
1. Rufen Sie die neue externe gespeicherte Prozedur auf. Der Aufruf gibt den Status `0` zurück.
```
db2 "call TESTSP.MYJAVASP('test')"
Return Status = 0
```
1. Fragen Sie die Tabelle ab, die Sie in Schritt 1 erstellt haben, um die Ergebnisse des Aufrufs der gespeicherten Prozedur zu überprüfen.
```
db2 "SELECT * from TEST.TEST_TABLE"
```
Die Abfrage gibt eine Ausgabe ähnlich der folgenden zurück:
```
C1 C2
------ ----------
test 02/05/2024
```
# Bekannte Probleme und Einschränkungen für Amazon RDS für Db2
Bekannte Probleme und Einschränkungen bei der Arbeit mit Amazon RDS für Db2 sind wie folgt:
**Topics**
+ [Einschränkung bei der Authentifizierung](#db2-known-issues-limitations-authentication-limit)
+ [Routinen ohne Fencing](#db2-known-issues-limitations-non-fenced-routines)
+ [Nicht automatische Speicher-Tablespaces während der Migration](#db2-known-issues-limitations-non-automatic-storage-tablespaces)
+ [Festlegen des Parameters db2\$1compatibility\$1vector](#db2-known-issues-limitations-db2-compatibility-vector)
+ [Migrieren von Datenbanken, die INVALID-Pakete enthalten](#db2-known-issues-limitations-invalid-packages-migrating)
## Einschränkung bei der Authentifizierung
Amazon RDS legt `db2auth` standardmäßig auf `JCC_ENFORCE_SECMEC` fest. Wenn Sie jedoch nicht möchten, dass Benutzer-ID und Passwort zwangsweise drahtgebunden verschlüsselt werden, können Sie diese Einstellung überschreiben, indem Sie den Parameter `db2auth` in der Parametergruppe in `CLEAR_TEXT` ändern. Weitere Informationen finden Sie unter [Ändern von Parametern in einer DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).
## Routinen ohne Fencing
RDS für Db2 unterstützt keine Erstellung von Routinen ohne Fencing und keine Migration dieser Routinen durch Sicherung und Wiederherstellung von Daten. Führen Sie den folgenden SQL-Befehl aus, um zu überprüfen, ob Ihre Datenbank Routinen ohne Fencing enthält:
```
SELECT 'COUNT:' || count(*) FROM SYSCAT.ROUTINES where fenced='N' and routineschema not in ('SQLJ','SYSCAT','SYSFUN','SYSIBM','SYSIBMADM','SYSPROC','SYSTOOLS')
```
## Nicht automatische Speicher-Tablespaces während der Migration
RDS für Db2 unterstützt keine Erstellung von neuen, nicht automatischen Speicher-Tablespaces. Wenn Sie die native Wiederherstellung für eine einmalige Migration Ihrer Datenbank verwenden, konvertiert RDS für Db2 Ihre nicht automatischen Speicher-Tablespaces automatisch in automatische Tablespaces und stellt dann Ihre Datenbank in RDS für Db2 wieder her. Informationen zu einmaligen Migrationen finden Sie unter [Migration von Linux zu Linux für Amazon RDS für Db2](db2-one-time-migration-linux.md) und [Migration von AIX oder Windows zu Linux für Amazon RDS für Db2](db2-one-time-migration-aix-windows-linux.md).
## Festlegen des Parameters db2\$1compatibility\$1vector
Mit Amazon RDS können Sie beim Erstellen der DB-Instance eine erste Datenbank erstellen und dann Parameter in einer zugehörigen Parametergruppe ändern. Wenn Sie jedoch für Db2 den Parameter `db2_compatibility_vector` in einer Parametergruppe festlegen möchten, müssen Sie zuerst den Parameter in einer benutzerdefinierten Parametergruppe ändern, die DB-Instance ohne Datenbank erstellen und dann mithilfe der gespeicherten Prozedur `rdsadmin.create_database` eine Datenbank erstellen.
**So stellen Sie den Parameter `db2_compatibility_vector` ein**
1. [Erstellen Sie eine benutzerdefinierte Parametergruppe.](USER_WorkingWithParamGroups.Creating.md) (Sie können keine Standard-Parametergruppe modifizieren.)
1. [Ändern Sie den Parameter](USER_WorkingWithParamGroups.Modifying.md).
1. [Erstellen Sie eine DB-Instance](USER_CreateDBInstance.md).
1. [Erstellen Sie eine Datenbank](db2-managing-databases.md#db2-creating-database) mithilfe der gespeicherten `rdsadmin.create_database`-Prozedur.
1. [Ordnen Sie die neue Parametergruppe](USER_WorkingWithParamGroups.Associating.md) der DB-Instance zu, die die Datenbank enthält.
## Migrieren von Datenbanken, die INVALID-Pakete enthalten
Wenn Sie Db2-Datenbanken, die `INVALID`-Pakete enthalten, mithilfe des `RESTORE`-Befehls zu RDS für Db2 migrieren, können Probleme auftreten, wenn Sie die Datenbanken verwenden. `INVALID`-Pakete können aufgrund der Einrichtung der Autorisierung für den DB-Instance-Benutzer `rdsdb` und der Entfernung der Autorisierung von `PUBLIC` Probleme verursachen. `INVALID`-Pakete führen dazu, dass die folgenden Befehle fehlschlagen:
+ `db2updv115`
+ `db2 "call SYSPROC.ADMIN_REVALIDATE_DB_OBJECTS()"`
Bevor Sie Ihre Datenbank mit dem `RESTORE`-Befehl migrieren, stellen Sie sicher, dass Ihre Datenbank keine `INVALID`-Pakete enthält, indem Sie den folgenden Befehl ausführen:
```
db2 "SELECT 'COUNT:' || count(*) FROM SYSCAT.INVALIDOBJECTS"
```
Wenn der Befehl eine Anzahl von mehr als Null zurückgibt, rufen Sie den folgenden Befehl auf:
```
db2 "call SYSPROC.ADMIN_REVALIDATE_DB_OBJECTS()"
```
Rufen Sie anschließend den vorherigen Befehl auf, um zu bestätigen, dass Ihre Datenbank keine `INVALID`-Pakete mehr enthält.
```
db2 "SELECT 'COUNT:' || count(*) FROM SYSCAT.INVALIDOBJECTS"
```
Jetzt sind Sie bereit, ein Backup Ihrer Datenbank zu erstellen und sie auf Ihrer DB-Instance von RDS für Db2 wiederherzustellen.
# 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')"
```
# Referenz für benutzerdefinierte Funktionen von Amazon RDS für Db2
Die folgenden benutzerdefinierten Funktionen sind für Amazon-RDS-DB-Instances verfügbar, auf denen die Db2-Engine ausgeführt wird.
**Topics**
+ [rdsadmin.get\$1task\$1status](#db2-udf-get-task-status)
+ [rdsadmin.list\$1databases](#db2-udf-list-databases)
+ [rdsadmin.list\$1modifiable\$1db\$1params](#db2-udf-list-modi-db-params)
## rdsadmin.get\$1task\$1status
Gibt den Status einer Aufgabe zurück.
### Syntax
```
db2 "select task_id, task_type, database_name, lifecycle,
varchar(bson_to_json(task_input_params), 500) as task_params,
cast(task_output as varchar(500)) as task_output
from table(rdsadmin.get_task_status(task_id,'database_name','task_type'))"
```
### Parameters
Die folgenden Parameter sind optional. Wenn Sie keine Parameter angeben, gibt die benutzerdefinierte Funktion den Status aller Aufgaben für alle Datenbanken zurück. Der Aufgabenverlauf wird in Amazon RDS 35 Tage lang gespeichert.
*task\$1id*
Die ID der Aufgabe, die derzeit ausgeführt wird. Diese ID wird zurückgegeben, wenn Sie eine Aufgabe ausführen. Standard: `0`.
*database\$1name*
Der Name der Datenbank, für die die Aufgabe derzeit ausgeführt wird.
*task\$1type*
Der Typ der abzufragenden Aufgabe. Zulässige Werte: `ADD_GROUPS`, `ADD_USER`, `ALTER_BUFFERPOOL`, `ALTER_TABLESPACE`, `CHANGE_PASSWORD`, `COMPLETE_ROLLFORWARD`, `CREATE_BUFFERPOOL`, `CREATE_DATABASE`, `CREATE_ROLE`, `CREATE_TABLESPACE`, `DROP_BUFFERPOOL`, `DROP_DATABASE`, `DROP_TABLESPACE`, `LIST_USERS`, `REMOVE_GROUPS`, `REMOVE_USER`, `RESTORE_DB`, `ROLLFORWARD_DB_LOG`, `ROLLFORWARD_STATUS`, `UPDATE_DB_PARAM`.
### Nutzungshinweise
Sie können die benutzerdefinierte Funktion `rdsadmin.get_task_status` verwenden, um den Status der folgenden Aufgaben für Amazon RDS für Db2 zu überprüfen. Diese Liste ist nicht umfassend.
+ Erstellen, Ändern oder Verwerfen eines Pufferpools
+ Erstellen, Ändern oder Verwerfen eines Tablespace
+ Erstellen oder Verwerfen einer Datenbank
+ Wiederherstellen eines Datenbank-Backups aus Amazon S3
+ Ausführen eines Rollforward von Datenbankprotokollen aus Amazon S3
### Beispiele
Im folgenden Beispiel werden die Spalten angezeigt, die beim Aufrufen von `rdsadmin.get_task_status` zurückgegeben werden.
```
db2 "describe select * from table(rdsadmin.get_task_status())"
```
Im folgenden Beispiel wird der Status aller Aufgaben angegeben.
```
db2 "select task_id, task_type, database_name, lifecycle,
varchar(bson_to_json(task_input_params), 500) as task_params,
cast(task_output as varchar(500)) as task_output
from table(rdsadmin.get_task_status(null,null,null))"
```
Im folgenden Beispiel wird der Status einer bestimmten Aufgabe aufgeführt.
```
db2 "select task_id, task_type, database_name,
varchar(bson_to_json(task_input_params), 500) as task_params
from table(rdsadmin.get_task_status(1,null,null))"
```
Im folgenden Beispiel wird der Status einer bestimmten Aufgabe und Datenbank aufgeführt.
```
db2 "select task_id, task_type, database_name,
varchar(bson_to_json(task_input_params), 500) as task_params
from table(rdsadmin.get_task_status(2,'SAMPLE',null))"
```
Im folgenden Beispiel wird der Status aller Aufgaben von `ADD_GROUPS` angegeben.
```
db2 "select task_id, task_type, database_name,
varchar(bson_to_json(task_input_params), 500) as task_params
from table(rdsadmin.get_task_status(null,null,'add_groups'))"
```
Im folgenden Beispiel wird der Status aller Aufgaben für eine bestimmte Datenbank aufgeführt.
```
db2 "select task_id, task_type, database_name,
varchar(bson_to_json(task_input_params), 500) as task_params
from table(rdsadmin.get_task_status(null,'testdb', null))"
```
Im folgenden Beispiel werden die JSON-Werte als Spalten ausgegeben.
```
db2 "select varchar(r.task_type,25) as task_type, varchar(r.lifecycle,10) as lifecycle, r.created_at, u.* from
table(rdsadmin.get_task_status(null,null,'restore_db')) as r, json_table(r.task_input_params, 'strict $' columns(s3_prefix varchar(500)
null on empty, s3_bucket_name varchar(500) null on empty) error on error ) as U"
```
### Antwort
Die benutzerdefinierte Funktion `rdsadmin.get_task_status` gibt die folgenden Spalten zurück:
`TASK_ID`
Die ID der Aufgabe.
`TASK_TYPE`
Hängt von den Eingabeparametern ab.
+ `ADD_GROUPS`: Fügt Gruppen hinzu.
+ `ADD_USER`: Fügt einen Benutzer hinzu.
+ `ALTER_BUFFERPOOL`: Ändert einen Pufferpool.
+ `ALTER_TABLESPACE`: Ändert ein Tablespace.
+ `CHANGE_PASSWORD `: Ändert das Passwort eines Benutzers.
+ `COMPLETE_ROLLFORWARD`: Schließt die Aufgabe `rdsadmin.rollforward_database` ab und aktiviert eine Datenbank.
+ `CREATE_BUFFERPOOL`: Erstellt einen Pufferpool.
+ `CREATE_DATABASE`: Erstellt eine Datenbank.
+ `CREATE_ROLE`: Erstellt eine Db2-Rolle für einen Benutzer.
+ `CREATE_TABLESPACE`: Erstellt ein Tablespace.
+ `DROP_BUFFERPOOL`: Verwirft einen Pufferpool.
+ `DROP_DATABASE`: Verwirft eine Datenbank.
+ `DROP_TABLESPACE`: Verwirft ein Tablespace.
+ `LIST_USERS`: Listet alle Benutzer auf.
+ `REMOVE_GROUPS`: Entfernt Gruppen.
+ `REMOVE_USER`: Entfernt einen Benutzer.
+ `RESTORE_DB`: Stellt eine vollständige Datenbank wieder her.
+ `ROLLFORWARD_DB_LOG`: Führt die Aufgabe `rdsadmin.rollforward_database` für Datenbankprotokolle aus.
+ `ROLLFORWARD_STATUS `: Gibt den Status der Aufgabe `rdsadmin.rollforward_database` zurück.
+ `UPDATE_DB_PARAM`: Aktualisiert die Datenparameter.
`DATABASE_NAME`
Der Name der Datenbank, der die Aufgabe zugeordnet ist.
`COMPLETED_WORK_BYTES`
Die Anzahl der von der Aufgabe wiederhergestellten Bytes.
`DURATION_MINS`
Die Zeit, die zum Abschließen der Aufgabe benötigt wird.
`LIFECYCLE`
Der Status der Aufgabe. Mögliche Status:
+ `CREATED`: Nachdem eine Aufgabe an Amazon RDS übermittelt wurde, legt Amazon RDS den Status auf `CREATED` fest.
+ `IN_PROGRESS`: Nach dem Starten einer Aufgabe legt Amazon RDS den Status auf `IN_PROGRESS` fest. Es kann bis zu 5 Minuten dauern, bis sich der Status von `CREATED` zu `IN_PROGRESS` ändert.
+ `SUCCESS`: Wenn eine Aufgabe abgeschlossen wurde, legt Amazon RDS den Status auf `SUCCESS` fest.
+ `ERROR`: Wenn eine Wiederherstellungsaufgabe fehlschlägt, legt Amazon RDS den Status auf `ERROR` fest. Weitere Informationen zum Fehler finden Sie unter `TASK_OUPUT`.
`CREATED_BY`
Der Parameter `authid`, der den Befehl erstellt hat.
`CREATED_AT`
Der Zeitpunkt (Datum und Uhrzeit), zu dem die Aufgabe angelegt wurde.
`LAST_UPDATED_AT`
Der Zeitpunkt (Datum und Uhrzeit), zu dem die Aufgabe zuletzt aktualisiert wurde.
`TASK_INPUT_PARAMS`
Die Parameter unterscheiden sich je nach Aufgabentyp. Alle Eingabeparameter werden als JSON-Objekt dargestellt. Die JSON-Schlüssel für die Aufgabe `RESTORE_DB` lauten beispielsweise wie folgt:
+ `DBNAME`
+ `RESTORE_TIMESTAMP`
+ `S3_BUCKET_NAME`
+ `S3_PREFIX`
`TASK_OUTPUT`
Zusätzliche Informationen über die Aufgabe. Wenn bei der systemeigenen Wiederherstellung ein Fehler auftritt, enthält diese Spalte Informationen zu dem Fehler.
### Antwortbeispiele
Das folgende Antwortbeispiel zeigt, dass die Datenbank `TESTJP` erfolgreich erstellt wurde. Weitere Informationen finden Sie in der gespeicherten Prozedur [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database).
```
`1 SUCCESS CREATE_DATABASE RDSDB 2023-10-24-18.32.44.962689 2023-10-24-18.34.50.038523 1 TESTJP { "CODESET" : "IBM-437", "TERRITORY" : "JP", "COLLATION" : "SYSTEM", "AUTOCONFIGURE_CMD" : "", "PAGESIZE" : 4096 }
2023-10-24-18.33.30.079048 Task execution has started.
2023-10-24-18.34.50.038523 Task execution has completed successfully`.
```
Im folgenden Antwortbeispiel wird erläutert, warum das Verwerfen einer Datenbank fehlgeschlagen ist. Weitere Informationen finden Sie in der gespeicherten Prozedur [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database).
```
1 ERROR DROP_DATABASE RDSDB 2023-10-10-16.33.03.744122 2023-10-10-16.33.30.143797 - 2023-10-10-16.33.30.098857 Task execution has started.
2023-10-10-16.33.30.143797 Caught exception during executing task id 1, Aborting task.
Reason Dropping database created via rds CreateDBInstance api is not allowed.
Only database created using rdsadmin.create_database can be dropped
```
Das folgende Antwortbeispiel zeigt die erfolgreiche Wiederherstellung einer Datenbank. Weitere Informationen finden Sie in der gespeicherten Prozedur [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database).
```
1 RESTORE_DB SAMPLE SUCCESS
{ "S3_BUCKET_NAME" : "amzn-s3-demo-bucket", "S3_PREFIX" : "SAMPLE.0.rdsdb3.DBPART000.20230413183211.001", "RESTORE_TIMESTAMP" : "20230413183211", "BACKUP_TYPE" : "offline" }
2023-11-06-18.31.03.115795 Task execution has started.
2023-11-06-18.31.04.300231 Preparing to download
2023-11-06-18.31.08.368827 Download complete. Starting Restore
2023-11-06-18.33.13.891356 Task Completed Successfully
```
## rdsadmin.list\$1databases
Gibt eine Liste aller Datenbanken zurück, die auf einer DB-Instance von RDS für Db2 ausgeführt werden.
### Syntax
```
db2 "select * from table(rdsadmin.list_databases())"
```
### Nutzungshinweise
Diese benutzerdefinierte Funktion gibt nicht an, ob sich die Datenbanken in einem aktivierten oder deaktivierten Zustand befinden.
Wenn Ihre Datenbanken nicht in der Liste angezeigt werden, rufen Sie die benutzerdefinierte Funktion [rdsadmin.get\$1task\$1status](#db2-udf-get-task-status) auf und suchen Sie nach Fehlermeldungen.
### Antwort
Die benutzerdefinierte Funktion `rdsadmin.list_databases` gibt die folgenden Spalten zurück:
`DATABASE_NAME`
Der Name einer Datenbank.
`CREATE_TIME`
Der Zeitpunkt (Datum und Uhrzeit), zu dem die Datenbank erstellt wurde.
`DATABASE_UNIQUE_ID`
Der RDS hat eine GUID erstellt, um die Db2-Datenbank eindeutig zu identifizieren.
`ARCHIVE_LOG_RETENTION_HOUR`
Die Anzahl der Stunden, die die Archivprotokolldateien beibehalten werden sollen.
`ARCHIVE_LOG_COPY`
Zeigt an, ob die Funktion für die Datenbank AKTIVIERT oder DEAKTIVIERT ist.
`ARCHIVE_LOG_LAST_UPLOAD_FILE `
Zeigt das letzte Archivprotokoll an, das auf S3 hochgeladen wurde.
`ARCHIVE_LOG_LAST_UPLOAD_FILE_TIME`
Gibt den Zeitpunkt an, zu dem die Protokolldatei archiviert wurde.
`ARCHIVE_LOG_COPY_STATUS`
Zeigt den Status der Archivprotokollkopie an.
UPLOADING: gibt an, dass Archivprotokolldateien auf S3 hochgeladen werden.
CONFIGURATION\$1ERROR: weist darauf hin, dass ein Konfigurationsproblem vorliegt, das Ihre Aufmerksamkeit erfordert.
Eine detaillierte Fehlermeldung finden Sie unter RDS-Ereignismeldungen für Ihre DB-Instance. Die Ereignisnachrichten können unter [Amazon RDS-Ereignisse anzeigen eingesehen werden.](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ListEvents.html)
### Antwortbeispiele
Das folgende Antwortbeispiel zeigt eine Liste der Datenbanken und die Zeitpunkte, zu denen sie erstellt wurden. Die Datenbank `rdsadmin` wird von Amazon RDS verwaltet und stets in der Ausgabe angezeigt.
```
DATABASE_NAME CREATE_TIME DATABASE_UNIQUE_ID ARCHIVE_LOG_RETENTION_HOURS ARCHIVE_LOG_COPY ARCHIVE_LOG_LAST_UPLOAD_FILE ARCHIVE_LOG_LAST_UPLOAD_FILE_TIME ARCHIVE_LOG_COPY_STATUS
--------------- -------------------------- -------------------------------------------------- --------------------------- ---------------- ---------------------------- --------------------------------- ------------------------------
RDSADMIN 2026-01-06-02.03.42.569069 RDSADMIN 0 DISABLED - - -
FOO 2026-01-06-02.13.42.885650 F0D81C7E-7213-4565-B376-4F33FCF420E3 0 ENABLED S0006536.LOG 2026-01-28-19.15.10.000000 UPLOADING
CODEP 2026-01-14-19.42.42.508476 106EEF95-6E30-4FFF-85AE-B044352DF095 0 DISABLED - - -
...
```
## rdsadmin.list\$1modifiable\$1db\$1params
Gibt eine Liste aller änderbaren Datenbankkonfigurationsparameter zurück.
### Syntax
```
db2 "select * from table(rdsadmin.list_modifiable_db_params())"
```
### Nutzungshinweise
Diese benutzerdefinierte Funktion zeigt eine ausgewählte Liste von änderbaren Datenbankparametern an. Diese Parameter können mithilfe der gespeicherten Prozedur aktualisiert werden. [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param)
Alle Datenbankparameter, die nicht in dieser Liste enthalten sind, wurden eingeschränkt und können nicht geändert werden.
### Antwort
Die benutzerdefinierte Funktion `rdsadmin.list_modifiable_db_params` gibt die folgenden Spalten zurück:
`PARAM_NAME`
Der Name des Parameters, der geändert werden kann.
`DEFAULT_VALUE`
Standardparameterwert zum Zeitpunkt der Datenbankerstellung.
`RESTART_REQUIRED`
Ob das Recycling der Datenbank erforderlich ist oder nicht.
Y = Ja, ein Neustart der Datenbank ist erforderlich.
N = Nein, ein Neustart der Datenbank ist nicht erforderlich.
### Antwortbeispiele
Im Folgenden finden Sie ein Beispiel für eine (gekürzte) Liste der erwarteten Ausgaben.
```
PARAM_NAME DEFAULT_VALUE RESTART_REQUIRED
---------------------- ------------- ----------------
ACT_SORTMEM_LIMIT NONE N
ARCHRETRYDELAY 20 N
AUTHN_CACHE_DURATION 3 N
AUTHN_CACHE_USERS 0 N
AUTO_CG_STATS OFF N
...
```
# Fehlerbehebung für Amazon RDS für Db2
Das folgende Thema kann Ihnen bei der Behebung von Problemen helfen, die in RDS für Db2 auftreten.
Weitere Informationen zur allgemeinen Fehlerbehebung in Amazon RDS finden Sie unter [Fehlerbehebung für Amazon RDS](CHAP_Troubleshooting.md).
**Topics**
+ [Fehler bei der Datenbankverbindung](#db2-database-connection-error)
+ [I/O Fehler in der Datei](#db2-file-input-output-error)
+ [Fehler bei gespeicherten Prozeduren](#db2-troubleshooting-stored-procedures)
## Fehler bei der Datenbankverbindung
Die folgende Fehlermeldung weist darauf hin, dass eine Datenbank keine Verbindung herstellen konnte, da der Server nicht über ausreichend Speicherplatz verfügt.
```
SQL1643C The database manager failed to allocate shared memory because the
database manager instance memory limit has been reached.
```
Erweitern Sie den Speicher für die DB-Instance und versuchen Sie dann erneut, eine Verbindung mit der Datenbank herzustellen. Weitere Informationen zur Speichernutzung und Empfehlungen für Datenbanken finden Sie unter [Mehrere Datenbanken auf einer DB-Instance von Amazon RDS für Db2](db2-multiple-databases.md). Weitere Informationen zum Aktualisieren des Speichers für eine Datenbank von RDS für Db2 finden Sie unter [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param).
## I/O Fehler in der Datei
Ein I/O Dateifehler kann aus verschiedenen Gründen auftreten, z. B. wenn Sie den `LOAD` Befehl verwenden oder die `rdsadmin.restore_database` gespeicherte Prozedur aufrufen.
In diesem Beispiel führen Sie den Befehl `LOAD` aus.
```
db2 "call sysproc.admin_cmd('load from "DB2REMOTE://s3test//public/datapump/t6.del" of del lobs from "DB2REMOTE://s3test/public/datapump/" modified by lobsinfile MESSAGES ON SERVER insert INTO RDSDB.t6 nonrecoverable ')"
```
Der Befehl `LOAD` gibt die folgende Meldung zurück:
```
Result set 1
--------------
ROWS_READ ROWS_SKIPPED ROWS_LOADED ROWS_REJECTED ROWS_DELETED ROWS_COMMITTED ROWS_PARTITIONED NUM_AGENTINFO_ENTRIES MSG_RETRIEVAL MSG_REMOVAL
-------------------- -------------------- -------------------- -------------------- -------------------- -------------------- -------------------- --------------------- -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
- - - - - - - - SELECT SQLCODE, MSG FROM TABLE(SYSPROC.ADMIN_GET_MSGS('1594987316_285548770')) AS MSG CALL SYSPROC.ADMIN_REMOVE_MSGS('1594987316_285548770')
1 record(s) selected.
Return Status = 0
SQL20397W Routine "SYSPROC.ADMIN_CMD" execution has completed, but at least
one error, "SQL1652", was encountered during the execution. More information
is available. SQLSTATE=01H52
```
Um die Fehlermeldung anzuzeigen, führen Sie den SQL-Befehl wie in der vorherigen Antwort vorgeschlagen aus. `SELECT SQLCODE, MSG FROM TABLE(SYSPROC.ADMIN_GET_MSGS('1594987316_285548770')) AS MSG` gibt die folgende Meldung zurück:
```
SQLCODE MSG
--------- ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
SQL2025N An I/O error occurred. Error code “438”. Media on which this error occurred: “DB2REMOTE://s3test//public/datapump/t6.del”
SQL3500W The utility is beginning the LOAD phase at time “07/05/2024 21:21:48.082954”
SQL1652N File I/O error occurred
```
Die Db2-Diagnoseprotokolle enthalten eine Protokolldatei, die der folgenden ähnelt:
```
2024-07-05-21.20.09.440609+000 I1191321E864 LEVEL: Error
PID : 2710 TID : 139619509200640 PROC : db2sysc 0
INSTANCE: rdsdb NODE : 000 DB : NTP
APPHDL : 0-12180 APPID: xxx.xx.x.xxx.xxxxx.xxxxxxxxxxxx
UOWID : 5 ACTID: 1
AUTHID : ADMIN HOSTNAME: ip-xx-xx-x-xx
EDUID : 147 EDUNAME: db2lmr 0
FUNCTION: DB2 UDB, oper system services, sqloS3Client_GetObjectInfo, probe:219
MESSAGE : ZRC=0x870F01B6=-2029059658=SQLO_FAILED
"An unexpected error is encountered"
DATA #1 : String, 29 bytes
S3:HeadObject request failed.
DATA #2 : signed integer, 4 bytes
99
DATA #3 : String, 0 bytes
Object not dumped: Address: 0x00007EFC08A9AE38 Size: 0 Reason: Zero-length data
DATA #4 : String, 33 bytes
curlCode: 28, Timeout was reached
```
Dieser I/O Dateifehler kann auf verschiedene Szenarien zurückzuführen sein. Beispielsweise fehlt der VPC, die der Sicherheitsgruppe zugeordnet ist, mit der die DB-Instance von RDS für Db2 erstellt wurde, möglicherweise ein Amazon-S3-Gateway-Endpunkt. Dieser Endpunkt ist unerlässlich, damit RDS für Db2 auf Amazon S3 zugreifen kann. Wenn sich die DB-Instance von RDS für Db2 in privaten Subnetzen befindet, ist ein Amazon-S3-Gateway-Endpunkt erforderlich. Sie können festlegen, ob die DB-Instance private oder öffentliche Subnetze verwendet, indem Sie Amazon-RDS-Subnetzgruppen konfigurieren. Weitere Informationen finden Sie unter [Arbeiten mit DB-Subnetzgruppen](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.Subnets).
**Topics**
+ [Schritt 1: Erstellen eines VPC-Gateway-Endpunkts für Amazon S3](#db2-creating-endpoint)
+ [Schritt 2: Überprüfen, ob der VPC-Gateway-Endpunkt für Amazon S3 vorhanden ist](#db2-confirming-endpoint)
### Schritt 1: Erstellen eines VPC-Gateway-Endpunkts für Amazon S3
Damit die DB-Instance von RDS für Db2 mit Amazon S3 interagieren kann, erstellen Sie erst eine VPC und dann einen Amazon-S3-Gateway-Endpunkt, den private Subnetze verwenden können.
**So erstellen Sie einen VPC-Gateway-Endpunkt für S3**
1. Erstellen Sie eine VPC. Weitere Informationen finden Sie unter [Erstellen einer VPC](https://docs.aws.amazon.com/vpc/latest/userguide/create-vpc.html) im *Benutzerhandbuch von Amazon Virtual Private Cloud*.
1. Erstellen Sie einen Amazon-S3-Gateway-Endpunkt, den private Subnetze verwenden können. Weitere Informationen finden Sie unter [Gateway-Endpunkte](https://docs.aws.amazon.com/vpc/latest/privatelink/gateway-endpoints.html) im *AWS PrivateLink -Leitfaden*.
### Schritt 2: Überprüfen, ob der VPC-Gateway-Endpunkt für Amazon S3 vorhanden ist
Vergewissern Sie sich, dass Sie erfolgreich einen Amazon-S3-Gateway-Endpunkt erstellt haben, indem Sie die AWS-Managementkonsole oder die AWS CLI verwenden.
#### Konsole
**So verifizieren Sie einen Amazon-S3-Gateway-Endpunkt**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon VPC-Konsole unter[https://console.aws.amazon.com/vpc](https://console.aws.amazon.com/vpc).
1. Wählen Sie oben rechts in der Konsole die AWS-Region der VPC aus.
1. Wählen Sie die VPC aus, den Sie erstellt haben.
1. Überprüfen Sie auf der Registerkarte **Ressourcenzuordnung** unter **Netzwerkverbindungen**, ob ein Amazon-S3-Gateway-Endpunkt aufgeführt wird.
#### AWS CLI
Führen Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html) aus, um einen Amazon-S3-Gateway-Endpunkt zu verifizieren. Ersetzen Sie im folgenden Beispiel *vpc\$1id* durch die VPC-ID, *region* durch Ihre AWS-Region und *profile* durch Ihren Profilnamen.
Für Linux, macOS oder Unix:
```
aws ec2 describe-vpc-endpoints \
--filters "Name=vpc-id,Values=$vpc_id" \
"Name=service-name,\
Values=com.amazonaws.${region}.s3" \
--region $region --profile=$profile \
--query "VpcEndpoints[*].VpcEndpointId" --output text
```
Für Windows:
```
aws ec2 describe-vpc-endpoints ^
--filters "Name=vpc-id,Values=$vpc_id" ^
"Name=service-name,^
Values=com.amazonaws.${region}.s3" ^
--region $region --profile=$profile ^
--query "VpcEndpoints[*].VpcEndpointId" --output text
```
Die Ausgabe dieses Befehls sieht etwa wie im folgenden Beispiel aus, wenn ein Amazon-S3-Gateway-Endpunkt vorhanden ist.
```
[
"vpce-0ea810434ff0b97e4"
]
```
Die Ausgabe dieses Befehls sieht etwa wie im folgenden Beispiel aus, wenn kein Amazon-S3-Gateway-Endpunkt vorhanden ist.
```
[]
```
Wenn kein Amazon-S3-Gateway-Endpunkt aufgeführt wird, fahren Sie mit [Schritt 1: Erstellen eines VPC-Gateway-Endpunkts für Amazon S3](#db2-creating-endpoint) fort.
## Fehler bei gespeicherten Prozeduren
In diesem Abschnitt werden verschiedene Fehler beschrieben, die beim Aufrufen von gespeicherten Prozeduren auftreten, sowie Maßnahmen zur Fehlerbehebung erläutert.
| Kategorie | Fehler bei gespeicherten Prozeduren |
| --- | --- |
| Datenbanken | [rdsadmin.activate\$1database-Fehler](#db2-troubleshooting-activate-database-sp-errors) |
| Datenbanken | [rdsadmin.backup\$1database-Fehler](#db2-troubleshooting-backup-database-sp-errors) |
| Datenbanken | [rdsadmin.create\$1database-Fehler](#db2-troubleshooting-create-database-sp-errors) |
| Datenbanken | [rdsadmin.deactivate\$1database-Fehler](#db2-troubleshooting-deactivate-database-sp-errors) |
| Datenbanken | [rdsadmin.drop\$1database-Fehler](#db2-troubleshooting-drop-database-sp-errors) |
| Datenbanken | [rdsadmin.reactivate\$1database-Fehler](#db2-troubleshooting-reactivate-database-sp-errors) |
| Datenbanken | [rdsadmin.restore\$1database-Fehler](#db2-troubleshooting-restore-database-sp-errors) |
| Datenbanken | [rdsadmin.update\$1db\$1param-Fehler](#db2-troubleshooting-update-db-param-sp-errors) |
| Tablespaces | [rdsadmin.alter\$1tablespace-Fehler](#db2-troubleshooting-alter-tablespace-sp-errors) |
### rdsadmin.activate\$1database-Fehler
Die folgenden Fehler können auftreten, wenn Sie die gespeicherte Prozedur [rdsadmin.activate\$1database](db2-sp-managing-databases.md#db2-sp-activate-database) aufrufen.
| Fehler | Fehlermeldung |
| --- | --- |
| [Failed to allocate shared memory](#activate-database-sp-failed-to-allocate-shared-memory) | `SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.` |
| [Unable to activate because of running processes](#activate-database-sp-unable-to-activate-processes) | `The database can’t be activated because it's in the process of being created or restored.` |
**Gemeinsamer Speicher konnte nicht zugewiesen werden**
Die folgende Fehlermeldung weist darauf hin, dass die gespeicherte Prozedur keine Datenbank aktivieren konnte, da die DB-Instance nicht über ausreichend Speicherplatz verfügt.
```
SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.
```
Erweitern Sie den Speicher für Ihre DB-Instance und rufen Sie dann die gespeicherte Prozedur `rdsadmin.activate_database` erneut auf. Weitere Informationen zur Speichernutzung und Empfehlungen für Datenbanken finden Sie unter [Mehrere Datenbanken auf einer DB-Instance von Amazon RDS für Db2](db2-multiple-databases.md).
**Aktivierung ist aufgrund laufender Prozesse nicht möglich**
Die folgende Fehlermeldung weist darauf hin, dass die gespeicherte Prozedur keine Datenbank aktivieren konnte, da die gespeicherte Prozedur `rdsadmin.create_database` oder `rdsadmin.restore_database` derzeit ausgeführt wird.
```
The database can’t be activated because it's in the process of being created or restored.
```
Warten Sie einige Minuten und rufen Sie dann die gespeicherte Prozedur `rdsadmin.activate_database` erneut auf.
### rdsadmin.alter\$1tablespace-Fehler
Die folgenden Fehler können auftreten, wenn Sie die gespeicherte Prozedur [rdsadmin.alter\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-alter-tablespace) aufrufen.
| Fehler | Fehlermeldung |
| --- | --- |
| [Statement not valid](#alter-tablespace-sp-statement-not-valid) | `DB21034E The command was processed as an SQL statement because it was not a valid Command Line Processor command. During SQL processing it returned: ` `SQL1763N Invalid ALTER TABLESPACE statement for table space "TBSP_TEST" due to reason "12"` |
| [tablespace_prefetch_size value not valid](#alter-tablespace-sp-prefetch-value-not-valid) | `Invalid tablespace_prefetch_size. Set value to AUTOMATIC or to a non-zero positive numerical value.` |
| [tablespace_prefetch_size numerical value not valid](#alter-tablespace-sp-prefetch-numerical-value-not-valid) | `Invalid tablespace_prefetch_size. The number of pages can't be greater than 32767.` |
| [Parameter can't be used with tablespace_prefetch_size](#alter-tablespace-sp-prefetch-incompatible-parameter) | `You can't use tablespace_prefetch_size with {parameter}.` |
| [Tablespace change failed](#alter-tablespace-sp-tablespace-change-failed) | `The change to tablespace {tablespace_name} failed because you can only alter LARGE or REGULAR tablespaces.` |
**Anweisung nicht gültig**
Die folgende Fehlermeldung weist darauf hin, dass die gespeicherte Prozedur sich gegenseitig ausschließende optionale Parameter mit anderen optionalen Parametern kombiniert hat. Die optionalen Parameter `reduce_max, reduce_stop`, `reduce_value`, `lower_high_water`, `lower_high_water_stop` und `switch_online` für die gespeicherte Prozedur `rdsadmin.alter_tablespace` schließen sich gegenseitig aus. Sie können nicht mit anderen optionalen Parametern wie `buffer_pool_name` in der gespeicherten Prozedur `rdsadmin.alter_tablespace` kombiniert werden. Wenn Sie sie kombinieren, gibt Db2 beim Aufrufen der benutzerdefinierten Funktion `rdsadmin.get_task_status` diese Fehlermeldung zurück.
```
DB21034E The command was processed as an SQL statement because it was not a valid Command Line Processor command. During SQL processing it returned:
SQL1763N Invalid ALTER TABLESPACE statement for table space "TBSP_TEST" due to reason "12"
```
Rufen Sie die gespeicherte Prozedur `rdsadmin.alter_tablespace` erneut auf, ohne sich gegenseitig ausschließende optionale Parameter mit anderen optionalen Parametern zu kombinieren. Rufen Sie dann die benutzerdefinierte Funktion `rdsadmin.get_task_status` auf. Weitere Informationen finden Sie unter [rdsadmin.alter\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-alter-tablespace) und [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
**Wert für tablespace\$1prefetch\$1size ist nicht gültig**
Die folgende Fehlermeldung weist darauf hin, dass Sie `tablespace_prefetch_size` nicht auf `AUTOMATIC` oder einen nicht positiven numerischen Wert festgelegt haben. Sie haben den Wert beispielsweise auf `testinput` festgelegt.
```
Invalid tablespace_prefetch_size. Set value to AUTOMATIC or to a non-zero positive numerical value.
```
Rufen Sie die gespeicherte Prozedur `rdsadmin.alter_tablespace` erneut auf und legen Sie `tablespace_prefetch_size` auf `AUTOMATIC` oder einen nicht positiven numerischen Wert fest.
**Numerischer Wert für tablespace\$1prefetch\$1size ist nicht gültig**
Die folgende Fehlermeldung weist darauf hin, dass Sie `tablespace_prefetch_size` auf einen numerischen Wert festgelegt haben, der größer als 32 767 ist.
```
Invalid tablespace_prefetch_size. The number of pages can't be greater than 32767.
```
Rufen Sie die gespeicherte Prozedur `rdsadmin.alter_tablespace` erneut auf und legen Sie `tablespace_prefetch_size` auf einen positiven numerischen Wert ungleich Null fest, der kleiner als oder gleich 32 767 ist.
**Parameter kann nicht mit tablespace\$1prefetch\$1size verwendet werden**
Die folgende Fehlermeldung weist darauf hin, dass Sie versucht haben, `tablespace_prefetch_size` mit einem inkompatiblen Parameter zu verwenden.
```
You can't use tablespace_prefetch_size with {parameter}.
```
Rufen Sie die gespeicherte Prozedur `rdsadmin.alter_tablespace` erneut auf und verwenden Sie `tablespace_prefetch_size` nur mit kompatiblen Parametern. Weitere Informationen zu Parametern, die Sie mit `tablespace_prefetch_size` verwenden können, finden Sie unter [rdsadmin.alter\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-alter-tablespace).
**Tablespace-Änderung ist fehlgeschlagen**
Die folgende Fehlermeldung weist darauf hin, dass Sie versucht haben, einen Tablespace zu ändern.
```
The change to tablespace {tablespace_name} failed because you can only alter LARGE or REGULAR tablespaces.
```
### rdsadmin.backup\$1database-Fehler
Die folgenden Fehler können auftreten, wenn Sie die gespeicherte Prozedur [rdsadmin.backup\$1database](db2-sp-managing-databases.md#db2-sp-backup-database) aufrufen.
| Fehler | Fehlermeldung |
| --- | --- |
| [Insufficient disk space](#backup-database-sp-insufficient-disk-space) | `Aborting task. Reason Backing up your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.backup_database stored procedure.` |
| [Internal error](#backup-database-sp-internal-error) | `Caught exception during executing task id 104, Aborting task. Reason Internal Error` |
**Nicht genügend Speicherplatz**
Die folgende Fehlermeldung weist darauf hin, dass Ihre DB-Instance nicht über ausreichend Festplattenspeicher verfügt, um Ihre Datenbank zu sichern:
```
Aborting task. Reason Backing up your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.backup_database stored procedure.
```
Wenn Sie eine Datenbank im Remotespeicher sichern, stellen Sie sicher, dass Sie über ausreichend freien Speicherplatz für die Sicherungssitzung und die Arbeitsdateien verfügen. In jeder Sicherungssitzung werden bis zu 5 GB Daten verarbeitet. Für Transaktionsprotokolle, temporäre Dateien und laufende Datenbankoperationen wird jedoch zusätzlicher Speicherplatz benötigt.
Wir empfehlen, dass Sie je nach Datenbankgröße über den folgenden freien Speicherplatz für Backups verfügen:
+ Für Datenbanken unter 5 GB — Die Datenbankgröße \$1 3 GB Puffer
+ Für Datenbanken mit 5 GB und mehr — Mindestens 10 GB freier Speicherplatz
Diese Menge an freiem Festplattenspeicher ist für die Verarbeitung von Sicherungssitzungen, die Akkumulation von Transaktionsprotokollen während der Sicherung, temporäre Arbeitsdateien und parallel Backup-Streams, sofern konfiguriert, verantwortlich. Weitere Informationen finden Sie unter [Steigern der DB-Instance-Speicherkapazität](USER_PIOPS.ModifyingExisting.md).
Erweitern Sie den Speicherplatz und rufen Sie dann die gespeicherte Prozedur [rdsadmin.backup\$1database](db2-sp-managing-databases.md#db2-sp-backup-database) erneut auf. Um sicherzustellen, dass die Datenbank korrekt gesichert wurde, überprüfen Sie den Status der Aufgabe mithilfe von[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). Sie können auch überprüfen, ob die Backup-Dateien in Ihrem Amazon S3 S3-Bucket unter vorhanden sind*s3\$1prefix/dbi\$1resource\$1id/db\$1name*.
**Interner Fehler**
Die folgende Fehlermeldung weist darauf hin, dass bei der gespeicherten Prozedur ein interner Fehler aufgetreten ist:
```
Caught exception during executing task id 104, Aborting task. Reason Internal Error
```
[AWS Support](https://aws.amazon.com/premiumsupport/) kontaktieren.
### rdsadmin.create\$1database-Fehler
Der folgende Fehler kann auftreten, wenn Sie die gespeicherte Prozedur [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database) aufrufen.
| Fehler | Fehlermeldung |
| --- | --- |
| [Failed to allocate shared memory](#create-database-sp-failed-to-allocate-shared-memory) | `SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.` |
**Gemeinsamer Speicher konnte nicht zugewiesen werden**
Die folgende Fehlermeldung weist darauf hin, dass die gespeicherte Prozedur keine Datenbank erstellen konnte, da die DB-Instance nicht über ausreichend Speicherplatz verfügt.
```
SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.
```
Erweitern Sie den Speicher für Ihre DB-Instance und rufen Sie dann die gespeicherte Prozedur `rdsadmin.create_database` erneut auf. Weitere Informationen zur Speichernutzung und Empfehlungen für Datenbanken finden Sie unter [Mehrere Datenbanken auf einer DB-Instance von Amazon RDS für Db2](db2-multiple-databases.md).
Um zu überprüfen, ob die Datenbank erstellt wurde, rufen Sie die benutzerdefinierte Funktion [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases) auf und überprüfen Sie, ob die neue Datenbank aufgelistet wird.
### rdsadmin.deactivate\$1database-Fehler
Der folgende Fehler kann auftreten, wenn Sie die gespeicherte Prozedur [rdsadmin.deactivate\$1database](db2-sp-managing-databases.md#db2-sp-deactivate-database) aufrufen.
| Fehler | Fehlermeldung |
| --- | --- |
| [Unable to deactivate because of running processes](#deactivate-database-sp-unable-to-deactivate-processes) | `The database can’t be deactivated because it's in the process of being created or restored.` |
**Deaktivierung ist aufgrund laufender Prozesse nicht möglich**
Die folgende Fehlermeldung weist darauf hin, dass die gespeicherte Prozedur keine Datenbank deaktivieren konnte, da die gespeicherte Prozedur `rdsadmin.create_database` oder `rdsadmin.restore_database` derzeit ausgeführt wird.
```
The database can’t be deactivated because it's in the process of being created or restored.
```
Warten Sie einige Minuten und rufen Sie dann die gespeicherte Prozedur `rdsadmin.deactivate_database` erneut auf.
### rdsadmin.drop\$1database-Fehler
Die folgenden Fehler können auftreten, wenn Sie die gespeicherte Prozedur [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database) aufrufen.
| Fehler | Fehlermeldung |
| --- | --- |
| [Database name doesn't exist](#drop-database-sp-database-name-not-exist) | `SQL0438N Application raised error or warning with diagnostic text: "Cannot drop database. Database with provided name does not exist". SQLSTATE=99993` |
| [Return status = 0](#drop-database-sp-return-status-zero) | `Return Status = 0` |
| [Dropping database not allowed](#drop-database-sp-not-allowed) | `1 ERROR DROP_DATABASE RDSDB 2023-10-10-16.33.03.744122 2023-10-10-16.33.30.143797 - 2023-10-10-16.33.30.098857 Task execution has started. 2023-10-10-16.33.30.143797 Caught exception during executing task id 1, Aborting task. Reason Dropping database created via rds CreateDBInstance api is not allowed. Only database created using rdsadmin.create_database can be dropped` |
**Datenbankname ist nicht vorhanden**
Die folgende Fehlermeldung weist darauf hin, dass Sie in der gespeicherten Prozedur `rdsadmin.drop_database` einen falschen Datenbanknamen angegeben haben.
```
SQL0438N Application raised error or warning with diagnostic text: "Cannot
drop database. Database with provided name does not exist". SQLSTATE=99993
```
Rufen Sie die gespeicherte Prozedur `rdsadmin.drop_database` mit einem korrekten Datenbanknamen erneut auf. Um zu überprüfen, ob die Datenbank verworfen wurde, rufen Sie die benutzerdefinierte Funktion [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases) auf und vergewissern Sie sich, dass die verworfene Datenbank nicht aufgelistet wird.
**Rückgabestatus = 0**
Die folgende Fehlermeldung weist darauf hin, dass die gespeicherte Prozedur nicht abgeschlossen werden konnte.
```
Return Status = 0
```
Rufen Sie nach dem Empfang von `Return Status = 0` die benutzerdefinierte Funktion [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status) auf.
**Verwerfen der Datenbank ist nicht zulässig**
Die folgende Fehlermeldung weist darauf hin, dass Sie die Datenbank entweder mit der Amazon-RDS-Konsole oder mit der AWS CLI erstellt haben. Sie können die gespeicherte Prozedur `rdsadmin.drop_database` nur verwenden, wenn Sie die Datenbank durch Aufrufen der gespeicherten Prozedur [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database) erstellt haben.
```
1 ERROR DROP_DATABASE RDSDB 2023-10-10-16.33.03.744122 2023-10-10-16.33.30.143797 - 2023-10-10-16.33.30.098857 Task execution has started.
2023-10-10-16.33.30.143797 Caught exception during executing task id 1, Aborting task.
Reason Dropping database created via rds CreateDBInstance api is not allowed.
Only database created using rdsadmin.create_database can be dropped
```
Um eine Datenbank zu verwerfen, die Sie entweder mit der Amazon-RDS-Konsole oder der AWS CLI erstellt haben, stellen Sie über einen Client eine Verbindung mit der Datenbank her und führen Sie dann den entsprechenden Befehl aus.
### rdsadmin.reactivate\$1database-Fehler
Der folgende Fehler kann auftreten, wenn Sie die gespeicherte Prozedur [rdsadmin.reactivate\$1database](db2-sp-managing-databases.md#db2-sp-reactivate-database) aufrufen.
| Fehler | Fehlermeldung |
| --- | --- |
| [Failed to allocate shared memory](#reactivate-database-sp-failed-to-allocate-shared-memory) | `SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.` |
| [Unable to reactivate because of running processes](#reactivate-database-sp-unable-to-reactivate-processes) | `The database can’t be reactivated because it's in the process of being created or restored.` |
**Gemeinsamer Speicher konnte nicht zugewiesen werden**
Die folgende Fehlermeldung weist darauf hin, dass die gespeicherte Prozedur keine Datenbank aktivieren konnte, da die DB-Instance nicht über ausreichend Speicherplatz verfügt.
```
SQL1643C The database manager failed to allocate shared memory because the database manager instance memory limit has been reached.
```
Erweitern Sie den Speicher für Ihre DB-Instance und rufen Sie dann die gespeicherte Prozedur `rdsadmin.activate_database` erneut auf. Weitere Informationen zur Speichernutzung und Empfehlungen für Datenbanken finden Sie unter [Mehrere Datenbanken auf einer DB-Instance von Amazon RDS für Db2](db2-multiple-databases.md).
**Reaktivierung ist aufgrund laufender Prozesse nicht möglich**
Die folgende Fehlermeldung weist darauf hin, dass die gespeicherte Prozedur keine Datenbank reaktivieren konnte, da die gespeicherte Prozedur `rdsadmin.create_database` oder `rdsadmin.restore_database` derzeit ausgeführt wird.
```
The database can’t be reactivated because it's in the process of being created or restored.
```
Warten Sie einige Minuten und rufen Sie dann die gespeicherte Prozedur `rdsadmin.reactivate_database` erneut auf.
### rdsadmin.restore\$1database-Fehler
Die folgenden Fehler können auftreten, wenn Sie die gespeicherte Prozedur [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database) aufrufen:
| Fehler | Fehlermeldung |
| --- | --- |
| [Insufficient disk space](#restore-database-sp-insufficient-disk-space) | `Aborting task. Reason Restoring your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.restore_database stored procedure.` |
| [Internal error](#restore-database-sp-internal-error) | `Caught exception during executing task id 104, Aborting task. Reason Internal Error` |
| [Non-fenced routines not allowed](#restore-database-sp-non-fenced-routines) | `Caught exception during executing task id 2, Aborting task. Reason Non fenced routines are not allowed. Please delete the routines and retry the restore.` |
| [Tablespaces not restored](#restore-database-sp-tablespaces-not-restored) | `Reason SQL0970N The system attempted to write to a read-only file. Reason SQL2563W The Restore process has completed successfully. However one or more table spaces from the backup were not restored.` |
**Nicht genügend Speicherplatz**
Die folgende Fehlermeldung weist darauf hin, dass die DB-Instance nicht über ausreichend Speicherplatz verfügt, um Ihre Datenbank wiederherzustellen:
```
Aborting task. Reason Restoring your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.restore_database stored procedure.
```
Der freie Speicherplatz auf der DB-Instance muss mehr als doppelt so groß sein wie das Backup-Abbild. Wenn das Backup-Abbild komprimiert ist, muss der freie Speicherplatz auf der DB-Instance mehr als dreimal so groß wie das Backup-Abbild sein. Weitere Informationen finden Sie unter [Steigern der DB-Instance-Speicherkapazität](USER_PIOPS.ModifyingExisting.md).
Erweitern Sie den Speicherplatz und rufen Sie dann die gespeicherte Prozedur `rdsadmin.restore_database` erneut auf. Um zu überprüfen, ob die Datenbank wiederhergestellt wurde, rufen Sie die benutzerdefinierte Funktion [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases) auf und überprüfen Sie, ob die wiederhergestellte Datenbank aufgelistet wird.
**Interner Fehler**
Die folgende Fehlermeldung weist darauf hin, dass bei der gespeicherten Prozedur ein interner Fehler aufgetreten ist:
```
Caught exception during executing task id 104, Aborting task. Reason Internal Error
```
[AWS Support](https://aws.amazon.com/premiumsupport/) kontaktieren.
**Routinen ohne Fencing sind nicht zulässig**
Die folgende Fehlermeldung weist darauf hin, dass die Datenbank Routinen ohne Fencing enthält:
```
Caught exception during executing task id 2, Aborting task. Reason Non fenced routines are not allowed. Please delete the routines and retry the restore.
```
RDS für Db2 unterstützt keine Routinen ohne Fencing. Entfernen Sie die Routinen ohne Fencing aus der Quelldatenbank und rufen Sie `rdsadmin.restore_database` dann erneut auf. Um zu überprüfen, ob die Datenbank wiederhergestellt wurde, rufen Sie die benutzerdefinierte Funktion [rdsadmin.list\$1databases](db2-user-defined-functions.md#db2-udf-list-databases) auf und überprüfen Sie, ob die wiederhergestellte Datenbank aufgelistet wird. Weitere Informationen finden Sie unter [Routinen ohne Fencing](db2-known-issues-limitations.md#db2-known-issues-limitations-non-fenced-routines).
**Tablespaces wurden nicht wiederhergestellt**
Die folgende Fehlermeldung weist darauf hin, dass RDS für Db2 die Datenbank erfolgreich wiederhergestellt hat, aber ein oder mehrere Tablespaces nicht wiederhergestellt werden konnten:
```
Reason SQL0970N The system attempted to write to a read-only file.
Reason SQL2563W The Restore process has completed successfully. However one or more table spaces from the backup were not restored.
```
RDS für Db2 unterstützt keine nicht automatische Speicherung. Wandeln Sie nicht automatischen Speicher in automatischen Speicher um und rufen Sie `rdsadmin.restore_database` dann erneut auf. Weitere Informationen finden Sie unter [Konvertieren einer Datenbank mit nicht automatischem Speicher zur Verwendung von automatischem Speicher](https://www.ibm.com/docs/en/db2/11.5?topic=databases-converting-nonautomatic-storage-database-use-automatic-storage)in der IBM Db2-Dokumentation.
Datenbanken mit nicht automatischem SMS-Speicher müssen manuell wiederhergestellt werden. Wenn die Datenbank über einen nicht automatischen SMS-Speicher verfügt, wenden Sie sich an den [AWS Support](https://aws.amazon.com/premiumsupport/).
Informationen zu nicht automatischem Speicher und einmaligen Migrationen finden Sie unter [Nicht automatische Speicher-Tablespaces während der Migration](db2-known-issues-limitations.md#db2-known-issues-limitations-non-automatic-storage-tablespaces).
### rdsadmin.update\$1db\$1param-Fehler
Der folgende Fehler kann auftreten, wenn Sie die gespeicherte Prozedur [rdsadmin.update\$1db\$1param](db2-sp-managing-databases.md#db2-sp-update-db-param) aufrufen.
| Fehler | Fehlermeldung |
| --- | --- |
| [Parameter not supported or modifiable](#update-db-param-sp-parameter-not-supported-modifiable) | SQL0438N Application raised error or warning with diagnostic text: "Parameter is either not supported or not modifiable to customers". SQLSTATE=99993 |
**Parameter wird nicht unterstützt oder kann nicht geändert werden**
Die folgende Fehlermeldung weist darauf hin, dass Sie versucht haben, einen Datenbankkonfigurationsparameter zu ändern, der entweder nicht unterstützt wird oder nicht geändert werden kann.
```
SQL0438N Application raised error or warning with diagnostic text: "Parameter
is either not supported or not modifiable to customers". SQLSTATE=99993
```
Sie können anhand der Parametergruppen einsehen, welche Parameter geändert werden können. Weitere Informationen finden Sie unter [Anzeigen von Parameterwerten für eine DB-Parametergruppe in Amazon RDS](USER_WorkingWithParamGroups.Viewing.md).