Informazioni di riferimento sulle funzioni - Amazon Relational Database Service
aws_s3.query_export_to_s3aws_commons.create_s3_uri

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

aws_s3.query_export_to_s3

Esporta il risultato di una SQL query Postgre 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_s3.query_export_to_s3.

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 SQL query eseguita dal motore Postgre. SQL I risultati di questa query vengono copiati in un bucket S3 identificato nel parametro s3_info.

s3_info

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— Il AWS Regione in cui si trova il secchio. Per un elenco di AWS Nomi delle regioni e valori associati, vedereRegioni, zone di disponibilità e Local Zones.

    Attualmente, questo valore deve essere lo stesso AWS Regione come quella dell'istanza DB del che esporta. L'impostazione predefinita è AWS Regione dell'istanza DB del che esporta.

Per creare una struttura composita aws_commons._s3_uri_1, consulta la funzione aws_commons.create_s3_uri.

options

Una stringa di testo opzionale contenente argomenti per il comando SQL COPY Postgre. Questi argomenti specificano come i dati devono essere copiati quando vengono esportati. Per maggiori dettagli, consulta la documentazione di SQLCOPYPostgre.

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,
)
query

Una stringa di testo obbligatoria contenente una SQL query eseguita dal motore SQL Postgre. 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_path

Una stringa di testo obbligatoria contenente il nome file di Amazon S3, incluso il percorso.

Regione

Una stringa di testo opzionale contenente AWS Regione in cui si trova il bucket. Per un elenco di AWS Nomi delle regioni e valori associati, vedereRegioni, zone di disponibilità e Local Zones.

Attualmente, questo valore deve essere lo stesso AWS Regione come quella dell'istanza DB del che esporta. L'impostazione predefinita è AWS Regione dell'istanza DB del che esporta.

options

Una stringa di testo opzionale contenente argomenti per il comando SQL COPY Postgre. Questi argomenti specificano come i dati devono essere copiati quando vengono esportati. Per maggiori dettagli, consulta la documentazione di SQLCOPYPostgre.

Parametri di output

aws_s3.query_export_to_s3(
    OUT rows_uploaded bigint,
    OUT files_uploaded bigint,
    OUT bytes_uploaded bigint
)
rows_uploaded

Il numero di righe della tabella che sono state caricate correttamente in Amazon S3 per la query specificata.

files_uploaded

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_uploaded

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_commons.create_s3_uri

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_s3.query_export_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.

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_path

Una stringa di testo obbligatoria contenente il nome file di Amazon S3, incluso il percorso.

Regione

Una stringa di testo obbligatoria contenente AWS Regione in cui si trova il file. Per un elenco di AWS Nomi delle regioni e valori associati, vedereRegioni, zone di disponibilità e Local Zones.