

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Kapazität zur Abfrageverarbeitung verwalten
<a name="capacity-management"></a>

Sie können Kapazitätsreservierungen verwenden, um dedizierte serverlose Verarbeitungskapazität für die Abfragen zu erhalten, die Sie in Athena ausführen. Mit Kapazitätsreservierungen können Sie die Vorteile von Workload-Management-Funktionen nutzen, mit denen Sie Ihre wichtigsten Workloads priorisieren, kontrollieren und skalieren können. Sie können beispielsweise Kapazität hinzufügen, um die Anzahl der Abfragen zu kontrollieren, die Sie gleichzeitig ausführen können, auszuwählen, welche Workloads die Kapazität nutzen können, und die Kapazität auf mehrere Workloads verteilen. Die Kapazität ist serverlos und wird vollständig von Athena verwaltet. Sie wird so lange für Sie bereitgestellt, wie Sie sie benötigen. Die Einrichtung ist einfach und es sind keine Änderungen an Ihren SQL-Abfragen erforderlich.

Um die Verarbeitungskapazität für Ihre Abfragen zu erhalten, erstellen Sie eine Kapazitätsreservierung, geben die Anzahl der benötigten Datenverarbeitungseinheiten (DPUs) an und weisen der Reservierung eine oder mehrere Arbeitsgruppen zu.

Arbeitsgruppen spielen eine wichtige Rolle, wenn Sie Kapazitätsreservierungen verwenden. Arbeitsgruppen ermöglichen es Ihnen, Abfragen in logischen Gruppierungen oder Anwendungsfällen zu organisieren. Mit Kapazitätsreservierungen weisen Sie Arbeitsgruppen selektiv Kapazität zu, sodass Sie kontrollieren können, wie sich die Abfragen für jede Arbeitsgruppe verhalten und wie sie abgerechnet werden. Weitere Informationen zu Arbeitsgruppen finden Sie unter [Verwendung von Arbeitsgruppen zur Kontrolle des Abfragenzugriffs und der Kosten](workgroups-manage-queries-control-costs.md).

Wenn Sie Arbeitsgruppen Kapazitätsreservierungen zuweisen, können Sie diesen Abfragen Priorität einräumen, da sie auf Ihrer reservierten Kapazität ausgeführt werden und nicht auf Ihr DDL- und DML-Abfragekontingent angerechnet werden. Sie können beispielsweise einer Arbeitsgruppe, die für zeitkritische Finanzberichterstattungsabfragen verwendet wird, Kapazität zuweisen, um diese Abfragen von weniger kritischen Abfragen in einer anderen Arbeitsgruppe zu isolieren. Auf diese Weise erhalten Sie eine vorhersehbare Abfrageausführung für kritische Workloads, während andere Workloads unabhängig voneinander ausgeführt werden können.

Sie können Kapazitätsreservierungen und Arbeitsgruppen zusammen verwenden, um unterschiedlichen Anforderungen gerecht zu werden. Es folgen einige Beispielszenarien:
+ **Isolieren Sie wichtige Abfragen** — Um sicherzustellen, dass ein wichtiger Workload die Kapazität hat, die er benötigt, wenn Sie sie benötigen, erstellen Sie eine Kapazitätsreservierung und weisen Sie die zugehörige Arbeitsgruppe der Reservierung zu. Nur Anfragen der zugewiesenen Arbeitsgruppe nutzen die Verarbeitungskapazität aus Ihrer Reservierung. Um beispielsweise die zuverlässige Ausführung von Abfragen zu gewährleisten, die eine Produktionsanwendung unterstützen, weisen Sie die Produktionsarbeitsgruppe für diese Abfragen einer Kapazitätsreservierung zu. Verwenden Sie bei der Entwicklung von Abfragen eine separate Arbeitsgruppe, die keiner Reservierung zugeordnet ist, und verschieben Sie die Abfragen an die Produktionsarbeitsgruppe, sobald diese bereit ist.
+ **Kapazität auf ähnliche Workloads verteilen — Bei mehreren Workloads** kann die Kapazität aus einer Reservierung gemeinsam genutzt werden. Auf diese Weise können Sie vorhersehbare Kosten für diese Workloads erzielen und ihre Parallelität kontrollieren. Wenn Sie beispielsweise Workloads geplant haben, die verzögerte Startzeiten bei der Ausführung von Abfragen tolerieren, können Sie deren Arbeitsgruppen einer einzigen Reservierung zuordnen. Dadurch wird Ihr Kontingent für DDL- und DML-Abfragen für interaktive Abfragen freigegeben, die unter demselben Konto ausgeführt werden, sodass sichergestellt wird, dass diese Abfragen mit minimaler Verzögerung gestartet werden.

## Verstehen DPUs
<a name="capacity-management-understanding-dpus"></a>

Die Kapazität wird in Datenverarbeitungseinheiten (DPUs) gemessen. DPUs stellen die serverlosen Rechen- und Speicherressourcen dar, die Athena verwendet, um in Ihrem Namen auf Daten zuzugreifen und diese zu verarbeiten. Eine DPU stellt in der Regel 4 V CPUs und 16 GB Arbeitsspeicher bereit. Die Anzahl der Abfragen DPUs , die Sie speichern, beeinflusst die Anzahl der Abfragen, die Sie gleichzeitig ausführen können. Beispielsweise DPUs kann eine Reservierung mit 256 ungefähr doppelt so viele gleichzeitige Abfragen unterstützen wie eine Reservierung mit 128. DPUs

