Création d’un cluster compatible avec les requêtes parallèles à l’aide de la console Création d’un cluster compatible avec les requêtes parallèles à l’aide de l’interface de ligne de commande (CLI)

Création d’un cluster de bases de données de requêtes parallèles dans Aurora MySQL

Pour créer un cluster Aurora MySQL compatible avec les requêtes parallèles, pour y ajouter des instances ou pour effectuer d’autres opérations administratives, vous devez utiliser les mêmes techniques d’AWS Management Console et d’AWS CLI que pour les autres clusters Aurora MySQL. Vous pouvez créer un cluster pour qu’il soit compatible avec les requêtes parallèles. Vous pouvez également créer un cluster de bases de données pour qu’il fonctionne avec les requêtes parallèles en restaurant un instantané de cluster de bases de données Aurora compatible avec MySQL 5.6. Si vous ne savez pas comment créer un cluster Aurora MySQL, vous trouverez les prérequis et toute information utile dans Création d’un cluster de bases de données Amazon Aurora.

Lorsque vous choisissez une version de moteur Aurora MySQL, nous vous recommandons de choisir la version la plus récente disponible. Actuellement, toutes les versions disponibles d’Aurora MySQL prennent en charge les requêtes parallèles. Vous disposez d’une plus grande flexibilité pour activer et désactiver les requêtes parallèles ou pour les utiliser avec des clusters existants sur les versions les plus récentes.

Que vous choisissiez de créer un cluster ou de restaurer un instantané, les techniques d’ajout de nouvelles instances de base de données sont les mêmes techniques que pour les autres clusters Aurora MySQL.

Vous pouvez créer un cluster de requêtes parallèles à l’aide de la console Amazon RDS ou de l’AWS CLI.

Table des matières

Création d’un cluster compatible avec les requêtes parallèles à l’aide de la console

Pour créer un cluster compatible avec les requêtes parallèles à l’aide de la console, procédez comme décrit ci-dessous.

Pour créer un cluster compatible avec les requêtes parallèles via AWS Management Console

Suivez la procédure AWS Management Console générale décrite dans Création d’un cluster de bases de données Amazon Aurora.
Pour Type de moteur, choisissez Aurora MySQL.
Pour Configuration supplémentaire, choisissez un groupe de paramètres que vous avez créé pour Groupe de paramètres de cluster de bases de données. L’utilisation d’un groupe de paramètres personnalisés de ce type est requise pour Aurora MySQL 2.09 et versions ultérieures. Dans votre groupe de paramètres de cluster de bases de données, spécifiez les paramètres aurora_parallel_query=ON et aurora_disable_hash_join=OFF. Cela active la requête parallèle pour le cluster, ainsi que l’optimisation de jointure par hachage qui fonctionne en combinaison avec la requête parallèle.

Pour vérifier qu’un nouveau cluster est compatible avec les requêtes parallèles

Créez un cluster à l’aide de la technique précédente.

(Pour Aurora MySQL version 2 ou 3) Vérifiez que le paramètre de configuration aurora_parallel_query est true.


mysql> select @@aurora_parallel_query;
+-------------------------+
| @@aurora_parallel_query |
+-------------------------+
|                       1 |
+-------------------------+

(Pour Aurora MySQL version 2) Vérifiez que le paramètre aurora_disable_hash_join est false.


mysql> select @@aurora_disable_hash_join;
+----------------------------+
| @@aurora_disable_hash_join |
+----------------------------+
|                          0 |
+----------------------------+

Avec certaines tables volumineuses et certaines requêtes à grand volume de données, vérifiez les plans de requête pour confirmer que certaines de vos requêtes utilisent l’optimisation de requête parallèle. Pour ce faire, suivez la procédure décrite dans Vérification des instructions utilisant les requêtes parallèles pour Aurora MySQL.

Création d’un cluster compatible avec les requêtes parallèles à l’aide de l’interface de ligne de commande (CLI)

Pour créer un cluster compatible avec les requêtes parallèles à l’aide de l’interface de ligne de commande (CLI), procédez comme décrit ci-dessous.

Pour créer un cluster compatible avec les requêtes parallèles via AWS CLI

