Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
AWS DataSync vous permet d'appliquer des filtres pour inclure ou exclure des données de votre emplacement source lors d'un transfert. Par exemple, si vous ne souhaitez pas transférer des fichiers temporaires se terminant par.tmp
, vous pouvez créer un filtre d'exclusion afin que ces fichiers ne soient pas acheminés vers votre emplacement de destination.
Vous pouvez utiliser une combinaison de filtres d'exclusion et d'inclusion dans la même tâche de transfert. Si vous modifiez les filtres d'une tâche, ces modifications seront appliquées lors de la prochaine exécution de la tâche.
Termes, définitions et syntaxe de filtrage
Familiarisez-vous avec les concepts liés au DataSync filtrage :
- Filtre
-
La chaîne complète qui constitue un filtre particulier (par exemple,
*.tmp
|
*.temp
ou/folderA|/folderB
).Les filtres sont constitués de motifs délimités à l'aide d'un tube (|). Vous n'avez pas besoin de délimiteur lorsque vous ajoutez des modèles dans la DataSync console, car vous ajoutez chaque modèle séparément.
Note
Les filtres font la distinction majuscules/minuscules. Par exemple, le filtre
/folderA
ne correspondra pas/FolderA
. - Modèle
-
Modèle interne à un filtre. Par exemple,
*.tmp
il s'agit d'un motif qui fait partie du*.tmp
|
*.temp
filtre. Si votre filtre comporte plusieurs modèles, vous délimitez chaque motif à l'aide d'un tube (|). - Dossiers
-
-
Tous les filtres se rapportent au chemin de l'emplacement source. Supposons, par exemple, que vous spécifiez
/my_source/
comme chemin source lorsque vous créez votre emplacement source et votre tâche et que vous spécifiez le filtre d'inclusion/transfer_this/
. Dans ce cas, DataSync transfère uniquement le répertoire/my_source/transfer_this/
et son contenu. -
Pour spécifier un dossier directement sous l'emplacement source, insérez une barre oblique (/) devant le nom du dossier. Dans l'exemple précédent, le modèle utilise
/transfer_this
et non pastransfer_this
. -
DataSync interprète les modèles suivants de la même manière et fait correspondre à la fois le dossier et son contenu.
/dir
/dir/
-
Lorsque vous transférez des données depuis ou vers un compartiment Amazon S3, DataSync traitez le
/
caractère de la clé d'objet comme l'équivalent d'un dossier dans un système de fichiers.
-
- Caractères spéciaux
-
Les caractères spéciaux à utiliser avec le filtrage sont les suivants.
Caractère spécial Description *
(caractère générique)Caractère correspondant à zéro, un ou plusieurs caractères. Par exemple,
/movies_folder*
correspond à la fois à/movies_folder
et à/movies_folder1
.|
(barre verticale de séparation)Caractère utilisé comme délimiteur entre des modèles. Il permet de spécifier plusieurs modèles, dont chacun peut correspondre au filtre. Par exemple,
*.tmp
|
*.temp
correspond aux fichiers se terminant partmp
ou partemp
.Note
Ce délimiteur n'est pas nécessaire lorsque vous ajoutez des modèles sur la console, car vous ajoutez chaque modèle sur une ligne distincte.
\
(barre oblique inverse)Caractère utilisé pour échapper aux caractères spéciaux (*, |, \) du nom d'un fichier ou d'un objet.
Une double barre oblique inverse (\\) est requise lorsqu'une barre oblique inverse figure dans un nom de fichier. De la même façon, \\\\ représente deux barres obliques inverses consécutives dans un nom de fichier.
Une barre oblique inverse suivie d'une barre verticale (\|) est requise lorsqu'une barre verticale figure dans un nom de fichier.
Une barre oblique inverse (\) suivie de tout autre caractère, ou à la fin d'un modèle, est ignorée.
Exemples de filtres
Les exemples suivants montrent les filtres courants que vous pouvez utiliser DataSync.
Note
Le nombre de caractères que vous pouvez utiliser dans un filtre est limité. Pour de plus amples informations, veuillez consulter DataSync quotas.
Exclusion de certains dossiers de votre emplacement source
Dans certains cas, vous souhaiterez peut-être exclure des dossiers de votre emplacement source afin de ne pas les copier vers votre emplacement de destination. Par exemple, si vous avez work-in-progress des dossiers temporaires, vous pouvez utiliser le filtre suivant :
*/.temp
Pour exclure des dossiers présentant un contenu similaire (tel que /reports2021
et/reports2022)
), vous pouvez utiliser un filtre d'exclusion tel que le suivant :
/reports*
Pour exclure des dossiers à n'importe quel niveau de la hiérarchie des fichiers, vous pouvez utiliser un filtre d'exclusion comme celui-ci.
*/folder-to-exclude-1
|*/folder-to-exclude-2
Pour exclure des dossiers situés au niveau supérieur de l'emplacement source, vous pouvez utiliser un filtre d'exclusion tel que le suivant.
/top-level-folder-to-exclude-1
|/top-level-folder-to-exclude-2
Inclure un sous-ensemble de dossiers sur votre emplacement source
Dans certains cas, votre emplacement source peut être une part importante et vous devez transférer un sous-ensemble des dossiers sous la racine. Pour inclure des dossiers spécifiques, démarrez une exécution de tâche avec un filtre d'inclusion similaire au suivant.
/folder-to-transfer/*
Exclusion de types de fichiers spécifiques
Pour exclure du transfert certains types de fichiers, vous pouvez créer une exécution de tâche avec un filtre d'exclusion tel que *.temp
.
Transférez les fichiers individuels que vous spécifiez
Pour transférer une liste de fichiers individuels, lancez l'exécution d'une tâche avec un filtre d'inclusion tel que celui-ci : « /folder/subfolder/file1.txt
| /folder/subfolder/file2.txt
| /folder/subfolder/file2.txt
»
Création de filtres d'inclusion
Les filtres d'inclusion définissent les fichiers, les objets et les dossiers que vous DataSync souhaitez transférer. Vous pouvez configurer des filtres d'inclusion lorsque vous créez, modifiez ou démarrez une tâche.
DataSync analyse et transfère uniquement les fichiers et dossiers qui correspondent aux filtres d'inclusion. Par exemple, pour inclure un sous-ensemble de vos dossiers sources, vous pouvez spécifier /important_folder_1
|/important_folder_2
.
Note
Les filtres d'inclusion prennent en charge le caractère générique (*) uniquement en tant que caractère le plus à droite d'un modèle. Par exemple, /documents*
| /code*
est pris en charge, mais ne l'*.txt
est pas.
Ouvrez la AWS DataSync console à l'adresse https://console.aws.amazon.com/datasync/
. -
Dans le volet de navigation de gauche, choisissez Tâches, puis sélectionnez Créer une tâche.
-
Configurez les emplacements source et de destination de votre tâche.
Pour plus d’informations, consultez Où puis-je transférer mes données AWS DataSync ?.
-
Pour le contenu à scanner, sélectionnez Fichiers, objets et dossiers spécifiques, puis sélectionnez Utiliser des filtres.
-
Pour Includes, entrez votre filtre (par exemple,
/important_folders
pour inclure un répertoire important), puis choisissez Ajouter un modèle. -
Ajoutez d'autres filtres d'inclusion si nécessaire.
Lorsque vous utilisez le AWS CLI, vous devez utiliser des guillemets simples ('
) autour du filtre et un | (tube) comme séparateur si vous avez plusieurs filtres.
L'exemple suivant indique deux filtres d'inclusion /important_folder1
et /important_folder2
lors de l'exécution de la create-task
commande.
aws datasync create-task --source-location-arn 'arn:aws:datasync:
region
:account-id
:location/location-id
' \ --destination-location-arn 'arn:aws:datasync:region
:account-id
:location/location-id
' \ --includes FilterType=SIMPLE_PATTERN,Value='/important_folder1|/important_folder2'
Création de filtres d'exclusion
Les filtres d'exclusion définissent les fichiers, les objets et les dossiers de votre emplacement source que vous ne DataSync souhaitez pas transférer. Vous pouvez configurer ces filtres lorsque vous créez, modifiez ou démarrez une tâche.
Rubriques
Données exclues par défaut
DataSync exclut automatiquement le transfert de certaines données :
-
.snapshot
— DataSync ignore tout chemin se terminant par.snapshot
, qui est généralement utilisé pour les point-in-time instantanés des fichiers ou des répertoires d'un système de stockage. -
/.aws-datasync
et/.awssync
— DataSync crée ces dossiers dans votre région pour faciliter votre transfert. -
/.zfs
— Vous pouvez voir ce dossier avec Amazon FSx pour les emplacements OpenZFS.
Ouvrez la AWS DataSync console à l'adresse https://console.aws.amazon.com/datasync/
. -
Dans le volet de navigation de gauche, choisissez Tâches, puis sélectionnez Créer une tâche.
-
Configurez les emplacements source et de destination de votre tâche.
Pour plus d’informations, consultez Où puis-je transférer mes données AWS DataSync ?.
-
Pour Exclusions, entrez votre filtre (par exemple,
*/temp
pour exclure des dossiers temporaires), puis choisissez Ajouter un modèle. -
Ajoutez d'autres filtres d'exclusion selon vos besoins.
-
Si nécessaire, ajoutez des filtres d'inclusion.
Lorsque vous utilisez le AWS CLI, vous devez utiliser des guillemets simples ('
) autour du filtre et un | (tube) comme séparateur si vous avez plusieurs filtres.
L'exemple suivant indique deux filtres d'exclusion */temp
et */tmp
lors de l'exécution de la create-task
commande.
aws datasync create-task \ --source-location-arn 'arn:aws:datasync:
region
:account-id
:location/location-id
' \ --destination-location-arn 'arn:aws:datasync:region
:account-id
:location/location-id
' \ --excludes FilterType=SIMPLE_PATTERN,Value='*/temp|*/tmp'