

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Trasferimento di file, oggetti e cartelle specifici tramite filtri
<a name="filtering"></a>

AWS DataSync consente di applicare filtri per includere o escludere dati dalla posizione di origine in un trasferimento. Ad esempio, se non desideri trasferire file temporanei che terminano con`.tmp`, puoi creare un filtro di esclusione in modo che questi file non raggiungano la posizione di destinazione.

È possibile utilizzare una combinazione di filtri di esclusione e inclusione nella stessa operazione di trasferimento. Se modifichi i filtri di un'attività, tali modifiche vengono applicate alla successiva esecuzione dell'attività.

## Filtraggio di termini, definizioni e sintassi
<a name="filter-overview"></a>

Acquisisci familiarità con i concetti relativi al filtraggio: DataSync 

**Filtro **  
L'intera stringa che costituisce un particolare filtro (ad esempio, `*.tmp` `|` `*.temp` o). `/folderA|/folderB`  
I filtri sono costituiti da motivi delimitati da una barra verticale (\$1). Non è necessario un delimitatore quando si aggiungono motivi nella DataSync console perché ogni motivo viene aggiunto separatamente.  
I filtri distinguono tra maiuscole e minuscole Ad esempio, il filtro `/folderA` non corrisponderà`/FolderA`.

**Pattern**  
Un modello all'interno di un filtro. Ad esempio, `*.tmp` è un pattern che fa parte del `*.tmp` `|` `*.temp` filtro. Se il filtro ha più pattern, è possibile delimitare ogni pattern utilizzando una pipe (\$1).

**Cartelle**  
+ Tutti i filtri sono relativi al percorso della posizione di origine. Ad esempio, supponete di specificare `/my_source/` come percorso di origine quando create la posizione e l'attività di origine e di specificare il filtro di inclusione. `/transfer_this/` In questo caso, DataSync trasferisce solo la directory `/my_source/transfer_this/` e il relativo contenuto.
+ Per specificare una cartella direttamente nella posizione di origine, includi una barra (/) davanti al nome della cartella. Nell'esempio precedente, il modello utilizza `/transfer_this`, non `transfer_this`.
+ DataSync interpreta i seguenti modelli allo stesso modo e corrisponde sia alla cartella che al suo contenuto.

  `/dir` 

  `/dir/`
+ Quando trasferisci dati da o verso un bucket Amazon S3 DataSync, considera `/` il carattere nella chiave oggetto come l'equivalente di una cartella su un file system.

**Caratteri speciali**  
Di seguito sono riportati i caratteri speciali per l'uso con i filtri.      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/datasync/latest/userguide/filtering.html)

## Filtri di esempio
<a name="sample-filters"></a>

I seguenti esempi mostrano i filtri più comuni con cui è possibile utilizzare DataSync.

**Nota**  
Esistono dei limiti al numero di caratteri che è possibile utilizzare in un filtro. Per ulteriori informazioni, consulta [DataSync quote](datasync-limits.md#task-hard-limits).

**Esclusione di alcune cartelle dalla posizione di origine**  
In alcuni casi, potresti voler escludere le cartelle nella posizione di origine per non copiarle nella posizione di destinazione. Ad esempio, se hai work-in-progress cartelle temporanee, puoi usare qualcosa come il seguente filtro:

`*/.temp`

Per escludere cartelle con contenuti simili (come `/reports2021` e`/reports2022)`), puoi utilizzare un filtro di esclusione come il seguente:

`/reports*`

Per escludere cartelle a qualsiasi livello nella gerarchia dei file, puoi utilizzare un filtro di esclusione come il seguente. 

`*/folder-to-exclude-1`\$1`*/folder-to-exclude-2`

Per escludere le cartelle al livello superiore della posizione di origine, puoi utilizzare un filtro di esclusione come il seguente. 

`/top-level-folder-to-exclude-1`\$1`/top-level-folder-to-exclude-2`

**Includi un sottoinsieme di cartelle nella posizione di origine**  
In alcuni casi, la posizione di origine potrebbe essere una condivisione di grandi dimensioni ed è necessario trasferire un sottoinsieme delle cartelle nella cartella principale. Per includere cartelle specifiche, avvia un'esecuzione dell'attività con un filtro di inclusione come il seguente.

`/folder-to-transfer/*`

**Escludere tipi di file specifici**  
Per escludere alcuni tipi di file dal trasferimento, puoi creare un'esecuzione dell'attività con un filtro di esclusione come `*.temp`.

**Trasferisci singoli file da te specificati**  
Per trasferire un elenco di singoli file, avviate l'esecuzione di un'attività con un filtro di inclusione come il seguente: "`/folder/subfolder/file1.txt`\$1 `/folder/subfolder/file2.txt` \$1`/folder/subfolder/file2.txt`»

## Creazione di filtri di inclusione
<a name="include-filters"></a>

I filtri di inclusione definiscono i file, gli oggetti e le cartelle che si desidera DataSync trasferire. È possibile configurare i filtri di inclusione quando si crea, si modifica o si avvia un'attività.

DataSync esegue la scansione e trasferisce solo i file e le cartelle che corrispondono ai filtri di inclusione. Ad esempio, per includere un sottoinsieme delle cartelle di origine, è possibile specificare `/important_folder_1` \$1. `/important_folder_2` 

**Nota**  
I filtri di inclusione supportano il carattere jolly (\$1) solo come carattere più a destra in uno schema. Ad esempio, `/documents*` \$1 `/code*` è supportato, ma non `*.txt` lo è.

### Utilizzo della DataSync console
<a name="include-filters-console"></a>

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, scegli **Attività**, quindi scegli **Crea attività**.

1. Configura le posizioni di origine e di destinazione dell'attività.

   Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md)

