Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Plantilla de clave de salida de S3 para la entrega de Amazon S3
Al realizar entregas en buckets de Amazon S3 de uso general, puede configurar una plantilla de clave de salida de S3 para controlar la estructura de claves de objetos de los archivos entregados. La plantilla de claves es opcional; si no se especifica, la entrega de Amazon S3 utiliza la plantilla predeterminada.
Plantilla Default
Si no especifica una plantilla de claves personalizada, la entrega de Amazon S3 utiliza la siguiente configuración predeterminada:
kinesis-channel/!{channel-name}/!{channel-id}/!{yyyy}/!{MM}/!{dd}/!{HH}/!{channel-name}-!{channel-id}-!{yyyy}-!{MM}-!{dd}-!{HH}-!{mm}!{extension}
La parte que precede a la última barra diagonal (/) forma el prefijo de la clave del objeto (la estructura de carpetas) y el último segmento forma el nombre del objeto. La plantilla predeterminada organiza los objetos entregados por canal y por hora, y repite los mismos valores en el nombre del objeto para que cada objeto se describa por sí mismo. Amazon Kinesis Data Streams añade automáticamente un sufijo único a cada clave de objeto, de modo que las claves de objeto son únicas incluso cuando la plantilla no incluye un componente de tiempo lo suficientemente preciso como para distinguirlas.
Variables de plantilla
Las siguientes variables están disponibles para su uso en la plantilla de claves:
| Variable | Description (Descripción) | Ejemplo de valor |
|---|---|---|
!{channel-name} |
El nombre de la entrega. | my-channel |
!{channel-id} |
El identificador único de la entrega. | abc123def456 |
!{stream-name} |
El nombre de la transmisión de Kinesis Data Streams de origen. | my-stream |
!{yyyy} |
Four-digit año (UTC). | 2026 |
!{yy} |
Two-digit año (UTC). | 26 |
!{MM} |
Two-digit mes (UTC), rellenado con ceros. | 07 |
!{dd} |
Two-digit día del mes (UTC), rellenado con ceros. | 20 |
!{HH} |
Two-digit hora (UTC, 24 horas), rellenada con ceros. | 14 |
!{mm} |
Two-digit minuto (UTC), rellenado con ceros. | 30 |
!{extension} |
Extensión de archivo derivada del tipo de compresión configurado (por ejemplo, .gz para GZIP o .zst ZSTD). Si está presente, debe aparecer al final de la plantilla. |
.gz |
!{extension:. |
Una extensión de archivo literal que especifique. Debe empezar con un punto y contener solo letras minúsculas y puntos. Si está presente, debe aparecer al final de la plantilla. | !{extension:.json} |
Reglas de la plantilla
Las plantillas clave deben cumplir las siguientes reglas:
-
Una vez expandidas todas las variables, la clave de objeto resultante no debe superar el límite de clave de objeto de Amazon S3 de 1024 caracteres. Dado que Amazon Kinesis Data Streams añade un sufijo único de hasta 38 caracteres, la propia plantilla expandida no debe superar los 986 caracteres.
-
No debe contener un recorrido de ruta: ningún punto consecutivo (
..), ningún segmento de ruta que solo contenga un punto (.) y no debe comenzar con una barra diagonal ()./ -
No debe contener barras diagonales consecutivas ().
// -
Todos los marcadores de posición de variables deben estar cerrados (cada uno
!{debe tener una coincidencia}) y deben usar un nombre de variable compatible. -
Los caracteres literales permitidos son caracteres alfanuméricos y los siguientes:.
! - _ ' . * ( ) / =El=carácter le permite expresar la Hive-style partición, como.year=!{yyyy}/month=!{MM}/ -
La plantilla puede contener como máximo un marcador de posición de extensión (
!{extension}o!{extension:.) y, si está presente, debe aparecer al final de la plantilla.literal} -
Cuando la compresión (GZIP o ZSTD) está habilitada, la plantilla debe incluir un marcador de posición de extensión.
nota
No es necesario incluir una variable de unicidad en la plantilla. Amazon Kinesis Data Streams añade automáticamente un sufijo único a cada clave de objeto entregada.
Ejemplos válidos y no válidos
| Plantilla | Valid (Válido) | Motivo |
|---|---|---|
!{channel-name}/!{yyyy}/!{MM}/!{dd}/!{HH}/records!{extension} |
Sí | Utiliza las variables admitidas y termina con un único marcador de posición de extensión. |
data/stream=!{stream-name}/!{yyyy}-!{MM}-!{dd}/!{HH}!{mm}!{extension:.json} |
Sí | Hive-style particionar con una extensión literal al final. |
!{channel-name}/!{channel-id} |
Sí | Plantilla mínima. Kinesis Data Streams agrega automáticamente un sufijo único. |
/data/!{channel-name}!{extension} |
No | Comienza con una barra diagonal. |
data/../!{channel-name}!{extension} |
No | Contiene el recorrido de rutas ()... |
data//!{channel-name}!{extension} |
No | Contiene barras diagonales consecutivas ()//. |
!{channel-name}!{extension}/!{yyyy} |
No | El marcador de posición de la extensión no está al final de la plantilla. |
data/!{partition-id}!{extension} |
No | !{partition-id}no es una variable admitida. |
data/!{channel-name}(con compresión GZIP o ZSTD) |
No | La compresión está habilitada, pero la plantilla no tiene ningún marcador de extensión. |
data/!{channel-name}/!{yyyy}(falta el corchete de cierre) |
No | Marcador de posición variable no cerrado. |
