Referensi fungsi - Layanan Basis Data Relasional Amazon
aws_s3.query_export_to_s3aws_commons.create_s3_uri

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

Referensi fungsi

aws_s3.query_export_to_s3

Mengekspor hasil SQL kueri Postgre ke bucket Amazon S3. Ekstensi aws_s3 memberikan fungsi aws_s3.query_export_to_s3.

Dua parameter yang dibutuhkan adalah query dan s3_info. Parameter ini menentukan kueri yang akan diekspor dan mengidentifikasi bucket Amazon S3 tempat tujuan ekspor. Parameter opsional yang disebut options disediakan untuk menentukan berbagai parameter ekspor. Sebagai contoh penggunaan fungsi aws_s3.query_export_to_s3, lihat Mengekspor data kueri menggunakan fungsi aws_s3.query_export_to_s3.

Sintaksis

aws_s3.query_export_to_s3(
    query text,    
    s3_info aws_commons._s3_uri_1,    
    options text,
    kms_key text
)
Parameter input
query

String teks yang diperlukan yang berisi SQL kueri yang dijalankan SQL mesin Postgre. Hasil kueri ini disalin ke bucket S3 yang diidentifikasi dalam parameter s3_info.

s3_info

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

  • bucket – Nama bucket Amazon S3 yang akan diisi file.

  • file_path – Nama dan jalur file Amazon S3.

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

    Saat ini, nilai ini harus sama AWS Wilayah sebagai instans yang mengekspor. Defaultnya adalah AWS Wilayah instans yang mengekspor.

Untuk membuat struktur komposit aws_commons._s3_uri_1, lihat fungsi aws_commons.create_s3_uri.

options

Sebuah string teks opsional yang berisi argumen untuk perintah Postgre SQLCOPY. Argumen ini menentukan cara menyalin data saat diekspor. Untuk lebih jelasnya, lihat dokumentasi Postgre SQL COPY.

Parameter input alternatif

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

Alih-alih menggunakan parameter s3_info untuk mengidentifikasi file Amazon S3, gunakan kombinasi parameter bucket, file_path, dan region.

aws_s3.query_export_to_s3(
    query text,    
    bucket text,    
    file_path text,    
    region text,    
    options text,
)
query

String teks yang diperlukan yang berisi SQL kueri yang dijalankan SQL mesin Postgre. Hasil kueri ini disalin ke bucket S3 yang diidentifikasi dalam parameter s3_info.

bucket

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

file_path

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

region

Sebuah string teks opsional yang berisi AWS Wilayah tempat ember berada. Untuk daftar AWS Nama wilayah dan nilai terkait, lihatWilayah, Zona Ketersediaan, dan Zona Lokal.

Saat ini, nilai ini harus sama AWS Wilayah sebagai instans yang mengekspor. Defaultnya adalah AWS Wilayah instans yang mengekspor.

options

Sebuah string teks opsional yang berisi argumen untuk perintah Postgre SQLCOPY. Argumen ini menentukan cara menyalin data saat diekspor. Untuk lebih jelasnya, lihat dokumentasi Postgre SQL COPY.

Parameter output

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

Jumlah baris tabel yang berhasil diunggah ke Amazon S3 untuk kueri tertentu.

files_uploaded

Jumlah file yang diunggah ke Amazon S3. File dibuat dalam ukuran kira-kira 6 GB. Setiap file tambahan yang dibuat memiliki _partXX yang ditambahkan pada namanya. XX mewakili 2, kemudian 3, dan seterusnya sesuai kebutuhan.

bytes_uploaded

Jumlah total byte yang diunggah ke Amazon S3.

Contoh

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

Membuat struktur aws_commons._s3_uri_1 untuk menyimpan informasi file Amazon S3. Gunakan hasil dari fungsi aws_commons.create_s3_uri dalam parameter s3_info dari fungsi aws_s3.query_export_to_s3. Untuk contoh penggunaan fungsi aws_commons.create_s3_uri, lihat Menentukan jalur file Amazon S3 tujuan ekspor.

Sintaksis

aws_commons.create_s3_uri(
   bucket text,
   file_path text,
   region text
)
Parameter input
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 AWS Wilayah tempat file tersebut berada. Untuk daftar AWS Nama wilayah dan nilai terkait, lihatWilayah, Zona Ketersediaan, dan Zona Lokal.