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. # Gestion de la capacité de traitement des requêtes Vous pouvez utiliser les réservations de capacité pour obtenir une capacité de traitement sans serveur dédiée aux requêtes que vous exécutez dans Athena. Avec les réservations de capacité, vous pouvez tirer parti des fonctionnalités de gestion des charges de travail qui vous aident à hiérarchiser, contrôler et dimensionner vos charges de travail les plus importantes. Par exemple, vous pouvez ajouter de la capacité pour contrôler le nombre de requêtes que vous pouvez exécuter simultanément, choisir les charges de travail qui peuvent utiliser cette capacité et partager la capacité entre les charges de travail. La capacité est sans serveur, entièrement gérée par Athena et conservée pour vous aussi longtemps que vous en avez besoin. La configuration est simple et aucune modification de vos requêtes SQL n'est requise. Pour obtenir une capacité de traitement pour vos requêtes, vous créez une réservation de capacité, vous spécifiez le nombre d'unités de traitement des données (DPUs) dont vous avez besoin et vous assignez un ou plusieurs groupes de travail à la réservation. Les groupes de travail jouent un rôle important lorsque vous utilisez les réserves de capacité. Les groupes de travail vous permettent d'organiser les requêtes en groupes logiques ou en cas d'utilisation. Grâce aux réserves de capacité, vous attribuez une capacité de manière sélective aux groupes de travail afin de contrôler le comportement des requêtes pour chaque groupe de travail et la manière dont elles sont facturées. Pour plus d'informations sur les groupes de travail, consultez [Utilisation de groupes de travail pour contrôler l’accès aux requêtes et les coûts](workgroups-manage-queries-control-costs.md). L'attribution de groupes de travail aux réservations de capacité vous permet de donner la priorité à ces requêtes, car elles s'exécutent sur votre capacité réservée et ne sont pas prises en compte dans votre quota de requêtes DDL et DML. Par exemple, vous pouvez allouer de la capacité à un groupe de travail utilisé pour les requêtes d'information financière urgentes afin d'isoler ces requêtes des requêtes moins critiques d'un autre groupe de travail. Cela permet une exécution prévisible des requêtes pour les charges de travail critiques tout en permettant aux autres charges de travail de s'exécuter indépendamment. Vous pouvez utiliser les réserves de capacité et les groupes de travail ensemble pour répondre à différentes exigences. Voici des exemples de scénarios : + **Isolez les requêtes importantes** : pour garantir qu'une charge de travail importante dispose de la capacité dont elle a besoin au moment où vous en avez besoin, créez une réservation de capacité et assignez son groupe de travail à la réservation. Seules les requêtes du groupe de travail désigné utilisent la capacité de traitement de votre réservation. Par exemple, pour garantir l'exécution fiable des requêtes qui prennent en charge une application de production, assignez le groupe de travail de production chargé de ces requêtes à une réservation de capacité. Lorsque vous développez des requêtes, utilisez un groupe de travail distinct qui n'est pas associé à une réservation et déplacez les requêtes vers le groupe de travail de production lorsque vous êtes prêt. + **Partagez la capacité entre des charges de travail similaires : plusieurs charges** de travail peuvent partager la capacité d'une seule réservation. Cela vous permet d'obtenir un coût prévisible pour ces charges de travail et de contrôler leur simultanéité. Par exemple, si vous avez des charges de travail planifiées qui tolèrent les délais de début d'exécution des requêtes, vous pouvez affecter leurs groupes de travail à une seule réservation. Cela libère votre quota de requêtes DDL et DML pour les requêtes interactives exécutées dans le même compte, ce qui garantit que ces requêtes démarrent dans un délai minimal. ## Comprendre DPUs La capacité est mesurée en unités de traitement des données (DPUs). DPUs représentent les ressources de calcul et de mémoire sans serveur utilisées par Athena pour accéder aux données et les traiter en votre nom. Un processeur fournit généralement 4 V CPUs et 16 Go de mémoire. Le nombre de requêtes DPUs que vous détenez influence le nombre de requêtes que vous pouvez exécuter simultanément. Par exemple, une réservation avec 256 DPUs peut prendre en charge environ deux fois plus de requêtes simultanées qu'une réservation avec 128 DPUs. Pour plus d'informations sur l'estimation de vos exigences de capacité, consultez[Détermination des exigences de capacité](capacity-management-requirements.md). Pour de plus amples informations, consultez la rubrique [Tarification Amazon Athena](https://aws.amazon.com/athena/pricing/). ## Considérations et restrictions + Vous pouvez utiliser les réservations de capacité et la facturation par requête, sur la base des données numérisées, en même temps dans le même compte. + Les requêtes exécutées dans le cadre de réservations de capacité ne sont pas prises en compte dans votre quota de requêtes DDL et DML. + Si votre capacité est occupée à répondre à d'autres demandes, les demandes nouvellement soumises sont mises en file d'attente jusqu'à ce que la capacité soit disponible. La durée maximale autorisée dans la file d'attente est de 10 heures. + Un groupe de travail peut être affecté à une seule réservation de capacité à la fois. Vous pouvez affecter un total de 20 groupes de travail à une seule réservation. Lorsque vous attribuez plusieurs groupes de travail à une réservation, la capacité est partagée entre les groupes de travail et allouée aux requêtes en fonction de leur ordre de soumission. L'ordre d'exécution peut varier en raison de la façon dont Athena alloue dynamiquement la capacité aux requêtes. + Athena alloue automatiquement entre 4 et 124 requêtes DML DPUs en fonction de leur complexité. Les requêtes DDL en consomment 4 DPUs chacune. Consultez les rubriques suivantes pour plus d'informations : + [Détermination des exigences de capacité](capacity-management-requirements.md) + [Contrôler l'utilisation de la capacité](capacity-management-control-capacity-usage.md) + Le nombre minimum DPUs requis pour chaque réservation de capacité est de 4. Pour de plus amples informations, consultez la rubrique [Tarification Amazon Athena](https://aws.amazon.com/athena/pricing/). + Vous pouvez créer jusqu'à 100 réservations de capacité avec un total de 1 000 DPUs par compte et par région. Si vous en avez besoin de plus de 1 000 DPUs pour votre cas d'utilisation, veuillez contacter [athena-feedback@amazon.com](mailto:athena-feedback@amazon.com?subject=Athena Provisioned Capacity DPU Limit Request). + Les demandes de capacité ne sont pas garanties et peuvent prendre jusqu'à 30 minutes. La capacité n'est pas transférable à une autre réservation de capacité Compte AWS, ou Région AWS. + La `DPUConsumed` CloudWatch métrique est par groupe de travail plutôt que par réservation. Si vous déplacez un groupe de travail d'une réserve à une autre, la métrique `DPUConsumed` inclut les données de la période pendant laquelle le groupe de travail appartenait à la première réserve. Pour plus d'informations sur l'utilisation CloudWatch des métriques dans Athena, consultez. [Surveillez les métriques des requêtes Athena avec CloudWatch](query-metrics-viewing.md) + Pour supprimer un groupe de travail attribué à une réserve, supprimez d'abord le groupe de travail de la réserve. + Les groupes de travail configurés pour utiliser Apache Spark ne sont pas pris en charge. + Les réservations de capacité ne sont pas disponibles pour les publicités suivantes Régions AWS : + Israël (Tel Aviv) + Moyen-Orient (EAU) + Middle East (Bahrain) + Asie-Pacifique (Nouvelle Zélande) **Topics** + [Comprendre DPUs](#capacity-management-understanding-dpus) + [Considérations et restrictions](#capacity-management-considerations-limitations) + [Détermination des exigences de capacité](capacity-management-requirements.md) + [Création de réserves de capacité](capacity-management-creating-capacity-reservations.md) + [Contrôler l'utilisation de la capacité](capacity-management-control-capacity-usage.md) + [Régler automatiquement la capacité](capacity-management-automatically-adjust-capacity.md) + [Gestion des réserves](capacity-management-managing-reservations.md) + [Politiques IAM pour les réserves de capacité](capacity-reservations-iam-policy.md) + [Réservation de capacité à Athena APIs](capacity-management-api-list.md) # Détermination des exigences de capacité Avant de créer une réservation de capacité, vous pouvez estimer la capacité requise afin de pouvoir lui attribuer le nombre correct de DPUs. Ensuite, une fois qu'une réserve est en cours d'utilisation, vous souhaiterez peut-être vérifier si sa capacité est insuffisante ou excédentaire. Cette rubrique décrit les techniques que vous pouvez utiliser pour réaliser ces estimations et décrit également certains AWS outils permettant d'évaluer l'utilisation et les coûts. **Topics** + [Estimation de la capacité requise](#capacity-management-requirements-estimating) + [Signes indiquant qu'une capacité accrue est requise](#capacity-management-requirements-insufficient-capacity) + [Vérification de la capacité inactive](#capacity-management-requirements-idle-capacity) + [Surveillance de la consommation du DPU](#capacity-management-requirements-monitoring-dpu-consumption) ## Estimation de la capacité requise Lors de l'estimation des exigences de capacité, il est utile de prendre en compte deux points de vue : la capacité dont une requête particulière peut avoir besoin et la capacité dont vous pourriez avoir besoin en général. ### Estimation des exigences de capacité par requête Pour déterminer le nombre DPUs requis par une requête, vous pouvez suivre les instructions suivantes : + Les requêtes DDL consomment 4 DPUs. + Les requêtes DML consomment entre 4 et 124 DPUs. Athena détermine le nombre de caractères DPUs requis par une requête DML lorsque celle-ci est soumise. Le nombre varie en fonction de la taille des données, du format de stockage, de la construction de la requête et d'autres facteurs. En général, Athena essaie de sélectionner le nombre de DPU le plus bas et le plus efficace. Si Athena détermine qu'une puissance de calcul plus importante est nécessaire pour que la requête soit menée à bien, elle augmente le nombre de données DPUs attribuées à la requête. ### Estimation des exigences de capacité spécifiques à la charge de travail Pour déterminer la capacité dont vous pourriez avoir besoin pour exécuter plusieurs requêtes en même temps, prenez en compte les directives générales du tableau suivant : **** | Requêtes simultanées | DPUs requis | | --- | --- | | 10 | 40 ou plus | | 20 | 96 ou plus | | 30 ou plus | 240 ou plus | Notez que le nombre réel dont vous avez besoin dépend de vos objectifs et de vos modèles d'analyse. DPUs Par exemple, si vous souhaitez que les requêtes démarrent immédiatement sans mise en file d'attente, déterminez votre demande maximale de requêtes simultanées, puis indiquez le nombre de DPUs requêtes simultanées en conséquence. Vous pouvez fournir une quantité DPUs inférieure à votre demande de pointe, mais des files d'attente peuvent survenir en cas de pic de demande. Lors de la mise en file d'attente, Athena place vos requêtes dans une file d'attente et les exécute lorsque la capacité devient disponible. Si votre objectif est d'exécuter des requêtes dans les limites d'un budget fixe, vous pouvez utiliser le [calculateur de AWS prix](https://calculator.aws/#/addService/Athena) pour déterminer le nombre de requêtes DPUs correspondant à votre budget. Enfin, n'oubliez pas que la taille des données, le format de stockage et la manière dont une requête est écrite DPUs influencent les besoins de celle-ci. Pour améliorer les performances des requêtes, vous pouvez compresser ou partitionner vos données ou les convertir en formats en colonnes. Pour de plus amples informations, veuillez consulter [Optimisation des performances d’Athena](performance-tuning.md). ## Signes indiquant qu'une capacité accrue est requise Les messages d'erreur relatifs à une capacité insuffisante et la mise en file d'attente des requêtes indiquent que la capacité qui vous est attribuée est inadéquate. Si vos requêtes échouent avec un message d'erreur indiquant une capacité insuffisante, c'est que le nombre de DPU de votre réserve de capacité est trop faible pour votre requête. Par exemple, si vous avez une réservation avec 24 DPUs et que vous exécutez une requête nécessitant plus de 24 DPUs, la requête échouera. Pour détecter cette erreur de requête, vous pouvez utiliser les [EventBridge événements](athena-events.md) d'Athéna. Essayez d'en ajouter d'autres DPUs et de réexécuter votre requête. Si de nombreuses requêtes sont mises en file d'attente, cela signifie que votre capacité est pleinement utilisée par d'autres requêtes. Pour réduire la mise en file d'attente, effectuez l'une des actions suivantes : + Ajoutez DPUs à votre réservation pour augmenter la simultanéité des requêtes. + Supprimer des groupes de travail de votre réserve afin de libérer de la capacité pour d'autres requêtes. Pour vérifier l'absence de files d'attente excessives, utilisez l'[CloudWatchindicateur](query-metrics-viewing.md) de temps de file d'attente des requêtes Athena pour les groupes de travail inclus dans votre réservation de capacité. Si la valeur est supérieure à votre seuil préféré, vous pouvez l'ajouter DPUs à la réservation de capacité. ## Vérification de la capacité inactive Pour vérifier la capacité inutilisée, vous pouvez soit diminuer le nombre de personnes DPUs dans la réservation, soit augmenter sa charge de travail, puis observer les résultats. **Pour vérifier la capacité inutilisée** 1. Effectuez l’une des actions suivantes : + Réduisez le nombre de DPUs personnes figurant dans votre réservation (réduisez les ressources disponibles) + Ajouter des groupes de travail à votre réserve (augmenter la charge de travail) 1. [CloudWatch](query-metrics-viewing.md)À utiliser pour mesurer le temps d'attente des requêtes. 1. Si le temps de file d'attente augmente au-delà d'un niveau souhaitable, effectuez l'une des actions suivantes : + Supprimer des groupes de travail + Ajoutez DPUs à votre réservation de capacité 1. Après chaque modification, vérifiez les performances et le temps de file d'attente des requêtes. 1. Continuez à ajuster le nombre de and/or DPU de charge de travail pour atteindre l'équilibre souhaité. Si vous ne souhaitez pas maintenir la capacité en dehors d'une période préférée, vous pouvez [annuler](capacity-management-cancelling-a-capacity-reservation.md) la réserve et en créer une autre ultérieurement. Toutefois, même si vous avez récemment annulé la capacité d'une autre réserve, les demandes de nouvelles capacités ne sont pas garanties et la création de nouvelles réserves prend du temps. ## Surveillance de la consommation du DPU Une fois vos requêtes exécutées, vous pouvez consulter le DPU consommé par vos requêtes afin d'affiner vos estimations de capacité. Athena fournit des mesures de consommation du DPU via la console, les opérations de l'API et. CloudWatch Ces informations vous aident à identifier les requêtes qui consomment plus ou moins de ressources que prévu et à optimiser votre allocation de capacité en fonction de données réelles. Pour des informations détaillées sur l'affichage et le suivi de la consommation du DPU, consultez[Surveiller l'utilisation du DPU](capacity-management-control-capacity-usage.md#capacity-management-monitor-dpu-usage). ## Outils d'évaluation des exigences de capacité et des coûts Vous pouvez utiliser les services et fonctionnalités suivants AWS pour mesurer votre utilisation et vos coûts d'Athena. ### CloudWatch métriques Vous pouvez configurer Athena pour publier les métriques liées aux requêtes sur Amazon CloudWatch au niveau du groupe de travail. Une fois que vous avez activé les métriques pour le groupe de travail, les métriques pour les requêtes du groupe de travail s'affichent dans la console Athena sur la page de détails du groupe de travail. Pour plus d'informations sur les métriques Athena publiées sur CloudWatch et leurs dimensions, consultez. [Surveillez les métriques des requêtes Athena avec CloudWatch](query-metrics-viewing.md) ### CloudWatch métriques d'utilisation Vous pouvez utiliser les statistiques CloudWatch d'utilisation pour avoir une idée de la manière dont votre compte utilise les ressources en affichant votre utilisation actuelle des services sur CloudWatch des graphiques et des tableaux de bord. Pour Athena, les mesures de disponibilité d'utilisation correspondent aux [quotas de AWS service](service-limits.md) pour Athena. Vous pouvez configurer des alarmes qui vous alertent lorsque votre utilisation approche d’un quota de service. Pour de plus amples informations, veuillez consulter [Surveillez les statistiques d'utilisation d'Athena avec CloudWatch](monitoring-athena-usage-metrics.md). ### EventBridge Événements Amazon Vous pouvez utiliser Amazon Athena avec Amazon EventBridge pour recevoir des notifications en temps réel concernant l'état de vos requêtes. Lorsqu'une requête que vous avez soumise change d'état, Athena publie un événement EventBridge contenant des informations sur le changement d'état de la requête. Vous pouvez écrire des règles simples pour les événements qui vous intéressent et effectuer des actions automatisées lorsqu'un événement correspond à une règle. Pour plus d'informations, veuillez consulter les ressources suivantes. + [Surveillez les événements de requête Athena avec EventBridge](athena-events.md) + [Qu'est-ce qu'Amazon EventBridge ?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) + [ EventBridgeÉvénements Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) ### Étiquettes Dans Athena, les réserves de capacité prennent en charge les balises. Une balise se compose d'une clé et d'une valeur. Pour suivre vos coûts dans Athena, vous pouvez utiliser des balises de AWS répartition des coûts générées. AWS utilise les balises de répartition des coûts pour organiser les coûts des ressources dans votre [rapport sur les coûts et l'utilisation](https://docs.aws.amazon.com/cur/latest/userguide/what-is-cur.html). Cela vous permet de classer et de suivre plus facilement vos AWS coûts. Pour activer les balises de répartition des coûts pour Athena, vous devez utiliser la [console AWS Billing and Cost Management](https://console.aws.amazon.com/billing/). Pour plus d'informations, veuillez consulter les ressources suivantes. + [Balisage des ressources Athena](tags.md) + [Activation des AWS balises de répartition des coûts générées](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activate-built-in-tags.html) + [Utilisation des balises de répartition des coûts  AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) # Création de réserves de capacité Pour commencer, vous créez une réservation de DPUs capacité dont vous avez besoin, puis vous assignez un ou plusieurs groupes de travail qui utiliseront cette capacité pour leurs requêtes. Vous pouvez ajuster votre capacité ultérieurement si nécessaire pour fournir des performances plus constantes ou mieux gérer les coûts. Pour plus d'informations sur l'estimation de vos exigences de capacité, consultez[Détermination des exigences de capacité](capacity-management-requirements.md). **Important** Les demandes de capacité ne sont pas garanties et peuvent prendre jusqu'à 30 minutes. **Pour créer une réserve de capacité** 1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche. 1. Choisissez **Administration**, **Réserves de capacité**. 1. Choisissez **Créer une réserve de capacité**. 1. Sur la page **Créer une réserve de capacité**, saisissez le nom dans le champ **Nom de la réserve de capacité**. Le nom doit être unique, compter de 1 à 128 caractères, et utiliser uniquement les caractères a-z, A-Z, 0-9, \$1 (trait de soulignement), . (point) et - (trait d'union). Vous ne pouvez pas modifier le nom une fois la réserve créée. 1. Pour le **DPU**, choisissez ou entrez le nombre d'unités de traitement de données (DPUs) que vous souhaitez par incréments de 4. Pour de plus amples informations, veuillez consulter [Comprendre DPUs](capacity-management.md#capacity-management-understanding-dpus). 1. (Facultatif) Développez l'option **Balises**, puis choisissez **Ajouter une nouvelle balise** pour ajouter une ou plusieurs key/value paires personnalisées à associer à la ressource de réservation de capacité. Pour de plus amples informations, veuillez consulter [Balisage des ressources Athena](tags.md). 1. Choisissez **Examiner**. 1. À l'invite **Confirmer la réservation de capacité**, confirmez le nombre de DPUs Région AWS, et les autres informations. Si vous acceptez, choisissez **Soumettre**. Sur la page de détails, l'**état** de votre réserve de capacité indique **En attente**. Lorsque votre réserve de capacité est disponible pour exécuter des requêtes, son état s'affiche comme **Actif**. À ce stade, vous êtes prêt à ajouter un ou plusieurs groupes de travail à votre réserve. Pour les étapes, consultez [Ajout de groupes de travail à une réserve](capacity-management-adding-workgroups-to-a-reservation.md). # Contrôler l'utilisation de la capacité Vous pouvez contrôler le nombre de DPU qu'Athena alloue à vos requêtes en définissant des contrôles DPU maximum ou minimum. Vous pouvez les configurer au niveau du groupe de travail pour établir des contrôles de base pour toutes les requêtes, ou au niveau des requêtes individuelles pour un contrôle précis. Cela vous permet de contrôler directement les performances des requêtes, la simultanéité de la charge de travail et les coûts. + Lorsque vous définissez un nombre maximal de DPU, les requêtes ne peuvent pas consommer plus de capacité que ce que vous spécifiez. Cela facilite le contrôle des coûts et de la simultanéité de la charge de travail. Par exemple, si votre réservation de capacité comporte 200 DPU, le fait de définir le maximum de DPU par requête sur 8 vous permet d'exécuter 25 requêtes simultanément. Si vous augmentez votre réservation à 400 DPU, vous pouvez exécuter 50 requêtes simultanément. + Lorsque vous définissez un nombre minimum de DPU, vous vous assurez que les requêtes sont exécutées avec le nombre minimum de DPU souhaité. Cela est utile lorsque vous connaissez à l'avance le profil d'utilisation de la capacité typique pour vos requêtes. **Note** Les contrôles d'utilisation du DPU ne s'appliquent qu'aux requêtes exécutées avec des réservations de capacité. **Note** Pour utiliser le même nombre de DPU pour toutes les requêtes, utilisez la même valeur pour le DPU minimum et maximum. ## Définissez les commandes du DPU au niveau du groupe de travail Définissez les contrôles DPU au niveau du groupe de travail afin de gérer les coûts et de contrôler les performances de la charge de travail pour le groupe de travail de votre choix. Les contrôles DPU définis au niveau du groupe de travail s'appliquent à toutes les requêtes lorsque l'option Ignorer les **paramètres côté client** est activée. **Pour configurer les commandes du DPU à l'aide de la console** 1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. Dans le panneau de navigation, choisissez **Groupes de travail**. 1. Sélectionnez un groupe de travail qui utilise une réservation de capacité. 1. Dans l'onglet **Contrôles d'exécution**, choisissez **Modifier les contrôles**. 1. 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. 1. Choisissez **Enregistrer**. 1. (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 option`true`, `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](https://docs.aws.amazon.com/athena/latest/APIReference/API_StartQueryExecution.html) Cela garantit une allocation cohérente des ressources pour toutes les requêtes du groupe de travail. ## Définissez les contrôles du DPU avec des requêtes individuelles Définissez des contrôles DPU au niveau des requêtes lorsque vous avez besoin d'un contrôle précis avec des requêtes ayant des besoins en ressources différents. **Les contrôles DPU au niveau de la requête ont priorité sur les paramètres au niveau du groupe de travail, sauf si le groupe de travail a activé l'option Remplacer les paramètres côté client.** **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/](https://console.aws.amazon.com/athena/home). 1. Dans le panneau de navigation, choisissez **Query Editor (Éditeur de requête)**. 1. Sélectionnez un groupe de travail qui utilise une réservation de capacité. 1. Choisissez l'onglet **Paramètres de requête**. 1. Dans la section **Contrôles d'exécution**, choisissez **Modifier les contrôles**. 1. 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. 1. 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" } } ]}' ``` La relation entre les paramètres DPU au niveau de la requête et au niveau du groupe de travail dépend de la configuration de votre groupe de travail : + Lorsque l'option **Ignorer les paramètres côté client** est activée, les contrôles DPU au niveau du groupe de travail ont priorité sur les paramètres au niveau des requêtes. Cela garantit une utilisation cohérente des ressources pour toutes les requêtes du groupe de travail spécifié. + Lorsque le **remplacement des paramètres côté client** n'est pas activé, les contrôles DPU au niveau des requêtes ont priorité sur les paramètres au niveau du groupe de travail. Cela permet une certaine flexibilité pour optimiser les requêtes individuelles. Si vous ne spécifiez aucun contrôle DPU à aucun niveau, Athena alloue automatiquement la capacité en fonction de la complexité des requêtes. **Note** Pour les requêtes DDL, la valeur maximale du minimum DPUs est de 4. La définition d'un minimum plus élevé pour les requêtes DDL entraîne une erreur. ## Surveiller l'utilisation du DPU Une fois vos requêtes terminées, vous pouvez consulter son utilisation du DPU. Athena fournit des métriques d'utilisation du DPU via la console, les opérations d'API et. CloudWatch **Pour afficher la consommation de DPU dans la console** 1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. Dans le panneau de navigation, choisissez **Query Editor (Éditeur de requête)**. 1. Une fois la requête terminée, consultez sa valeur de **DPU consommée** dans le conteneur des résultats de la requête. 1. 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. 1. 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. 1. Vérifiez la consommation de DPU pour chaque requête terminée. 1. 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 1. 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'`Statistics`objet : ``` { "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](query-metrics-viewing.md). # Régler automatiquement la capacité Vous pouvez ajuster automatiquement la capacité de votre réservation en fonction de l'utilisation de la charge de travail à l'aide de la solution d'auto-scaling d'Athena. Il augmente automatiquement la capacité lorsque l'utilisation dépasse le seuil configuré et supprime de la capacité pendant les périodes de faible utilisation afin de réduire les coûts. Vous pouvez personnaliser son comportement en définissant différents seuils d'utilisation, des quantités minimales et maximales de DPU, des incréments de dimensionnement et une fréquence d'évaluation de l'utilisation. Cela élimine les ajustements manuels de capacité tout en vous aidant à trouver un équilibre entre les exigences de performance et l'optimisation des coûts. Vous déployez cette solution sans serveur à l'aide d'un CloudFormation modèle. Il crée une machine d'état Step Functions qui surveille les indicateurs d'utilisation et prend des décisions de dimensionnement. Vous pouvez personnaliser davantage le modèle ou la machine à états pour répondre à vos besoins spécifiques. Pour commencer, utilisez la console Athena et choisissez **Configurer l'auto-scaling** sur la page détaillée de votre réservation de capacité, qui vous redirige vers le modèle préchargé. CloudFormation Vous pouvez également suivre la procédure ci-dessous. ## Conditions préalables + Une réservation de capacité active est requise + Autorisations IAM requises pour déployer des CloudFormation stacks et créer des ressources Step Functions ## Lancez la CloudFormation pile Ce CloudFormation modèle automatisé déploie la solution d'auto-scaling Athena Capacity Reservation. Vous devez suivre les étapes applicables [Conditions préalables](#capacity-management-auto-scaling-prerequisites) avant de lancer la pile. [https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?&templateURL=https:%2F%2Fathena-downloads.s3.us-east-1.amazonaws.com%2F%2Ftemplates%2F%2Fcapacity-reservation-scaling%2F%2Fstate-machine%2F%2Fathena-capacity-reservation-scaling-template-v1.1.yaml](https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?&templateURL=https:%2F%2Fathena-downloads.s3.us-east-1.amazonaws.com%2F%2Ftemplates%2F%2Fcapacity-reservation-scaling%2F%2Fstate-machine%2F%2Fathena-capacity-reservation-scaling-template-v1.1.yaml) **Pour lancer la solution d'auto-scaling** 1. Connectez-vous à [AWS la console de gestion](https://console.aws.amazon.com/) et sélectionnez le bouton pour lancer le `AWSAccelerator-InstallerStack` CloudFormation modèle. 1. Le modèle est lancé par défaut dans l'est des États-Unis (Virginie du Nord). Pour lancer la solution sous une autre forme Région AWS, utilisez le sélecteur de région dans la barre de navigation de la console. 1. Sur la page **Create stack**, vérifiez que l'URL du modèle se trouve dans la **zone de texte URL Amazon S3** et choisissez **Next**. 1. Sur la page **Spécifier les détails de la pile**, attribuez un nom à votre pile de solutions. 1. Sous **Paramètres**, passez en revue les paramètres de ce modèle de solution et modifiez-les si nécessaire. Cette solution utilise les valeurs par défaut suivantes. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/athena/latest/ug/capacity-management-automatically-adjust-capacity.html) **Note** Toutes les valeurs DPU doivent être des multiples de 4 pour être conformes aux exigences de réservation de capacité d'Athena. 1. Choisissez **Next** (Suivant). 1. Sur la page **Configurer les options de pile**, choisissez **Suivant**. 1. Sur la page **Réviser et créer**, vérifiez et confirmez les paramètres. Cochez la case indiquant que le modèle est susceptible de créer des ressources IAM. 1. Choisissez **Submit** pour déployer la pile. Vous pouvez consulter l'état de la pile dans la CloudFormation console dans la colonne **État**. Vous devriez recevoir un `CREATE_COMPLETE` statut dans quelques minutes. # Gestion des réserves Vous pouvez consulter et gérer vos réserves de capacité sur la page **Réserves de capacité**. Vous pouvez effectuer des tâches de gestion telles que l'ajout ou la réduction DPUs, la modification des attributions des groupes de travail et le balisage ou l'annulation de réservations. **Pour consulter et gérer des réserves de capacité** 1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche. 1. Choisissez **Administration**, **Réserves de capacité**. 1. Vous pouvez effectuer les tâches suivantes sur la page des réserves de capacité : + Pour créer une réserve de capacité, sélectionnez **Créer une réserve de capacité**. + Utilisez le champ de recherche pour filtrer les réservations par nom ou par numéro de DPUs. + Choisissez le menu déroulant d'état pour filtrer par état de réserve de capacité (par exemple, **Actif** ou **Annulé**). Pour de plus amples informations sur l'état des réserves, consultez [Présentation de l’état des réserves](#capacity-management-understanding-reservation-status). + Pour consulter les détails d'une réserve de capacité, cliquez sur le lien correspondant à la réserve. La page de détails de la réserve inclut des options relatives à la [modification de la capacité](capacity-management-editing-capacity-reservations.md), à l’[ajout de groupes de travail](capacity-management-adding-workgroups-to-a-reservation.md), à la [suppression de groupes de travail](capacity-management-removing-a-workgroup-from-a-reservation.md) et à l’[annulation](capacity-management-cancelling-a-capacity-reservation.md) de la réserve. + Pour modifier une réservation (par exemple, en ajoutant ou en supprimant DPUs), sélectionnez le bouton correspondant à la réservation, puis choisissez **Modifier**. + Pour annuler une réserve, sélectionnez le bouton correspondant à la réserve, puis cliquez sur **Annuler**. ## Présentation de l’état des réserves Le tableau suivant décrit les valeurs d'état possibles pour une réserve de capacité. **** | État | Description | | --- | --- | | En suspens | Athena est en train de traiter votre demande de capacité. La capacité n'est pas prête à exécuter des requêtes. | | Actif | La capacité est disponible pour exécuter des requêtes. | | Échec | Votre demande de capacité n'a pas été traitée avec succès. Notez que le traitement des demandes de capacité n'est pas garanti. Les réserves qui ont échoué sont prises en compte dans le calcul des limites de DPU de votre compte. Pour libérer l'utilisation, vous devez annuler la réserve. | | Mise à jour en attente | Athena est en train de modifier la réserve. Par exemple, ce statut apparaît une fois que vous avez modifié la réservation pour l'ajouter ou la supprimer DPUs. | | Annulation | Athena est en train de traiter une demande d'annulation de réserve. Les requêtes toujours en cours d'exécution dans les groupes de travail qui utilisaient la réserve sont autorisées à se terminer, mais les autres requêtes du groupe de travail utiliseront la capacité à la demande (non allouée). | | Annulée | L'annulation de la réserve de capacité est terminée. Les réserves annulées restent dans la console pendant 45 jours. Après 45 jours, Athena annulera la réserve. Pendant les 45 jours, vous ne pouvez pas réaffecter ou réutiliser la réserve, mais vous pouvez vous référer à ses balises et consulter ses détails pour une référence historique. Il n'est pas garanti que la capacité annulée puisse être réservée à nouveau à une date future. La capacité ne peut pas être transférée à une autre réservation, Compte AWS ou Région AWS. | ## Comprendre Active DPUs et Target DPUs Dans la liste des réserves de capacité de la console Athena, votre réserve affiche deux valeurs DPU : **DPU active** et **DPU cible**. + **DPU actif** : le nombre de DPUs DPU disponibles dans votre réservation pour exécuter des requêtes. Par exemple, si vous demandez 100 DPUs et que votre demande est satisfaite, **Active DPU** affiche **100**. + **DPU cible** : numéro vers DPUs lequel votre réservation est en train d'être transférée. **Le DPU cible** affiche une valeur différente de celle du **DPU actif** lorsqu'une réservation est créée ou lorsqu'une augmentation ou une diminution du nombre de réservations DPUs est en attente. **Par exemple, après avoir soumis une demande pour créer une réservation avec 24 DPUs, le **statut** de la réservation sera **En attente**, le **DPU actif** sera **0** et le **DPU cible** sera 24.** **Si vous avez une réservation de 100 DPUs et que vous modifiez votre réservation pour demander une augmentation de 20 DPUs, le **statut** sera **En attente de mise à jour**, le **DPU actif** sera de **100** et le **DPU cible** de 120.** **Si vous avez une réservation de 100 DPUs et que vous modifiez votre réservation pour demander une réduction de 20 DPUs, le **statut** sera **En attente de mise à jour**, le **DPU actif** sera de **100** et le **DPU cible** de 80.** Au cours de ces transitions, Athena travaille activement à acquérir ou à réduire le nombre de en DPUs fonction de votre demande. Lorsque **DPU active** devient égal à **DPU cible**, le nombre cible est atteint et aucune modification n'est en attente. Pour récupérer ces valeurs par programmation, vous pouvez appeler l'action [GetCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetCapacityReservation.html)API. L'API fait référence à **DPU active** et **DPU cible** sous `AllocatedDpus` et `TargetDpus`. **Topics** + [Présentation de l’état des réserves](#capacity-management-understanding-reservation-status) + [Comprendre Active DPUs et Target DPUs](#capacity-management-understanding-dpu-status) + [Modification des réserves de capacité](capacity-management-editing-capacity-reservations.md) + [Ajout de groupes de travail à une réserve](capacity-management-adding-workgroups-to-a-reservation.md) + [Suppression d’un groupe de travail d’une réserve](capacity-management-removing-a-workgroup-from-a-reservation.md) + [Annulation d’une réserve de capacité](capacity-management-cancelling-a-capacity-reservation.md) + [Suppression d’une réserve de capacité](capacity-management-deleting-a-capacity-reservation.md) # Modification des réserves de capacité Après avoir créé une réservation de capacité, vous pouvez ajuster son nombre DPUs et ajouter ou supprimer ses balises personnalisées. **Pour modifier une réserve de capacité** 1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche. 1. Choisissez **Administration**, **Réserves de capacité**. 1. Dans la liste des réserves de capacité, effectuez l'une des opérations suivantes : + Sélectionner le bouton en regard de la réserve, puis choisir **Modifier**. + Choisir le lien de la réserve, puis choisir **Modifier**. 1. Pour **DPU**, choisissez ou entrez le nombre d'unités de traitement de données que vous souhaitez. Pour de plus amples informations, veuillez consulter [Comprendre DPUs](capacity-management.md#capacity-management-understanding-dpus). **Note** Vous pouvez demander à ajouter DPUs à une réservation de capacité active à tout moment. Vous pouvez demander la réduction d'une réservation DPUs de capacité active lorsqu'une minute s'est écoulée depuis que la réservation est devenue active ou quand elle a DPUs été ajoutée pour la dernière fois. Lorsque vous demandez une réduction DPUs, Athena donne la priorité à la suppression des périodes d'inactivité par rapport à celles d'activité. DPUs DPUs Si les requêtes marquées pour suppression sont gourmandes, Athena attend DPUs qu'elles soient terminées avant de supprimer le. DPUs 1. (Facultatif) Dans **Balises**, choisissez **Supprimer la balise** pour supprimer une balise ou **Ajouter une balise** pour ajouter une nouvelle balise. 1. Sélectionnez **Soumettre**. La page de détails de la réserve affiche la configuration mise à jour. # Ajout de groupes de travail à une réserve Après avoir créé une réserve de capacité, vous pouvez ajouter jusqu'à 20 groupes de travail à la réserve. L'ajout d'un groupe de travail à une réserve indique à Athena quelles requêtes doivent être exécutées sur la capacité réservée. Les requêtes provenant de groupes de travail qui ne sont pas associées à une réserve continuent d'être exécutées selon le modèle de tarification par téraoctet (To) analysé par défaut. Lorsqu'une réserve comporte deux groupes de travail ou plus, les requêtes provenant de ces groupes de travail peuvent utiliser la capacité de la réserve. Vous pouvez ajouter et supprimer des groupes de travail à tout moment. Lorsque vous ajoutez ou supprimez des groupes de travail, les requêtes en cours d'exécution ne sont pas interrompues. Lorsque votre réserve est en attente, les requêtes provenant des groupes de travail que vous avez ajoutés continuent de s'exécuter en utilisant le modèle de tarification par téraoctet (To) analysé par défaut jusqu'à ce que la réserve soit active. **Pour ajouter un ou plusieurs groupes de travail à votre réserve de capacité** 1. Sur la page de détails de la réserve de capacité, choisissez **Ajouter des groupes de travail**. 1. Sur la page **Ajouter des groupes de travail**, sélectionnez les groupes de travail que vous souhaitez ajouter, puis choisissez **Ajouter des groupes de travail**. Vous pouvez attribuer un groupe de travail à plusieurs réserves. La page de détails de votre réserve de capacité répertorie les groupes de travail que vous avez ajoutés. Les requêtes exécutées dans ces groupes de travail utiliseront la capacité que vous avez réservée lorsque la réserve est active. # Suppression d’un groupe de travail d’une réserve Si vous n'avez plus besoin de capacité dédiée pour un groupe de travail ou si vous souhaitez déplacer un groupe de travail vers sa propre réserve, vous pouvez le supprimer à tout moment. La suppression d'un groupe de travail d'une réserve est un processus simple. Une fois que vous avez retiré un groupe de travail d'une réservation, les requêtes du groupe de travail supprimé utilisent à nouveau la capacité à la demande et sont facturées sur la base des téraoctets (To) analysés. **Pour supprimer un ou plusieurs groupes de travail d'une réserve** 1. Sur la page de détails de la réserve de capacité, sélectionnez les groupes de travail que vous souhaitez supprimer. 1. Choisissez **Supprimer les groupes de travail**. L'invite **Supprimer les groupes de travail ?** vous informe que toutes les requêtes actuellement actives seront terminées avant que le groupe de travail ne soit supprimé de la réserve. 1. Cliquez sur **Supprimer**. La page de détails de votre réserve de capacité indique que les groupes de travail supprimés ne sont plus présents. # Annulation d’une réserve de capacité Si vous ne souhaitez plus utiliser la réserve de capacité, vous pouvez l'annuler. Les requêtes toujours en cours d'exécution dans les groupes de travail qui utilisaient la réserve seront autorisées à se terminer, mais les autres requêtes du groupe de travail n'utiliseront plus la réserve. **Note** Il n'est pas garanti que la capacité annulée puisse être réservée à nouveau à une date future. La capacité ne peut pas être transférée à une autre réservation, Compte AWS ou Région AWS. **Pour annuler une réserve de capacité** 1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche. 1. Choisissez **Administration**, **Réserves de capacité**. 1. Dans la liste des réserves de capacité, effectuez l'une des opérations suivantes : + Sélectionner le bouton en regard de la réserve, puis choisir **Annuler**. + Choisir le lien de réserve, puis choisir **Annuler la réserve de capacité**. 1. À l'invite **Annuler la réserve de capacité ?**, saisissez **Annuler**, puis choisissez **Annuler la réserve de capacité**. L'état de la réserve passe à **Annulation**, et une bannière de progression vous informe que l'annulation est en cours. Lorsque l'annulation est terminée, la réserve de capacité est maintenue, mais son état est **Annulé**. La réserve sera supprimée 45 jours après l'annulation. Pendant les 45 jours, vous ne pouvez pas réaffecter ou réutiliser la réserve annulée, mais vous pouvez vous référer à ses balises et consulter ses détails pour une référence historique. # Suppression d’une réserve de capacité Si vous souhaitez supprimer toutes les références à une réserve de capacité annulée, vous pouvez supprimer la réserve. La réserve doit être annulée avant de pouvoir être supprimée. Une réserve supprimée est immédiatement supprimée de votre compte et ne peut plus être référencée, y compris par son ARN. **Pour supprimer une réserve de capacité** 1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche. 1. Choisissez **Administration**, **Réserves de capacité**. 1. Dans la liste des réserves de capacité, effectuez l'une des opérations suivantes : + Sélectionner le bouton en regard de la réserve annulée, puis choisir **Actions**, **Supprimer**. + Choisir le lien de la réserve, puis choisir **Supprimer**. 1. À l'invite **Supprimer la réserve de capacité ?**, choisissez **Supprimer**. Une bannière vous informe que la réserve de capacité a été supprimée avec succès. La réserve supprimée n'apparaît plus dans la liste des réserves de capacité. # Politiques IAM pour les réserves de capacité Pour contrôler l'accès aux réserves de capacité, utilisez des autorisations IAM au niveau des ressources ou des politiques IAM basées sur l'identité. Chaque fois que vous utilisez des politiques IAM, veillez à respecter les bonnes pratiques IAM. Pour plus d'informations, consultez la rubrique [Bonnes pratiques IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) du *Guide de l'utilisateur IAM*. La procédure suivante est spécifique à Athena. Pour des informations spécifiques à IAM, consultez les liens répertoriés à la fin de cette section. Pour de plus amples informations sur les politiques de réserve de capacité JSON, consultez [Exemples de politiques de réserve de capacité](example-policies-capacity-reservations.md). **Utilisation de l'éditeur visuel dans la console IAM pour créer une politique de réserve de capacité** 1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse. 1. Dans le panneau de navigation à gauche, choisissez **politiques**, puis **Créer une politique**. 1. Dans l'onglet **Visual editor** (Éditeur visuel), sélectionnez **Choose a service** (Choisir un service). Choisissez ensuite Athena pour l'ajouter à la politique. 1. Choisissez **Sélectionner des actions**, puis choisissez les actions à ajouter à la politique. L'éditeur visuel affiche les actions disponibles dans Athena. Pour plus d'informations, consultez la rubrique [Actions, ressources et clés de condition pour Amazon Athena](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonathena.html) dans la section *Référence de l'autorisation de service*. 1. Choisissez **Ajouter des actions** pour entrer une action spécifique ou utilisez des caractères génériques (\$1) pour spécifier plusieurs actions. Par défaut, la politique que vous créez autorise les actions que vous choisissez. Si vous avez choisi une ou plusieurs actions qui prennent en charge les autorisations au niveau des ressources pour la ressource `capacity-reservation` dans Athena, l'éditeur visuel affiche la ressource `capacity-reservation`. 1. Choisissez **Ressources** pour spécifier les réserves de capacité spécifiques de votre politique. Pour un exemple de politiques de réserve de capacité JSON, consultez [Exemples de politiques de réserve de capacité](example-policies-capacity-reservations.md). 1. Spécifiez la ressource du `capacity-reservation` comme suit : ``` arn:aws:athena:::capacity-reservation/ ``` 1. Choisissez **Review policy** (Examiner une politique), puis saisissez un **Name** (Nom) et une **Description** (facultatif) pour la politique que vous êtes en train de créer. Passez en revue le résumé de politique afin de vous assurer que les autorisations nécessaires vous ont été accordées. 1. Choisissez **Create policy** (Créer une politique) pour enregistrer votre nouvelle politique. 1. Attachez cette politique basée sur l'identité à un utilisateur, un groupe ou un rôle. Pour plus d'informations, consultez les rubriques suivantes dans la *Référence de l'autorisation de service* et le *Guide de l'utilisateur IAM* : + [Actions, ressources et clés de condition pour Amazon Athena](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonathena.html) + [Création de politiques avec l'éditeur visuel](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-visual-editor) + [Ajout et suppression de politiques IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) + [Contrôle de l'accès aux ressources](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_controlling.html#access_controlling-resources) Pour un exemple de politiques de réserve de capacité JSON, consultez [Exemples de politiques de réserve de capacité](example-policies-capacity-reservations.md). Pour obtenir une liste complète d'actions Amazon Athena, consultez les noms d'action d'API dans la [Référence d'API Amazon Athena](https://docs.aws.amazon.com/athena/latest/APIReference/). # Exemples de politiques de réserve de capacité Cette section inclut des exemples de politiques que vous pouvez utiliser pour activer plusieurs actions sur des réserves de capacité. Chaque fois que vous utilisez des politiques IAM, veillez à respecter les bonnes pratiques IAM. Pour plus d'informations, consultez la rubrique [Bonnes pratiques IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) du *Guide de l'utilisateur IAM*. Une réserve de capacité est une ressource IAM gérée par Athena. Par conséquent, si votre politique de réserve de capacité utilise des actions prenant `capacity-reservation` en entrée, vous devez spécifier l'ARN de la réserve de capacité comme suit : ``` "Resource": [arn:aws:athena:::capacity-reservation/] ``` Où `` est le nom de votre réserve de capacité. Par exemple, pour une réserve de capacité nommée `test_capacity_reservation`, spécifiez-la en tant que ressource comme suit : ``` "Resource": ["arn:aws:athena:us-east-1:123456789012:capacity-reservation/test_capacity_reservation"] ``` Pour obtenir une liste complète d'actions Amazon Athena, consultez les noms d'action d'API dans la [Référence d'API Amazon Athena](https://docs.aws.amazon.com/athena/latest/APIReference/). Pour plus d'informations sur les politiques IAM, consultez la rubrique [Création de politiques avec l'éditeur visuel](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-visual-editor) du *Guide de l'utilisateur IAM*. **Example Exemple de politique pour répertorier les réserves de capacité** La politique suivante permet à tous les utilisateurs de répertorier toutes les réserves de capacité. **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "athena:ListCapacityReservations" ], "Resource": "*" } ] } ``` **Example Exemple de politique pour les opérations de gestion** La politique suivante permet à un utilisateur de créer, d'annuler, d'obtenir des informations sur et de mettre à jour la réserve de capacité `test_capacity_reservation`. La politique permet également à un utilisateur d'attribuer les `workgroupA` et `workgroupB` à la `test_capacity_reservation`. **** ``` { "Version":"2012-10-17", "Statement":[ { "Effect": "Allow", "Action": [ "athena:CreateCapacityReservation", "athena:GetCapacityReservation", "athena:CancelCapacityReservation", "athena:UpdateCapacityReservation", "athena:GetCapacityAssignmentConfiguration", "athena:PutCapacityAssignmentConfiguration" ], "Resource": [ "arn:aws:athena:us-east-1:123456789012:capacity-reservation/test_capacity_reservation", "arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA", "arn:aws:athena:us-east-1:123456789012:workgroup/workgroupB" ] } ] } ``` # Réservation de capacité à Athena APIs La liste suivante contient des liens de référence vers les actions des API de réserve de capacité Athena. Pour les structures de données et les autres actions des API Athena, voir la [https://docs.aws.amazon.com/athena/latest/APIReference/](https://docs.aws.amazon.com/athena/latest/APIReference/). + [CancelCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_CancelCapacityReservation.html) + [CreateCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_CreateCapacityReservation.html) + [DeleteCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_DeleteCapacityReservation.html) + [GetCapacityAssignmentConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetCapacityAssignmentConfiguration.html) + [GetCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetCapacityReservation.html) + [ListCapacityReservations](https://docs.aws.amazon.com/athena/latest/APIReference/API_ListCapacityReservations.html) + [PutCapacityAssignmentConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_PutCapacityAssignmentConfiguration.html) + [UpdateCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_UpdateCapacityReservation.html)