Organisasi objek menggunakan prefiks

Anda dapat menggunakan prefiks untuk organisasi data yang Anda simpan di bucket Amazon S3. Prefiks adalah string karakter di bagian awal nama kunci objek. Prefiks dapat memiliki panjang berapa pun, tergantung pada panjang maksimum dari nama kunci objek (1.024 byte). Anda dapat menganggap prefiks sebagai cara untuk mengatur data Anda dengan cara yang mirip dengan direktori. Namun, prefiks bukan direktori.

Pencarian berdasarkan prefiks membatasi hasil hanya pada kunci yang dimulai dengan prefiks tertentu. Pembatas menyebabkan operasi daftar menggabungkan semua kunci yang memiliki prefiks yang sama ke dalam satu hasil daftar ringkasan.

Tujuan dari parameter prefiks dan pembatas adalah untuk membantu Anda mengatur dan kemudian menelusuri kunci Anda secara hierarki. Untuk melakukan hal ini, pertama-tama pilih sebuah pembatas untuk bucket Anda, seperti garis miring (/), yang tidak ada dalam nama kunci mana pun yang Anda antisipasi. Anda dapat menggunakan karakter lain sebagai pembatas. Tidak ada yang unik tentang karakter garis miring (/), tetapi ini adalah pembatas prefiks yang sangat umum. Selanjutnya, buat nama kunci Anda dengan menggabungkan semua tingkat hierarki yang memuatnya, pisahkan setiap tingkat dengan pembatas.

Misalnya, jika Anda menyimpan informasi tentang kota, Anda mungkin mengaturnya berdasarkan benua, lalu berdasarkan negara, lalu berdasarkan provinsi atau negara bagian. Karena nama-nama ini biasanya tidak mengandung tanda baca, Anda dapat menggunakan garis miring (/) sebagai pembatas. Contoh berikut menggunakan pembatas garis miring (/).

Jika Anda menyimpan data untuk setiap kota di dunia dengan cara ini, maka pengelolaan namespace kunci datar akan terasa aneh. Dengan menggunakan Prefix dan Delimiter dengan operasi daftar, Anda dapat menggunakan hierarki yang telah Anda buat untuk mendaftarkan data Anda. Misalnya, untuk membuat daftar semua negara bagian di AS, atur Delimiter='/' dan Prefix='North America/USA/'. Untuk membuat daftar semua provinsi di Kanada yang datanya Anda miliki, atur Delimiter='/' dan Prefix='North America/Canada/'.

Untuk informasi selengkapnya tentang pembatas, prefiks, dan folder bersarang, lihat Perbedaan antara folder prefiks dan bersarang.

Membuat daftar objek menggunakan prefiks dan pembatas

Jika Anda mengeluarkan permintaan daftar dengan pembatas, Anda dapat menelusuri hierarki hanya pada satu tingkat, melompati dan meringkas (mungkin jutaan) kunci yang ada di tingkat yang lebih dalam. Misalnya, asumsikan Anda memiliki bucket (DOC-EXAMPLE-BUCKET) dengan kunci-kunci berikut:

sample.jpg

photos/2006/January/sample.jpg

photos/2006/February/sample2.jpg

photos/2006/February/sample3.jpg

photos/2006/February/sample4.jpg

Bucket sampel hanya memiliki objek sample.jpg pada tingkat root. Untuk mencantumkan objek tingkat root dalam bucket saja, Anda dapat mengirimkan permintaan GET pada bucket dengan karakter pembatas garis miring (/). Sebagai respons, Amazon S3 mengembalikan kunci objek sample.jpg karena tidak mengandung karakter pembatas /. Semua kunci lainnya mengandung karakter pembatas. Amazon S3 mengelompokkan kunci ini dan menampilkan satu CommonPrefixes elemen dengan nilai prefiks photos/, yang merupakan sebuah substring dari awal kunci ini hingga peristiwa pertama dari pembatas yang ditentukan.

<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Name>DOC-EXAMPLE-BUCKET</Name>
  <Prefix></Prefix>
  <Marker></Marker>
  <MaxKeys>1000</MaxKeys>
  <Delimiter>/</Delimiter>
  <IsTruncated>false</IsTruncated>
  <Contents>
    <Key>sample.jpg</Key>
    <LastModified>2011-07-24T19:39:30.000Z</LastModified>
    <ETag>&quot;d1a7fb5eab1c16cb4f7cf341cf188c3d&quot;</ETag>
    <Size>6</Size>
    <Owner>
      <ID>75cc57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
      <DisplayName>displayname</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
  </Contents>
  <CommonPrefixes>
    <Prefix>photos/</Prefix>
  </CommonPrefixes>
</ListBucketResult>

Untuk informasi selengkapnya tentang membuat daftar kunci objek secara terprogram, lihat Membuat daftar kunci objek secara terprogram.