在 RDS for SQL Server 和 Amazon S3 之間傳輸檔案

您可以使用 Amazon RDS預存程序，在 Amazon S3 和RDS資料庫執行個體之間下載和上傳檔案。您也可以使用 Amazon RDS預存程序來列出和刪除RDS執行個體上的檔案。

您自 S3 下載和上傳至 S3 的檔案會存放在 D:\S3 資料夾。您只有透過此資料夾才能存取您的檔案。您可以將檔案組織成子資料夾，在下載期間，當您包含目的地資料夾時，將為您建立這些子資料夾。

某些預存程序需要您將 Amazon Resource Name （ARN） 提供給 S3 儲存貯體和檔案。您 的格式ARN為 arn:aws:s3:::amzn-s3-demo-bucket/file_name。Amazon S3 不需要 中的帳戶號碼或 AWS 區域ARNs。

S3 整合任務循序執行，與原生備份和還原任務共同相同的佇列。不論何時，此佇列中最多只能有兩個任務在進行。可能需要五分鐘後，任務才會開始處理。

將檔案從 Amazon S3 儲存貯體下載至SQL伺服器資料庫執行個體

若要將檔案從 S3 儲存貯體下載至 RDS for SQL Server 資料庫執行個體，請使用 Amazon RDS預存程序msdb.dbo.rds_download_from_s3搭配下列參數。

參數名稱	資料類型	預設	必要	描述
@s3_arn_of_file	NVARCHAR	–	必要	要下載ARN的檔案 S3，例如： arn:aws:s3:::amzn-s3-demo-bucket/mydata.csv
@rds_file_path	NVARCHAR	–	選用	RDS 執行個體的檔案路徑。若沒有指定，則檔案路徑為 D:\S3\<filename in s3>。RDS 支援絕對路徑和相對路徑。如果您要建立子資料夾，請將子資料夾包含在檔案路徑中。
@overwrite_file	INT	0	選用	覆寫現有檔案： 0 = 不覆寫 1 = 覆寫

您可以下載沒有副檔名的檔案以及具有下列副檔名的檔案：.bcp、.csv、.dat、.fmt、.info、.lst、.tbl、.txt 和 .xml。

注意

啟用SQL伺服器整合服務時，支援下載副檔名為 .ispac 的檔案。如需啟用 的詳細資訊SSIS，請參閱 SQL 伺服器整合服務。

啟用SQL伺服器分析服務時，支援下載具有下列副檔名的檔案：.abf、.asdatabase、.configsettings、.deploymentoptions、.deploymenttargets 和 .xmla。如需啟用 的詳細資訊SSAS，請參閱 SQL 伺服器分析服務。

下列範例顯示從 S3 下載檔案的預存程序。

exec msdb.dbo.rds_download_from_s3
	    @s3_arn_of_file='arn:aws:s3:::amzn-s3-demo-bucket/bulk_data.csv',
	    @rds_file_path='D:\S3\seed_data\data.csv',
	    @overwrite_file=1; 

範例 rds_download_from_s3 操作在 seed_data 中建立名為 D:\S3\ 的資料夾 (如果此資料夾尚不存在)。然後，範例從 S3 將來源檔案 bulk_data.csv 下載至資料庫執行個體上名為 data.csv 的新檔案。因為 @overwrite_file 參數設為 1，如果檔案已事先存在，則會覆寫檔案。

從SQL伺服器資料庫執行個體上傳檔案至 Amazon S3 儲存貯體

若要將檔案從 RDS for SQL Server 資料庫執行個體上傳至 S3 儲存貯體，請使用 Amazon RDS預存程序msdb.dbo.rds_upload_to_s3搭配下列參數。

參數名稱	資料類型	預設	必要	描述
@s3_arn_of_file	NVARCHAR	–	必要	要在 S3 中建立之檔案ARN的 S3，例如： arn:aws:s3:::amzn-s3-demo-bucket/mydata.csv
@rds_file_path	NVARCHAR	–	必要	要上傳至 S3 之檔案的檔案路徑。支援絕對和相對路徑。
@overwrite_file	INT	–	選用	覆寫現有檔案： 0 = 不覆寫 1 = 覆寫

下列範例會將名為 的 檔案data.csv從 中的指定位置上傳至 指定的 S3 儲存貯new_data.csv體中的 D:\S3\seed_data\ 檔案ARN。

exec msdb.dbo.rds_upload_to_s3 
		@rds_file_path='D:\S3\seed_data\data.csv',
		@s3_arn_of_file='arn:aws:s3:::amzn-s3-demo-bucket/new_data.csv',
		@overwrite_file=1;

因為 @overwrite_file 參數設為 1，如果檔案已事先存在於 S3，則會覆寫檔案。