Schreiben eines Datenquellen-Konnektors

Athena empfiehlt, die von Ihnen verwendeten Datenquellen-Konnektoren regelmäßig auf die neueste Version zu aktualisieren, um von neuen Features und Verbesserungen zu profitieren. Um zu beginnen, müssen Sie die neueste Versionsnummer finden.

Die neueste Version von Athena-Verbundabfrage finden

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, die auf der AWS Serverless Application Repository (SAR) verfügbar sind.

Die neueste Versionsnummer von Athena-Verbundabfrage finden

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

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

   Release v year.week_of_year.iteration_of_week of Athena Query Federation

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

Ressourcennamen finden und notieren

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

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

2. Umgebungsvariablen für die Lambda-Funktion.

3. 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/.

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

   

3. Klicken Sie im Navigationsbereich auf Data sources (Datenquellen).

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

5. Wählen Sie im Abschnitt Datenquellendetails unter Lambda-Funktion den Link zu Ihrer Lambda-Funktion aus.

   

6. Notieren Sie sich auf der Seite Funktionen in der Spalte Funktionsname den Funktionsnamen für Ihren Konnektor.

   

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

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

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

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

11. Scrollen Sie zum Seitenanfang.

12. 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.

13. Notieren Sie sich auf der Seite serverlessrepo-your_application_name den NamenIhrer Anwendung ohne serverlessrepo. Wenn der Anwendungsname beispielsweise serverlessrepo-DynamoDbTestApp lautet, dann lautet Ihr Anwendungsname DynamoDbTestApp.

14. 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.

Suchen Sie die Version des Konnektors, den Sie verwenden

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.

2. Erweitern Sie auf der Registerkarte Bereitstellungen SAM-Vorlage.

3. Suchen Sie nach CodeURI.

4. Suchen Sie im Feld Schlüssel unter CodeURI nach der 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...

5. Notieren Sie den Wert für das 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

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/.

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

   

3. Klicken Sie im Navigationsbereich auf Data sources (Datenquellen).

4. Wählen Sie auf der Seite Datenquellen die Option Datenquellen erstellen aus.

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

6. 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.

   

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

8. 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.

   2. Kopieren Sie Ihren Lambda-Funktionsnamen in das Feld AthenaCatalogName. Einige Konnektoren nennen dieses Feld LambdaFunctionName.

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

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

10. 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.

    

11. Um die neue Versionsnummer zu bestätigen, können Sie die SAM-Vorlage wie zuvor erweitern, nach CodeURI suchen und die Versionsnummer des Konnektors im Feld Schlüssel überprüfen.

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