Regeln

Wenn Sie eine Vorlage bereitstellen, muss diese alle folgenden Anforderungen erfüllen.

Struktur

• Länge — höchstens 1024 Zeichen. Darüber hinaus müssen die Länge des Ausgabepräfixes plus die Länge der Vorlage höchstens 1024 Zeichen betragen (sie werden zum endgültigen Schlüssel verkettet).

• Keine Pfaddurchquerung — darf nicht .. oder enthalten und darf nicht mit ./ beginnen. /

• Darf nicht enden mit / — der Schlüssel muss zu einem Objekt aufgelöst werden, nicht zu einer Verzeichnisgrenze.

• Ausgewogene Variablen — für jede !{ muss eine passende Variable vorhanden sein}.

• Zulässige Literale — Zeichen außerhalb !{...} müssen übereinstimmen [a-zA-Z0-9/_\-.+=] (alphanumerisch,,/,, _ -.,+). = Leerzeichen sind nicht erlaubt.

Variablen

• Nur bekannte Namen — nur die unterstützten Variablen sind gültig; jede andere Variable wird abgelehnt.

• Mindestens eine Variable — eine Vorlage, die nur Literale enthält — wird zurückgewiesen.

• Genau ein Eindeutigkeitstoken — muss entweder !{sequence-number} oder enthalten!{kafka-offset}, aber nicht beide (sie schließen sich gegenseitig aus).

• kafka-offseterfordert partition-id — falls Sie es verwenden!{kafka-offset}, muss die Vorlage auch Folgendes enthalten!{partition-id}.

• Platzierung des Eindeutigkeitstokens — das gewählte Token (!{sequence-number}oder!{kafka-offset}) muss im letzten, / durch Trennzeichen getrennten Segment erscheinen, sodass jedes gelieferte Objekt einen eigenen Schlüssel erhält.

Anmerkung

Warum ein Eindeutigkeitstoken erforderlich ist: Der Channel schreibt mehrere Datensätze in jedes S3-Objekt (einen Batch), sodass das Token das Objekt identifiziert, nicht einen einzelnen Datensatz. !{sequence-number}ist eine monotone Batchnummer pro Objekt; !{kafka-offset} ist der Kafka-Offset des ersten Datensatzes im Objekt. Die Vorlage benötigt genau eines dieser Token im letzten Pfadsegment, damit jedes übergebene Objekt einen eindeutigen Schlüssel erhält und Objekte nicht überschrieben werden.