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.
# Arbeiten mit dem Aurora-Abfrage-Editor
Mit dem Aurora-Abfrage-Editor können Sie SQL-Anweisungen auf Ihrem Aurora-DB-Cluster über die AWS-Managementkonsole ausführen. Sie können SQL-Abfragen, DML-Anweisungen (Data Manipulation Language) und DDL-Anweisungen (Data Definition Language) ausführen. Mithilfe der Konsolenschnittstelle können Sie die Datenbankwartung durchführen, Berichte erstellen und SQL-Experimente durchführen. Sie können vermeiden, die Netzwerkkonfiguration so einzurichten, dass Sie von einem separaten Clientsystem wie einer EC2 Instance oder einem Laptop aus eine Verbindung zu Ihrem DB-Cluster herstellen.
Der Abfrage-Editor erfordert einen Aurora-DB-Cluster mit aktivierter RDS-Daten-API (Daten-API). Informationen zu DB-Clustern, die die Daten-API unterstützen, und zu deren Aktivierung finden Sie unter [Verwenden der Daten-API von Amazon RDS](data-api.md). Das SQL, das Sie ausführen können, unterliegt den Einschränkungen der Daten-API. Weitere Informationen finden Sie unter [Einschränkungen der Amazon-RDS-Daten-API](data-api.limitations.md).
## Verfügbarkeit des Abfrage-Editors
Der Abfrage-Editor ist für Aurora-DB-Cluster verfügbar, die Aurora MySQL- und Aurora PostgreSQL-Engine-Versionen verwenden, die Data API unterstützen, und dort, AWS-Regionen wo Data API verfügbar ist. Weitere Informationen finden Sie unter [Unterstützte Regionen und Aurora-DB-Engines für RDS-Daten-API](Concepts.Aurora_Fea_Regions_DB-eng.Feature.Data_API.md).
## Autorisieren des Zugriffs auf den Abfrage-Editor
Ein Benutzer muss zum Ausführen von Abfragen im Abfrage-Editor autorisiert sein. Sie können einen Benutzer autorisieren, Abfragen im Abfrage-Editor auszuführen, indem Sie diesem Benutzer die `AmazonRDSDataFullAccess` Richtlinie, eine vordefinierte Richtlinie AWS Identity and Access Management (IAM), hinzufügen.
**Anmerkung**
Vergewissern Sie sich, dass Sie beim Erstellen des IAM-Benutzers denselben Benutzernamen und dasselbe Passwort verwenden wie für den Datenbankbenutzer, z. B. den Namen und das Passwort des Administratorbenutzers. Weitere Informationen zum Hinzufügen von Benutzern finden Sie unter [Erstellen eines IAM-Benutzers in Ihrem AWS-Konto](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) im *AWS Identity and Access Management-Benutzerhandbuch*.
Sie können auch eine IAM-Richtlinie erstellen die Zugriff auf den Abfrage-Editor gewährt. Nach dem Erstellen der Richtlinie können Sie diese jedem Benutzer hinzufügen, der Zugriff auf den Abfrage-Editor benötigt.
Die folgende Richtlinie bietet die mindestens erforderlichen Berechtigungen für einen Benutzer, um auf den Abfrage-Editor zuzugreifen.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryEditor0",
"Effect": "Allow",
"Action": [
"secretsmanager:GetSecretValue",
"secretsmanager:PutResourcePolicy",
"secretsmanager:PutSecretValue",
"secretsmanager:DeleteSecret",
"secretsmanager:DescribeSecret",
"secretsmanager:TagResource"
],
"Resource": "arn:aws:secretsmanager:*:*:secret:rds-db-credentials/*"
},
{
"Sid": "QueryEditor1",
"Effect": "Allow",
"Action": [
"secretsmanager:GetRandomPassword",
"tag:GetResources",
"secretsmanager:CreateSecret",
"secretsmanager:ListSecrets",
"dbqms:CreateFavoriteQuery",
"dbqms:DescribeFavoriteQueries",
"dbqms:UpdateFavoriteQuery",
"dbqms:DeleteFavoriteQueries",
"dbqms:GetQueryString",
"dbqms:CreateQueryHistory",
"dbqms:UpdateQueryHistory",
"dbqms:DeleteQueryHistory",
"dbqms:DescribeQueryHistory",
"rds-data:BatchExecuteStatement",
"rds-data:BeginTransaction",
"rds-data:CommitTransaction",
"rds-data:ExecuteStatement",
"rds-data:RollbackTransaction"
],
"Resource": "*"
}
]
}
```
------
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 *AWS Identity and Access Management-Benutzerhandbuch*.
Informationen zum Hinzufügen einer IAM-Richtlinie zu einem Benutzer finden Sie im Abschnitt [Hinzufügen und Entfernen von IAM-Identitätsberechtigungen](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) im *AWS Identity and Access Management-Benutzerhandbuch*.
## Ausführen von Abfragen im Abfrage-Editor
Sie können SQL-Anweisungen auf einem Aurora-DB-Cluster im Abfrage-Editor ausführen. Das SQL, das Sie ausführen können, unterliegt den Einschränkungen der Daten-API. Weitere Informationen finden Sie unter [Einschränkungen der Amazon-RDS-Daten-API](data-api.limitations.md).
**So führen Sie eine Abfrage im Abfrage-Editor aus**
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 des den ausAWS-Managementkonsole, AWS-Region in dem Sie die Aurora-DB-Cluster erstellt haben, die Sie abfragen möchten.
1. Wählen Sie im Navigationsbereich **Datenbanken** aus.
1. Wählen Sie den Aurora-DB-Cluster aus, für den Sie SQL-Abfragen ausführen möchten.
1. Wählen Sie für **Aktionen** die Option **Abfrage** aus. Falls Sie noch keine Verbindung zur Datenbank hergestellt haben, wird die Seite **Connect to database (Verbindung zur Datenbank herstellen)** geöffnet.
![\[Abfrage-Editor Seite „Connect to database“ (Verbindung zur Datenbank herstellen)\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/query-editor-connect.png)
1. Geben Sie die folgenden Informationen ein:
1. Wählen Sie für **Datenbank-Instance oder -Cluster** den Aurora-DB-Cluster aus, für den Sie SQL-Abfragen ausführen möchten.
1. Wählen Sie in **Database username (Datenbank-Benutzername)** den Benutzernamen des Benutzers der Datenbank aus, mit der Sie eine Verbindung herstellen möchten, oder wählen Sie **Add new database credentials (Neue Datenbankanmeldeinformationen hinzufügen)** aus. Wenn Sie **Add new database credentials (Neue Datenbankanmeldeinformationen)** auswählen, geben Sie den Benutzernamen für die neuen Datenbankanmeldeinformationen in **Enter database username (Datenbank-Benutzername eingeben)** ein.
1. Geben Sie in **Enter database password (Datenbankpasswort eingeben)** das Passwort für den von Ihnen ausgewählten Datenbankbenutzer ein.
1. Geben Sie in das letzte Feld den Namen der Datenbank oder des Schemas ein, die bzw. das Sie für das Aurora-DB-Cluster verwenden möchten.
1. Wählen Sie **Connect to database (Verbindung zur Datenbank herstellen)**.
**Anmerkung**
Wenn Ihre Verbindung erfolgreich ist, werden Ihre Verbindungs- und Authentifizierungsinformationen in gespeicher AWS Secrets Manager. Sie müssen die Verbindungsinformationen nicht noch einmal eingeben.
1. Geben Sie im Abfrage-Editor die SQL-Abfrage ein, die Sie für die Datenbank ausführen möchten.
![\[Abfrage-Editor mit einer SQL-Anweisung im Textbereich\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/query-editor.png)
Jede SQL-Anweisung kann automatisch übergeben werden. Alternativ können Sie SQL-Anweisungen in einem Skript als Teil einer Transaktion ausführen. Um dieses Verhalten zu steuern, wählen Sie das Zahnradsymbol oberhalb des Abfragefensters aus.
![\[Zahnradsymbol im Abfrage-Editor\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/query-editor-gear.png)
Das Fenster **Query Editor Settings (Einstellungen des Abfrage-Editors)** wird angezeigt.
![\[Einstellungen des Abfrage-Editors\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/images/query-editor-settings.png)
Wenn Sie **Auto-commit (Automatisch übergeben)** wählen, wird jede SQL-Anweisung automatisch übergeben. Wenn Sie **Transaktion** wählen, können Sie eine Gruppe von Anweisungen in einem Skript ausführen. Anweisungen werden automatisch am Ende des Skripts festgeschrieben, es sei denn, vorher wurde explizit festgeschrieben oder zurückgesetzt. Sie können ein Skript, das ausgeführt wird, bei Auftreten eines Fehlers auch anhalten, indem Sie **Stop on error (Bei Fehler anhalten)** aktivieren.
**Anmerkung**
In einer Gruppe von Anweisungen können Data Definition Language (DDL)-Anweisungen dazu führen, dass frühere Data Manipulation Language (DML)-Anweisungen übergeben werden. Sie können in einer Gruppe von Anweisungen in einem Skript auch `COMMIT`- und `ROLLBACK`-Anweisungen einfügen.
Wählen Sie nach Festlegen der Optionen im Fenster **Query Editor Settings (Einstellungen des Abfrage-Editors)** **Save (Speichern)** aus.
1. Wählen Sie **Run (Ausführen)** oder drücken Sie STRG\$1Eingabetaste. Der Abfrage-Editor zeigt dann die Ergebnisse Ihrer Abfrage an.
Speichern Sie nach dem Ausführen der Abfrage diese in **Saved Queries (Gespeicherte Abfragen)** durch Auswahl von **Save (Speichern)**.
Sie können die Abfrageergebnisse durch Auswahl von **Export to csv (Zu CSV exportieren)** in ein Tabellenformat exportieren.
Sie können frühere Abfragen suchen, bearbeiten und erneut ausführen. Hierzu wählen Sie die Registerkarte **Recent (Zuletzt)** oder **Saved queries (Gespeicherte Abfragen)**, den Abfragetext und anschließend **Run (Ausführen)** aus.
Um die Datenbank zu ändern, wählen Sie **Change database (Datenbank ändern)**.
# API-Referenz für Database Query Metadata Service (DBQMS)
Der Database Query Metadata Service (`dbqms`) ist ein reiner Dienst für interne Daten. Er stellt Ihre aktuellen und gespeicherten Abfragen für den Abfrage-Editor auf AWS-Managementkonsole für mehrere AWS-Services bereit, einschließlich Amazon RDS.
**Topics**
+ [CreateFavoriteQuery](#CreateFavoriteQuery)
+ [CreateQueryHistory](#CreateQueryHistory)
+ [CreateTab](#CreateTab)
+ [DeleteFavoriteQueries](#DeleteFavoriteQueries)
+ [DeleteQueryHistory](#DeleteQueryHistory)
+ [DeleteTab](#DeleteTab)
+ [DescribeFavoriteQueries](#DescribeFavoriteQueries)
+ [DescribeQueryHistory](#DescribeQueryHistory)
+ [DescribeTabs](#DescribeTabs)
+ [GetQueryString](#GetQueryString)
+ [UpdateFavoriteQuery](#UpdateFavoriteQuery)
+ [UpdateQueryHistory](#UpdateQueryHistory)
+ [UpdateTab](#UpdateTab)
## CreateFavoriteQuery
Speichern Sie eine neue bevorzugte Abfrage. Jeder -Benutzer kann bis zu 1000 gespeicherte Abfragen erstellen. Dieses Limit kann in Zukunft geändert werden.
## CreateQueryHistory
Dient zum Speichern eines neuen Abfrageverlaufseintrags.
## CreateTab
Speichern Sie eine neue Abfrage-Registerkarte. Jeder -Benutzer kann bis zu 10 Abfrage-Registerkarten erstellen.
## DeleteFavoriteQueries
Löschen Sie eine oder mehrere gespeicherte Abfragen.
## DeleteQueryHistory
Dient zum Löschen von Abfrageverlaufseinträgen.
## DeleteTab
Löschen Sie Einträge der Abfrage-Registerkarte
## DescribeFavoriteQueries
Listet gespeicherte Abfragen auf, die von einem Benutzer in einem bestimmten Konto erstellt wurden.
## DescribeQueryHistory
Listet Abfrageverlaufseinträge auf.
## DescribeTabs
Listet Abfrage-Registerkarten auf, die von einem Benutzer in einem bestimmten Konto erstellt wurden.
## GetQueryString
Dient zum Abruf des vollständigen Abfragetexts über eine Abfrage-ID.
## UpdateFavoriteQuery
Ermöglicht die Aktualisierung der Abfragezeichenfolge, der Beschreibung, des Namens oder des Ablaufdatums.
## UpdateQueryHistory
Dient zum Aktualisieren des Status des Abfrageverlaufs.
## UpdateTab
Aktualisieren Sie den Namen der Abfrage-Registerkarte und die Abfragezeichenfolge.