Informazioni di riferimento sulle funzioni

aws_s3.table_import_from_s3

Importa dati Amazon S3 in una tabella Amazon RDS. L'estensione aws_s3 fornisce la funzione aws_s3.table_import_from_s3. Il valore restituito è testo.

Sintassi

I parametri richiesti sono table_name, column_list e options. Identificano la tabella di database e specificano il modo in cui i dati vengono copiati nella tabella

Puoi inoltre utilizzare i seguenti parametri:

• Il parametro s3_info specifica il file Amazon S3 da importare. Se si utilizza questo parametro, l'accesso a Amazon S3 è fornito da un ruolo IAM per l'istanza database PostgreSQL.

  aws_s3.table_import_from_s3 (
     table_name text, 
     column_list text, 
     options text, 
     s3_info aws_commons._s3_uri_1
  ) 

• Il parametro credentials specifica le credenziali per accedere a Amazon S3. Se si utilizza questo parametro, non si utilizza il ruolo IAM.

  aws_s3.table_import_from_s3 (
     table_name text, 
     column_list text, 
     options text, 
     s3_info aws_commons._s3_uri_1,
     credentials aws_commons._aws_credentials_1
  )

Parametri

table_name

Una stringa di testo obbligatoria contenente il nome della tabella di database PostgreSQL in cui importare i dati.

column_list

Una stringa di testo obbligatoria contenente un elenco opzionale delle colonne della tabella di database PostgreSQL nelle quali copiare i dati. Se la stringa è vuota, vengono utilizzate tutte le colonne della tabella. Per un esempio, consulta Importazione di un file Amazon S3 che utilizza un delimitatore personalizzato.

options

Una stringa di testo obbligatorio contenente gli argomenti del comando COPY di PostgreSQL. Tali argomenti specificano in che modo i dati vengono copiati nella tabella PostgreSQL. Per maggiori dettagli, consulta la documentazione di COPY PostgreSQL.

s3_info

Un tipo composito aws_commons._s3_uri_1 contenente le seguenti informazioni sull'oggetto S3:

• bucket – Il nome del bucket Amazon S3 contenente il file.

• file_path – Il nome file di Amazon S3, incluso il percorso.

• region: la regione AWS in cui si trova il file. Per un elenco di nomi di regione AWS e dei valori associati, consulta Regioni, zone di disponibilità e Local Zones.

credenziali

Un tipo composito aws_commons._aws_credentials_1 contenente le seguenti credenziali da utilizzare per l'operazione di importazione:

• Chiave di accesso

• Chiave segreta

• Token di sessione

Per informazioni sulla creazione di una struttura composita aws_commons._aws_credentials_1, consulta aws_commons.create_aws_credentials.

Sintassi alternativa

Per un aiuto nei test, si può utilizzare un set più ampio di parametri al posto dei parametri s3_info e credentials. Di seguito vengono riportate le variazioni di sintassi aggiuntive per la funzione aws_s3.table_import_from_s3.

• Invece di utilizzare il parametro s3_info per identificare un file Amazon S3, utilizzare la combinazione dei parametri bucket, file_path e region. Con questo formato della funzione, l'accesso a Amazon S3 viene fornito da un ruolo IAM nell'istanza database PostgreSQL.

  aws_s3.table_import_from_s3 (
     table_name text, 
     column_list text, 
     options text, 
     bucket text, 
     file_path text, 
     region text 
  )

• Invece di utilizzare il parametro credentials per specificare l'accesso a Amazon S3, utilizzare la combinazione dei parametri access_key, session_key e session_token.

  aws_s3.table_import_from_s3 (
     table_name text, 
     column_list text, 
     options text, 
     bucket text, 
     file_path text, 
     region text, 
     access_key text, 
     secret_key text, 
     session_token text 
  ) 

Parametri alternativi

bucket

Una stringa di testo contenente il nome del bucket Amazon S3 che contiene il file

file_path

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

Regione

Una stringa di testo che identifica la posizione Regione AWS del file. Per un elenco di nomi di Regione AWS e di valori associati, consulta Regioni, zone di disponibilità e Local Zones.

chiave_accesso

Una stringa di testo contenente la chiave di accesso da utilizzare per l'operazione di importazione. Il valore predefinito è NULL.

secret_key

Una stringa di testo contenente la chiave segreta da utilizzare per l'operazione di importazione. Il valore predefinito è NULL.

session_token

(Opzionale) Una stringa di testo contenente la chiave di sessione da utilizzare per l'operazione di importazione. Il valore predefinito è NULL.

aws_commons.create_s3_uri

Crea una struttura aws_commons._s3_uri_1 per conservare le informazioni relative al file Amazon S3. Si utilizzano i risultati della funzione aws_commons.create_s3_uri nel parametro s3_info della funzione aws_s3.table_import_from_s3.

Sintassi

aws_commons.create_s3_uri(
   bucket text,
   file_path text,
   region text
)

Parametri

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 la Regione AWS in cui si trova il file. Per un elenco di nomi di Regione AWS e di valori associati, consulta Regioni, zone di disponibilità e Local Zones.

aws_commons.create_aws_credentials

Imposta una chiave di accesso e una chiave segreta in una struttura aws_commons._aws_credentials_1. Si utilizzano i risultati della funzione aws_commons.create_aws_credentials nel parametro credentials della funzione aws_s3.table_import_from_s3.

Sintassi

aws_commons.create_aws_credentials(
   access_key text,
   secret_key text,
   session_token text
)

Parametri

chiave_accesso

Una stringa di testo obbligatoria contenente la chiave di accesso da utilizzare per l'importazione di un file Amazon S3. Il valore predefinito è NULL.

secret_key

Una stringa di testo obbligatoria contenente la chiave segreta da utilizzare per l'importazione di un file Amazon S3. Il valore predefinito è NULL.

session_token

Una stringa di testo opzionale contenente il token di sessione da utilizzare per l'importazione di un file Amazon S3. Il valore predefinito è NULL. Se si fornisce un session_token opzionale, è possibile utilizzare credenziali temporanee.