Regole

Se fornisci un modello, questo deve soddisfare tutti i seguenti requisiti.

Struttura

• Lunghezza: al massimo 1024 caratteri. Inoltre, la lunghezza del prefisso di output più la lunghezza del modello devono essere al massimo di 1024 caratteri (vengono concatenati nella chiave finale).

• Nessun percorso: non deve contenere .. o ./ e non deve iniziare con. /

• Non deve terminare con /: la chiave deve risolversi in un oggetto, non in un confine di directory.

• Variabili bilanciate: ognuna !{ deve avere una corrispondenza}.

• Valori letterali consentiti: i caratteri esterni !{...} devono corrispondere [a-zA-Z0-9/_\-.+=] (alfanumerici,,,,/, _-,.). + = Gli spazi non sono consentiti.

Variabili

• Solo nomi noti: solo le variabili supportate sono valide; qualsiasi altra variabile viene rifiutata.

• Almeno una variabile: un modello di soli valori letterali viene rifiutato.

• Esattamente un token di unicità: deve contenere uno !{sequence-number} o più!{kafka-offset}, ma non entrambi (si escludono a vicenda).

• kafka-offsetrichiede partition-id: se si utilizza!{kafka-offset}, il modello deve contenere anche. !{partition-id}

• Posizionamento del token di unicità: il token (!{sequence-number}o!{kafka-offset}) scelto deve apparire nell'ultimo segmento / separato, in modo che ogni oggetto consegnato riceva una chiave distinta.

Nota

Perché è necessario un token di unicità: il canale scrive più record in ogni oggetto S3 (un batch), in modo che il token identifichi l'oggetto, non un singolo record. !{sequence-number}è un numero di batch monotono per oggetto; !{kafka-offset} è l'offset di Kafka del primo record dell'oggetto. Il modello richiede esattamente uno di questi token nel segmento finale del percorso in modo che ogni oggetto consegnato riceva una chiave distinta e gli oggetti non vengano sovrascritti.