Contrôler l'utilisation de la capacité

Pour configurer les commandes du DPU à l'aide de la console

1. Ouvrez la console à l'adresse https://console.aws.amazon.com/athena/.

2. Dans le panneau de navigation, choisissez Groupes de travail.

3. Sélectionnez un groupe de travail qui utilise une réservation de capacité.

4. Dans l'onglet Contrôles d'exécution, choisissez Modifier les contrôles.

5. Configurez ce qui suit :

   • Pour Min. DPU par requête, entrez une valeur comprise entre 4 et 124 par incréments de 4.

   • Pour le DPU maximal par requête, entrez une valeur comprise entre 4 et 124 par incréments de 4.

6. Choisissez Enregistrer.

7. (Facultatif) Sélectionnez Remplacer les paramètres côté client pour appliquer ces paramètres et ignorer les configurations DPU au niveau des requêtes.

Pour configurer les commandes du DPU à l'aide du AWS CLI

• Utilisez la update-work-group commande pour définir les contrôles DPU pour un groupe de travail :

  aws athena update-work-group \
    --work-group my_workgroup \
    --configuration-updates '{
          "EngineConfiguration": {
              "Classifications": [
                  {
                      "Name": "athena-query-engine-properties",
                      "Properties": {
                          "max-dpu-count" : "24",
                          "min-dpu-count" : "12"
                          }
                      }
                  ]
          }}'

  Si vous définissez cette optiontrue, EnforceWorkGroupConfiguration les paramètres du groupe de travail remplacent tous les contrôles DPU spécifiés au niveau de la requête lors de leur envoi via. StartQueryExecution Cela garantit une allocation cohérente des ressources pour toutes les requêtes du groupe de travail.

Pour définir les contrôles DPU pour une requête à l'aide de la console

1. Ouvrez la console à l'adresse https://console.aws.amazon.com/athena/.

2. Dans le panneau de navigation, choisissez Query Editor (Éditeur de requête).

3. Sélectionnez un groupe de travail qui utilise une réservation de capacité.

4. Choisissez l'onglet Paramètres de requête.

5. Dans la section Contrôles d'exécution, choisissez Modifier les contrôles.

6. Configurez ce qui suit :

   • Pour Min. DPU par requête, entrez une valeur comprise entre 4 et 124 par incréments de 4.

   • Pour le DPU maximal par requête, entrez une valeur comprise entre 4 et 124 par incréments de 4.

7. Choisissez Enregistrer.

Pour définir les contrôles DPU pour une requête à l'aide du AWS CLI

• Utilisez la start-query-execution commande avec le engine-configuration paramètre :

  aws athena start-query-execution \
    --query-string "SELECT * FROM my_table LIMIT 10" \
    --work-group "my_workgroup" \
    --engine-configuration '{
      "Classifications": [ {
          "Name": "athena-query-engine-properties",
              "Properties": {
                  "max-dpu-count" : "32",
                  "min-dpu-count" : "8"
                  }
              }
          ]}'

Pour afficher la consommation de DPU dans la console

1. Ouvrez la console à l'adresse https://console.aws.amazon.com/athena/.

2. Dans le panneau de navigation, choisissez Query Editor (Éditeur de requête).

3. Une fois la requête terminée, consultez sa valeur de DPU consommée dans le conteneur des résultats de la requête.

4. Pour consulter la consommation de DPU pour les requêtes précédentes, procédez comme suit :

   1. Choisissez Requêtes récentes dans le volet de navigation.

   2. Sélectionnez l'icône des paramètres pour ajouter la colonne DPU consommée au tableau si elle n'est pas déjà affichée.

   3. Vérifiez la consommation de DPU pour chaque requête terminée.

5. Dans l'éditeur de requêtes, choisissez éventuellement l'onglet Statistiques de requête et passez en revue le DPU consommé.

Pour récupérer la consommation de DPU à l'aide de l'API

1. Utilisez les opérations d'API suivantes pour récupérer la consommation de DPU par programmation :

   • GetQueryExecution- Renvoie les détails d'exécution d'une requête spécifique

   • BatchGetQueryExecution- Renvoie les détails d'exécution pour plusieurs requêtes

2. Exemple d’utilisation de AWS CLI :

   aws athena get-query-execution \
     --query-execution-id "123e4567-e89b-12d3-a456-426614174000"

   La réponse inclut le DpuCount champ dans l'Statisticsobjet :

   {
     "QueryExecution": {
       "Statistics": {
         "DpuCount": 8
       }
     }
   }

Pour surveiller l'utilisation du DPU avec CloudWatch

• Athena publie des métriques liées aux requêtes CloudWatch qui vous aident à surveiller l'utilisation des capacités et d'autres données de performance. Pour en savoir plus, veuillez consulter la section Surveillez les métriques des requêtes Athena avec CloudWatch.