View a markdown version of this page

Vorlage für einen S3-Ausgabeschlüssel für die Amazon S3-Lieferung - Amazon Kinesis Data Streams
StandardvorlageVorlagenvariablenRegeln für VorlagenGültige und ungültige Beispiele

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Vorlage für einen S3-Ausgabeschlüssel für die Amazon S3-Lieferung

Bei der Lieferung an Amazon S3-Buckets für allgemeine Zwecke können Sie eine S3-Ausgabeschlüsselvorlage konfigurieren, um die Objektschlüsselstruktur der bereitgestellten Dateien zu steuern. Die Schlüsselvorlage ist optional — falls nicht angegeben, verwendet Amazon S3-Versand die Standardvorlage.

Standardvorlage

Wenn Sie keine benutzerdefinierte Schlüsselvorlage angeben, verwendet Amazon S3-Versand die folgende Standardeinstellung: 

kinesis-channel/!{channel-name}/!{channel-id}/!{yyyy}/!{MM}/!{dd}/!{HH}/!{channel-name}-!{channel-id}-!{yyyy}-!{MM}-!{dd}-!{HH}-!{mm}!{extension}

Der Teil vor dem letzten Schrägstrich (/) bildet das Objektschlüsselpräfix (die Ordnerstruktur), und das letzte Segment bildet den Objektnamen. Die Standardvorlage organisiert die gelieferten Objekte nach Kanal und Stunde und wiederholt dieselben Werte im Objektnamen, sodass jedes Objekt sich selbst beschreibt. Amazon Kinesis Data Streams hängt automatisch an jeden Objektschlüssel ein eindeutiges Suffix an, sodass Objektschlüssel auch dann eindeutig sind, wenn die Vorlage keine Zeitkomponente enthält, die fein genug ist, um sie zu unterscheiden.

Vorlagenvariablen

Die folgenden Variablen stehen für die Verwendung in Ihrer Schlüsselvorlage zur Verfügung:

Variablen für S3-Schlüsselvorlagen
Variable Description Beispielwert
!{channel-name} Der Name der Lieferung. my-channel
!{channel-id} Die eindeutige Kennung der Lieferung. abc123def456
!{stream-name} Der Name des Kinesis Data Streams-Quellstreams. my-stream
!{yyyy} Four-digit Jahr (UTC). 2026
!{yy} Two-digit Jahr (UTC). 26
!{MM} Two-digit Monat (UTC), mit Nullen aufgefüllt. 07
!{dd} Two-digit Tag des Monats (UTC), mit Nullen aufgefüllt. 20
!{HH} Two-digit Stunde (UTC, 24 Stunden), mit Nullen aufgefüllt. 14
!{mm} Two-digit Minute (UTC), mit Nullen aufgefüllt. 30
!{extension} Eine vom konfigurierten Komprimierungstyp abgeleitete Dateierweiterung (z. B. für GZIP oder .gz .zst für ZSTD). Falls vorhanden, muss sie am Ende der Vorlage erscheinen. .gz
!{extension:.literal} Eine literale Dateierweiterung, die Sie angeben. Muss mit einem Punkt beginnen und darf nur Kleinbuchstaben und Punkte enthalten. Falls vorhanden, muss es am Ende der Vorlage erscheinen. !{extension:.json}

Regeln für Vorlagen

Wichtige Vorlagen müssen den folgenden Regeln entsprechen:

  • Nachdem alle Variablen erweitert wurden, darf der resultierende Objektschlüssel das Amazon S3-Objektschlüssellimit von 1.024 Zeichen nicht überschreiten. Da Amazon Kinesis Data Streams ein eindeutiges Suffix von bis zu 38 Zeichen anhängt, darf die erweiterte Vorlage selbst 986 Zeichen nicht überschreiten.

  • Darf keine Pfaddurchquerung enthalten: keine aufeinanderfolgenden Punkte (..), kein Pfadsegment nur für Perioden () und darf nicht mit einem Schrägstrich (.) beginnen. /

  • Darf keine aufeinanderfolgenden Schrägstriche () enthalten. //

  • Jeder Variablenplatzhalter muss geschlossen sein (für jeden !{ muss ein passender Name vorhanden sein}) und muss einen unterstützten Variablennamen verwenden.

  • Zulässige Literalzeichen sind alphanumerische Zeichen und die folgenden:. ! - _ ' . * ( ) / = Mit dem = Zeichen können Sie die Hive-style Partitionierung ausdrücken, z. B. year=!{yyyy}/month=!{MM}/

  • Die Vorlage kann höchstens einen Erweiterungsplatzhalter (!{extension}oder!{extension:.literal}) enthalten. Falls vorhanden, muss er am Ende der Vorlage erscheinen.

  • Wenn die Komprimierung (GZIP oder ZSTD) aktiviert ist, muss die Vorlage einen Platzhalter für Erweiterungen enthalten.

Anmerkung

Sie müssen keine Eindeutigkeitsvariable in die Vorlage aufnehmen. Amazon Kinesis Data Streams hängt automatisch ein eindeutiges Suffix an jeden gelieferten Objektschlüssel an.

Gültige und ungültige Beispiele

Wichtige Beispiele für Vorlagen
Vorlage Valid Grund
!{channel-name}/!{yyyy}/!{MM}/!{dd}/!{HH}/records!{extension} Ja Verwendet unterstützte Variablen und endet mit einem einzigen Platzhalter für Erweiterungen.
data/stream=!{stream-name}/!{yyyy}-!{MM}-!{dd}/!{HH}!{mm}!{extension:.json} Ja Hive-style Partitionierung mit einer wörtlichen Erweiterung am Ende.
!{channel-name}/!{channel-id} Ja Minimale Vorlage. Kinesis Data Streams hängt automatisch ein eindeutiges Suffix an.
/data/!{channel-name}!{extension} Nein Beginnt mit einem Schrägstrich.
data/../!{channel-name}!{extension} Nein Enthält Path Traversal (). ..
data//!{channel-name}!{extension} Nein Enthält aufeinanderfolgende Schrägstriche (). //
!{channel-name}!{extension}/!{yyyy} Nein Der Platzhalter für die Erweiterung befindet sich nicht am Ende der Vorlage.
data/!{partition-id}!{extension} Nein !{partition-id}ist keine unterstützte Variable.
data/!{channel-name}(mit GZIP- oder STD-Komprimierung) Nein Die Komprimierung ist aktiviert, aber die Vorlage hat keinen Platzhalter für Erweiterungen.
data/!{channel-name}/!{yyyy}(fehlende schließende Klammer) Nein Ungeschlossener variabler Platzhalter.