

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.

# Datenquellen-Konnektor aktualisieren
<a name="connectors-updating"></a>

Athena empfiehlt, die von Ihnen verwendeten Datenquellen-Konnektoren regelmäßig auf die neueste Version zu aktualisieren, um von neuen Features und Verbesserungen zu profitieren. Die Aktualisierung eines Datenquellen-Konnektors umfasst die folgenden Schritte:

## AWS Glue Data Catalog föderierte Konnektoren mit Lambda
<a name="connectors-updating-gc"></a>

### Die neueste Version von Athena-Verbundabfrage finden
<a name="connectors-updating-finding-the-latest-version"></a>

Die neueste Versionsnummer der Athena-Datenquellen-Konnektors entspricht der neuesten Version von Athena-Verbundabfrage. In bestimmten Fällen können die GitHub Versionen etwas neuer sein als die auf der AWS Serverless Application Repository (SAR) verfügbaren Versionen.

**Die neueste Versionsnummer von Athena-Verbundabfrage finden**

1. Besuchen Sie die GitHub URL [https://github.com/awslabs/aws-athena-query-federation/releases/latest](https://github.com/awslabs/aws-athena-query-federation/releases/latest).

1. Notieren Sie sich die Versionsnummer in der Überschrift der Hauptseite im folgenden Format:

   **{{year}}Version** v. {{week\_of\_year}}. {{iteration\_of\_week}}**von Athena Query Federation**

   Die Versionsnummer für **Version 2023.8.3 von Athena-Verbundabfrage** lautet beispielsweise 2023.8.3.

### Ihre Connector-Version finden
<a name="connectors-find-version"></a>

Gehen Sie wie folgt vor, um festzustellen, welche Version Ihres Connectors Sie gerade verwenden.

**Um Ihre Connector-Version zu finden**

1. Wählen Sie auf der Lambda-Konsolenseite für Ihre Lambda-Anwendung die Registerkarte **Bild** aus.

1. Suchen Sie auf der Registerkarte Bild nach der Bild-URI. Die URI hat folgendes Format:

   ```
   {{Image_location_account}}.dkr.ecr.us-west-2.amazonaws.com/athena-federation-repository:{{Version}}
   ```

1. Die Versionsnummer in der Bild-URI hat das Format `year.week_of_year.iteration_of_week` (z. B. `2021.42.1`). Diese Nummer steht für Ihre Connector-Version.

### Bereitstellen einer neuen Connector-Version
<a name="connectors-deploy-new-version"></a>

Gehen Sie wie folgt vor, um eine neue Version Ihres Konnektors bereitzustellen.

**Wie Sie die neue Connector-Version bereitstellen**

1. Finden Sie die gewünschte Version, indem Sie die Anweisungen befolgen, um die neueste Version von Athena-Verbundabfrage zu finden.

1. Suchen Sie in der Lambda-Funktion des Verbundconnectors die ImageURI und aktualisieren Sie das Tag auf die gewünschte Version. Beispiel:

   From:

   ```
   509399631660.dkr.ecr.us-east-1.amazonaws.com/athena-federation-repository:2025.15.1
   ```

   auf:

   ```
   509399631660.dkr.ecr.us-east-1.amazonaws.com/athena-federation-repository:2025.26.1
   ```

**Anmerkung**  
Wenn Ihre aktuelle Version älter als 2025.15.1 ist, beachten Sie diese wichtigen Änderungen:  
Der Repository-Name wurde aktualisiert auf `athena-federation-repository`
Für Versionen vor diesem Update ist die Befehlsüberschreibung möglicherweise nicht gesetzt. Sie müssen sie auf den Composite-Handler setzen.

## Verbundkonnektoren für den Athena-Datenkatalog
<a name="connectors-updating-legacy"></a>

### Die neueste Version von Athena-Verbundabfrage finden
<a name="connectors-updating-finding-the-latest-version-legacy"></a>

Die neueste Versionsnummer der Athena-Datenquellen-Konnektors entspricht der neuesten Version von Athena-Verbundabfrage. In bestimmten Fällen können die GitHub Versionen etwas neuer sein als die auf der AWS Serverless Application Repository (SAR) verfügbaren Versionen.

**Die neueste Versionsnummer von Athena-Verbundabfrage finden**

1. Besuchen Sie die GitHub URL [https://github.com/awslabs/aws-athena-query-federation/releases/latest](https://github.com/awslabs/aws-athena-query-federation/releases/latest).

1. Notieren Sie sich die Versionsnummer in der Überschrift der Hauptseite im folgenden Format:

   **{{year}}Version** v. {{week\_of\_year}}. {{iteration\_of\_week}}**von Athena Query Federation**

   Die Versionsnummer für **Version 2023.8.3 von Athena-Verbundabfrage** lautet beispielsweise 2023.8.3.

### Ressourcennamen suchen und notieren
<a name="connectors-updating-finding-and-noting-resource-names"></a>

Zur Vorbereitung des Upgrades müssen Sie die folgenden Informationen finden und sich diese notieren:

1. Der Lambda-Funktionsname für den Konnektor.

1. Umgebungsvariablen für die Lambda-Funktion.

1. Der Name der Lambda-Anwendung, die die Lambda-Funktion für den Konnektor verwaltet.

**Wie Sie Ressourcennamen von der Athena-Konsole aus suchen**

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.  
![Wählen Sie das Erweiterungsmenü aus.](http://docs.aws.amazon.com/de_de/athena/latest/ug/images/nav-pane-expansion.png)

1. Wählen Sie im Navigationsbereich **Datenquellen und Kataloge** aus.

1. Wählen Sie in der Spalte **Datenquellenname** den Link zur Datenquelle für Ihren Konnektor aus.

1. Wählen Sie im Abschnitt **Datenquellendetails** unter **Lambda-Funktion** den Link zu Ihrer Lambda-Funktion aus.  
![Wählen Sie den Link zu Ihrer Lambda-Funktion aus.](http://docs.aws.amazon.com/de_de/athena/latest/ug/images/connectors-updating-1.png)

1. Notieren Sie sich auf der Seite **Funktionen** in der Spalte **Funktionsname** den Funktionsnamen für Ihren Konnektor.  
![Notieren Sie sich den Funktionsnamen.](http://docs.aws.amazon.com/de_de/athena/latest/ug/images/connectors-updating-2.png)

1. Wählen Sie den Link mit dem Funktionsnamen.

1. Wählen Sie im Abschnitt **Funktionsübersicht** die Registerkarte **Konfiguration** aus.

1. Wählen Sie im Bereich auf der linken Seite **Umgebungsvariablen** aus.

1. Notieren Sie sich im Abschnitt **Umgebungsvariablen** die Schlüssel und ihre entsprechenden Werte.

1. Scrollen Sie zum Seitenanfang.

1. In der Nachricht **Diese Funktion gehört zu einer Anwendung. Klicken Sie hier, um sie zu verwalten**, und wählen Sie den Link **Hier klicken**.

1. **Notieren Sie sich auf der **serverlessrepo- {{your\_application\_name}}** Seite den Namen Ihrer Anwendung ohne serverlessrepo.** Wenn der Anwendungsname beispielsweise **serverlessrepo** - lautet, dann lautet Ihr Anwendungsname. DynamoDbTestApp **DynamoDbTestApp**

1. Bleiben Sie auf der Lambda-Konsolenseite für Ihre Anwendung und fahren Sie dann mit den Schritten unter **Suchen der Version des Konnektors fort, den Sie verwenden**.

### Finden Sie die Version des Connectors, den Sie verwenden
<a name="connectors-updating-finding-the-version-that-you-are-using"></a>

Gehen Sie folgendermaßen vor, um die Version des von Ihnen verwendeten Konnektors zu ermitteln.

**Wie Sie die Version des Konnektors, den Sie verwenden, suchen**

1. Wählen Sie auf der Konsolenseite für Ihre Lambda-Anwendung die Registerkarte **Bereitstellungen** aus.

1. Erweitern Sie auf der Registerkarte **Bereitstellungen** **SAM-Vorlage**.

1. Suchen Sie nach **CodeUri**.

1. Suchen Sie im Feld **Schlüssel** darunter nach der **CodeUri**folgenden Zeichenfolge:

   ```
   applications-{{connector_name}}-versions-{{year}}.{{week_of_year}}.{{iteration_of_week}}/{{hash_number}}
   ```

   Das folgende Beispiel zeigt eine Zeichenfolge für den CloudWatch Konnektor:

   ```
   applications-AthenaCloudwatchConnector-versions-2021.42.1/15151159...
   ```

1. Notieren Sie den Wert für{{year}}. {{week\_of\_year}}. {{iteration\_of\_week}}(zum Beispiel **2021.42.1**). Dies ist die Version für Ihren Konnektor.

### Die neue Version Ihres Konnektors bereitstellen
<a name="connectors-updating-deploying-the-new-version"></a>

Gehen Sie wie folgt vor, um eine neue Version Ihres Konnektors bereitzustellen.

**Wie Sie die neue Version Ihres Konnektors bereitstellen**

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.  
![Wählen Sie das Erweiterungsmenü aus.](http://docs.aws.amazon.com/de_de/athena/latest/ug/images/nav-pane-expansion.png)

1. Wählen Sie im Navigationsbereich **Datenquellen und Kataloge** aus.

1. Wählen Sie auf der Seite **Datenquellen und Kataloge** die Option **Datenquellen erstellen** aus.

1. Wählen Sie die Datenquelle aus, für die Sie ein Upgrade durchführen möchten, und wählen Sie dann **Weiter** aus.

1. Wählen Sie auf der Seite **Verbindungsdetails** die Option **Neue Lambda-Funktion erstellen** aus. Dadurch wird die Lambda-Konsole geöffnet, in der Sie Ihre aktualisierte Anwendung bereitstellen können.  
![Connector-Seite in der Konsole. AWS Lambda](http://docs.aws.amazon.com/de_de/athena/latest/ug/images/connectors-updating-3.png)

1. Da Sie keine neue Datenquelle erstellen, können Sie die Registerkarte Athena-Konsole schließen.

1. Führen Sie Lambda-Konsolenseite für den Konnektor die folgenden Schritte aus:

   1. Stellen Sie sicher, dass Sie das Präfix **serverlessrepo-** aus Ihrem Anwendungsnamen entfernt haben, und kopieren Sie dann den Anwendungsnamen in das Feld **Anwendungsname**.

   1. Kopieren Sie den Namen Ihrer Lambda-Funktion in das **AthenaCatalogName**Feld. Einige Konnektoren rufen dieses Feld auf **LambdaFunctionName**.

   1. Kopieren Sie die Umgebungsvariablen, die Sie aufgezeichnet haben, in die entsprechenden Felder.

1. Wählen Sie **Ich bestätige, dass diese Anwendung benutzerdefinierte IAM-Rollen und Ressourcenrichtlinien erstellt** und dann **Bereitstellen**.

1. Um zu überprüfen, ob Ihre Anwendung aktualisiert wurde, wählen Sie die Registerkarte **Bereitstellungen.**

   Im Abschnitt **Bereitstellungsverlauf** wird angezeigt, dass Ihr Update abgeschlossen ist.  
![Konnektor-Update abgeschlossen.](http://docs.aws.amazon.com/de_de/athena/latest/ug/images/connectors-updating-4.png)

1. Um die neue Versionsnummer zu bestätigen, können Sie die **SAM-Vorlage** wie zuvor erweitern und die Versionsnummer des Connectors im Feld **Schlüssel** suchen **CodeUri**und überprüfen.

Sie können jetzt Ihren aktualisierten Konnektor verwenden, um Athena-Verbundabfragen zu erstellen.