

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Aggiornare un connettore di origine dati
<a name="connectors-updating"></a>

Athena consiglia di aggiornare regolarmente i connettori di origine dati utilizzati alla versione più recente per sfruttare le nuove funzionalità e miglioramenti. L’aggiornamento di un connettore di origine dati include i seguenti passaggi:

## AWS Glue Data Catalog connettori federati con Lambda
<a name="connectors-updating-gc"></a>

### Trovare la versione più recente di Athena Query Federation
<a name="connectors-updating-finding-the-latest-version"></a>

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 GitHub versioni 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' GitHub URL [https://github.com/awslabs/aws-athena-query-federation/releases/latest](https://github.com/awslabs/aws-athena-query-federation/releases/latest).

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

   **{{year}}Versione v.** {{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.

### Trovare la versione del proprio connettore
<a name="connectors-find-version"></a>

Seguire questi passaggi per determinare la versione del connettore in uso.

**Per trovare la versione del connettore**

1. Nella pagina della console Lambda dell’applicazione Lambda, selezionare la scheda **Immagine**.

1. Nella scheda Immagine, individuare l’URI dell’immagine. L’URI segue questo formato:

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

1. Il numero di versione nell’URI dell’immagine segue il formato `year.week_of_year.iteration_of_week` (ad esempio, `2021.42.1`). Questo numero rappresenta la versione del connettore in uso.

### Implementazione di una nuova versione del connettore
<a name="connectors-deploy-new-version"></a>

Segui questi passaggi per implementare una nuova versione del connettore.

**Per implementare una nuova versione del connettore**

1. Trovare la versione desiderata seguendo la procedura per trovare la versione più recente di Athena Query Federation.

1. Nella funzione Lambda del connettore federato, individuare l’URI dell’immagine e aggiornare il tag alla versione desiderata. Esempio:

   Da:

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

   A:

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

**Nota**  
Se la versione attualmente in uso è precedente alla 2025.15.1, bisogna tenere in considerazione queste importanti modifiche:  
Il nome del repository è stato aggiornato a `athena-federation-repository`
Per le versioni precedenti a questo aggiornamento, il comando override potrebbe non essere impostato. È necessario impostarlo sul gestore composito.

## Connettori federati del catalogo dati Athena
<a name="connectors-updating-legacy"></a>

### Trovare la versione più recente di Athena Query Federation
<a name="connectors-updating-finding-the-latest-version-legacy"></a>

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 GitHub versioni 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' GitHub URL [https://github.com/awslabs/aws-athena-query-federation/releases/latest](https://github.com/awslabs/aws-athena-query-federation/releases/latest).

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

   **{{year}}Versione v.** {{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.

### Trovare e annotare i nomi delle risorse
<a name="connectors-updating-finding-and-noting-resource-names"></a>

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

1. Il nome della funzione Lambda del connettore.

1. Variabili di ambiente della funzione Lambda.

1. Il nome dell'applicazione Lambda, che gestisce la funzione Lambda del connettore.

**Come trovare i nomi delle risorse dalla console Athena**

1. Apri la console Athena all'indirizzo [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.  
![Scegli il menu di espansione.](http://docs.aws.amazon.com/it_it/athena/latest/ug/images/nav-pane-expansion.png)

1. Nel pannello di navigazione scegliere **Origini dati e cataloghi**.

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

1. Nella sezione **Dettagli origine dati**, in **Funzione Lambda**, seleziona il link alla tua funzione Lambda.  
![Seleziona il link della funzione Lambda.](http://docs.aws.amazon.com/it_it/athena/latest/ug/images/connectors-updating-1.png)

1. Nella pagina **Funzioni**, nella colonna **Nome funzione**, annota il nome della funzione per il connettore.  
![Prendi nota del nome della funzione.](http://docs.aws.amazon.com/it_it/athena/latest/ug/images/connectors-updating-2.png)

1. Scegli il link del nome della funzione.

1. Nella sezione **Panoramica funzioni**, seleziona la scheda **Configurazione**.

1. Nel riquadro a sinistra, seleziona **Variabili di ambiente**.

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

1. Scorri fino alla parte superiore della pagina.

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

1. **Nella {{your\_application\_name}} pagina **serverlessrepo-**, prendi nota del nome dell'applicazione senza serverlessrepo.** Ad esempio, se il nome dell'applicazione è **serverlessrepo** -, il nome dell'applicazione è. DynamoDbTestApp **DynamoDbTestApp**

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

### Trovare la versione del connettore in uso
<a name="connectors-updating-finding-the-version-that-you-are-using"></a>

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

1. Nella scheda **Distribuzioni** espandi il **modello SAM**.

1. Cercare **CodeUri**.

1. Nel campo **Chiave** sotto **CodeUri**, trova la seguente stringa:

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

   L'esempio seguente mostra una stringa per il CloudWatch connettore:

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

1. Registra il valore per{{year}}. {{week\_of\_year}}. {{iteration\_of\_week}}(ad esempio, **2021.42.1**). Questa è la versione del tuo connettore.

### Implementare una nuova versione del connettore
<a name="connectors-updating-deploying-the-new-version"></a>

Segui questi passaggi per implementare una nuova versione del connettore.

**Come implementare una nuova versione del connettore**

1. Apri la console Athena all'indirizzo [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Se il pannello di navigazione della console non è visibile, scegli il menu di espansione a sinistra.  
![Scegli il menu di espansione.](http://docs.aws.amazon.com/it_it/athena/latest/ug/images/nav-pane-expansion.png)

1. Nel pannello di navigazione scegliere **Origini dati e cataloghi**.

1. Nella pagina **Origini dati e cataloghi**, scegliere **Crea origine dati**.

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

1. Nella sezione **Dettagli connessione**, seleziona **Crea funzione Lambda**. Si apre la console Lambda dove potrai implementare l'applicazione aggiornata.  
![Pagina del connettore nella console. AWS Lambda](http://docs.aws.amazon.com/it_it/athena/latest/ug/images/connectors-updating-3.png)

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

1. 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**.

   1. Copia il nome della funzione Lambda nel **AthenaCatalogName**campo. Alcuni connettori chiamano questo campo **LambdaFunctionName**.

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

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

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

   La sezione **Cronologia delle implementazioni** mostra che l'aggiornamento è completo.  
![Aggiornamento del connettore completato.](http://docs.aws.amazon.com/it_it/athena/latest/ug/images/connectors-updating-4.png)

1. Per confermare il nuovo numero di versione, puoi espandere il **modello SAM** come prima **CodeUri**, trovare e controllare il numero di versione del connettore nel campo **Chiave**.

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