Aggiornamento di un connettore origine dati

Athena consiglia di aggiornare regolarmente i connettori di origine dati utilizzati alla versione più recente per sfruttare le nuove funzionalità e miglioramenti. Per iniziare, devi individuare il numero della versione più recente.

Come trovare la versione più recente di Athena Query Federation

Il numero di versione più recente dei connettori di origine dati di Athena Data corrisponde all'ultima versione di Athena Query Federation. In alcuni casi, le versioni di GitHub possono essere leggermente più recenti di quelle disponibili su AWS Serverless Application Repository (SAR).

Come trovare il numero di versione più recente di Athena Query Federation

1. Visita l'URL GitHub https://github.com/awslabs/aws-athena-query-federation/releases/latest.

2. Prendi nota del numero della versione nell'intestazione della pagina principale nel seguente formato:

   Rilascio v anno.week_of_year.iteration_of_week di Athena Query Federation

   Ad esempio, il numero di rilascio per la versione di rilascio v2023.8.3 di Athena Query Federation è 2023.8.3.

Individuazione e annotazione dei nomi delle risorse

Per prepararti all'aggiornamento, individua e prendi nota delle seguenti informazioni:

1. il nome della funzione Lambda del connettore.

2. Variabili di ambiente della funzione Lambda.

3. il nome dell'applicazione Lambda, che gestisce la funzione Lambda del connettore.

Come trovare i nomi delle risorse dalla console Athena

1. Aprire la console Athena all'indirizzo https://console.aws.amazon.com/athena/.

2. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.

   

3. Nel pannello di navigazione scegli Data sources (Origini dati).

4. Nella colonna Nome origine dati, seleziona il link dell'origine dati del tuo connettore.

5. Nella sezione Dettagli origine dati, in Funzione Lambda, seleziona il link alla tua funzione Lambda.

   

6. Nella pagina Funzioni, nella colonna Nome funzione, annota il nome della funzione per il connettore.

   

7. Scegli il link del nome della funzione.

8. Nella sezione Panoramica funzioni, seleziona la scheda Configurazione.

9. Nel riquadro a sinistra, seleziona Variabili di ambiente.

10. Nella sezione Variabili ambiente, prendi nota delle chiavi e dei valori corrispondenti.

11. Scorri fino alla parte superiore della pagina.

12. Nel messaggio Questa funzione appartiene a un'applicazione. Fai clic qui per gestirlo, seleziona il link Fai clic qui.

13. Nella pagina serverlessrepo-your_application_name, prendi nota del nome dell'applicazione senza serverlessrepo. Ad esempio, se il nome dell'applicazione è serverlessrepo-DynamoDbTestApp, il nome della tua applicazione sarà DynamoDbTestApp.

14. Resta sulla pagina della console Lambda dell'applicazione, quindi continua con i passaggi descritti in Individuazione della versione del connettore in uso.

Individuazione della versione del connettore in uso

Segui questi passaggi per trovare la versione del connettore in uso.

Come trovare la versione del connettore in uso

1. Nella pagina della console Lambda dell'applicazione Lambda, seleziona la scheda Implementazioni.

2. Nella scheda Distribuzioni espandi il modello SAM.

3. Cerca CodeUri.

4. Nel campo Chiave sotto CodeUri, individua la seguente stringa:

   applications-connector_name-versions-year.week_of_year.iteration_of_week/hash_number

   L'esempio seguente mostra una stringa del connettore CloudWatch:

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

5. Registra il valore per year.week_of_year.iteration_of_week (ad esempio 2021.42.1). Questa è la versione del tuo connettore.

Implementazione della nuova versione del connettore

Segui questi passaggi per implementare una nuova versione del connettore.

Come implementare una nuova versione del connettore

1. Aprire la console Athena all'indirizzo https://console.aws.amazon.com/athena/.

2. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.

   

3. Nel pannello di navigazione scegli Data sources (Origini dati).

4. Nella pagina Data sources (Origini dati), scegli Create data source (Crea origine dati).

5. Seleziona l'origine dati che intendi aggiornare, quindi seleziona Avanti.

6. Nella sezione Dettagli connessione, seleziona Crea funzione Lambda. Si apre la console Lambda dove potrai implementare l'applicazione aggiornata.

   

7. Poiché di fatto non stai creando una nuova origine dati, puoi chiudere la scheda della console Athena.

8. Nella pagina della console Lambda del connettore, esegui le seguenti operazioni:

   1. Assicurati di aver rimosso il prefisso serverlessrepo- dal nome dell'applicazione, quindi copia il nome dell'applicazione nel campo Nome applicazione.

   2. Copia il nome della funzione Lambda nel campo AthenaCatalogName. Alcuni connettori invocano questo campo LambdaFunctionName.

   3. Copia le variabili di ambiente registrate nei campi corrispondenti.

9. Seleziona l'opzione Sono consapevole che questa app crea ruoli IAM personalizzati e policy delle risorse, quindi scegli Implementa.

10. Per verificare che l'applicazione sia stata aggiornata, seleziona la scheda Implementazioni.

    La sezione Cronologia delle implementazioni mostra che l'aggiornamento è completo.

    

11. Per confermare il nuovo numero di versione, puoi espandere il modello SAM come fatto prima, individuare CodeUri e controllare il numero di versione del connettore nel campo Chiave.

Ora puoi usare il connettore aggiornato per creare query federate Athena.