函數參考 - Amazon Relational Database Service
aws_s3.table_import_from_s3aws_commons.create_s3_uriaws_commons.create_aws_credentials

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

函數參考

aws_s3.table_import_from_s3

將 Amazon S3 數據導入 A Amazon RDS 表。aws_s3 擴充功能提供 aws_s3.table_import_from_s3 函數。傳回值為文字。

語法

必要的參數為 table_name、column_list 及 options。這些參數可識別資料庫表格，並指定資料要如何複製到表格中。

您也可以使用下列參數：

  • s3_info 參數指定要匯入的 Amazon S3 檔案。使用此參數時，Postgre SQL 資料庫執行個體的IAM角色會提供對 Amazon S3 的存取。

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

  • credentials 參數指定登入資料以存取 Amazon S3。當您使用這個參數時，您不會使用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
)

參數

table_name

包含要將資料匯入其中之 Postgre 資料SQL庫表格名稱的必要文字字串。

column_list

必要的文字字串，其中包含要在其中複製資料之 Postgre 資料SQL庫表格欄的選擇性清單。如果字串為空白，就會使用表格的所有欄。如需範例，請參閱 匯入使用自訂分隔符號的 Amazon S3 檔案。

options

包含 Postgre SQL COPY 指令引數的必要文字字串。這些引數指定如何將數據複製到 Postgre SQL 表中。有關更多詳細信息，請參閱 Postgre SQL COPY 文檔。

s3_info

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

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

  • file_path – 包括檔案路徑的 Amazon S3 檔案名稱。

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

登入資料

aws_commons._aws_credentials_1 複合類型，含有下列登入資料以用於匯入作業：

  • 存取金鑰

  • 私密金鑰

  • 工作階段字符

如需建立 aws_commons._aws_credentials_1 複合結構的詳細資訊，請參閱 aws_commons.create_aws_credentials。

替代語法

為了協助進行測試，您可使用一組更大的參數取代 s3_info 及 credentials 參數。以下是 aws_s3.table_import_from_s3 函數的額外語法變化：

  • 請不要使用 s3_info 參數識別 Amazon S3 檔案，而是使用 bucket、file_path 及 region 參數組合進行。使用這種形式的功能，Postgre SQL 資料庫執行個體上的IAM角色可以存取 Amazon S3。

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

  • 請不要使用 credentials 參數識別 Amazon S3 存取，而是使用 access_key、session_key 及 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 
)

替代參數

bucket

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

file_path

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

region

一個文本字符串標識 AWS 區域 檔案的位置。對於列表 AWS 區域 名稱與關聯值，請參閱區域、可用區域和 Local Zones。

access_key

文字字串，其中含有用於匯入作業的存取金鑰。預設值為NULL。

secret_key

文字字串，其中含有用於匯入作業的秘密金鑰。預設值為NULL。

session_token

(選用) 文字字串，其中含有用於匯入作業的工作階段金鑰。預設值為NULL。

aws_commons.create_s3_uri

建立 aws_commons._s3_uri_1 結構以保留 Amazon S3 檔案資訊。使用 aws_commons.create_s3_uri 函數 s3_info 參數的 aws_s3.table_import_from_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。

aws_commons.create_aws_credentials

在 aws_commons._aws_credentials_1 結構設定存取金鑰及秘密金鑰。使用 aws_commons.create_aws_credentials 函數 credentials 參數的 aws_s3.table_import_from_s3 函數結果。

語法

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

參數

access_key

必要的文字字串，其中含有用於匯入 Amazon S3 檔案的存取金鑰。預設值為NULL。

secret_key

必要的文字字串，其中含有用於匯入 Amazon S3 檔案的秘密金鑰。預設值為NULL。

session_token

選用的文字字串，其中含有用於匯入 Amazon S3 檔案的工作階段字符。預設值為NULL。如果您提供選用的 session_token，就可以使用臨時登入資料。