Ändern von Athena-Engine-Versionen

Athena veröffentlicht gelegentlich eine neue Engine-Version, um verbesserte Leistung, Funktionalität und Code-Fehlerbehebungen bereitzustellen. Wenn eine neue Engine-Version verfügbar ist, benachrichtigt Athena Sie über die Konsole. Sie können Athena entscheiden lassen, wann ein Upgrade durchgeführt werden soll, oder manuell eine Athena-Engine-Version pro Arbeitsgruppe angeben.

Suchen der Version der Abfrage-Engine für eine Arbeitsgruppe

Sie können die Workgroups (Arbeitsgruppen) verwenden, um die aktuelle Engine-Version für jede Arbeitsgruppe zu finden.

So suchen Sie die aktuelle Engine-Version für eine beliebige Arbeitsgruppe

1. Öffnen Sie die Athena-Konsole unter https://console.aws.amazon.com/athena/.

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

   

3. Klicken Sie im Navigationsbereich der Athena-Konsole auf Workgroups (Arbeitsgruppen).

4. Suchen Sie auf der Seite Workgroups (Arbeitsgruppen) die gewünschte Arbeitsgruppe. Die Abfrage-Engine-Version-Spalte für die Arbeitsgruppe zeigt die Version der Abfrage-Engine an.

Ändern der Engine-Version in der Athena-Konsole

Wenn eine neue Engine-Version verfügbar ist, können Sie Athena entscheiden lassen, wann die Arbeitsgruppe aktualisiert werden soll, oder manuell die Athena-Engine-Version angeben, die von der Arbeitsgruppe verwendet wird. Wenn derzeit nur eine Version verfügbar ist, ist die manuelle Angabe einer anderen Version nicht möglich.

Anmerkung

Um die Engine-Version für eine Arbeitsgruppe zu ändern, benötigen Sie die Berechtigung zum Ausführen der athena:ListEngineVersions-Aktion für die Arbeitsgruppe. Beispiele für IAM Richtlinien finden Sie unterBeispiel-Arbeitsgruppenrichtlinien.

Athena entscheiden lassen, wann die Arbeitsgruppe aktualisiert werden soll

1. Öffnen Sie die Athena-Konsole unter https://console.aws.amazon.com/athena/.

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

3. Klicken Sie im Navigationsbereich der Konsole auf Workgroups (Arbeitsgruppen).

4. Wählen Sie in der Liste der Arbeitsgruppen den Link für die Arbeitsgruppe aus, den sie konfigurieren möchten.

5. Wählen Sie Edit (Bearbeiten).

6. Wählen Sie im Abschnitt Version der Abfrage-Engine für Abfrage-Engine aktualisieren die Option Automatisch aus, damit Athena auswählen kann, wann Ihre Arbeitsgruppe aktualisiert werden soll. Dies ist die Standardeinstellung.

7. Wählen Sie Save Changes (Änderungen speichern).

   In der Liste der Arbeitsgruppen zeigt der Query engine update status (Aktualisierungsstatus des Abfrage-Engines) für die Arbeitsgruppe Automatic (Automatisch) an.

So wählen Sie manuell eine Engine-Version

1. Öffnen Sie die Athena-Konsole unter https://console.aws.amazon.com/athena/.

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

3. Klicken Sie im Navigationsbereich der Konsole auf Workgroups (Arbeitsgruppen).

4. Wählen Sie in der Liste der Arbeitsgruppen den Link für die Arbeitsgruppe aus, den sie konfigurieren möchten.

5. Wählen Sie Edit (Bearbeiten).

6. Wählen Sie im Abschnitt Query engine version (Abfrage-Engine-Version) für Update query engine (Abfrage-Engine aktualisieren) die Option Manual (Manuell), um manuell eine Engine-Version auszuwählen.

7. Verwenden Sie die Option, Abfrage-Engine-Version, um die Engine-Version auszuwählen, die die Arbeitsgruppe verwenden soll. Wenn eine andere Engine-Version nicht verfügbar ist, kann keine andere Engine-Version angegeben werden.

8. Wählen Sie Save Changes (Änderungen speichern).

   In der Liste der Arbeitsgruppen zeigt der Query engine update status (Aktualisierungsstatus des Abfrage-Engines) für die Arbeitsgruppe Manual (Manuell) an.

Ändern der Engine-Version mit dem AWS CLI

Verwenden Sie die Syntax im folgenden Beispiel AWS CLI, um die Engine-Version mithilfe von zu ändern.

aws athena update-work-group --work-group workgroup-name --configuration-updates EngineVersion={SelectedEngineVersion='Athena engine version 3'}

