Referensi fungsi - Layanan Basis Data Relasional Amazon
aws_s3.table_import_from_s3aws_commons.create_s3_uriaws_commons.create_aws_credentials

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Referensi fungsi

aws_s3.table_import_from_s3

Mengimpor data Amazon S3 ke tabel Amazon RDS. 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. Saat Anda menggunakan parameter ini, akses ke Amazon S3 disediakan oleh peran IAM untuk instans DB PostgreSQL.

    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, jangan menggunakan peran 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
)

Parameter

table_name

String teks yang diperlukan yang berisi nama tabel basis data PostgreSQL sebagai tujuan impor data.

column_list

String teks yang diperlukan yang berisi daftar opsional kolom tabel basis data PostgreSQL tempat tujuan data akan disalin. Jika string kosong, semua kolom tabel akan digunakan. Sebagai contoh, lihat Mengimpor file Amazon S3 yang menggunakan pemisah kustom.

options

String teks yang diperlukan yang berisi argumen untuk perintah COPY PostgreSQL. Argumen ini menentukan cara data akan disalin ke dalam tabel PostgreSQL. Untuk detail selengkapnya, lihat Dokumentasi PostgreSQL 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 nama AWS Wilayah dan nilai terkait, lihatWilayah, Zona Ketersediaan, dan Zona Lokal.

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 peran IAM pada instans DB PostgreSQL.

    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

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

access_key

String teks yang berisi kunci akses untuk digunakan dalam operasi impor. Default-nya adalah NULL.

secret_key

String teks yang berisi kunci rahasia yang akan digunakan dalam operasi impor. Default-nya adalah NULL.

session_token

(Opsional) String teks yang berisi kunci sesi yang akan digunakan dalam operasi impor. Default-nya adalah NULL.

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

String teks yang diperlukan Wilayah AWS yang berisi file tersebut. Untuk daftar Wilayah AWS nama dan nilai terkait, lihatWilayah, Zona Ketersediaan, dan Zona Lokal.

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. Default-nya adalah NULL.

secret_key

String teks yang diperlukan yang berisi kunci rahasia yang akan digunakan untuk mengimpor file Amazon S3. Default-nya adalah NULL.

session_token

String teks opsional yang berisi token sesi yang akan digunakan untuk mengimpor file Amazon S3. Default-nya adalah NULL. Jika Anda memberikan session_token opsional, Anda dapat menggunakan kredensial sementara.