Mise en route avec Aurora DSQL - Amazon Aurora DSQL
PrérequisCréation d’un cluster à une seule régionConnexion à un clusterExécution de commandes SQLCréation d’un cluster multi-régionsRésolution de problème

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mise en route avec Aurora DSQL

Amazon Aurora DSQL est une base de données relationnelle distribuée sans serveur optimisée pour les charges de travail transactionnelles. Dans les sections suivantes, vous allez apprendre à créer des clusters Aurora DSQL à région unique ou multirégionale, à vous y connecter et à créer et charger un exemple de schéma. Vous accéderez aux clusters à l'aide de la AWS console et interagirez éventuellement avec votre base de données à l'aide d'autres clients PostgreSQL. À la fin, vous disposerez d'un cluster Aurora DSQL fonctionnel prêt à être utilisé pour les charges de travail de test ou de production.

Prérequis

Avant de commencer à utiliser Aurora DSQL, assurez-vous de remplir les prérequis suivants :

  • Votre identité IAM doit être autorisée à vous connecter à la console.

  • Votre identité IAM doit répondre aux critères suivants :

    • Accès pour effectuer n'importe quelle action sur n'importe quelle ressource de votre Compte AWS

    • AmazonAuroraDSQLConsoleFullAccess AWS une politique gérée est jointe.

Étape 1 : création d’un cluster à une seule région Aurora DSQL

L’unité de base d’Aurora DSQL est le cluster, dans lequel vous stockez vos données. Dans cette tâche, vous créez un cluster en une seule Région AWS.

Pour créer un cluster à une seule région dans Aurora DSQL

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

  2. Choisissez Créer un cluster, puis Une seule région.

  3. (Facultatif) modifiez la valeur de la balise Name par défaut.

  4. (Facultatif) Ajoutez des balises supplémentaires pour ce cluster.

  5. (Facultatif) Dans Paramètres du cluster, sélectionnez l’une des options suivantes :

    • Sélectionnez Personnaliser les paramètres de chiffrement (avancé) pour choisir ou créer une AWS KMS key.

    • Sélectionnez Activer la protection contre la suppression pour empêcher la suppression de votre cluster. Par défaut, la protection contre la suppression est sélectionnée.

    • Sélectionnez Stratégie basée sur les ressources (avancée) pour spécifier les politiques de contrôle d'accès pour ce cluster.

  6. Choisissez Créer un cluster.

  7. La console vous renvoie à la page Clusters. Une bannière de notification apparaît pour indiquer que le cluster est en cours de création. Sélectionnez l'ID du cluster pour ouvrir la vue détaillée du cluster.

Étape 2 : connexion à votre cluster Aurora DSQL

Aurora SQL prend en charge plusieurs méthodes de connexion à votre cluster, notamment l'éditeur de requêtes SQL AWS CloudShell, le client PSQL local et d'autres outils compatibles avec PostgreSQL. Au cours de cette étape, vous vous connectez à l'aide de l'éditeur de requêtes SQL Aurora, qui permet de commencer rapidement à interagir avec votre nouveau cluster.

Pour vous connecter à l'aide de l'éditeur de requêtes

  1. Dans la console Aurora DSQL (https://console.aws.amazon.com/dsql), ouvrez la page Clusters et vérifiez que la création de votre cluster est terminée et que son statut est Actif.

  2. Sélectionnez votre cluster dans la liste ou choisissez l'ID du cluster pour ouvrir la page des détails du cluster.

  3. Choisissez Connect with Query editor.

  4. Choisissez Connect en tant qu'administrateur pour le cluster qui vient d'être créé.

Étape 3 : exécution d’exemples de commandes SQL dans Aurora DSQL

Testez votre cluster Aurora DSQL en exécutant des instructions SQL. Après avoir ouvert le cluster dans l'éditeur de requêtes, sélectionnez et exécutez chaque exemple de requête étape par étape.

Exécuter des exemples de commandes SQL dans Aurora DSQL

  1. Créez un schéma nommé test.

    CREATE SCHEMA IF NOT EXISTS test;

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

    CREATE TABLE IF NOT EXISTS test.hello_world (  
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),  
    message VARCHAR(255) NOT NULL,  
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP  
);

  3. Insérez un exemple de ligne.

    INSERT INTO test.hello_world (message)  
VALUES ('Hello, World!');

  4. Lisez les valeurs insérées.

    SELECT * FROM test.hello_world;

  5. Nettoyage optionnel

    DROP TABLE test.hello_world;
