Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mentransfer file, objek, dan folder tertentu dengan menggunakan filter
<a name="filtering"></a>

AWS DataSync memungkinkan Anda menerapkan filter untuk menyertakan atau mengecualikan data dari lokasi sumber Anda dalam transfer. Misalnya, jika Anda tidak ingin mentransfer file sementara yang diakhiri dengan`.tmp`, Anda dapat membuat filter pengecualian sehingga file-file ini tidak sampai ke lokasi tujuan Anda.

Anda dapat menggunakan kombinasi pengecualian dan menyertakan filter dalam tugas transfer yang sama. Jika Anda memodifikasi filter tugas, perubahan tersebut akan diterapkan saat berikutnya Anda menjalankan tugas.

## Memfilter istilah, ketentuan, dan sintaks
<a name="filter-overview"></a>

Biasakan diri Anda dengan konsep yang terkait dengan DataSync penyaringan:

**Filter **  
Seluruh string yang membentuk filter tertentu (misalnya, `*.tmp` `|` `*.temp` atau`/folderA|/folderB`).  
Filter terdiri dari pola yang dibatasi dengan menggunakan pipa (\$1). Anda tidak memerlukan pembatas saat menambahkan pola di DataSync konsol karena Anda menambahkan setiap pola secara terpisah.  
Filter peka huruf besar/kecil. Misalnya, filter `/folderA` tidak akan cocok`/FolderA`.

**Pola**  
Sebuah pola di dalam filter. Misalnya, `*.tmp` adalah pola yang merupakan bagian dari `*.tmp` `|` `*.temp` filter. Jika filter Anda memiliki beberapa pola, Anda membatasi setiap pola dengan menggunakan pipa (\$1).

**Folder**  
+ Semua filter adalah relatif terhadap jalur lokasi sumber. Misalnya, misalkan Anda menentukan `/my_source/` sebagai jalur sumber saat Anda membuat lokasi dan tugas sumber Anda dan tentukan filter sertakan`/transfer_this/`. Dalam hal ini, DataSync transfer hanya direktori `/my_source/transfer_this/` dan isinya.
+ Untuk menentukan folder langsung di bawah lokasi sumber, sertakan garis miring (/) di depan nama folder. Dalam contoh sebelumnya, pola menggunakan `/transfer_this`, bukan `transfer_this`.
+ DataSync menafsirkan pola berikut dengan cara yang sama dan cocok dengan folder dan isinya.

  `/dir` 

  `/dir/`
+ Saat Anda mentransfer data dari atau ke bucket Amazon S3 DataSync, memperlakukan `/` karakter dalam kunci objek sebagai setara dengan folder pada sistem file.

**Karakter-karakter khusus**  
Berikut ini adalah karakter khusus untuk digunakan dengan pemfilteran.      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/datasync/latest/userguide/filtering.html)

## Contoh filter
<a name="sample-filters"></a>

Contoh berikut menunjukkan filter umum yang dapat Anda gunakan DataSync.

