Erste Schritte mit Aurora DSQL

Wählen Sie Neue Datenbankverbindung.

Wählen Sie im Fenster Neue Datenbankverbindung die Option PostgreSQL aus.

Wählen Sie auf der Registerkarte Verbindungseinstellungen/Main die Option Connect by: Host und geben Sie die folgenden Informationen ein.

1. Host — Verwenden Sie Ihren Cluster-Endpunkt.

   Datenbank — Geben Sie ein postgres

   Authentifizierung — Wählen Database Native

   Nutzername — Geben Sie ein admin

   Passwort — Generieren Sie ein Authentifizierungstoken. Kopieren Sie das generierte Token und verwenden Sie es als Passwort.

Ignorieren Sie alle Warnungen und fügen Sie Ihr Authentifizierungstoken in das Feld DBeaverPasswort ein.

Sie sollten mit Ihrem Cluster verbunden sein und mit der Ausführung von SQL-Anweisungen beginnen können.

Wählen Sie Neue Datenquelle und dann PostgreSQL.

Geben Sie auf der Sources/General Registerkarte Daten die folgenden Informationen ein:

1. Host — Verwenden Sie Ihren Cluster-Endpunkt.

   Port — Aurora DSQL verwendet den PostgreSQL-Standard: 5432

   Datenbank — Aurora DSQL verwendet den PostgreSQL-Standard von postgres

   Authentifizierung — Wählen Sie. User & Password

   Nutzername — Geben Sie einadmin.

   Passwort — Generieren Sie ein Token und fügen Sie es in dieses Feld ein.

   URL — Ändern Sie dieses Feld nicht. Es wird basierend auf den anderen Feldern automatisch ausgefüllt.

Passwort — Geben Sie dieses an, indem Sie ein Authentifizierungstoken generieren. Kopieren Sie die resultierende Ausgabe des Token-Generators und fügen Sie sie in das Passwortfeld ein.

Sie sollten mit Ihrem Cluster verbunden sein und mit der Ausführung von SQL-Anweisungen beginnen können:

Melden Sie sich bei der an AWS Management Console und öffnen Sie die Aurora DSQL-Konsole unterhttps://console.aws.amazon.com/dsql.

Wählen Sie Create Cluster und dann Single-Region aus.

(Optional) Wählen Sie in den Clustereinstellungen eine der folgenden Optionen aus:

(Optional) Wählen Sie unter Tags ein Tag für diesen Cluster aus, oder geben Sie es ein.

Wählen Sie Cluster erstellen.

Wählen Sie in der Aurora DSQL-Konsole den Cluster aus, zu dem Sie eine Verbindung herstellen möchten.

Wählen Sie Connect aus.

Kopieren Sie den Endpunkt von Endpoint (Host).

Vergewissern Sie sich, dass im Abschnitt Authentifizierungstoken (Passwort) die Option Als Administrator Connect ausgewählt ist.

Kopieren Sie das generierte Authentifizierungstoken. Dieses Token ist 15 Minuten gültig.

Verwenden Sie in der Befehlszeile des Betriebssystems den folgenden Befehl, um Ihren Cluster zu starten psql und eine Verbindung zu ihm herzustellen. your_cluster_endpointErsetzen Sie es durch den Cluster-Endpunkt, den Sie zuvor kopiert haben.

PGSSLMODE=require \
  psql --dbname postgres \
  --username admin \
  --host your_cluster_endpoint

Wenn Sie zur Eingabe eines Kennworts aufgefordert werden, geben Sie das Authentifizierungstoken ein, das Sie zuvor kopiert haben. Wenn Sie versuchen, mit einem abgelaufenen Token erneut eine Verbindung herzustellen, wird die Verbindungsanforderung verweigert. Weitere Informationen finden Sie unter Generieren eines Authentifizierungstokens in Amazon Aurora DSQL.

Drücken Sie die Eingabetaste. Sie sollten eine PostgreSQL-Eingabeaufforderung sehen.

postgres=>

Wenn Sie die Fehlermeldung „Zugriff verweigert“ erhalten, stellen Sie sicher, dass Ihre IAM-Identität über die entsprechende Berechtigung verfügt. dsql:DbConnectAdmin Wenn Sie über die entsprechende Berechtigung verfügen und weiterhin die Fehlermeldung „Zugriff verweigert“ erhalten, finden Sie weitere Informationen unter Problembehandlung bei IAM und Wie kann ich Fehler mit einer IAM-Richtlinie beheben, bei der der Zugriff verweigert wurde oder bei nicht autorisierten Vorgängen? .

Erstellen Sie ein Schema mit dem Namenexample.

CREATE SCHEMA example;

Erstellen Sie eine Rechnungstabelle, die eine automatisch generierte UUID als Primärschlüssel verwendet.

CREATE TABLE example.invoice(
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(), 
    created timestamp, 
    purchaser int, 
    amount float);

Erstellen Sie einen sekundären Index, der die leere Tabelle verwendet.

CREATE INDEX ASYNC invoice_created_idx on example.invoice(created);

Erstellen Sie eine Abteilungstabelle.

CREATE TABLE example.department(id INT PRIMARY KEY UNIQUE, name text, email text);

Verwenden Sie den Befehlpsql \include, um die Datei mit dem Namen zu ladendepartment-insert-multirow.sql, die Sie aus dem aurora-dsql-samplesaws-samples/ -Repository heruntergeladen haben. GitHub Ersetzen Sie es my-path durch den Pfad zu Ihrer lokalen Kopie.

\include my-path/department-insert-multirow.sql