DROP SCHEMA test;

Étape 4 (facultatif) : créer un cluster multirégional

Si vous souhaitez créer un cluster multi-régions, indiquez les régions suivantes :

Région distante

Il s’agit de la région dans laquelle vous créez un deuxième cluster. Vous créez un deuxième cluster dans cette région et vous le connectez à votre cluster initial. Aurora DSQL réplique toutes les écritures du cluster initial vers le cluster distant. Vous pouvez lire et écrire sur n’importe quel cluster.

Région témoin

Cette région reçoit toutes les données écrites dans le cluster multi-régions. Toutefois, les régions témoins n’hébergent pas de points de terminaison clients et ne fournissent pas d’accès aux données utilisateur. Une fenêtre limitée du journal des transactions chiffré est conservée dans les régions témoins. Ce journal facilite la restauration et soutient le quorum transactionnel en cas d’indisponibilité d’une région.

Utilisez la procédure suivante pour créer un cluster initial, créer un deuxième cluster dans une région différente, puis comparer les deux clusters pour créer un cluster multirégional. Il montre également la réplication d’écriture entre plusieurs régions et les lectures cohérentes à partir des deux points de terminaison régionaux.

Pour créer un cluster multi-régions

  1. Connectez-vous à la console Aurora DSQL.

  2. Dans le panneau de navigation, choisissez Clusters.

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

  4. (Facultatif) modifiez la valeur de la balise Name par défaut.

  5. (Facultatif) Ajoutez des balises supplémentaires pour ce cluster.

  6. Dans Paramètres multi-régions, choisissez les options suivantes pour votre cluster initial :

    • Dans Région témoin, choisissez une région. Actuellement, seules les régions basées aux États-Unis sont prises en charge pour les régions témoins dans les clusters multi-régions.

    • (Facultatif) Dans ARN du cluster de région distante, entrez un ARN pour un cluster existant dans une autre région. S’il n’existe aucun cluster pouvant servir de deuxième cluster dans votre cluster multi-régions, terminez la configuration après avoir créé le cluster initial.

  7. (Facultatif) Dans Paramètres du cluster, sélectionnez l’une des options suivantes pour votre cluster initial :

    • Sélectionnez Personnaliser les paramètres de chiffrement (avancé) pour choisir ou créer une AWS KMS key.

    • Sélectionnez Activer la protection contre la suppression pour empêcher la suppression de votre cluster. Par défaut, la protection contre la suppression est sélectionnée.

    • Sélectionnez Stratégie basée sur les ressources (avancée) pour spécifier les politiques de contrôle d'accès pour ce cluster.

  8. Choisissez Créer un 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 Configuration du cluster en attente.

  9. Dans la notification Configuration du cluster en attente, choisissez Compléter la configuration du cluster multi-régions. Cette action initie la création d’un deuxième cluster dans une autre région.

  10. Choisissez l’une des options suivantes pour votre deuxième cluster :

    • Ajouter un ARN de cluster de région distante : choisissez cette option si un cluster existe et que vous souhaitez qu’il soit le deuxième cluster de votre cluster multi-régions.

    • Créer un cluster dans une autre région : choisissez cette option pour créer un deuxième cluster. Dans Région distante, choisissez la région pour ce deuxième cluster.

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

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

  13. Choisissez Créer un cluster pour créer votre deuxième cluster.

  14. 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éé.

  15. Lorsque vous y êtes invité, choisissez Confirmer. Cette étape termine la création de votre cluster multi-régions.

Connexion à votre deuxième cluster

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

  2. Choisissez Clusters.

  3. Sélectionnez la ligne correspondant au deuxième cluster de votre cluster multi-régions.

  4. Choisissez Connect with Query editor.

  5. Choisissez Connecter en tant qu’administrateur.

  6. Créez un exemple de schéma et de table, puis insérez des données en suivant les étapes décrites dansÉtape 3 : exécution d’exemples de commandes SQL dans Aurora DSQL.

Interrogation des données du deuxième cluster à partir de la région hébergeant votre cluster initial

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

  2. Choisissez Clusters.

  3. Sélectionnez la ligne correspondant au deuxième cluster de votre cluster multi-régions.

  4. Choisissez Connect with Query editor.

  5. Choisissez Connecter en tant qu’administrateur.

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

    SELECT * FROM test.hello_world;

Résolution de problème

Consultez la section Dépannage de la documentation d'Aurora DSQL.