Commencer à utiliser Aurora DSQL

Choisissez Nouvelle connexion à la base de données.

Dans la fenêtre Nouvelle connexion à la base de données, sélectionnez PostgreSQL.

Dans l'onglet Paramètres de connexion/Main, choisissez Connect by : Host et entrez les informations suivantes.

1. Hôte : utilisez le point de terminaison de votre cluster.

   Base de données — Entrez postgres

   Authentification — Choisissez Database Native

   Nom d'utilisateur — Entrez admin

   Mot de passe — Générez un jeton d'authentification. Copiez le jeton généré et utilisez-le comme mot de passe.

Ignorez les avertissements et collez votre jeton d'authentification dans le champ DBeaverMot de passe.

Vous devez être connecté à votre cluster et pouvez commencer à exécuter des instructions SQL.

Choisissez Nouvelle source de données, puis PostgreSQL.

Dans l' Sources/General onglet Données, entrez les informations suivantes :

1. Hôte : utilisez le point de terminaison de votre cluster.

   Port — Aurora DSQL utilise la valeur par défaut de PostgreSQL : 5432

   Base de données — Aurora DSQL utilise la valeur par défaut de PostgreSQL postgres

   Authentification — ChoisissezUser & Password .

   Nom d'utilisateur — Entrezadmin.

   Mot de passe — Générez un jeton et collez-le dans ce champ.

   URL — Ne modifiez pas ce champ. Il sera rempli automatiquement en fonction des autres champs.

Mot de passe — Fournissez-le en générant un jeton d'authentification. Copiez le résultat du générateur de jetons et collez-le dans le champ du mot de passe.

Vous devez être connecté à votre cluster et pouvez commencer à exécuter des instructions SQL :

Connectez-vous à la console Aurora AWS Management Console DSQL et ouvrez-la à https://console.aws.amazon.com/dsql l'adresse.

Choisissez Create cluster, puis Single-Region.

(Facultatif) Dans les paramètres du cluster, sélectionnez l'une des options suivantes :

(Facultatif) Dans Balises, choisissez ou entrez une balise pour ce cluster.

Choisissez Créer un cluster.

Dans la console Aurora DSQL, choisissez le cluster auquel vous souhaitez vous connecter.

Choisissez Se connecter.

Copiez le point de terminaison depuis le point de terminaison (hôte).

Assurez-vous que vous vous connectez en tant qu'administrateur est sélectionné dans la section Jeton d'authentification (mot de passe).

Copiez le jeton d'authentification généré. Ce jeton est valide pendant 15 minutes.

Sur la ligne de commande du système d'exploitation, utilisez la commande suivante pour démarrer psql et vous connecter à votre cluster. your_cluster_endpointRemplacez-le par le point de terminaison du cluster que vous avez copié précédemment.

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

Lorsque vous êtes invité à saisir un mot de passe, entrez le jeton d'authentification que vous avez copié précédemment. Si vous essayez de vous reconnecter à l'aide d'un jeton expiré, la demande de connexion est refusée. Pour de plus amples informations, veuillez consulter Génération d'un jeton d'authentification dans Amazon Aurora DSQL.

Appuyez sur Entrée. Vous devriez voir une invite PostgreSQL s'afficher.

postgres=>

Si vous recevez un message d'erreur de refus d'accès, assurez-vous que votre identité IAM dispose de l'dsql:DbConnectAdminautorisation requise. Si vous êtes autorisé et que vous continuez à recevoir des erreurs de refus d'accès, consultez Résoudre les problèmes liés à l'IAM et Comment puis-je résoudre les problèmes liés aux refus d'accès ou aux erreurs de fonctionnement non autorisées avec une politique IAM ? .

Créez un schéma nomméexample.

CREATE SCHEMA example;

Créez une table de factures qui utilise un UUID généré automatiquement comme clé primaire.

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

Créez un index secondaire qui utilise la table vide.

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

Créez un tableau des départements.

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

Utilisez la commande psql \include pour charger le fichier nommé department-insert-multirow.sql que vous avez téléchargé depuis le dépôt aurora-dsql-samplesaws-samples/ sur. GitHub Remplacez my-path par le chemin d'accès à votre copie locale.

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

Utilisez la commande psql \copy pour charger le fichier nommé invoice.csv que vous avez téléchargé depuis le dépôt aurora-dsql-samplesaws-samples/ sur. GitHub Remplacez my-path par le chemin d'accès à votre copie locale.

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

Interrogez les départements et triez-les en fonction de leurs ventes totales.

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;

L'exemple de résultat suivant montre que le département 3 enregistre le plus de ventes.

           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)

Connectez-vous à la console Aurora AWS Management Console DSQL et ouvrez-la à https://console.aws.amazon.com/dsql l'adresse.

Dans le panneau de navigation, choisissez Clusters.

Choisissez Créer un cluster, puis Multi-région.

(Facultatif) Dans les paramètres du cluster, sélectionnez l'une des options suivantes pour votre cluster initial :

Dans les paramètres multirégionaux, choisissez les options suivantes pour votre cluster initial :

(Facultatif) Choisissez des balises pour votre cluster initial.

Choisissez Create cluster pour créer votre cluster initial. Si vous n'avez pas saisi d'ARN à l'étape précédente, la console affiche la notification de configuration du cluster en attente.

Dans la notification Configuration du cluster en attente, choisissez Compléter la configuration du cluster multirégional. Cette action initie la création d'un deuxième cluster dans une autre région.

Choisissez l'une des options suivantes pour votre deuxième cluster :

Choisissez Créer un cluster dans your-second-region, où se your-second-region trouve l'emplacement de votre deuxième cluster. La console s'ouvre dans votre deuxième région.

(Facultatif) Choisissez les paramètres de cluster pour votre deuxième cluster. Par exemple, vous pouvez choisir un AWS KMS key.

Choisissez Create cluster pour créer votre deuxième cluster.

Choisissez Peer in initial-cluster-region, où se initial-cluster-region trouve la région qui héberge le premier cluster que vous avez créé.

Lorsque vous y êtes invité, choisissez Confirmer. Cette étape termine la création de votre cluster multirégional.

Ouvrez la console Aurora DSQL et choisissez la région pour votre deuxième cluster.

Choisissez Clusters.

Sélectionnez la ligne correspondant au deuxième cluster de votre cluster multirégional.

Dans Actions, sélectionnez Ouvrir dans CloudShell.

Choisissez Connect en tant qu'administrateur.

Choisissez Lancer CloudShell.

Cliquez sur Exécuter.

Créez un exemple de schéma en suivant les étapes décrites dansÉtape 3 : Exécuter des exemples de commandes SQL dans Aurora DSQL.

Exemples de transactions

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);

Utilisez include les commandes psql copy et pour charger des exemples de données. Pour de plus amples informations, veuillez consulter Étape 3 : Exécuter des exemples de commandes SQL dans Aurora DSQL.

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

Dans la console Aurora DSQL, choisissez la région pour votre cluster initial.

Choisissez Clusters.

Sélectionnez la ligne correspondant au deuxième cluster de votre cluster multirégional.

Dans Actions, sélectionnez Ouvrir dans CloudShell.

Choisissez Connect en tant qu'administrateur.

Choisissez Lancer CloudShell.

Cliquez sur Exécuter.

Recherchez les données que vous avez insérées dans le deuxième cluster.

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;