函數參考 - Amazon Relational Database Service
aws_s3.query_export_to_s3aws_commons.create_s3_uri

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

函數參考

aws_s3.query_export_to_s3

將郵件SQL查詢結果匯出至 Amazon S3 儲存貯體。aws_s3 延伸提供 aws_s3.query_export_to_s3 函數。

兩個必要參數為 query 及 s3_info。這些參數會定義要匯出的查詢，以及要匯出至的 Amazon S3 儲存貯體。名為 options 的選用參數會提供來定義各種匯出參數。如需使用 aws_s3.query_export_to_s3 函數的範例，請參閱 使用 aws_s3.query_export_to_s3 函數匯出查詢資料。

語法

aws_s3.query_export_to_s3(
    query text,    
    s3_info aws_commons._s3_uri_1,    
    options text,
    kms_key text
)
輸入參數
query

包含 Postgre SQL 引擎執行之SQL查詢的必要文字字串。此查詢的結果會複製到 s3_info 參數中識別的 S3 儲存貯體。

s3_info

aws_commons._s3_uri_1 複合類型，含有下列 S3 物件相關資訊：

  • bucket – 包含檔案的 Amazon S3 儲存貯體名稱。

  • file_path – Amazon S3 檔案名稱和路徑。

  • region— 該 AWS 值區所在的區域。對於列表 AWS 區域名稱與關聯值，請參閱區域、可用區域和 Local Zones。

    目前，此值必須相同 AWS 與匯出執行個體相同的區域。預設值為 AWS 匯出執行個體的區域。

如果要建立 aws_commons._s3_uri_1 複合結構，請參閱 aws_commons.create_s3_uri 函數。

options

包含 Postgre SQL COPY 指令引數的選擇性文字字串。這些引數指定資料要如何在匯出時複製。有關更多詳細信息，請參閱 Postgre SQL COPY 文檔。

替代輸入參數

為了協助進行測試，您可使用一組更大的參數取代 s3_info 參數。以下是 aws_s3.query_export_to_s3 函數的其他語法變化。

請不要使用 s3_info 參數識別 Amazon S3 檔案，而是使用 bucket、file_path 及 region 參數組合進行。

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

包含 Postgre SQL 引擎執行之SQL查詢的必要文字字串。此查詢的結果會複製到 s3_info 參數中識別的 S3 儲存貯體。

bucket

必要文字字串，其中含有包含檔案的 Amazon S3 儲存貯體名稱。

file_path

包含 Amazon S3 檔案名稱 (包括檔案路徑) 的必要文字字串。

region

選擇性文字字串，包含 AWS 值區所在的區域。對於列表 AWS 區域名稱與關聯值，請參閱區域、可用區域和 Local Zones。

目前，此值必須相同 AWS 與匯出執行個體相同的區域。預設值為 AWS 匯出執行個體的區域。

options

包含 Postgre SQL COPY 指令引數的選擇性文字字串。這些引數指定資料要如何在匯出時複製。有關更多詳細信息，請參閱 Postgre SQL COPY 文檔。

輸出參數

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

指定查詢成功上傳至 Amazon S3 的資料表列數。

files_uploaded

上傳至 Amazon S3 的檔案數。建立的檔案大小約為 6 GB。每個額外建立的檔案，名稱都會加上 _partXX。XX 代表 2，接著是 3，視需要以此類推。

bytes_uploaded

上傳至 Amazon S3 的總位元組數。

範例

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

建立 aws_commons._s3_uri_1 結構以保留 Amazon S3 檔案資訊。您使用 aws_commons.create_s3_uri 函數 s3_info 參數之中的 aws_s3.query_export_to_s3 函數結果。如需使用 aws_commons.create_s3_uri 函數的範例，請參閱 指定要匯出的 Amazon S3 檔案路徑。

語法

aws_commons.create_s3_uri(
   bucket text,
   file_path text,
   region text
)
輸入參數
bucket

必要的文字字串，其中含有檔案的 Amazon S3 儲存貯體名稱。

file_path

包含 Amazon S3 檔案名稱 (包括檔案路徑) 的必要文字字串。

region

必要的文字字串，包含 AWS 檔案所在的區域。對於列表 AWS 區域名稱與關聯值，請參閱區域、可用區域和 Local Zones。