

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

# Esportazione di dati da un Cluster DB Aurora PostgreSQL ad Amazon S3

È possibile eseguire query sui dati da del cluster di database Aurora PostgreSQLRDS per PostgreSQL ed esportarli direttamente in file memorizzati in un bucket Amazon S3. A questo scopo, installa innanzitutto l'estensione Aurora PostgreSQL `aws_s3`. Questa estensione fornisce le funzioni utilizzate per esportare i risultati delle quey in Amazon S3. Di seguito, sono disponibili informazioni su come installare l'estensione ed esportare i dati in Amazon S3. 

Puoi esportare da un'istanza database con provisioning o Aurora serverless. Questi passaggi non sono supportati per Aurora Serverless v1. 

Tutte le versioni attualmente disponibili di Aurora PostgreSQL supportano l'esportazione dei dati in Servizio di archiviazione semplice Amazon. Per informazioni dettagliate sulla versione, consulta gli [aggiornamenti di Amazon Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraPostgreSQLReleaseNotes/AuroraPostgreSQL.Updates.html) nelle *Note di rilascio di Aurora PostgreSQL*.

Se non disponi di un bucket configurato per l'esportazione, consulta i seguenti argomenti nella *Guida per l'utente di Servizio di archiviazione semplice Amazon*. 
+ [Configurazione di Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/setting-up-s3.html)
+ [Creare un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)

Per impostazione predefinita, i dati esportati da Aurora PostgreSQL ad Amazon S3 utilizzano la crittografia lato server con Chiave gestita da AWS. In alternativa, è possibile utilizzare la chiave gestita dal cliente che è già stata creata. Se utilizzi la crittografia a bucket, il bucket Amazon S3 deve essere crittografato con AWS Key Management Service (AWS KMS) chiave (SSE-KMS). Attualmente, bucket crittografati con chiavi gestite da Amazon S3 (SSE-S3) non sono supportati. 

**Nota**  
È possibile salvare i dati degli snapshot del DB e del cluster DB in Amazon S3 utilizzando Console di gestione AWS, AWS CLI o API Amazon RDS. Per ulteriori informazioni, consulta [Esportazione dei dati dello snapshot del cluster di database in Amazon S3](aurora-export-snapshot.md).