Verwenden Sie den Befehlpsql \copy, um die Datei mit dem Namen zu ladeninvoice.csv, die Sie aus dem aurora-dsql-samplesaws-samples/ -Repository heruntergeladen haben. GitHub Ersetzen Sie es my-path durch den Pfad zu Ihrer lokalen Kopie.

\copy example.invoice(created, purchaser, amount) from my-path/invoice.csv csv

Fragen Sie die Abteilungen ab und sortieren Sie sie nach ihrem Gesamtumsatz.

SELECT name, sum(amount) AS sum_amount
FROM example.department LEFT JOIN example.invoice ON department.id=invoice.purchaser
GROUP BY name
HAVING sum(amount) > 0
ORDER BY sum_amount DESC;

Die folgende Beispielausgabe zeigt, dass Abteilung Drei die meisten Verkäufe erzielt.

           name           |     sum_amount     
--------------------------+--------------------
 Example Department Three |  54061.67752854594
 Example Department Seven |  53869.65965365204
 Example Department Eight |  52199.73742066634
 Example Department One   | 52034.078869900826
 Example Department Six   |  50886.15556256385
 Example Department Two   |  50589.98422247931
 Example Department Five  | 49549.852635496005
 Example Department Four  |  49266.15578027619
(8 rows)

Melden Sie sich bei der an AWS Management Console und öffnen Sie die Aurora DSQL-Konsole unterhttps://console.aws.amazon.com/dsql.

Klicken Sie im Navigationsbereich auf Cluster.

Wählen Sie Cluster erstellen und dann Multi-Region aus.

(Optional) Wählen Sie in den Clustereinstellungen eine der folgenden Optionen für Ihren ersten Cluster aus:

Wählen Sie in den Einstellungen für mehrere Regionen die folgenden Optionen für Ihren ersten Cluster aus:

(Optional) Wählen Sie Tags für Ihren ersten Cluster aus.

Wählen Sie Cluster erstellen aus, um Ihren ersten Cluster zu erstellen. Wenn Sie im vorherigen Schritt keinen ARN eingegeben haben, zeigt die Konsole die Benachrichtigung Cluster-Setup ausstehend an.

Wählen Sie in der Benachrichtigung „Cluster-Setup ausstehend“ die Option Complete Multi-Region-Cluster-Setup aus. Diese Aktion initiiert die Erstellung eines zweiten Clusters in einer anderen Region.

Wählen Sie eine der folgenden Optionen für Ihren zweiten Cluster:

Wählen Sie Cluster erstellen in your-second-region, wo your-second-region sich der Standort Ihres zweiten Clusters befindet. Die Konsole wird in Ihrer zweiten Region geöffnet.

(Optional) Wählen Sie die Clustereinstellungen für Ihren zweiten Cluster aus. Sie können beispielsweise eine auswählen AWS KMS key.

Wählen Sie Cluster erstellen, um Ihren zweiten Cluster zu erstellen.

Wählen Sie Peer in initial-cluster-region. Dabei initial-cluster-region handelt es sich um die Region, die den ersten Cluster hostet, den Sie erstellt haben.

Wenn Sie dazu aufgefordert werden, wählen Sie Bestätigen. Mit diesem Schritt ist die Erstellung Ihres Clusters mit mehreren Regionen abgeschlossen.

Öffnen Sie die Aurora DSQL-Konsole und wählen Sie die Region für Ihren zweiten Cluster aus.

Wählen Sie Clusters (Cluster) aus.

Wählen Sie die Zeile für den zweiten Cluster in Ihrem Multi-Region-Cluster aus.

Wählen Sie unter Aktionen die Option Öffnen in CloudShell aus.

Wählen Sie Als Administrator Connect.

Wählen Sie Launch CloudShell (Starten) aus.

Wählen Sie Ausführen aus.

Erstellen Sie ein Beispielschema, indem Sie die Schritte unter befolgenSchritt 3: Führen Sie SQL-Beispielbefehle in Aurora DSQL aus.

Beispieltransaktionen

CREATE SCHEMA example;
CREATE TABLE example.invoice(id UUID PRIMARY KEY DEFAULT gen_random_uuid(), created timestamp, purchaser int, amount float);
CREATE INDEX ASYNC invoice_created_idx on example.invoice(created);
CREATE TABLE example.department(id INT PRIMARY KEY UNIQUE, name text, email text);

Verwenden Sie die include Befehle psql copy und zum Laden von Beispieldaten. Weitere Informationen finden Sie unter Schritt 3: Führen Sie SQL-Beispielbefehle in Aurora DSQL aus.

\copy example.invoice(created, purchaser, amount) from samples/invoice.csv csv
\include samples/department-insert-multirow.sql

Wählen Sie in der Aurora DSQL-Konsole die Region für Ihren ersten Cluster aus.

Wählen Sie Clusters (Cluster) aus.

Wählen Sie die Zeile für den zweiten Cluster in Ihrem Cluster mit mehreren Regionen aus.

Wählen Sie unter Aktionen die Option Öffnen in CloudShell aus.

Wählen Sie Als Administrator Connect.

Wählen Sie Launch CloudShell (Starten) aus.

Wählen Sie Ausführen aus.

Fragen Sie die Daten ab, die Sie in den zweiten Cluster eingefügt haben.

SELECT name, sum(amount) AS sum_amount
FROM example.department 
LEFT JOIN example.invoice ON department.id=invoice.purchaser 
GROUP BY name 
HAVING sum(amount) > 0
ORDER BY sum_amount DESC;