Referensi fungsi

aws_s3.table_import_from_s3

Ekstensi aws_s3 memberikan fungsi aws_s3.table_import_from_s3. Nilai yang ditampilkan berupa teks.

Sintaksis

Parameter yang diperlukan adalah table_name, column_list, dan options. Parameter ini mengidentifikasi tabel basis data dan menentukan cara data disalin ke dalam tabel.

Anda juga dapat menggunakan parameter berikut:

• Parameter s3_info menentukan file Amazon S3 yang akan diimpor.

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

• Parameter credentials menentukan kredensial untuk mengakses Amazon S3. Saat Anda menggunakan parameter ini, Anda tidak menggunakan IAM peran.

  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
  )

Parameter

table_name

Sebuah string teks yang diperlukan berisi nama tabel SQL database Postgre untuk mengimpor data ke dalam.

column_list

String teks yang diperlukan yang berisi daftar opsional kolom tabel SQL database Postgre untuk menyalin data. Jika string kosong, semua kolom tabel akan digunakan. Sebagai contoh, lihat Mengimpor file Amazon S3 yang menggunakan pemisah kustom.

options

Sebuah string teks yang diperlukan berisi argumen untuk perintah Postgre SQLCOPY. Argumen ini menentukan bagaimana data akan disalin ke dalam tabel PostgreSQL. Untuk lebih jelasnya, lihat dokumentasi Postgre SQL COPY.

s3_info

Jenis komposit aws_commons._s3_uri_1 yang berisi informasi tentang objek S3 berikut:

• bucket – Nama bucket Amazon S3 yang berisi file.

• file_path – Nama file Amazon S3 yang mencakup jalur file.

• region— AWS Wilayah tempat file tersebut berada. Untuk daftar AWS Nama wilayah dan nilai terkait, lihatWilayah dan Zona Ketersediaan.

credentials

Jenis komposit aws_commons._aws_credentials_1 yang berisi kredensial berikut yang akan digunakan untuk operasi impor:

• Kunci akses

• Kunci rahasia

• Token sesi

Untuk informasi tentang cara membuat struktur komposit aws_commons._aws_credentials_1, lihat aws_commons.create_aws_credentials.

Sintaksis alternatif

Untuk memudahkan pengujian, Anda dapat menggunakan serangkaian parameter yang diperluas, bukan parameter s3_info dan credentials. Berikut ini adalah variasi sintaks tambahan untuk fungsi aws_s3.table_import_from_s3:

• Alih-alih menggunakan parameter s3_info untuk mengidentifikasi file Amazon S3, gunakan kombinasi parameter bucket, file_path, dan region. Dengan bentuk fungsi ini, akses ke Amazon S3 disediakan oleh IAM peran pada instans SQL Postgre DB.

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

• Alih-alih menggunakan parameter credentials untuk menentukan akses Amazon S3, gunakan kombinasi parameter access_key, session_key, dan 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 
  ) 

Parameter alternatif

bucket

String teks yang berisi nama bucket Amazon S3 yang berisi file.

file_path

String teks yang berisi nama file Amazon S3 beserta jalur file.

region

Sebuah string teks yang mengidentifikasi Wilayah AWS lokasi file. Untuk daftar Wilayah AWS nama dan nilai terkait, lihatWilayah dan Zona Ketersediaan.

access_key

String teks yang berisi kunci akses untuk digunakan dalam operasi impor. Defaultnya adalahNULL.

secret_key

String teks yang berisi kunci rahasia yang akan digunakan dalam operasi impor. Defaultnya adalahNULL.

session_token

(Opsional) String teks yang berisi kunci sesi yang akan digunakan dalam operasi impor. Defaultnya adalahNULL.

aws_commons.create_s3_uri

Membuat struktur aws_commons._s3_uri_1 untuk menyimpan informasi file Amazon S3. Gunakan hasil dari fungsi aws_commons.create_s3_uri di parameter s3_info dari fungsi aws_s3.table_import_from_s3.

Sintaksis

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

Parameter

bucket

String teks yang diperlukan yang berisi nama bucket Amazon S3 untuk file tersebut.

file_path

String teks yang diperlukan yang berisi nama file Amazon S3 beserta jalurnya.

region

Sebuah string teks yang diperlukan yang berisi Wilayah AWS bahwa file tersebut ada di. Untuk daftar Wilayah AWS nama dan nilai terkait, lihatWilayah dan Zona Ketersediaan.

aws_commons.create_aws_credentials

Mengatur kunci akses dan kunci rahasia dalam struktur aws_commons._aws_credentials_1. Gunakan hasil dari fungsi aws_commons.create_aws_credentials di parameter credentials dari fungsi aws_s3.table_import_from_s3.

Sintaksis

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

Parameter

access_key

String teks yang diperlukan berisi kunci akses yang digunakan untuk mengimpor file Amazon S3. Defaultnya adalahNULL.

secret_key

String teks yang diperlukan yang berisi kunci rahasia yang akan digunakan untuk mengimpor file Amazon S3. Defaultnya adalahNULL.

session_token

String teks opsional yang berisi token sesi yang akan digunakan untuk mengimpor file Amazon S3. Defaultnya adalahNULL. Jika Anda memberikan session_token opsional, Anda dapat menggunakan kredensial sementara.