1. **Per i contenuti da scansionare**, scegli **File, oggetti e cartelle specifici**, quindi seleziona **Utilizzo dei filtri**.

1. Per **Include**, inserisci il filtro (ad esempio, `/important_folders` per includere una directory importante), quindi scegli **Aggiungi modello**.

1. Aggiungi altri filtri di inclusione, se necessario. 

### Usando il AWS CLI
<a name="include-filters-cli"></a>

Quando si utilizza il AWS CLI, è necessario utilizzare le virgolette singole (`'`) attorno al filtro e un \$1 (pipe) come delimitatore se si dispone di più di un filtro.

L'esempio seguente specifica due filtri di inclusione `/important_folder1` e `/important_folder2` quando si esegue il comando. `create-task`

```
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'
```

## Creazione di filtri di esclusione
<a name="exclude-filters"></a>

I filtri di esclusione definiscono i file, gli oggetti e le cartelle nella posizione di origine che non desideri DataSync trasferire. Puoi configurare questi filtri quando crei, modifichi o inizi un'attività.

**Topics**
+ [Dati esclusi per impostazione predefinita](#directories-ignored-during-transfers)

### Dati esclusi per impostazione predefinita
<a name="directories-ignored-during-transfers"></a>

DataSync esclude automaticamente alcuni dati dal trasferimento:
+ `.snapshot`— DataSync ignora qualsiasi percorso che termina con`.snapshot`, che in genere viene utilizzato per le point-in-time istantanee dei file o delle directory di un sistema di storage.
+ `/.aws-datasync`e `/.awssync` — DataSync crea queste cartelle nella posizione dell'utente per facilitare il trasferimento.
+ `/.zfs`— Potresti vedere questa cartella con le sedi di Amazon FSx for OpenZFS.

### Utilizzo della console DataSync
<a name="adding-exclude-filters"></a>

1. Apri la AWS DataSync console all'indirizzo [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Nel riquadro di navigazione a sinistra, scegli **Attività**, quindi scegli **Crea attività**.

1. Configura le posizioni di origine e di destinazione dell'attività.

   Per ulteriori informazioni, consulta [Con chi posso trasferire i miei dati AWS DataSync?](working-with-locations.md)

1. Per **Escludi**, inserisci il filtro (ad esempio, `*/temp` per escludere le cartelle temporanee), quindi scegli **Aggiungi modello**.

1. Aggiungi altri filtri di esclusione, se necessario. 

1. Se necessario, aggiungi [filtri di inclusione](#include-filters).

### Usando il AWS CLI
<a name="adding-exclude-filters-cli"></a>

Quando si utilizza il AWS CLI, è necessario utilizzare le virgolette singole (`'`) attorno al filtro e un \$1 (pipe) come delimitatore se si dispone di più di un filtro. 

L'esempio seguente specifica due filtri di esclusione `*/temp` e `*/tmp` quando esegue il comando. `create-task`

```
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'
```