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

# Memahami awalan khusus untuk objek Amazon S3
<a name="s3-prefixes"></a>

<evaluated prefix><suffix>Objek yang dikirim ke Amazon S3 mengikuti [format nama](https://docs.aws.amazon.com/firehose/latest/dev/basic-deliver.html#s3-object-namekey). Anda dapat menentukan awalan kustom yang menyertakan ekspresi yang dievaluasi saat runtime. Awalan kustom yang Anda tentukan akan mengganti awalan default. `yyyy/MM/dd/HH`

Anda dapat menggunakan ekspresi formulir berikut dalam awalan kustom Anda:`!{namespace:{{value}}}`, di mana `namespace` bisa menjadi salah satu dari yang berikut, seperti yang dijelaskan di bagian berikut.
+  `firehose` 
+ `timestamp`
+ `partitionKeyFromQuery`
+ `partitionKeyFromLambda`

Jika prefiks berakhir dengan garis miring (/), itu akan muncul sebagai folder dalam bucket Amazon S3. Untuk informasi selengkapnya, lihat [Format Nama Objek Amazon S3](https://docs.aws.amazon.com/firehose/latest/dev/basic-deliver.html#s3-object-name) di Panduan *Data FirehoseDeveloper Amazon*.

## `timestamp`namespace
<a name="timestamp-namespace"></a>

[Nilai yang valid untuk namespace ini adalah string yang merupakan string Java yang valid. DateTimeFormatter](https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html) Sebagai contoh, pada tahun 2018, ekspresi `!{timestamp:yyyy}` memberi nilai `2018`. 

Saat mengevaluasi stempel waktu, Firehose menggunakan perkiraan stempel waktu kedatangan dari catatan tertua yang terdapat dalam objek Amazon S3 yang sedang ditulis. 

Secara default, stempel waktu ada di UTC. Tapi, Anda dapat menentukan zona waktu yang Anda inginkan. Misalnya, Anda dapat mengonfigurasi zona waktu ke Asia/Tokyo dalam Konsol Manajemen AWS atau dalam pengaturan parameter API ([CustomTimeZone](https://docs.aws.amazon.com/firehose/latest/APIReference/API_ExtendedS3DestinationConfiguration.html)) jika Anda ingin menggunakan Waktu Standar Jepang, bukan UTC. Untuk melihat daftar zona waktu yang didukung, lihat Format [Nama Objek Amazon S3](https://docs.aws.amazon.com/firehose/latest/dev/basic-deliver.html#s3-object-name).

Jika Anda menggunakan namespace `timestamp` lebih dari sekali dalam ekspresi prefiks yang sama, setiap instans akan memberi nilai waktu yang sama.

## `firehose`namespace
<a name="firehose-namespace"></a>

Ada dua nilai yang dapat Anda gunakan dengan namespace ini: `error-output-type` dan `random-string`. Tabel berikut menjelaskan cara menggunakannya.


**Nilai namespace `firehose`**  

| Konversi | Deskripsi | Contoh input | Contoh Output | Catatan | 
| --- | --- | --- | --- | --- | 
| error-output-type | Mengevaluasi ke salah satu string berikut, tergantung pada konfigurasi aliran Firehose Anda, dan alasan kegagalan: {processing-failed, AmazonOpenSearchService -failed, splunk-failed,,}. format-conversion-failed http-endpoint-failedJika Anda menggunakannya lebih dari sekali dalam ekspresi yang sama, setiap instans akan memberi nilai string kesalahan yang sama. | myPrefix/result=\!{firehose:error-output-type}/\!{timestamp:yyyy/MM/dd} | myPrefix/result=processing-failed/2018/08/03 |  error-output-typeNilai hanya dapat digunakan di ErrorOutputPrefix lapangan. | 
| random-string | Memberi nilai string acak berisi 11 karakter. Jika Anda menggunakannya lebih dari sekali dalam ekspresi yang sama, setiap instans akan memberi nilai string acak baru. | myPrefix/\!{firehose:random-string}/ | myPrefix/046b6c7f-0b/ | Anda dapat menggunakannya dengan kedua jenis prefiks tersebut.Anda dapat menempatkannya di awal string format untuk mendapatkan prefiks acak, yang kadang-kadang diperlukan untuk mencapai throughput yang sangat tinggi dengan Amazon S3. | 

## `partitionKeyFromLambda`dan ruang `partitionKeyFromQuery` nama
<a name="dynamic-partitioning-namespaces"></a>

Untuk [partisi dinamis](dynamic-partitioning.md), Anda harus menggunakan format ekspresi berikut di awalan bucket S3:`!{namespace:value}`, di mana namespace dapat berupa atau, atau keduanya. `partitionKeyFromQuery` `partitionKeyFromLambda` Jika Anda menggunakan penguraian inline untuk membuat kunci partisi untuk data sumber Anda, Anda harus menentukan nilai awalan bucket S3 yang terdiri dari ekspresi yang ditentukan dalam format berikut:. `"partitionKeyFromQuery:keyID"` Jika Anda menggunakan fungsi AWS Lambda untuk membuat kunci partisi untuk data sumber Anda, Anda harus menentukan nilai awalan bucket S3 yang terdiri dari ekspresi yang ditentukan dalam format berikut:. `"partitionKeyFromLambda:keyID"` Untuk informasi selengkapnya, lihat “Pilih Amazon S3 untuk Tujuan Anda” di [Membuat aliran Amazon Firehose](basic-create.md#basic-create.title).

## Aturan semantik
<a name="prefix-rules"></a>

Aturan berikut berlaku untuk ekspresi `Prefix` dan `ErrorOutputPrefix`.
+ Untuk namespace `timestamp`, setiap karakter yang tidak diapit tanda kutip tunggal akan diberi nilai. Dengan kata lain, string yang tidak menggunakan tanda kutip tunggal di bidang nilai akan ditafsirkan secara harfiah.
+ Jika Anda menentukan awalan yang tidak berisi ekspresi namespace stempel waktu, Firehose menambahkan ekspresi ke nilai di `!{timestamp:yyyy/MM/dd/HH/}` bidang. `Prefix`
+ Urutan `!{` hanya dapat muncul dalam ekspresi `!{namespace:{{value}}}`.
+ `ErrorOutputPrefix` boleh null hanya jika `Prefix` tidak mengandung ekspresi apa pun. Dalam kasus ini, `Prefix` memberi nilai `<specified-prefix>yyyy/MM/DDD/HH/` dan `ErrorOutputPrefix` memberi nilai `<specified-prefix><error-output-type>yyyy/MM/DDD/HH/`. `DDD` mewakili hari ke berapa dalam tahun itu.
+ Jika Anda menentukan ekspresi untuk `ErrorOutputPrefix`, Anda harus menyertakan setidaknya satu instans dari `!{firehose:error-output-type}`.
+ `Prefix` tidak boleh berisi `!{firehose:error-output-type}`.
+ Baik `Prefix` maupun `ErrorOutputPrefix` boleh berisi lebih dari 512 karakter setelah diberi nilai.
+ Jika tujuannya adalah Amazon Redshift, `Prefix` tidak boleh berisi ekspresi dan `ErrorOutputPrefix` harus null.
+ Jika tujuannya adalah Amazon OpenSearch Service atau Splunk, dan tidak `ErrorOutputPrefix` ditentukan, Firehose menggunakan bidang untuk `Prefix` catatan gagal. 
+ Ketika tujuannya adalah Amazon S3, `Prefix` dan `ErrorOutputPrefix` dalam konfigurasi tujuan Amazon S3 secara berurutan digunakan untuk catatan yang berhasil dan catatan yang gagal. Jika Anda menggunakan AWS CLI atau API, Anda dapat menggunakan `ExtendedS3DestinationConfiguration` untuk menentukan konfigurasi *pencadangan* Amazon S3 dengan `Prefix` dan `ErrorOutputPrefix`-nya sendiri.
+ Saat Anda menggunakan Konsol Manajemen AWS dan mengatur tujuan ke Amazon S3, Firehose masing-masing menggunakan `Prefix` dan `ErrorOutputPrefix` dalam konfigurasi tujuan untuk catatan yang berhasil dan catatan gagal. Jika Anda menentukan awalan menggunakan ekspresi, Anda harus menentukan awalan kesalahan termasuk. `!{firehose:error-output-type}`
+ Saat Anda menggunakan `ExtendedS3DestinationConfiguration` AWS CLI, API, atau CloudFormation, jika Anda menentukan`S3BackupConfiguration`, Firehose tidak menyediakan default. `ErrorOutputPrefix`
+ Anda tidak dapat menggunakan `partitionKeyFromLambda` dan `partitionKeyFromQuery` ruang nama saat membuat ErrorOutputPrefix ekspresi.

## Contoh prefiks
<a name="s3-prefix-examples"></a>


**Contoh `Prefix` dan `ErrorOutputPrefix`**  

| Input | Prefiks yang diberi nilai (pukul 10:30 UTC pada 27 Agt 2018) | 
| --- | --- | 
| `Prefix`: Tidak ditentukan<br />`ErrorOutputPrefix`: `myFirehoseFailures/!{firehose:error-output-type}/` | `Prefix`: `2018/08/27/10`<br />`ErrorOutputPrefix`: `myFirehoseFailures/processing-failed/` | 
| `Prefix`: `!{timestamp:yyyy/MM/dd}`<br />`ErrorOutputPrefix`: Tidak ditentukan | Input tidak valid: ErrorOutputPrefix tidak boleh null ketika Prefiks berisi ekspresi | 
| `Prefix`: `myFirehose/DeliveredYear=!{timestamp:yyyy}/anyMonth/rand=!{firehose:random-string}`<br />`ErrorOutputPrefix`: `myFirehoseFailures/!{firehose:error-output-type}/!{timestamp:yyyy}/anyMonth/!{timestamp:dd}` | `Prefix`: `myFirehose/DeliveredYear=2018/anyMonth/rand=5abf82daaa5`<br />`ErrorOutputPrefix`: `myFirehoseFailures/processing-failed/2018/anyMonth/10` | 
| `Prefix`: `myPrefix/year=!{timestamp:yyyy}/month=!{timestamp:MM}/day=!{timestamp:dd}/hour=!{timestamp:HH}/`<br />`ErrorOutputPrefix`: `myErrorPrefix/year=!{timestamp:yyyy}/month=!{timestamp:MM}/day=!{timestamp:dd}/hour=!{timestamp:HH}/!{firehose:error-output-type}` | `Prefix`: `myPrefix/year=2018/month=07/day=06/hour=23/`<br />`ErrorOutputPrefix`: `myErrorPrefix/year=2018/month=07/day=06/hour=23/processing-failed` | 
| `Prefix`: `myFirehosePrefix/`<br />`ErrorOutputPrefix`: Tidak ditentukan | `Prefix`: `myFirehosePrefix/2018/08/27/`<br />`ErrorOutputPrefix`: `myFirehosePrefix/processing-failed/2018/08/27/` |