**catatan**  
Ada batasan berapa banyak karakter yang dapat Anda gunakan dalam filter. Untuk informasi selengkapnya, lihat [DataSync kuota](datasync-limits.md#task-hard-limits).

**Kecualikan beberapa folder dari lokasi sumber Anda**  
Dalam beberapa kasus, Anda ingin mengecualikan folder di lokasi sumber Anda untuk tidak menyalinnya ke lokasi tujuan Anda. Misalnya, jika Anda memiliki work-in-progress folder sementara, Anda dapat menggunakan sesuatu seperti filter berikut:

`*/.temp`

Untuk mengecualikan folder dengan konten serupa (seperti `/reports2021` dan`/reports2022)`), Anda dapat menggunakan filter pengecualian seperti berikut:

`/reports*`

Untuk mengecualikan folder di tingkat mana pun dalam hierarki file, Anda dapat menggunakan filter pengecualian seperti berikut ini. 

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

Untuk mengecualikan folder di tingkat atas lokasi sumber, Anda dapat menggunakan filter pengecualian seperti berikut ini. 

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

**Sertakan subset folder di lokasi sumber Anda**  
Dalam beberapa kasus, lokasi sumber Anda mungkin merupakan bagian yang besar dan Anda perlu mentransfer subset folder di bawah root. Untuk menyertakan folder tertentu, mulai eksekusi tugas dengan filter penyertaan seperti berikut.

`/folder-to-transfer/*`

**Kecualikan tipe file tertentu**  
Untuk mengecualikan tipe file tertentu dari transfer, Anda dapat membuat eksekusi tugas dengan filter pengecualian seperti `*.temp`.

**Transfer file individual yang Anda tentukan**  
Untuk mentransfer daftar file individual, mulai eksekusi tugas dengan menyertakan filter seperti berikut: "`/folder/subfolder/file1.txt`\$1`/folder/subfolder/file2.txt`\$1`/folder/subfolder/file2.txt`"

## Membuat filter termasuk
<a name="include-filters"></a>

Sertakan filter menentukan file, objek, dan folder yang DataSync ingin Anda transfer. Anda dapat mengonfigurasi filter sertakan saat membuat, mengedit, atau memulai tugas.

DataSync memindai dan mentransfer hanya file dan folder yang cocok dengan filter include. Misalnya, untuk menyertakan subset folder sumber Anda, Anda dapat menentukan `/important_folder_1` \$1`/important_folder_2`. 

**catatan**  
Sertakan filter yang mendukung karakter wildcard (\$1) hanya sebagai karakter paling kanan dalam suatu pola. Misalnya, `/documents*` \$1 `/code*` didukung, tetapi `*.txt` tidak.

### Menggunakan DataSync konsol
<a name="include-filters-console"></a>

1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Di panel navigasi kiri, pilih **Tugas**, lalu pilih **Buat tugas**.

1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.

   Untuk informasi selengkapnya, lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)

1. **Agar Konten dapat dipindai**, pilih **File, objek, dan folder tertentu**, lalu pilih **Menggunakan filter**.

1. Untuk **Termasuk**, masukkan filter Anda (misalnya, `/important_folders` untuk menyertakan direktori penting), lalu pilih **Tambah pola**.

1. Tambahkan filter sertakan lainnya sesuai kebutuhan. 

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

Saat menggunakan AWS CLI, Anda harus menggunakan tanda kutip tunggal (`'`) di sekitar filter dan \$1 (pipa) sebagai pembatas jika Anda memiliki lebih dari satu filter.

Contoh berikut menentukan dua termasuk filter `/important_folder1` dan `/important_folder2` ketika menjalankan `create-task` perintah.

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

## Membuat filter pengecualian
<a name="exclude-filters"></a>

Kecualikan filter menentukan file, objek, dan folder di lokasi sumber yang tidak DataSync ingin Anda transfer. Anda dapat mengonfigurasi filter ini saat membuat, mengedit, atau memulai tugas.

**Topics**
+ [Data dikecualikan secara default](#directories-ignored-during-transfers)

### Data dikecualikan secara default
<a name="directories-ignored-during-transfers"></a>

DataSync secara otomatis mengecualikan beberapa data agar tidak ditransfer:
+ `.snapshot`— DataSync mengabaikan jalur yang diakhiri dengan`.snapshot`, yang biasanya digunakan untuk point-in-time snapshot file atau direktori sistem penyimpanan.
+ `/.aws-datasync`dan `/.awssync` — DataSync membuat folder ini di lokasi Anda untuk membantu memfasilitasi transfer Anda.
+ `/.zfs`— Anda mungkin melihat folder ini dengan Amazon FSx untuk lokasi OpenZFS.

### Menggunakan DataSync konsol
<a name="adding-exclude-filters"></a>

1. Buka AWS DataSync konsol di [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).

1. Di panel navigasi kiri, pilih **Tugas**, lalu pilih **Buat tugas**.

1. Konfigurasikan lokasi sumber dan tujuan tugas Anda.

   Untuk informasi selengkapnya, lihat [Di mana saya dapat mentransfer data saya AWS DataSync?](working-with-locations.md)

1. Untuk **Excludes**, masukkan filter Anda (misalnya, `*/temp` untuk mengecualikan folder sementara), lalu pilih **Tambah pola**.

1. Tambahkan filter pengecualian lainnya sesuai kebutuhan. 

1. Jika perlu, tambahkan [filter sertakan](#include-filters).

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

Saat menggunakan AWS CLI, Anda harus menggunakan tanda kutip tunggal (`'`) di sekitar filter dan \$1 (pipa) sebagai pembatas jika Anda memiliki lebih dari satu filter. 

Contoh berikut menentukan dua mengecualikan filter `*/temp` dan `*/tmp` ketika menjalankan `create-task` perintah.

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