Informationen zur Schätzung Ihres Kapazitätsbedarfs finden Sie unter [Kapazitätsanforderungen bestimmen](capacity-management-requirements.md). Preisinformationen finden Sie unter [Amazon-Athena-Preisinformationen](https://aws.amazon.com/athena/pricing/).

## Überlegungen und Einschränkungen
<a name="capacity-management-considerations-limitations"></a>
+ Sie können Kapazitätsreservierungen und die Abrechnung pro Abfrage auf der Grundlage der gescannten Daten gleichzeitig in demselben Konto verwenden.
+ Abfragen, die aufgrund von Kapazitätsreservierungen ausgeführt werden, werden nicht auf Ihr DDL- und DML-Abfragekontingent angerechnet.
+ Wenn Ihre Kapazität zur Bearbeitung anderer Abfragen ausgelastet ist, werden neu eingereichte Abfragen in die Warteschlange gestellt, bis Kapazität verfügbar ist. Die maximal zulässige Zeit in der Warteschlange beträgt 10 Stunden.
+ Eine Arbeitsgruppe kann jeweils einer Kapazitätsreservierung zugewiesen werden. Sie können einer einzelnen Reservierung insgesamt 20 Arbeitsgruppen zuweisen. Wenn Sie einer Reservierung mehrere Arbeitsgruppen zuweisen, wird die Kapazität von allen Arbeitsgruppen gemeinsam genutzt und Anfragen auf der Grundlage ihrer Einreichungsreihenfolge zugewiesen. Es kann zu Abweichungen in der Ausführungsreihenfolge kommen, da Athena Abfragen dynamisch Kapazität zuweist.
+ Athena weist DML-Abfragen aufgrund ihrer Komplexität automatisch zwischen 4 und 124 DPUs zu. DDL-Abfragen verbrauchen jeweils 4 Abfragen. DPUs Weitere Informationen finden Sie in den folgenden Themen:
  + [Kapazitätsanforderungen bestimmen](capacity-management-requirements.md)
  + [Steuern Sie die Kapazitätsnutzung](capacity-management-control-capacity-usage.md)
+ Bei jeder Kapazitätsreservierung sind mindestens 4 Personen DPUs erforderlich. Preisinformationen finden Sie unter [Amazon-Athena-Preisinformationen](https://aws.amazon.com/athena/pricing/).
+ Sie können bis zu 100 Kapazitätsreservierungen mit insgesamt bis zu 1.000 DPUs pro Konto und Region erstellen. Wenn Sie mehr als 1.000 DPUs für Ihren Anwendungsfall benötigen, wenden Sie sich bitte an [athena-feedback@amazon.com](mailto:athena-feedback@amazon.com?subject=Athena Provisioned Capacity DPU Limit Request).
+ Kapazitätsanfragen können nicht garantiert werden und können bis zu 30 Minuten dauern. Die Kapazität ist nicht auf eine andere Kapazitätsreservierung übertragbar AWS-Konto, oder AWS-Region.
+ Die `DPUConsumed` CloudWatch Metrik gilt pro Arbeitsgruppe und nicht pro Reservierung. Wenn Sie also eine Arbeitsgruppe von einer Reservierung in eine andere verschieben, enthält die `DPUConsumed`-Metrik Daten aus dem Zeitpunkt, zu dem die Arbeitsgruppe zur ersten Reservierung gehörte. Weitere Informationen zur Verwendung von CloudWatch Metriken in Athena finden Sie unter[Überwachen Sie Athena-Abfragemetriken mit CloudWatch](query-metrics-viewing.md).
+ Um eine Arbeitsgruppe zu löschen, die einer Reservierung zugewiesen wurde, entfernen Sie zuerst die Arbeitsgruppe aus der Reservierung.
+ Arbeitsgruppen, die für die Verwendung von Apache Spark konfiguriert sind, werden nicht unterstützt.
+ Kapazitätsreservierungen sind in den folgenden Werbespots AWS-Regionen nicht verfügbar:
  + Israel (Tel Aviv)
  + Naher Osten (VAE)
  + Middle East (Bahrain)
  + Asien-Pazifik (Neuseeland)

**Topics**
+ [Verstehen DPUs](#capacity-management-understanding-dpus)
+ [Überlegungen und Einschränkungen](#capacity-management-considerations-limitations)
+ [Kapazitätsanforderungen bestimmen](capacity-management-requirements.md)
+ [Kapazitätsreservierungen erstellen](capacity-management-creating-capacity-reservations.md)
+ [Steuern Sie die Kapazitätsnutzung](capacity-management-control-capacity-usage.md)
+ [Passen Sie die Kapazität automatisch an](capacity-management-automatically-adjust-capacity.md)
+ [Reservierungen verwalten](capacity-management-managing-reservations.md)
+ [IAM-Richtlinien für Kapazitätsreservierungen](capacity-reservations-iam-policy.md)
+ [Athena-Kapazitätsreservierung APIs](capacity-management-api-list.md)

# Kapazitätsanforderungen bestimmen
<a name="capacity-management-requirements"></a>

Bevor Sie eine Kapazitätsreservierung erstellen, können Sie die benötigte Kapazität schätzen, sodass Sie ihr die richtige Anzahl von zuweisen können DPUs. Und wenn eine Reservierung genutzt wurde, sollten Sie die Reservierung möglicherweise auf unzureichende oder überschüssige Kapazität überprüfen. In diesem Thema werden Techniken beschrieben, mit denen Sie diese Schätzungen vornehmen können. Außerdem werden einige AWS Tools zur Bewertung von Nutzung und Kosten beschrieben.

**Topics**
+ [Erforderliche Kapazität einscchätzen](#capacity-management-requirements-estimating)
+ [Anzeichen dafür, dass mehr Kapazität benötigt wird](#capacity-management-requirements-insufficient-capacity)
+ [Auf ungenutzte Kapazität prüfen](#capacity-management-requirements-idle-capacity)
+ [Überwachung des DPU-Verbrauchs](#capacity-management-requirements-monitoring-dpu-consumption)

## Erforderliche Kapazität einscchätzen
<a name="capacity-management-requirements-estimating"></a>

Bei der Schätzung des Kapazitätsbedarfs ist es sinnvoll, zwei Aspekte zu berücksichtigen: wie viel Kapazität eine bestimmte Abfrage möglicherweise benötigt, und wie viel Kapazität Sie im Allgemeinen benötigen könnten.

### Kapazitätsbedarf pro Abfrage einschätzen
<a name="capacity-management-requirements-estimating-query"></a>

Anhand der folgenden Richtlinien können Sie ermitteln, wie viele davon für eine Abfrage erforderlich sein könnten: DPUs 
+ DDL-Abfragen verbrauchen 4. DPUs
+ DML-Abfragen verbrauchen zwischen 4 und 124. DPUs

Athena bestimmt die Anzahl der von einer DML-Abfrage DPUs benötigten, wenn die Abfrage gesendet wird. Die Anzahl variiert je nach Datengröße, Speicherformat, Abfragekonstruktion und anderen Faktoren. Im Allgemeinen versucht Athena, die niedrigste und effizienteste DPU-Nummer auszuwählen. Wenn Athena feststellt, dass mehr Rechenleistung erforderlich ist, damit die Abfrage erfolgreich abgeschlossen werden kann, wird die Anzahl der der Abfrage DPUs zugewiesenen Personen erhöht.

### Für die Workload spezifischen Kapazitätsanforderungen einschätzen
<a name="capacity-management-requirements-estimating-workload"></a>

Beachten Sie die allgemeinen Richtlinien in der folgenden Tabelle, um zu ermitteln, wie viel Kapazität Sie möglicherweise benötigen, um mehrere Abfragen gleichzeitig auszuführen:


****  

| Gleichzeitige Abfragen | DPUs erforderlich | 
| --- | --- | 
| 10 | 40 oder mehr | 
| 20 | 96 oder mehr | 
| 30 oder mehr | 240 oder mehr | 

Beachten Sie, dass die tatsächliche Anzahl davon DPUs , die Sie benötigen, von Ihren Zielen und Analysemustern abhängt. Wenn Sie beispielsweise möchten, dass Abfragen sofort und ohne Warteschlangen gestartet werden, ermitteln Sie den höchsten Bedarf an gleichzeitigen Abfragen und geben Sie dann die Anzahl der DPUs Abfragen entsprechend an.

Sie können weniger DPUs als Ihren Spitzenbedarf bereitstellen, aber bei Spitzenbedarf kann es zu Warteschlangen kommen. Wenn es zu Warteschlangen kommt, hält Athena Ihre Abfragen in einer Warteschlange und führt sie aus, sobald Kapazität verfügbar ist.

Wenn Sie innerhalb eines festen Budgets Abfragen ausführen möchten, können Sie mit dem [AWS Preisrechner](https://calculator.aws/#/addService/Athena) ermitteln, wie viele Abfragen Ihrem Budget entsprechen. DPUs

Denken Sie abschließend daran, dass die Datengröße, das Speicherformat und die Art und Weise, wie eine Abfrage geschrieben wird DPUs , die Anforderungen einer Abfrage beeinflussen. Um die Abfrageleistung zu erhöhen, können Sie Ihre Daten komprimieren, partitionieren oder in spaltenförmige Formate konvertieren. Weitere Informationen finden Sie unter [Optimieren der Leistung von Athena](performance-tuning.md).

## Anzeichen dafür, dass mehr Kapazität benötigt wird
<a name="capacity-management-requirements-insufficient-capacity"></a>

Fehlermeldungen zu unzureichender Kapazität und Queuing bei Abfragen sind zwei Anzeichen dafür, dass die zugewiesene Kapazität unzureichend ist.

Wenn Ihre Abfragen mit einer Fehlermeldung über unzureichende Kapazität fehlschlagen, ist die DPU-Anzahl Ihrer Kapazitätsreservierung zu niedrig für Ihre Abfrage. Wenn Sie beispielsweise eine Reservierung mit 24 haben DPUs und eine Abfrage ausführen, die mehr als 24 erfordert DPUs, schlägt die Abfrage fehl. Um diesen Abfragefehler zu überwachen, können Sie die [EventBridge Ereignisse](athena-events.md) von Athena verwenden. Versuchen Sie, weitere hinzuzufügen DPUs und Ihre Abfrage erneut auszuführen.

Wenn sich viele Abfragen in der Warteschlange befinden, bedeutet dies, dass Ihre Kapazität durch andere Abfragen voll ausgelastet ist. Um die Warteschlangen zu reduzieren, gehen Sie wie folgt vor:
+ Fügen Sie Ihrer Reservierung hinzu DPUs , um die Parallelität der Abfragen zu erhöhen.
+ Entfernen Sie Arbeitsgruppen aus Ihrer Reservierung, um Kapazitäten für andere Abfragen freizugeben.

Verwenden Sie die [CloudWatchAthena-Queue-Time-Metrik](query-metrics-viewing.md) für die Arbeitsgruppen in Ihrer Kapazitätsreservierung, um zu überprüfen, ob zu viele Abfragewarteschlangen vorhanden sind. Wenn der Wert über Ihrem bevorzugten Schwellenwert liegt, können Sie ihn zur DPUs Kapazitätsreservierung hinzufügen.

## Auf ungenutzte Kapazität prüfen
<a name="capacity-management-requirements-idle-capacity"></a>

Um nach ungenutzter Kapazität zu suchen, können Sie entweder die Anzahl der DPUs in der Reservierung enthaltenen Kapazitäten verringern oder die Arbeitslast erhöhen und dann die Ergebnisse beobachten.

**Auf untätige Kapazität prüfen**

1. Führen Sie eine der folgenden Aktionen aus:
   + Reduzieren Sie die Anzahl der DPUs in Ihrer Reservierung enthaltenen Ressourcen (reduzieren Sie die verfügbaren Ressourcen)
   + Fügen Sie Ihrer Reservierung Arbeitsgruppen hinzu (erhöhen Sie den Workload)

1. Wird verwendet [CloudWatch](query-metrics-viewing.md), um die Wartezeit für Abfragen zu messen.

1. Wenn die Warteschlangenzeit einen gewünschten Wert überschreitet, gehen Sie wie folgt vor:
   + Entfernen Sie Arbeitsgruppen
   +  DPUs Zu Ihrer Kapazitätsreservierung hinzufügen

1. Überprüfen Sie nach jeder Änderung die Leistung und die Warteschlangenzeit für Abfragen.

1. Passen Sie die Anzahl der and/or Workload-DPUs weiter an, um das gewünschte Gleichgewicht zu erreichen.

Wenn Sie die Kapazität außerhalb eines bevorzugten Zeitraums nicht aufrechterhalten möchten, können Sie die Reservierung [stornieren](capacity-management-cancelling-a-capacity-reservation.md) und später eine weitere Reservierung erstellen. Selbst wenn Sie kürzlich Kapazitäten für eine andere Reservierung storniert haben, können Anfragen nach neuen Kapazitäten nicht garantiert werden, und die Erstellung neuer Reservierungen dauert einige Zeit.

## Überwachung des DPU-Verbrauchs
<a name="capacity-management-requirements-monitoring-dpu-consumption"></a>

Nachdem Ihre Abfragen ausgeführt wurden, können Sie die von Ihren Abfragen verbrauchte DPU anzeigen, um Ihre Kapazitätsschätzungen zu verfeinern. Athena stellt Metriken zum DPU-Verbrauch über die Konsole, API-Operationen und bereit. CloudWatch Diese Informationen helfen Ihnen dabei, Abfragen zu identifizieren, die mehr oder weniger Ressourcen als erwartet verbrauchen, und Ihre Kapazitätszuweisung auf der Grundlage realer Daten zu optimieren. Ausführliche Informationen zum Anzeigen und Verfolgen des DPU-Verbrauchs finden Sie unter. [Überwachen Sie die DPU-Nutzung](capacity-management-control-capacity-usage.md#capacity-management-monitor-dpu-usage)

## Tools zur Bewertung von Kapazitätsanforderungen und Kosten
<a name="capacity-management-requirements-tools"></a>

Sie können die folgenden Dienste und Funktionen verwenden, AWS um Ihre Nutzung und Kosten von Athena zu messen.

### CloudWatch Metriken
<a name="capacity-management-requirements-tools-cloudwatch-metrics"></a>

Sie können Athena so konfigurieren, dass abfragebezogene Metriken auf CloudWatch Arbeitsgruppenebene in Amazon veröffentlicht werden. Nachdem Sie Metriken für die Arbeitsgruppe aktiviert haben, werden die Metriken für die Abfragen der Arbeitsgruppe in der Athena-Konsole auf der Detailseite der Arbeitsgruppe angezeigt.

Informationen zu den auf veröffentlichten Athena-Metriken CloudWatch und ihren Dimensionen finden Sie unter[Überwachen Sie Athena-Abfragemetriken mit CloudWatch](query-metrics-viewing.md).

### CloudWatch Nutzungsmetriken
<a name="capacity-management-requirements-tools-cloudwatch-usage-metrics"></a>

Mithilfe von CloudWatch Nutzungsmetriken können Sie sich einen Überblick darüber verschaffen, wie Ihr Konto Ressourcen nutzt, indem Sie Ihre aktuelle Servicenutzung in CloudWatch Diagrammen und Dashboards anzeigen. Für Athena entsprechen die Nutzungsverfügbarkeitsmetriken den AWS [Servicekontingenten](service-limits.md) für Athena. Sie können Alarme konfigurieren, mit denen Sie benachrichtigt werden, wenn sich Ihre Nutzung einem Servicekontingent nähert.

Weitere Informationen finden Sie unter [Überwachen Sie die Nutzungsmetriken von Athena mit CloudWatch](monitoring-athena-usage-metrics.md).

### EventBridge Amazon-Veranstaltungen
<a name="capacity-management-requirements-tools-eventbridge-events"></a>

Sie können Amazon Athena mit Amazon verwenden EventBridge , um in Echtzeit Benachrichtigungen über den Status Ihrer Anfragen zu erhalten. Wenn eine von Ihnen eingereichte Abfrage den Status ändert, veröffentlicht Athena ein Ereignis, EventBridge das Informationen über den Abfragestatusübergang enthält. Sie können einfache Regeln für Ereignisse schreiben, die für Sie von Interesse sind, und automatisierte Aktionen ausführen, wenn ein Ereignis mit einer Regel übereinstimmt.

Weitere Informationen finden Sie in den folgenden Ressourcen.
+ [Überwachen Sie Athena-Abfrageereignisse mit EventBridge](athena-events.md)
+ [Was ist Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)
+ [ EventBridgeAmazon-Veranstaltungen](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) 

### Tags (Markierungen)
<a name="capacity-management-requirements-tools-tags"></a>

In Athena unterstützen Kapazitätsreservierungen Tags. Ein Tag besteht aus einem Schlüssel und einem Wert. Um Ihre Kosten in Athena zu verfolgen, können Sie AWS-generierte Kostenzuordnungs-Tags verwenden. AWS verwendet die Kostenzuweisungs-Tags, um Ihre Ressourcenkosten in Ihrem [Kosten- und Nutzungsbericht](https://docs.aws.amazon.com/cur/latest/userguide/what-is-cur.html) zu organisieren. Auf diese Weise können Sie Ihre AWS Kosten leichter kategorisieren und nachverfolgen. Um Kostenzuweisungs-Tags für Athena zu aktivieren, verwenden Sie die [AWS Fakturierung und Kostenmanagement -Konsole](https://console.aws.amazon.com/billing/).

Weitere Informationen finden Sie in den folgenden Ressourcen.
+ [Athena-Ressourcen markieren](tags.md)
+ [Aktivierung der von AWS-generierten Kostenzuweisungs-Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activate-built-in-tags.html)
+ [Verwenden von  AWS -Kostenzuordnungs-Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)

# Kapazitätsreservierungen erstellen
<a name="capacity-management-creating-capacity-reservations"></a>

Zunächst erstellen Sie eine Kapazitätsreservierung mit der Anzahl der DPUs benötigten Kapazitäten und weisen dann eine oder mehrere Arbeitsgruppen zu, die diese Kapazität für ihre Abfragen verwenden. Sie können Ihre Kapazität später nach Bedarf anpassen, um eine konsistentere Leistung zu erzielen oder die Kosten besser zu verwalten. Informationen zur Schätzung Ihres Kapazitätsbedarfs finden Sie unter [Kapazitätsanforderungen bestimmen](capacity-management-requirements.md).

**Wichtig**  
Kapazitätsanfragen können nicht garantiert werden und können bis zu 30 Minuten dauern.

**So erstellen Sie eine Kapazitätsreservierung**

1. Öffnen Sie die Athena-Konsole unter [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Wenn der Navigationsbereich in der Konsole nicht sichtbar ist, wählen Sie das Erweiterungsmenü auf der linken Seite.

1. Wählen Sie **Administration**, **Kapazitätsreservierungen** aus.

1. Wählen Sie **Kapazitätsreservierung erstellen**.

1. Geben Sie auf der Seite **Kapazitätsreservierung erstellen** für den **Namen der Kapazitätsreservierung** den Namen ein. Der Name muss eindeutig sein, zwischen 1 und 128 Zeichen lang sein und darf nur die Zeichen a-z, A-Z, 0-9, \$1 (Unterstrich), enthalten. (Punkt) und - (Bindestrich). Sie können den Namen nicht mehr ändern, nachdem Sie die Reservierung erstellt haben.

1. Wählen Sie für **DPU** die Anzahl der gewünschten Datenverarbeitungseinheiten (DPUs) in Schritten von 4 aus, oder geben Sie sie ein. Weitere Informationen finden Sie unter [Verstehen DPUs](capacity-management.md#capacity-management-understanding-dpus).

1. (Optional) Erweitern Sie die Option **Tags** und wählen Sie dann **Neues Tag hinzufügen** aus, um ein oder mehrere benutzerdefinierte key/value Paare hinzuzufügen, die der Kapazitätsreservierungsressource zugeordnet werden sollen. Weitere Informationen finden Sie unter [Athena-Ressourcen markieren](tags.md).

1. Wählen Sie **Überprüfen** aus.

1. **Bestätigen Sie bei der Aufforderung „Kapazitätsreservierung erstellen** bestätigen“ die Anzahl der DPUs AWS-Region, und weitere Informationen. Wenn Sie damit einverstanden sind, wählen Sie **Senden** aus.

   Auf der Detailseite wird der **Status** Ihrer Kapazitätsreservierung als **Ausstehend** angezeigt. Wenn Ihre Reservierungskapazität für Abfragen verfügbar ist, wird ihr Status als **Aktiv** angezeigt.

Sie können Ihrer Reservierung nun eine oder mehrere Arbeitsgruppen hinzufügen. Informationen zu den erforderlichen Schritten finden Sie unter [Arbeitsgruppen zu einer Reservierung hinzufügen](capacity-management-adding-workgroups-to-a-reservation.md).

# Steuern Sie die Kapazitätsnutzung
<a name="capacity-management-control-capacity-usage"></a>

Sie können die Anzahl der DPU steuern, die Athena Ihren Abfragen zuweist, indem Sie maximale oder minimale DPU-Steuerungen festlegen. Sie können diese auf Arbeitsgruppenebene konfigurieren, um grundlegende Steuerungen für alle Abfragen festzulegen, oder auf individueller Abfrageebene, um eine detaillierte Steuerung zu gewährleisten. Auf diese Weise haben Sie direkte Kontrolle über die Abfrageleistung, die Parallelität der Arbeitslast und die Kosten.
+ Wenn Sie eine maximale Anzahl von DPU festlegen, wird verhindert, dass Abfragen mehr Kapazität verbrauchen als von Ihnen angegeben. Dies macht es einfach, die Kosten und die Gleichzeitigkeit der Arbeitslast zu kontrollieren. Wenn Ihre Kapazitätsreservierung beispielsweise 200 DPU umfasst, können Sie 25 Abfragen gleichzeitig ausführen, wenn Sie die maximale DPU pro Abfrage auf 8 festlegen. Wenn Sie Ihre Reservierung auf 400 DPU erhöhen, können Sie 50 Abfragen gleichzeitig ausführen.
+ Wenn Sie eine Mindestanzahl von DPU festlegen, stellen Sie sicher, dass Abfragen mit der gewünschten Mindestanzahl von DPU ausgeführt werden. Dies ist hilfreich, wenn Sie das typische Kapazitätsnutzungsprofil für Ihre Abfragen im Voraus kennen.

**Anmerkung**  
Die DPU-Nutzungskontrollen gelten nur für Abfragen, die mit Kapazitätsreservierungen ausgeführt werden.

**Anmerkung**  
Um dieselbe Anzahl von DPU für alle Abfragen zu verwenden, verwenden Sie denselben Wert für die minimale und maximale DPU.

## Stellen Sie die DPU-Steuerelemente auf Arbeitsgruppenebene ein
<a name="capacity-management-set-dpu-controls-workgroup-level"></a>

Richten Sie DPU-Steuerungen auf Arbeitsgruppenebene ein, um die Kosten zu verwalten und die Workload-Leistung für die von Ihnen gewählte Arbeitsgruppe zu kontrollieren. Auf Arbeitsgruppenebene festgelegte DPU-Steuerelemente gelten für alle Abfragen, wenn die Option Clientseitige Einstellungen **überschreiben** aktiviert ist.

**So legen Sie DPU-Steuerelemente mithilfe der Konsole fest**

1. Öffnen Sie die Athena-Konsole unter [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Wählen Sie im Navigationsbereich die Option **Arbeitsgruppen** aus.

1. Wählen Sie eine Arbeitsgruppe aus, die eine Kapazitätsreservierung verwendet.

1. Wählen Sie auf der Registerkarte **Ausführungskontrollen** die Option **Kontrollen bearbeiten** aus.

1. Konfigurieren Sie Folgendes:
   + Geben Sie für **Min. DPU pro Abfrage** einen Wert zwischen 4 und 124 in Schritten von 4 ein.
   + Geben Sie für **Max DPU pro Abfrage** einen Wert zwischen 4 und 124 in Schritten von 4 ein.

1. Wählen Sie **Speichern**.

1. (Optional) Wählen Sie **Clientseitige Einstellungen überschreiben, um diese Einstellungen** durchzusetzen und DPU-Konfigurationen auf Abfrageebene zu ignorieren.

**Um die DPU-Steuerung einzustellen, verwenden Sie AWS CLI**
+ Verwenden Sie den `update-work-group` Befehl, um die DPU-Steuerelemente für eine Arbeitsgruppe festzulegen:

  ```
  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"
                          }
                      }
                  ]
          }}'
  ```

  Wenn Sie `EnforceWorkGroupConfiguration` auf festlegen`true`, überschreiben die Arbeitsgruppeneinstellungen alle auf Abfrageebene angegebenen DPU-Steuerelemente, wenn sie über gesendet werden. [StartQueryExecution](https://docs.aws.amazon.com/athena/latest/APIReference/API_StartQueryExecution.html) Dadurch wird eine konsistente Ressourcenzuweisung für alle Abfragen in der Arbeitsgruppe gewährleistet.

## Stellen Sie DPU-Steuerelemente mit individuellen Abfragen ein
<a name="capacity-management-set-dpu-controls-individual-queries"></a>

Richten Sie DPU-Steuerelemente auf Abfrageebene ein, wenn Sie eine detaillierte Steuerung für Abfragen mit unterschiedlichen Ressourcenanforderungen benötigen. **DPU-Steuerelemente auf Abfrageebene haben Vorrang vor Einstellungen auf Arbeitsgruppenebene, es sei denn, für die Arbeitsgruppe ist die Option Clientseitige Einstellungen überschreiben aktiviert.**

**So legen Sie DPU-Steuerelemente für eine Abfrage mithilfe der Konsole fest**

1. Öffnen Sie die Athena-Konsole unter [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Wählen Sie im Navigationsbereich die Option **Query Editor (Abfrage-Editor)** aus.

1. Wählen Sie eine Arbeitsgruppe aus, die eine Kapazitätsreservierung verwendet.

1. Wählen Sie die Registerkarte **Abfrageeinstellungen**.

1. Wählen Sie im Abschnitt **Ausführungskontrollen** die Option **Steuerelemente bearbeiten** aus.

1. Konfigurieren Sie Folgendes:
   + Geben Sie für **Min. DPU pro Abfrage** einen Wert zwischen 4 und 124 in Schritten von 4 ein.
   + Geben Sie für **Max DPU pro Abfrage** einen Wert zwischen 4 und 124 in Schritten von 4 ein.

1. Wählen Sie **Speichern**.

**Um die DPU-Steuerelemente für eine Abfrage festzulegen, verwenden Sie AWS CLI**
+ Verwenden Sie den `start-query-execution` Befehl mit dem folgenden `engine-configuration` Parameter:

  ```
  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"
                  }
              }
          ]}'
  ```

Die Beziehung zwischen den DPU-Einstellungen auf Abfrageebene und auf Arbeitsgruppenebene hängt von Ihrer Arbeitsgruppenkonfiguration ab:
+ Wenn die Option **Clientseitige Einstellungen überschreiben aktiviert ist, haben DPU-Steuerelemente auf Arbeitsgruppenebene Vorrang vor allen Einstellungen** auf Abfrageebene. Dadurch wird eine konsistente Ressourcennutzung für alle Abfragen in der angegebenen Arbeitsgruppe gewährleistet.
+ Wenn „**Clientseitige Einstellungen überschreiben**“ nicht aktiviert ist, haben DPU-Steuerelemente auf Abfrageebene Vorrang vor Einstellungen auf Arbeitsgruppenebene. Dies ermöglicht Flexibilität bei der Optimierung einzelner Abfragen.

Wenn Sie auf keiner der beiden Ebenen DPU-Steuerungen angeben, weist Athena die Kapazität automatisch auf der Grundlage der Komplexität der Abfrage zu.

**Anmerkung**  
Bei DDL-Abfragen ist der Höchstwert für das Minimum 4. DPUs Das Festlegen eines höheren Minimums für DDL-Abfragen führt zu einem Fehler.

## Überwachen Sie die DPU-Nutzung
<a name="capacity-management-monitor-dpu-usage"></a>

Nachdem Ihre Abfragen abgeschlossen sind, können Sie die DPU-Nutzung einsehen. Athena stellt DPU-Nutzungsmetriken über die Konsole, API-Operationen und bereit. CloudWatch

**Um den DPU-Verbrauch in der Konsole anzuzeigen**

1. Öffnen Sie die Athena-Konsole unter [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Wählen Sie im Navigationsbereich die Option **Query Editor (Abfrage-Editor)** aus.

1. Nachdem eine Abfrage abgeschlossen ist, können Sie den Wert für **verbrauchte DPU** im Container mit den Abfrageergebnissen anzeigen.

1. So zeigen Sie den DPU-Verbrauch für frühere Abfragen an:

   1. Wählen Sie im Navigationsbereich die Option **Letzte Abfragen** aus.

   1. Wählen Sie das Einstellungssymbol aus, um die Spalte **Verbrauchte DPU** zur Tabelle hinzuzufügen, sofern sie nicht bereits angezeigt wird.

   1. Überprüfen Sie den DPU-Verbrauch für jede abgeschlossene Abfrage.

1. Wählen Sie optional im **Abfrage-Editor** die Registerkarte **Abfragestatistiken** und überprüfen Sie die **verbrauchte DPU**.

**Um den DPU-Verbrauch mithilfe der API abzurufen**

1. Verwenden Sie die folgenden API-Operationen, um den DPU-Verbrauch programmgesteuert abzurufen:
   + `GetQueryExecution`— Gibt Ausführungsdetails für eine bestimmte Abfrage zurück
   + `BatchGetQueryExecution`- Gibt Ausführungsdetails für mehrere Abfragen zurück

1. Beispiel - Verwenden des AWS CLI:

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

   Die Antwort enthält das `DpuCount` Feld im `Statistics` Objekt:

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

**Um die DPU-Nutzung zu überwachen mit CloudWatch**
+ Athena veröffentlicht abfragebezogene Metriken, mit CloudWatch denen Sie die Kapazitätsauslastung und andere Leistungsdaten überwachen können. Weitere Informationen hierzu finden Sie unter [Überwachen Sie Athena-Abfragemetriken mit CloudWatch](query-metrics-viewing.md).

# Passen Sie die Kapazität automatisch an
<a name="capacity-management-automatically-adjust-capacity"></a>

Mit der Auto-Scaling-Lösung von Athena können Sie die Kapazität Ihrer Reservierung automatisch an die Auslastung der Arbeitslast anpassen. Sie fügt automatisch Kapazität hinzu, wenn die Auslastung Ihren konfigurierten Schwellenwert überschreitet, und entfernt Kapazität in Zeiten geringer Auslastung, um die Kosten zu senken. Sie können das Verhalten anpassen, indem Sie verschiedene Nutzungsgrenzwerte, minimale und maximale DPU-Mengen, Skalierungsstufen und Häufigkeit der Nutzungsbewertung festlegen. Dadurch entfallen manuelle Kapazitätsanpassungen und Sie können gleichzeitig Leistungsanforderungen und Kostenoptimierung in Einklang bringen.

Sie stellen diese serverlose Lösung mithilfe einer CloudFormation Vorlage bereit. Es erstellt eine Step Functions Functions-Zustandsmaschine, die Nutzungsmetriken überwacht und Skalierungsentscheidungen trifft. Sie können die Vorlage oder die Zustandsmaschine weiter an Ihre spezifischen Bedürfnisse anpassen.

Verwenden Sie zunächst die Athena-Konsole und wählen Sie auf der Detailseite Ihrer Kapazitätsreservierung die **Option auto-scaling einrichten** aus. Daraufhin werden Sie CloudFormation mit der vorinstallierten Vorlage weitergeleitet. Gehen Sie alternativ wie folgt vor.

## Voraussetzungen
<a name="capacity-management-auto-scaling-prerequisites"></a>
+ Eine aktive Kapazitätsreservierung ist erforderlich
+ Erforderliche IAM-Berechtigungen für die Bereitstellung von CloudFormation Stacks und die Erstellung von Step Functions Functions-Ressourcen

## Starten Sie den Stack CloudFormation
<a name="capacity-management-auto-scaling-launch-stack"></a>

Diese automatisierte CloudFormation Vorlage stellt die auto-scaling Skalierungslösung Athena Capacity Reservation bereit. Sie müssen die entsprechenden Schritte unter ausführen, [Voraussetzungen](#capacity-management-auto-scaling-prerequisites) bevor Sie den Stack starten.

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

**Um die Auto-Scaling-Lösung zu starten**

1. Melden Sie sich bei der [AWS Management Console](https://console.aws.amazon.com/) an und klicken Sie auf die Schaltfläche, um die `AWSAccelerator-InstallerStack` CloudFormation Vorlage zu starten.

1. Die Vorlage wird standardmäßig im Osten der USA (Nord-Virginia) gestartet. Um die Lösung in einer anderen Version zu starten AWS-Region, verwenden Sie die Regionsauswahl in der Navigationsleiste der Konsole.

1. Vergewissern Sie sich auf der Seite **Stack erstellen**, dass sich die Vorlagen-URL im Textfeld **Amazon S3 S3-URL** befindet, und wählen Sie **Weiter**.

1. Weisen Sie Ihrem **Lösungsstapel auf der Seite „Stack-Details angeben**“ einen Namen zu.

1. Überprüfen Sie unter **Parameter** die Parameter für diese Lösungsvorlage und ändern Sie sie nach Bedarf. Diese Lösung verwendet die folgenden Standardwerte.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/athena/latest/ug/capacity-management-automatically-adjust-capacity.html)
**Anmerkung**  
Alle DPU-Werte müssen ein Vielfaches von 4 sein, um die Kapazitätsreservierungsanforderungen von Athena zu erfüllen.

1. Wählen Sie **Weiter** aus.

1. Wählen Sie auf der Seite **Configure stack options** (Stack-Optionen konfigurieren) **Next** (Weiter) aus.

1. **Überprüfen und bestätigen Sie auf der Seite Überprüfen und erstellen** die Einstellungen. Aktivieren Sie das Kästchen, um zu bestätigen, dass die Vorlage möglicherweise IAM-Ressourcen erstellt.

1. Wählen Sie **Submit**, um den Stack bereitzustellen.

   Sie können den Status des Stacks in der CloudFormation Konsole in der Spalte **Status einsehen**. Sie sollten in ein paar Minuten einen `CREATE_COMPLETE` Status erhalten.

# Reservierungen verwalten
<a name="capacity-management-managing-reservations"></a>

Sie können Ihre Kapazitätsreservierungen auf der Seite **Kapazitätsreservierungen** einsehen und verwalten. Sie können Verwaltungsaufgaben wie Hinzufügen oder Reduzieren DPUs, Ändern von Arbeitsgruppenzuweisungen und Markieren oder Stornieren von Reservierungen ausführen.

**So zeigen Sie Kapazitätsreservierungen an und verwalten sie**

1. Öffnen Sie die Athena-Konsole unter [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Wenn der Navigationsbereich in der Konsole nicht sichtbar ist, wählen Sie das Erweiterungsmenü auf der linken Seite.

1. Wählen Sie **Administration**, **Kapazitätsreservierungen** aus.

1. Auf der Seite Kapazitätsreservierungen können Sie die folgenden Aufgaben ausführen:
   + Um eine Kapazitätsreservierung zu erstellen, wählen Sie **Kapazitätsreservierung erstellen**.
   + Verwenden Sie das Suchfeld, um Reservierungen nach Namen oder Anzahl von zu filtern. DPUs
   + Wählen Sie das Status-Dropdown-Menü, um nach dem Status der Kapazitätsreservierung zu filtern (z. B. **Aktiv** oder **Storniert**). Weitere Informationen zum Reservierungsstatus finden Sie unter [Reservierungsstatus verstehen](#capacity-management-understanding-reservation-status).
   + Um Details zu einer Kapazitätsreservierung anzuzeigen, wählen Sie den Link für die Reservierung. Die Detailseite für die Reservierung enthält Optionen zum [Bearbeiten von Kapazitäten](capacity-management-editing-capacity-reservations.md), zum [Hinzufügen von Arbeitsgruppen](capacity-management-adding-workgroups-to-a-reservation.md), zum [Entfernen von Arbeitsgruppen](capacity-management-removing-a-workgroup-from-a-reservation.md) und zum [Abbrechen](capacity-management-cancelling-a-capacity-reservation.md) der Reservierung.
   + Um eine Reservierung zu bearbeiten (z. B. durch Hinzufügen oder Entfernen DPUs), klicken Sie auf die Schaltfläche für die Reservierung und wählen Sie dann **Bearbeiten**.
   + Um eine Reservierung zu stornieren, klicken Sie auf die Schaltfläche für die Reservierung und wählen Sie dann **Abbrechen**.

## Reservierungsstatus verstehen
<a name="capacity-management-understanding-reservation-status"></a>

Die folgende Tabelle beschreibt die möglichen Statuswerte für eine Kapazitätsreservierung.


****  

| Status | Description | 
| --- | --- | 
| Ausstehend | Athena bearbeitet Ihre Kapazitätsanfrage. Kapazität ist nicht bereit, Abfragen auszuführen. | 
| Aktiv | Kapazität ist verfügbar, um Abfragen auszuführen. | 
| Fehlgeschlagen | Ihre Kapazitätsanfrage wurde nicht erfolgreich abgeschlossen. Beachten Sie, dass die Erfüllung von Kapazitätsanfragen nicht garantiert werden kann. Fehlgeschlagene Reservierungen werden auf die DPU-Limits Ihres Kontos angerechnet. Um die Nutzung freizugeben, müssen Sie die Reservierung abbrechen. | 
| Aktualisierung ausstehend | Athena bearbeitet gerade eine Änderung der Reservierung. Dieser Status wird beispielsweise angezeigt, nachdem Sie die Reservierung bearbeitet haben, um sie hinzuzufügen oder zu entfernen DPUs. | 
| Abbrechen | Athena bearbeitet eine Anfrage zur Stornierung der Reservierung. Abfragen, die in den Arbeitsgruppen, die die Reservierung verwendet haben, noch ausgeführt werden, können abgeschlossen werden, aber andere Abfragen in der Arbeitsgruppe verwenden On-Demand-Kapazität (nicht bereitgestellte). | 
| Abgebrochen |  Die Stornierung der Kapazitätsreservierung ist abgeschlossen. Stornierte Reservierungen bleiben 45 Tage lang in der Konsole. Nach 45 Tagen löscht Athena die Reservierung. Während der 45 Tage können Sie die Reservierung nicht wiederverwenden oder anderweitig verwenden. Sie können jedoch anhand der zugehörigen Tags die Details einsehen, um historische Informationen zu erhalten. Es kann nicht garantiert werden, dass stornierte Kapazitäten zu einem zukünftigen Zeitpunkt erneut reserviert werden können. Kapazität kann nicht auf eine andere Reservierung übertragen werden, AWS-Konto oder AWS-Region.   | 

## Verstehen Sie Active DPUs und Target DPUs
<a name="capacity-management-understanding-dpu-status"></a>

In der Liste der Kapazitätsreservierungen in der Athena-Konsole werden für Ihre Reservierung zwei DPU-Werte angezeigt: **Aktive DPU** und **Ziel-DPU**.
+ **Aktive DPU** — Die Anzahl der DPU DPUs , die in Ihrer Reservierung zur Ausführung von Abfragen verfügbar sind. **Wenn Sie beispielsweise 100 DPUs anfordern und Ihre Anfrage erfüllt ist, zeigt **Active DPU** 100 an.**
+ **Ziel-DPU** — Die Nummer, auf DPUs die Ihre Reservierung gerade umgestellt wird. Die **Ziel-DPU** zeigt einen anderen Wert als die **aktive DPU** an, wenn eine Reservierung erstellt wird oder eine Erhöhung oder Verringerung der Anzahl DPUs ausstehender Reservierungen noch aussteht.

**Wenn Sie beispielsweise eine Anfrage zur Erstellung einer Reservierung mit 24 eingereicht haben DPUs, lautet der **Reservierungsstatus** **Ausstehend**, der **aktive DPU** ist **0** und der **Ziel-DPU** ist 24.**

**Wenn Sie eine Reservierung mit 100 haben und Ihre Reservierung bearbeiten DPUs, um eine Erhöhung um 20 zu beantragen DPUs, lautet der **Status** **Aktualisierung ausstehend**, der **aktive DPU lautet** **100** und der **Ziel-DPU** ist 120.**

**Wenn Sie eine Reservierung mit 100 haben und Ihre Reservierung bearbeiten DPUs, um eine Minderung um 20 zu beantragen DPUs, lautet der **Status** **Aktualisierung ausstehend**, die **aktive DPU** ist **100** und die **Ziel-DPU** ist 80.**

Während dieser Übergänge arbeitet Athena aktiv daran, die Anzahl der auf Ihre Anfrage DPUs basierenden zu erwerben oder zu reduzieren. Wenn die **aktive DPU** der **Ziel-DPU** entspricht, wurde die Zielzahl erreicht und es stehen keine Änderungen mehr aus.

Um diese Werte programmgesteuert abzurufen, können Sie die [GetCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetCapacityReservation.html)API-Aktion aufrufen. Die API bezeichnet **aktive DPU** und **Ziel-DPU** als `AllocatedDpus` und `TargetDpus`.

**Topics**
+ [Reservierungsstatus verstehen](#capacity-management-understanding-reservation-status)
+ [Verstehen Sie Active DPUs und Target DPUs](#capacity-management-understanding-dpu-status)
+ [Kapazitätsreservierungen bearbeiten](capacity-management-editing-capacity-reservations.md)
+ [Arbeitsgruppen zu einer Reservierung hinzufügen](capacity-management-adding-workgroups-to-a-reservation.md)
+ [Eine Arbeitsgruppe aus einer Reservierung entfernen](capacity-management-removing-a-workgroup-from-a-reservation.md)
+ [Eine Kapazitätsreservierung abbrechen](capacity-management-cancelling-a-capacity-reservation.md)
+ [Eine Kapazitätsreservierung löschen](capacity-management-deleting-a-capacity-reservation.md)

# Kapazitätsreservierungen bearbeiten
<a name="capacity-management-editing-capacity-reservations"></a>

Nachdem Sie eine Kapazitätsreservierung erstellt haben, können Sie deren Anzahl anpassen DPUs und ihre benutzerdefinierten Tags hinzufügen oder entfernen.

**So bearbeiten Sie eine Kapazitätsreservierung**

1. Öffnen Sie die Athena-Konsole unter [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Wenn der Navigationsbereich in der Konsole nicht sichtbar ist, wählen Sie das Erweiterungsmenü auf der linken Seite.

1. Wählen Sie **Administration**, **Kapazitätsreservierungen** aus.

1. Führen Sie in der Liste der Kapazitätsreservierungen einen der folgenden Schritte aus:
   + Wählen Sie die Schaltfläche neben dem Katalognamen und anschließend **Bearbeiten** aus.
   + Wählen Sie den Reservierungslink und dann **Bearbeiten** aus.

1. Wählen Sie für **DPU** die Anzahl der gewünschten Datenverarbeitungseinheiten aus, oder geben Sie sie ein. Weitere Informationen finden Sie unter [Verstehen DPUs](capacity-management.md#capacity-management-understanding-dpus).
**Anmerkung**  
Sie können jederzeit eine Erweiterung DPUs einer aktiven Kapazitätsreservierung beantragen.
Sie können eine Reduzierung DPUs von einer aktiven Kapazitätsreservierung beantragen, wenn 1 Minute vergangen ist, seit die Reservierung aktiv wurde oder zuletzt hinzugefügt wurde. DPUs 
Wenn Sie eine Reduzierung beantragen DPUs, priorisiert Athena das Entfernen von Idle DPUs vor dem Entfernen von Active. DPUs Wenn Abfragen aufwändig sind DPUs , die zum Entfernen markiert sind, wartet Athena, bis die Abfragen abgeschlossen sind, bevor sie die entfernt. DPUs 

1. (Optional) Wählen Sie bei **Tags** die Option **Entfernen**, um ein Tag zu entfernen, oder wählen Sie **Neues Tag hinzufügen**, um ein neues Tag hinzuzufügen.

1. Wählen Sie **Absenden** aus. Die Detailseite für die Reservierung zeigt die aktualisierte Konfiguration.

# Arbeitsgruppen zu einer Reservierung hinzufügen
<a name="capacity-management-adding-workgroups-to-a-reservation"></a>

Nachdem Sie eine Kapazitätsreservierung erstellt haben, können Sie der Reservierung bis zu 20 Arbeitsgruppen hinzufügen. Das Hinzufügen einer Arbeitsgruppe zu einer Reservierung teilt Athena mit, welche Abfragen auf Ihrer reservierten Kapazität ausgeführt werden sollen. Abfragen von Arbeitsgruppen, die keiner Reservierung zugeordnet sind, werden weiterhin mit dem standardmäßigen Preismodell pro gescanntem Terabyte (TB) ausgeführt.

Wenn eine Reservierung zwei oder mehr Arbeitsgruppen umfasst, können Abfragen von diesen Arbeitsgruppen die Kapazität der Reservierung beanspruchen. Sie können Arbeitsgruppen jederzeit hinzufügen oder entfernen. Wenn Sie Arbeitsgruppen hinzufügen oder entfernen, werden laufende Abfragen nicht unterbrochen.

Wenn sich Ihre Reservierung im Status „Ausstehend“ befindet, werden Abfragen von Arbeitsgruppen, die Sie hinzugefügt haben, weiterhin mit dem Standardpreismodell pro gescanntem Terabyte (TB) ausgeführt, bis die Reservierung aktiv wird.

**Um Ihrer Kapazitätsreservierung eine oder mehrere Arbeitsgruppen hinzuzufügen**

1. Wählen Sie auf der Detailseite für die Kapazitätsreservierung die Option **Arbeitsgruppen hinzufügen** aus.

1. Wählen Sie auf der Seite **Arbeitsgruppen hinzufügen** die Arbeitsgruppen aus, die Sie hinzufügen möchten, und klicken Sie dann auf **Arbeitsgruppen hinzufügen**. Sie können eine Arbeitsgruppe nicht mehr als einer Reservierung zuordnen.

   Auf der Detailseite für Ihre Kapazitätsreservierung sind die Arbeitsgruppen aufgeführt, die Sie hinzugefügt haben. Abfragen, die in diesen Arbeitsgruppen ausgeführt werden, verwenden die Kapazität, die Sie reserviert haben, wenn die Reservierung aktiv ist.

# Eine Arbeitsgruppe aus einer Reservierung entfernen
<a name="capacity-management-removing-a-workgroup-from-a-reservation"></a>

Wenn Sie keine dedizierte Kapazität länger benötigen oder eine Arbeitsgruppe dementsprechend nicht länger benötigen, können Sie sie jederzeit entfernen. Das Entfernen einer Arbeitsgruppe aus einer Reservierung ist ein unkomplizierter Vorgang. Nachdem Sie eine Arbeitsgruppe aus einer Reservierung entfernt haben, nutzen Anfragen aus der entfernten Arbeitsgruppe wieder Kapazitäten auf Abruf und werden auf der Grundlage der gescannten Terabyte (TB) abgerechnet.

**So entfernen Sie eine oder mehrere Arbeitsgruppen aus einer Reservierung**

1. Wählen Sie auf der Detailseite für die Kapazitätsreservierung die Arbeitsgruppen aus, die Sie entfernen möchten.

1. Wählen Sie **Arbeitsgruppen entfernen**. Die Eingabeaufforderung **Arbeitsgruppen entfernen?** informiert Sie darüber, dass alle derzeit aktiven Abfragen beendet werden müssen, bevor die Arbeitsgruppe aus der Reservierung entfernt wird.

1. Wählen Sie **Remove (Entfernen)** aus. Auf der Detailseite für Ihre Kapazitätsreservierung wird angezeigt, dass die entfernten Arbeitsgruppen nicht mehr vorhanden sind.

# Eine Kapazitätsreservierung abbrechen
<a name="capacity-management-cancelling-a-capacity-reservation"></a>

Wenn Sie eine Kapazitätsreservierung nicht länger benötigen, können Sie sie abbrechen. Abfragen, die noch in den Arbeitsgruppen laufen, die die Reservierung verwendet haben, können beendet werden, aber andere Abfragen in der Arbeitsgruppe verwenden die Reservierung nicht mehr.

**Anmerkung**  
Es kann nicht garantiert werden, dass stornierte Kapazitäten zu einem zukünftigen Zeitpunkt erneut reserviert werden können. Kapazität kann nicht auf eine andere Reservierung übertragen werden, oder. AWS-Konto AWS-Region

**So stornieren Sie eine Kapazitätsreservierung**

1. Öffnen Sie die Athena-Konsole unter [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Wenn der Navigationsbereich in der Konsole nicht sichtbar ist, wählen Sie das Erweiterungsmenü auf der linken Seite.

1. Wählen Sie **Administration**, **Kapazitätsreservierungen** aus.

1. Führen Sie in der Liste der Kapazitätsreservierungen einen der folgenden Schritte aus:
   + Wählen Sie die Schaltfläche neben dem Katalognamen und anschließend **Bearbeiten** aus.
   + Wählen Sie den Link zur Reservierung und wählen Sie dann **Kapazitätsreservierung abbrechen**.

1. Unter **Kapazitätsreservierung abbrechenen?** Geben Sie in der Befehlszeile **Abbrechen** ein und wählen Sie dann **Kapazitätsreservierung abbbrechen** aus.

   Der Status der Reservierung ändert sich in **Storniere**, und ein Fortschrittsbanner informiert Sie darüber, dass die Stornierung im Gange ist.

   Wenn die Stornierung abgeschlossen ist, bleibt die Kapazitätsreservierung bestehen, ihr Status wird jedoch als **Storniert** angezeigt. Die Reservierung wird 45 Tage nach der Stornierung gelöscht. Während der 45 Tage können Sie die beendete Reservierung nicht wiederverwenden oder anderweitig verwenden. Sie können jedoch anhand der zugehörigen Tags die Details einsehen, um historische Informationen zu erhalten.

# Eine Kapazitätsreservierung löschen
<a name="capacity-management-deleting-a-capacity-reservation"></a>

Wenn Sie alle Verweise auf eine stornierte Kapazitätsreservierung entfernen möchten, können Sie die Reservierung löschen. Eine Reservierung muss storniert werden, bevor sie gelöscht werden kann. Eine gelöschte Reservierung wird sofort aus Ihrem Konto entfernt und kann nicht mehr referenziert werden, auch nicht anhand ihres ARN.

**So löschen Sie eine Kapazitätsreservierung**

1. Öffnen Sie die Athena-Konsole unter [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Wenn der Navigationsbereich in der Konsole nicht sichtbar ist, wählen Sie das Erweiterungsmenü auf der linken Seite.

1. Wählen Sie **Administration**, **Kapazitätsreservierungen** aus.

1. Führen Sie in der Liste der Kapazitätsreservierungen einen der folgenden Schritte aus:
   + Wählen Sie die Schaltfläche neben dem Katalognamen und anschließend **Aktionen**, **Löschen** aus.
   + Wählen Sie den Reservierungslink und dann **Löschen** aus.

1. Bei der Eingabeaufforderung **Kapazitätsreservierung löschen?**, wählen Sie** Löschen**.

   Ein Banner informiert Sie darüber, dass die Kapazitätsreservierung erfolgreich gelöscht wurde. Die gelöschte Reservierung erscheint nicht mehr in der Liste der Kapazitätsreservierungen.

# IAM-Richtlinien für Kapazitätsreservierungen
<a name="capacity-reservations-iam-policy"></a>

Verwenden Sie zur Steuerung des Zugriffs auf Kapazitätsreservierungen IAM-Berechtigungen auf Ressourcenebene oder identitätsbasierte IAM-Richtlinien. Wenn Sie IAM-Richtlinien verwenden, stellen Sie sicher, dass Sie die bewährten IAM-Methoden befolgen. Weitere Informationen finden Sie unter [Bewährte Methoden für die Sicherheit in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) im *IAM-Benutzerhandbuch*.

Das folgende Verfahren gilt speziell für Athena. 

IAM-spezifische Informationen finden Sie unter den Links am Ende dieses Abschnitts. Weitere Informationen zu JSON-Kapazitätsreservierungsrichtlinien finden Sie unter [Beispiele für Kapazitätsreservierungs-Richtlinien](example-policies-capacity-reservations.md).

**Verwenden Sie den visuellen Editor in der IAM-Konsole, um eine Kapazitätsreservierungsrichtlinie zu erstellen**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Wählen Sie im Navigationsbereich auf der linken Seite **Policies** (Richtlinien) und dann **Create Policy** (Richtlinie erstellen) aus.

1. Wählen Sie auf der Registerkarte **Visual editor** (Visueller Editor) die Option **Choose a service** (Wählen Sie einen Service) aus. Wählen Sie dann Athena aus, um es der Richtlinie hinzuzufügen.

1. Wählen Sie **Select actions** (Aktionen auswählen) und dann die Aktionen aus, die Sie der Richtlinie hinzufügen möchten. Im visuellen Editor werden die in Athena verfügbaren Aktionen angezeigt. Weitere Informationen finden Sie unter [Aktionen, Ressourcen und Bedingungsschlüssel für Amazon Athena](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonathena.html) in der *Service-Autorisierungs-Referenz*.

1. Wählen Sie **Aktionen hinzufügen** aus, um eine bestimmte Aktion einzugeben, oder verwenden Sie Platzhalter (\$1), um mehrere Aktionen anzugeben. 

   Standardmäßig lässt die Richtlinie, die Sie erstellen, die Aktionen zu, die Sie auswählen. Wenn Sie eine oder mehrere Aktionen auswählen, die Berechtigungen auf Ressourcenebene für die `capacity-reservation`-Ressource in Athena unterstützen, listet der Editor die `capacity-reservation`-Ressource auf. 

1. Wählen Sie **Ressourcen** aus, um die Kapazitätsreservierungen für Ihre Richtlinie festzulegen. Beispiele für JSON-Kapazitätsreservierungsrichtlinien finden Sie unter [Beispiele für Kapazitätsreservierungs-Richtlinien](example-policies-capacity-reservations.md).

1. Geben Sie die `capacity-reservation`-Ressource wie folgt an:

   ```
   arn:aws:athena:<region>:<user-account>:capacity-reservation/<capacity-reservation-name>
   ```

1. Wählen Sie **Review policy (Richtlinie prüfen)** aus und geben Sie **Name** und **Description (Beschreibung)** (optional) für die zu erstellende Richtlinie ein. Prüfen Sie die Richtlinienübersicht, um sicherzustellen, dass Sie die beabsichtigten Berechtigungen erteilt haben. 

1. Wählen Sie **Create policy** (Richtlinie erstellen) aus, um Ihre neue Richtlinie zu speichern.

1. Hängen Sie diese identitätsbasierte Richtlinie an einen Benutzer, eine Gruppe oder eine Rolle an.

Weitere Informationen finden Sie in den folgenden Themen in der *Service Authorization Reference* und im *IAM-Benutzerhandbuch*:
+  [Aktionen, Ressourcen und Bedingungsschlüssel für Amazon Athena](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonathena.html) 
+  [Erstellen von Richtlinien mit dem visuellen Editor](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-visual-editor) 
+  [Hinzufügen und Entfernen von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) 
+  [Steuern des Zugriffs auf Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_controlling.html#access_controlling-resources) 

Beispiele für JSON-Kapazitätsreservierungsrichtlinien finden Sie unter [Beispiele für Kapazitätsreservierungs-Richtlinien](example-policies-capacity-reservations.md).

Eine vollständige Liste mit Amazon-Athena-Aktionen finden Sie unter den Namen von API-Aktionen in der [Amazon-Athena-API-Referenz](https://docs.aws.amazon.com/athena/latest/APIReference/). 

# Beispiele für Kapazitätsreservierungs-Richtlinien
<a name="example-policies-capacity-reservations"></a>

Dieser Abschnitt enthält Beispielrichtlinien, mit denen Sie verschiedene Aktionen für Kapazitätsreservierungen aktivieren können. Wenn Sie IAM-Richtlinien verwenden, stellen Sie sicher, dass Sie die bewährten IAM-Methoden befolgen. Weitere Informationen finden Sie unter [Bewährte Methoden für die Sicherheit in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) im *IAM-Benutzerhandbuch*.

Eine Kapazitätsreservierung ist eine IAM-Ressource, die von Athena verwaltet wird. Wenn Ihre Kapazitätsreservierungsrichtlinie Aktionen verwendet, die `capacity-reservation` als Eingabe verwenden, müssen Sie daher den ARN der Kapazitätsreservierung wie folgt angeben:

```
"Resource": [arn:aws:athena:<region>:<user-account>:capacity-reservation/<capacity-reservation-name>]
```

Dabei ist `<capacity-reservation-name>` der Name Ihrer Kapazitätsreservierung. Geben Sie diesen beispielsweise für eine Kapazitätsreservierung mit dem Namen `test_capacity_reservation` wie folgt als Ressource an:

```
"Resource": ["arn:aws:athena:us-east-1:123456789012:capacity-reservation/test_capacity_reservation"]
```

Eine vollständige Liste mit Amazon-Athena-Aktionen finden Sie unter den Namen von API-Aktionen in der [Amazon-Athena-API-Referenz](https://docs.aws.amazon.com/athena/latest/APIReference/). Weitere Informationen zu IAM-Richtlinien finden Sie unter [Erstellen von Richtlinien mit dem visuellen Editor](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-visual-editor) im *IAM-Benutzerhandbuch*.

**Example Beispielrichtlinie zum Auflisten von Kapazitätsreservierungen**  
Die folgende Richtlinie ermöglicht es allen Benutzern, alle Kapazitätsreservierungen aufzulisten.    
****  

```
{ 
    "Version":"2012-10-17",		 	 	  
    "Statement": [ 
        { 
            "Effect": "Allow", 
            "Action": [ 
                "athena:ListCapacityReservations" 
            ], 
            "Resource": "*" 
        } 
    ] 
}
```

**Example Beispielrichtlinie für Verwaltungsoperationen**  
Die folgende Richtlinie ermöglicht es einem Benutzer, die Kapazitätsreservierung `test_capacity_reservation` zu erstellen, abzubrechen, Details abzurufen und zu aktualisieren. Die Richtlinie ermöglicht es einem Benutzer auch, Zuweisungen `workgroupA` und `workgroupB` zu `test_capacity_reservation` zuzuweisen.    
****  

```
{ 
   "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" 
         ] 
      } 
   ] 
}
```

# Athena-Kapazitätsreservierung APIs
<a name="capacity-management-api-list"></a>

Die folgende Liste enthält Referenzlinks zu den Athena-Kapazitätsreservierungs-API-Aktionen. Datenstrukturen und andere Athena-API-Aktionen finden Sie in der [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) 