(Facultatif) Vérifiez quelles versions d’Aurora MySQL sont compatibles avec les clusters de requête parallèle. Pour ce faire, utilisez la commande describe-db-engine-versions et vérifiez la valeur du champ SupportsParallelQuery. Pour obtenir un exemple, consultez Vérification de la compatibilité de version Aurora MySQL pour une requête parallèle.
(Facultatif) Créez un groupe de paramètres de cluster de bases de données personnalisés avec les paramètres aurora_parallel_query=ON et aurora_disable_hash_join=OFF. Utilisez des commandes telles que les suivantes.
```
aws rds create-db-cluster-parameter-group --db-parameter-group-family aurora-mysql8.0 --db-cluster-parameter-group-name pq-enabled-80-compatible
aws rds modify-db-cluster-parameter-group --db-cluster-parameter-group-name pq-enabled-80-compatible \
  --parameters ParameterName=aurora_parallel_query,ParameterValue=ON,ApplyMethod=pending-reboot
aws rds modify-db-cluster-parameter-group --db-cluster-parameter-group-name pq-enabled-80-compatible \
  --parameters ParameterName=aurora_disable_hash_join,ParameterValue=OFF,ApplyMethod=pending-reboot
```
Si vous effectuez cette étape, spécifiez l’option --db-cluster-parameter-group-name my_cluster_parameter_group dans l’instruction create-db-cluster suivante. Indiquez le nom de votre propre groupe de paramètres. Si vous omettez cette étape, vous devrez créer le groupe de paramètres et l’associer ultérieurement au cluster, comme décrit dans Activation et désactivation des requêtes parallèles dans Aurora MySQL.
Suivez la procédure AWS CLI générale décrite dans Création d’un cluster de bases de données Amazon Aurora.
Spécifiez les options suivantes :
- Pour l’option --engine, utilisez aurora-mysql. Ces valeurs produisent des clusters de requête parallèle compatibles avec MySQL 5.7 ou 8.0.
- Pour l’option --db-cluster-parameter-group-name, spécifiez le nom d’un groupe de paramètres de cluster de bases de données que vous avez créé et spécifiez la valeur du paramètre aurora_parallel_query=ON. Si vous omettez cette option, vous pouvez créer le cluster avec un groupe de paramètres par défaut et le modifier ultérieurement pour utiliser un groupe de paramètres personnalisés de ce type.
- Pour l’option --engine-version, utilisez une version d’Aurora MySQL compatible avec la requête parallèle. Utilisez la procédure décrite dans Optimisation des requêtes parallèles dans Aurora MySQL pour obtenir une liste des versions si nécessaire.
  
  L’exemple de code suivant illustre la marche à suivre. Indiquez votre propre valeur pour chacune des variables d’environnement telles que $CLUSTER_ID. Cet exemple spécifie également l’option --manage-master-user-password permettant de générer le mot de passe de l’utilisateur principal et de le gérer dans Secrets Manager. Pour plus d’informations, consultez Gestion des mots de passe avec Amazon Aurora et AWS Secrets Manager. Vous pouvez également utiliser l’option --master-password pour spécifier et gérer vous-même le mot de passe.
```
aws rds create-db-cluster --db-cluster-identifier $CLUSTER_ID \
  --engine aurora-mysql --engine-version 8.0.mysql_aurora.3.04.1 \
  --master-username $MASTER_USER_ID --manage-master-user-password \
  --db-cluster-parameter-group-name $CUSTOM_CLUSTER_PARAM_GROUP

aws rds create-db-instance --db-instance-identifier ${INSTANCE_ID}-1 \
  --engine same_value_as_in_create_cluster_command \
  --db-cluster-identifier $CLUSTER_ID --db-instance-class $INSTANCE_CLASS
```
Vérifiez que la fonction de requête parallèle est disponible pour le cluster que vous avez créé ou restauré.

Vérifiez que le paramètre de configuration aurora_parallel_query existe. Si ce paramètre a pour valeur 1, la requête parallèle est prête à être utilisée. Si ce paramètre a pour valeur 0, définissez-la sur 1 afin de pouvoir utiliser la requête parallèle. Dans tous les cas, le cluster est capable d’effectuer des requêtes parallèles.
```
mysql> select @@aurora_parallel_query;
+------------------------+
| @@aurora_parallel_query|
+------------------------+
|                      1 |
+------------------------+
```

Pour restaurer un instantané de cluster compatible avec les requêtes parallèles via AWS CLI

Vérifiez quelles sont les versions Aurora MySQL compatibles avec les clusters de requête parallèle. Pour ce faire, utilisez la commande describe-db-engine-versions et vérifiez la valeur du champ SupportsParallelQuery. Pour obtenir un exemple, consultez Vérification de la compatibilité de version Aurora MySQL pour une requête parallèle. Choisissez la version à utiliser pour le cluster restauré.
Recherchez un instantané de cluster compatible avec Aurora MySQL.

Suivez la procédure AWS CLI générale décrite dans Restauration à partir d’un instantané de cluster de bases de données.


aws rds restore-db-cluster-from-snapshot \
  --db-cluster-identifier mynewdbcluster \
  --snapshot-identifier mydbclustersnapshot \
  --engine aurora-mysql

Vérifiez que la fonction de requête parallèle est disponible pour le cluster que vous avez créé ou restauré. Utilisez la même procédure de vérification que dans Création d’un cluster compatible avec les requêtes parallèles à l’aide de l’interface de ligne de commande (CLI).

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Requête parallèle pour Aurora MySQL

Activation et désactivation de la requête parallèle