Arbeiten mit dem Abfrage-Editor

Mit dem Abfrage-Editor können Sie SQL-Abfragen in der RDS-Konsole ausführen. Sie können SQL-Anweisungen zur Datenmanipulation und Datendefinition auf dem DB-Cluster ausführen. Das SQL, das Sie ausführen können, unterliegt den Einschränkungen der Daten-API. Weitere Informationen finden Sie unter Einschränkungen bei der RDS-Daten-API.

Der Abfrage-Editor erfordert einen Aurora-DB-Cluster mit aktivierter RDS Data API (Data API). Informationen zu DB-Clustern, die die Data API unterstützen, und wie Sie sie aktivieren, finden Sie unter Verwenden der RDS-Daten-API.

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 die Daten-API unterstützen, und in der AWS-Regionen , in der die Daten-API verfügbar ist. Weitere Informationen finden Sie unter RDS-Daten-API.

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 hinzufügen, eine vordefinierte AWS Identity and Access Management (IAM)-Richtlinie.

Anmerkung

Vergewissern Sie sich, dass Sie beim Erstellen des Benutzers denselben Benutzernamen und dasselbe Passwort verwenden wie für den Datenbankbenutzer, z. B. den Hauptbenutzernamen und das Passwort. Weitere Informationen zum Hinzufügen von Benutzern finden Sie unter Erstellen eines IAM-Benutzers in Ihrem AWS-Konto 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.

{
    "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 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 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 bei der RDS-Daten-API.

So führen Sie eine Abfrage im Abfrage-Editor aus

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon-RDS-Konsole unter https://console.aws.amazon.com/rds/.

2. Wählen Sie oben rechts in der die aus AWS Management Console, AWS-Region in der Sie die Aurora-DB-Cluster erstellt haben, die Sie abfragen möchten.

3. Wählen Sie im Navigationsbereich Datenbanken aus.

4. Wählen Sie den Aurora-DB-Cluster aus, auf dem Sie SQL-Abfragen ausführen möchten.

5. 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.

   

6. Geben Sie die folgenden Informationen ein:

   1. Wählen Sie für Datenbank-Instance oder Cluster den Aurora-DB-Cluster aus, auf dem Sie SQL-Abfragen ausführen möchten.

   2. 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.

   3. Geben Sie in Enter database password (Datenbankpasswort eingeben) das Passwort für den von Ihnen ausgewählten Datenbankbenutzer ein.

   4. 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.

   5. 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.

7. Geben Sie im Abfrage-Editor die SQL-Abfrage ein, die Sie für die Datenbank ausführen möchten.

   

   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.

   

   Das Fenster Query Editor Settings (Einstellungen des Abfrage-Editors) wird angezeigt.

   

   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.

8. Wählen Sie Run (Ausführen) oder drücken Sie STRG+Eingabetaste. 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).