Transfert de fichiers entre RDS for SQL Server et Amazon S3

Vous pouvez utiliser les procédures RDS stockées Amazon pour télécharger et charger des fichiers entre Amazon S3 et votre RDS instance de base de données. Vous pouvez également utiliser les procédures RDS stockées d'Amazon pour répertorier et supprimer des fichiers sur l'RDSinstance.

Les fichiers que vous téléchargez depuis/chargez vers S3 sont stockés dans le dossier D:\S3. Il s'agit du seul dossier que vous pouvez utiliser pour accéder à vos fichiers. Vous pouvez organiser vos fichiers en sous-dossiers, qui sont créés pour vous lorsque vous incluez le dossier de destination lors du téléchargement.

Certaines procédures stockées nécessitent que vous fournissiez un Amazon Resource Name (ARN) à votre compartiment et à votre fichier S3. Le format pour votre ARN estarn:aws:s3:::amzn-s3-demo-bucket/file_name. Amazon S3 n'a pas besoin de numéro de compte ni de AWS région dansARNs.

Les tâches d'intégration S3 s'exécutent de manière séquentielle, partagent la même file d'attente que la sauvegarde native et restaurent des tâches. Vous pouvez uniquement disposer de deux tâches maximum en cours à tout moment dans cette file d'attente. Le traitement de la tâche peut mettre jusqu'à cinq minutes avant de commencer.

Téléchargement de fichiers depuis un compartiment Amazon S3 vers une instance de base de données de SQL serveur

Pour télécharger des fichiers depuis un compartiment S3 vers une instance de base de données RDS for SQL Server, utilisez la procédure RDS stockée Amazon msdb.dbo.rds_download_from_s3 avec les paramètres suivants.

Nom du paramètre	Type de données	Par défaut	Obligatoire	Description
@s3_arn_of_file	NVARCHAR	–	Obligatoire	Le S3 ARN du fichier à télécharger, par exemple : arn:aws:s3:::amzn-s3-demo-bucket/mydata.csv
@rds_file_path	NVARCHAR	–	Facultatif	Le chemin du fichier pour l'RDSinstance. Si aucun n'est spécifié, le chemin du fichier est D:\S3\<filename in s3>. RDSprend en charge les chemins absolus et les chemins relatifs. Si vous souhaitez créer un sous-dossier, incluez-le dans le chemin du fichier.
@overwrite_file	INT	0	Facultatif	Écraser le fichier existant : 0 = Ne pas écraser 1 = Écraser

Vous pouvez télécharger des fichiers sans extension de fichier et des fichiers avec les extensions de fichier suivantes : .bcp, .csv, .dat, .fmt, .info, .lst, .tbl, .txt et .xml.

Note

Les fichiers portant l'extension de fichier .ispac peuvent être téléchargés lorsque SQL Server Integration Services est activé. Pour plus d'informations sur l'activationSSIS, consultezSQLServices d'intégration de serveurs.

Les fichiers portant les extensions de fichier suivantes peuvent être téléchargés lorsque SQL Server Analysis Services est activé : .abf, .asdatabase, .configsettings, .deploymentoptions, .deploymenttargets et .xmla. Pour plus d'informations sur l'activationSSAS, consultezSQLServices d'analyse de serveurs.

L'exemple suivant illustre la procédure stockée pour télécharger des fichiers depuis 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; 

L'exemple rds_download_from_s3 créé un dossier nommé seed_data in D:\S3\, si le dossier n'existe pas encore. Ensuite, l'exemple télécharge le fichier source bulk_data.csv depuis S3 vers un nouveau fichier nommé data.csv sur l'instance de base de données. Si le fichier existait déjà, il est écrasé car le paramètre @overwrite_file est défini sur 1.

Téléchargement de fichiers depuis une instance de base de données de SQL serveur vers un compartiment Amazon S3

Pour charger des fichiers depuis une instance de base de données RDS for SQL Server vers un compartiment S3, utilisez la procédure RDS stockée Amazon msdb.dbo.rds_upload_to_s3 avec les paramètres suivants.

Nom du paramètre	Type de données	Par défaut	Obligatoire	Description
@s3_arn_of_file	NVARCHAR	–	Obligatoire	Le S3 ARN du fichier à créer dans S3, par exemple : arn:aws:s3:::amzn-s3-demo-bucket/mydata.csv
@rds_file_path	NVARCHAR	–	Obligatoire	Le chemin du fichier à charger sur S3. Les chemins absolus et relatifs sont pris en charge.
@overwrite_file	INT	–	Facultatif	Écraser le fichier existant : 0 = Ne pas écraser 1 = Écraser

L'exemple suivant télécharge le fichier nommé data.csv depuis l'emplacement spécifié dans D:\S3\seed_data\ un fichier new_data.csv du compartiment S3 spécifié par leARN.

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;

Si le fichier existait déjà dans S3, il est écrasé car le paramètre @overwrite_file est défini sur 1.