**Topics**
+ [Installazione dell'estensione aws\_s3](#USER_PostgreSQL.S3Export.InstallExtension)
+ [Aggiornamento dell'estensione aws\_s3](#postgresql-s3-export-upgrade)
+ [Panoramica dell'esportazione di dati in Amazon S3](#postgresql-s3-export-overview)
+ [Specifica del percorso del file Amazon S3 in cui eseguire l'esportazione](#postgresql-s3-export-file)
+ [Configurazione dell'accesso a un bucket Amazon S3](postgresql-s3-export-access-bucket.md)
+ [Esportazione dei dati della query utilizzando la funzione aws\_s3.query\_export\_to\_s3](postgresql-s3-export-examples.md)
+ [Informazioni di riferimento sulle funzioni](postgresql-s3-export-functions.md)
+ [Risoluzione dei problemi di accesso a Amazon S3](postgresql-s3-export-troubleshoot.md)

## Installazione dell'estensione aws\_s3
<a name="USER_PostgreSQL.S3Export.InstallExtension"></a>

Prima di poter utilizzare Servizio di archiviazione semplice Amazon con il cluster database Aurora PostgreSQL, è necessario installare l'estensione `aws_s3`. Questa estensione fornisce funzioni per l'esportazione di dati dall'istanza di scrittura di un cluster database Aurora PostgreSQL in un bucket Amazon S3. Fornisce inoltre funzioni per l'importazione dei dati da Amazon S3. Per ulteriori informazioni, consulta [Importazione di dati da Amazon S3 in un Cluster DB Aurora PostgreSQL](USER_PostgreSQL.S3Import.md). L'estensione `aws_s3` dipende da alcune delle funzioni helper nell'estensione `aws_commons`, che vengono installate automaticamente quando necessario. 

**Per installare `aws_s3` estensione**

1. Usa psql (o pgAdmin) per connetterti all'istanza di scrittura del cluster database Aurora PostgreSQL come un utente che dispone di privilegi `rds_superuser`. Se hai mantenuto il nome predefinito durante il processo di configurazione, esegui la connessione come `postgres`.

   ```
   psql --host={{111122223333}}.{{aws-region}}.rds.amazonaws.com --port=5432 --username=postgres --password
   ```

1. Per installare l'estensione, esegui il comando seguente. 

   ```
   postgres=> CREATE EXTENSION aws_s3 CASCADE;
   NOTICE: installing required extension "aws_commons"
   CREATE EXTENSION
   ```

1. Per verificare che l'estensione sia installata, puoi usare il metacomando psql `\dx`.

   ```
   postgres=> \dx
          List of installed extensions
       Name     | Version |   Schema   |                 Description
   -------------+---------+------------+---------------------------------------------
    aws_commons | 1.2     | public     | Common data types across AWS services
    aws_s3      | 1.1     | public     | AWS S3 extension for importing data from S3
    plpgsql     | 1.0     | pg_catalog | PL/pgSQL procedural language
   (3 rows)
   ```

Le funzioni per importare dati da Amazon S3 ed esportare dati in Amazon S3 sono ora disponibili per l'uso.

### Verifica che il tuo Aurora PostgreSQL la versione supporta le esportazioni verso Amazon S3
<a name="postgresql-s3-supported"></a>

Per verificare che la versione di Aurora PostgreSQL supporti l'esportazione in Amazon S3, puoi utilizzare il comando `describe-db-engine-versions`. L'esempio seguente verifica se la versione 10.14 può eseguire l'esportazione in Amazon S3.

```
aws rds describe-db-engine-versions --region us-east-1 \
--engine aurora-postgresql --engine-version 10.14 | grep s3Export
```

Se l'output include la stringa `"s3Export"`, allora il motore supporta le esportazioni Amazon S3. In caso contrario, il motore non le supporta.

## Aggiornamento dell'estensione aws\_s3
<a name="postgresql-s3-export-upgrade"></a>

Stai aggiornando il tuo Cluster DB Aurora PostgreSQL a una nuova versione non aggiorna il `aws_s3` estensione allo stesso tempo. Per aggiornare l'estensione dopo il completamento dell'aggiornamento del motore, usa `ALTER EXTENSION ... UPDATE` comando. Per la procedura generale, vedere [Aggiornamento estensioni PostgreSQL](USER_UpgradeDBInstance.Upgrading.ExtensionUpgrades.md).

**Importante**  
Quando si aggiorna il `aws_s3` estensione dalla versione 1.1 alla versione 1.2, vengono ricreate le funzioni di esportazione Amazon S3 dell'estensione. Di conseguenza, tutte le autorizzazioni EXECUTE precedentemente concesse per queste funzioni ad altri utenti o ruoli (ad esempio, utilizzando `GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA aws_s3 TO your_user;`) vengono revocate. Una volta completato l'aggiornamento, concedi nuovamente queste autorizzazioni agli utenti o ai ruoli interessati.

## Panoramica dell'esportazione di dati in Amazon S3
<a name="postgresql-s3-export-overview"></a>

Per esportare i dati archiviati in un database Aurora PostgreSQL verso un bucket Amazon S3, attenersi alla procedura descritta di seguito.

**Per esportare Aurora PostgreSQL dati su S3**

1. Identifica un percorso del file Amazon S3 da utilizzare per l'esportazione dei dati. Per informazioni dettagliate su questo processo, consulta [Specifica del percorso del file Amazon S3 in cui eseguire l'esportazione](#postgresql-s3-export-file).

1. Fornisci l'autorizzazione ad accedere al bucket Amazon S3.

   Per esportare i dati in un file Amazon S3, concedi al cluster di database Aurora PostgreSQL l'autorizzazione per accedere al bucket Amazon S3 che verrà utilizzato dall'esportazione per lo storage. Questa operazione include le seguenti fasi:

   1. Crea una policy IAM che fornisce l'accesso a un bucket Amazon S3 in cui desideri eseguire l'esportazione.

   1. Creare un ruolo IAM.

   1. Collega la policy creata al ruolo creato.

   1. Aggiungi questo ruolo IAM al cluster di database .

   Per informazioni dettagliate su questo processo, consulta [Configurazione dell'accesso a un bucket Amazon S3](postgresql-s3-export-access-bucket.md).

1. Identifica una query del database per ottenere i dati. Esporta i dati della query chiamando la funzione `aws_s3.query_export_to_s3`. 

   Dopo aver completato le attività di preparazione precedenti, utilizza la funzione [aws\_s3.query\_export\_to\_s3](postgresql-s3-export-functions.md#aws_s3.export_query_to_s3) per esportare i risultati della query in Amazon S3. Per informazioni dettagliate su questo processo, consulta [Esportazione dei dati della query utilizzando la funzione aws\_s3.query\_export\_to\_s3](postgresql-s3-export-examples.md).

## Specifica del percorso del file Amazon S3 in cui eseguire l'esportazione
<a name="postgresql-s3-export-file"></a>

Specifica le seguenti informazioni per identificare la posizione in Amazon S3 in cui desideri esportare i dati:
+ Nome del bucket – Un *bucket* è un container di oggetti o file Amazon S3.

  Per ulteriori informazioni sull’archiviazione dei dati con Amazon S3, consulta [Creazione di un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) e [Utilizzo degli oggetti](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-downloading-objects.html) nella *Guida per l’utente di Amazon Simple Storage Service*. 
+ Percorso del file – Il percorso del file identifica la posizione di archiviazione dell'esportazione nel bucket Amazon S3. Il percorso del file comprende:
  + Un prefisso del percorso facoltativo che identifica un percorso di cartella virtuale.
  + Un prefisso del file che identifica uno o più file da archiviare. Esportazioni di dimensioni maggiori vengono archiviate in più file, ciascuno con una dimensione massima di circa 6 GB. I nomi di file aggiuntivi hanno lo stesso prefisso di file ma con l'aggiunta di `_part{{XX}}`. `{{XX}}` rappresenta 2, poi 3 e così via.

  Ad esempio, un percorso del file con una cartella `exports` e un prefisso del file `query-1-export` è `/exports/query-1-export`.
+ AWS Regione (opzionale): La AWS Regione in cui si trova il bucket Amazon S3. Se non specifichi una AWS Valore della regione, quindi Aurora salva i tuoi file in Amazon S3 nello stesso formato AWS Regione utilizzata per l'esportazione Cluster DB.
**Nota**  
Attualmente, AWS La regione deve essere la stessa della regione di esportazione Cluster DB.

  Per un elenco di AWS Nomi delle regioni e valori associati, vedere [Regioni e zone di disponibilità](Concepts.RegionsAndAvailabilityZones.md).

Per conservare le informazioni sul file Amazon S3 relative alla posizione di archiviazione dell'esportazione, puoi utilizzare la funzione [aws\_commons.create\_s3\_uri](postgresql-s3-export-functions.md#aws_commons.create_s3_uri) per creare una struttura composita `aws_commons._s3_uri_1` come descritto di seguito.

```
psql=> SELECT aws_commons.create_s3_uri(
   '{{amzn-s3-demo-bucket}}',
   'sample-filepath',
   'us-west-2'
) AS s3_uri_1 \gset
```

In seguito fornisci questo valore `s3_uri_1` come un parametro nella chiamata alla funzione [aws\_s3.query\_export\_to\_s3](postgresql-s3-export-functions.md#aws_s3.export_query_to_s3). Per alcuni esempi, consulta [Esportazione dei dati della query utilizzando la funzione aws\_s3.query\_export\_to\_s3](postgresql-s3-export-examples.md).