Angeben der Engine-Version beim Erstellen einer Arbeitsgruppe

Wenn Sie eine Arbeitsgruppe erstellen, können Sie die von der Arbeitsgruppe verwendete Engine-Version angeben oder Athena entscheiden lassen, wann die Arbeitsgruppe aktualisiert werden soll. Wenn eine neue Engine-Version verfügbar ist, besteht eine bewährte Methode darin, eine Arbeitsgruppe zu erstellen, um die neue Engine zu testen, bevor Sie die anderen Arbeitsgruppen aktualisieren. Um die Engine-Version für eine Arbeitsgruppe anzugeben, müssen Sie über die athena:ListEngineVersions-Berechtigung für die Arbeitsgruppe verfügen. Beispiele für IAM Richtlinien finden Sie unterBeispiel-Arbeitsgruppenrichtlinien.

So geben Sie die Engine-Version beim Erstellen einer Arbeitsgruppe an

1. Öffnen Sie die Athena-Konsole unter https://console.aws.amazon.com/athena/.

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

3. Klicken Sie im Navigationsbereich der Konsole auf Workgroups (Arbeitsgruppen).

4. Wählen Sie auf der Seite Workgroups (Arbeitsgruppen) die Option Create workgroup (Arbeitsgruppe erstellen) aus.

5. Führen Sie auf der Seite Create workgroup (Arbeitsgruppe erstellen) im Abschnitt Query engine version (Version der Abfrage-Engine) einen der folgenden Schritte aus:

   • Wählen Sie Automatisch aus, damit Athena entscheiden kann, wann Ihre Arbeitsgruppe aktualisiert werden soll. Dies ist die Standardeinstellung.

   • Wählen Sie Manual (Manuell), um manuell eine andere Engine-Version auszuwählen, falls eine verfügbar ist.

6. Geben Sie bei Bedarf Informationen für die anderen Felder ein. Informationen zu den anderen Feldern finden Sie unter Erstellen von Arbeitsgruppen.

7. Wählen Sie Create workgroup (Arbeitsgruppe erstellen) aus.

Testen von Abfragen im Voraus eines Engine-Versions-Upgrades

Wenn eine Arbeitsgruppe auf eine neue Engine-Version aktualisiert wird, können einige Ihrer Abfragen aufgrund von Inkompatibilitäten unterbrochen werden. Um sicherzustellen, dass das Upgrade der Engine-Version reibungslos funktioniert, können Sie Ihre Abfragen im Voraus testen.

So testen Sie Ihre Abfragen vor einem Upgrade der Engine-Version

1. Überprüfen Sie, ob die Engine-Version der Arbeitsgruppe verwendet wird. Die von Ihnen verwendete Engine-Version wird auf der Workgroups (Arbeitsgruppen)-Seite in der Query engine version (Abfrage-Engine-Version)-Spalte für die Arbeitsgruppe angezeigt. Weitere Informationen finden Sie unter Suchen der Version der Abfrage-Engine für eine Arbeitsgruppe.

2. Erstellen Sie eine Testarbeitsgruppe, die die neue Engine-Version verwendet. Weitere Informationen finden Sie unter Angeben der Engine-Version beim Erstellen einer Arbeitsgruppe.

3. Verwenden Sie die neue Arbeitsgruppe, um die Abfragen auszuführen, die Sie testen möchten.

4. Wenn eine Abfrage fehlschlägt, überprüfen Sie, ob das neue Modul fehlerhafte Änderungen enthält, die sich auf die Abfrage auswirken könnten. Einige Änderungen erfordern möglicherweise, dass Sie die Syntax Ihrer Abfragen aktualisieren.

5. Wenn Ihre Abfragen immer noch fehlschlagen, wenden Sie sich an, AWS Support um Unterstützung zu erhalten. Wählen Sie in der AWS Management ConsoleSupport, Supportcenter, oder stellen Sie eine Frage zu AWS re:Post, indem Sie das Amazon-Athena-Tag verwenden.

Fehlerbehebung bei Abfragen, die fehlschlagen

Wenn eine Abfrage nach einem Upgrade der Engine-Version fehlschlägt, suchen Sie nach grundlegenden Änderungen, einschließlich Änderungen, die sich auf die Syntax in Ihren Abfragen auswirken können.

Wenn Ihre Abfragen immer noch fehlschlagen, wenden Sie sich an uns, AWS Support um Unterstützung zu erhalten. Wählen Sie im Support AWS Management Console, Support Center oder stellen Sie mithilfe des Amazon Athena Athena-Tags eine Frage zu AWS re:POST.