Update `encoding.md` for `MiniBlockChunk` minichunk size changes

Abierto Apto para principiantes
#5,240 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 2 días

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
1/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
78/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Estancado
Stack tecnológico
rust

Línea de trabajo

Lee el PR #4959 sobre los cambios de MiniBlockChunk y, después, actualiza docs/src/format/file/encoding.md. Documenta la propiedad protobuf has_large_chunk, la clave de metadatos lance-encoding:minichunk-size y el comportamiento de u32 buffer_sizes en las versiones 2.1 y 2.2 del formato Lance. La tarea estará terminada cuando el archivo explique correctamente los nuevos metadatos, valores predeterminados, anulaciones y conversiones.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

documentation

PR #4959 expanded MiniBlockChunk minichunk size from u16 to u32, introducing new metadata and protobuf properties. The documentation at docs/src/format/file/encoding.md should be updated to reflect these changes:

  • New protobuf property: has_large_chunk for MiniBlockLayout.
  • New metadata key: lance-encoding:minichunk-size for specifying mini chunk size (default 4KB, can be larger, e.g., 64KB).
  • buffer_sizes now stored as u32 in memory:
    • Lance format v2.1: still stored as u16 on disk, converted to u32 in memory.
    • Lance format v2.2: default mini chunk size remains 4KB, but users can override it (up to 64KB or larger) via the new metadata key.

The docs should explain these changes so users and developers understand the updated MiniBlockChunk behavior.

Lenguaje dominante
Rust
Estrellas
7.2k
Forks
913
Merge medio
4 d 11 min
PR fusionados (30 d)
466

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de lance-format/lance

Todos los issues de lance-format/lance

Issues similares

Más issues de Rust

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.