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à.
# Informazioni di riferimento sulle funzioni
**Topics**
+ [aws\$1s3.query\$1export\$1to\$1s3](#aws_s3.export_query_to_s3)
+ [aws\$1commons.create\$1s3\$1uri](#aws_commons.create_s3_uri)
## aws\$1s3.query\$1export\$1to\$1s3
Esporta un risultato della query PostgreSQL in un bucket Amazon S3. L'estensione `aws_s3` fornisce la funzione `aws_s3.query_export_to_s3`.
I due parametri richiesti sono `query` e `s3_info`. Questi definiscono la query da esportare e identificano il bucket Amazon S3 in cui eseguire l’esportazione. Un parametro opzionale chiamato `options` fornisce la definizione di vari parametri di esportazione. Per esempi di utilizzo della funzione `aws_s3.query_export_to_s3`, consulta [Esportazione dei dati della query utilizzando la funzione aws\$1s3.query\$1export\$1to\$1s3](postgresql-s3-export-examples.md).
**Sintassi**
```
aws_s3.query_export_to_s3(
query text,
s3_info aws_commons._s3_uri_1,
options text,
kms_key text
)
```Parametri di input
*query*
Una stringa di testo obbligatoria contenente una query SQL eseguita dal motore PostgreSQL. I risultati di questa query vengono copiati in un bucket S3 identificato nel parametro `s3_info`.
*s3\$1info*
Un tipo composito `aws_commons._s3_uri_1` contenente le seguenti informazioni sull'oggetto S3:
+ `bucket` – Il nome del bucket Amazon S3 per contenere il file.
+ `file_path` – Il nome e il percorso del file Amazon S3.
+ `region`— La AWS regione in cui si trova il bucket. Per un elenco dei nomi delle AWS regioni e dei valori associati, vedere[Regioni, zone di disponibilità e Local Zones ](Concepts.RegionsAndAvailabilityZones.md).
Attualmente, questo valore deve essere la stessa AWS regione dell'istanza DB del che esporta. L'impostazione predefinita è la AWS regione dell'istanza DB del che esporta.
Per creare una struttura composita `aws_commons._s3_uri_1`, consulta la funzione [aws\$1commons.create\$1s3\$1uri](#aws_commons.create_s3_uri).
*options*
Una stringa di testo opzionale contenente gli argomenti del comando `COPY` di PostgreSQL. Questi argomenti specificano come i dati devono essere copiati quando vengono esportati. Per maggiori dettagli, consulta la [documentazione di COPY PostgreSQL](https://www.postgresql.org/docs/current/sql-copy.html).
*testo kms\$1key*
Una stringa di testo opzionale contenente la chiave KMS gestita dal cliente del bucket S3 in cui esportare i dati.
### Parametri di input alternativi
Per facilitare il testing, puoi utilizzare un set esteso di parametri al posto del parametro `s3_info`. Di seguito vengono riportate le variazioni di sintassi aggiuntive per la funzione `aws_s3.query_export_to_s3`.
Invece di utilizzare il parametro `s3_info` per identificare un file Amazon S3, utilizzare la combinazione dei parametri `bucket`, `file_path` e `region`.
```
aws_s3.query_export_to_s3(
query text,
bucket text,
file_path text,
region text,
options text,
kms_key text
)
```
*query*
Una stringa di testo obbligatoria contenente una query SQL eseguita dal motore PostgreSQL. I risultati di questa query vengono copiati in un bucket S3 identificato nel parametro `s3_info`.
*bucket*
Una stringa di testo obbligatoria contenente il nome del bucket Amazon S3 che contiene il file
*file\$1path*
Una stringa di testo obbligatoria contenente il nome file di Amazon S3, incluso il percorso.
*Regione*
Una stringa di testo opzionale contenente la AWS regione in cui si trova il bucket. Per un elenco dei nomi delle AWS regioni e dei valori associati, vedere[Regioni, zone di disponibilità e Local Zones ](Concepts.RegionsAndAvailabilityZones.md).
Attualmente, questo valore deve essere la stessa AWS regione dell'istanza DB del che esporta. L'impostazione predefinita è la AWS regione dell'istanza DB del che esporta.
*options*
Una stringa di testo opzionale contenente gli argomenti del comando `COPY` di PostgreSQL. Questi argomenti specificano come i dati devono essere copiati quando vengono esportati. Per maggiori dettagli, consulta la [documentazione di COPY PostgreSQL](https://www.postgresql.org/docs/current/sql-copy.html).
*testo kms\$1key*
Una stringa di testo opzionale contenente la chiave KMS gestita dal cliente del bucket S3 in cui esportare i dati.
### Parametri di output
```
aws_s3.query_export_to_s3(
OUT rows_uploaded bigint,
OUT files_uploaded bigint,
OUT bytes_uploaded bigint
)
```
*rows\$1uploaded*
Il numero di righe della tabella che sono state caricate correttamente in Amazon S3 per la query specificata.
*files\$1uploaded*
Il numero di file caricati in Amazon S3. I file vengono creati in dimensioni di circa 6 GB. A ogni file aggiuntivo creato è stato aggiunto `_partXX` al nome. `XX` rappresenta 2, poi 3 e così via, se necessario.
*bytes\$1uploaded*
Il numero totale di byte caricati in Amazon S3.
### Esempi
```
psql=> SELECT * from aws_s3.query_export_to_s3('select * from sample_table', 'amzn-s3-demo-bucket', 'sample-filepath');
psql=> SELECT * from aws_s3.query_export_to_s3('select * from sample_table', 'amzn-s3-demo-bucket', 'sample-filepath','us-west-2');
psql=> SELECT * from aws_s3.query_export_to_s3('select * from sample_table', 'amzn-s3-demo-bucket', 'sample-filepath','us-west-2','format text');
```
## aws\$1commons.create\$1s3\$1uri
Crea una struttura `aws_commons._s3_uri_1` per conservare le informazioni relative al file Amazon S3. I risultati della funzione `aws_commons.create_s3_uri` vengono utilizzati nel parametro `s3_info` della funzione [aws\$1s3.query\$1export\$1to\$1s3](#aws_s3.export_query_to_s3). Per un esempio di utilizzo della funzione `aws_commons.create_s3_uri`, consulta [Specifica del percorso del file Amazon S3 in cui eseguire l'esportazione](postgresql-s3-export.md#postgresql-s3-export-file).
**Sintassi**
```
aws_commons.create_s3_uri(
bucket text,
file_path text,
region text
)
```Parametri di input
*bucket*
Una stringa di testo obbligatoria contenente il nome del bucket Amazon S3 del file.
*file\$1path*
Una stringa di testo obbligatoria contenente il nome file di Amazon S3, incluso il percorso.
*Regione*
Una stringa di testo obbligatoria contenente la AWS regione in cui si trova il file. Per un elenco dei nomi delle AWS regioni e dei valori associati, vedere[Regioni, zone di disponibilità e Local Zones ](Concepts.RegionsAndAvailabilityZones.md).