Informazioni di riferimento sulle funzioni

aws_s3.table_import_from_s3

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.

  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. Quando si utilizza questo parametro, non si utilizza alcun 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 del SQL database Postgre in cui importare i dati.

column_list

Una stringa di testo obbligatoria contenente un elenco opzionale delle colonne della tabella del SQL database Postgre in cui 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 obbligatoria contenente argomenti per il comando SQL COPY Postgre. Questi argomenti specificano come i dati devono essere copiati nella tabella Postgre. SQL Per maggiori dettagli, consulta la documentazione di Postgre. SQL COPY

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

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 questa forma di funzione, l'accesso ad Amazon S3 è fornito da un IAM ruolo sull'istanza DB di SQL Postgre.

  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 il Regione AWS posizione del file. Per un elenco di Regione AWS nomi e valori associati, vedereRegioni e zone di disponibilità.

chiave_accesso

Una stringa di testo contenente la chiave di accesso da utilizzare per l'operazione di importazione. L'impostazione predefinita èNULL.

secret_key

Una stringa di testo contenente la chiave segreta da utilizzare per l'operazione di importazione. L'impostazione predefinita èNULL.

session_token

(Opzionale) Una stringa di testo contenente la chiave di sessione da utilizzare per l'operazione di importazione. L'impostazione predefinita è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 Regione AWS in cui si trova il file. Per un elenco di Regione AWS nomi e valori associati, vedereRegioni e zone di disponibilità.

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. L'impostazione predefinita èNULL.

secret_key

Una stringa di testo obbligatoria contenente la chiave segreta da utilizzare per l'importazione di un file Amazon S3. L'impostazione predefinita èNULL.

session_token

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