Say in the docs that a seek never reaches the rows whose ordered property is null

Abierto Apto para principiantes
#529 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
90/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
neo4j, postgresql, python

Línea de trabajo

Actualiza docs/06-object-manager.md junto a la documentación de seek. Lee la explicación existente de seek y compárala con el ejemplo y el párrafo de Drivine4j citado en el issue. Documenta que las propiedades por las que se ordena no deben ser nulas para que se llegue a las filas en páginas posteriores, y que los usuarios pueden filtrar los valores nulos en where o ordenar por una propiedad que siempre tenga un valor.

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

Descripción

The docs don't say that a seek drops every row whose ordered property is null from each page after the first, as drivine4j's do (docs/06-object-manager.md, "The ordered properties must be non-null in the data").

await gom.save_all([S(id="a", rank=1), S(id="b", rank=2), S(id="c"), S(id="d")])
q = refs(S)
await gom.load_all(S, order_by=[q.rank.asc(), q.id.asc()])                      # a, b, c, d
await gom.load_all(S, order_by=[q.rank.asc(), q.id.asc()], limit=2,
                   seek=[q.rank.after(2), q.id.after("b")])                     # []: c and d are never reached

Seen on SQLite. A null sort key satisfies no comparison on any store, the graph engines' Cypher included, so this is how keyset paging works, not a bug: an order that places its nulls is already refused with seek. But a user paging over an optional property loses rows without a word.

The fix is docs: say, beside seek, that its ordered properties must be non-null in the data, and that a user should filter nulls out in where or order by a property that always has a value. drivine4j's paragraph can be taken as it is.

Lenguaje dominante
Python
Estrellas
2
Forks
0
Merge medio
3 h 40 min
PR fusionados (30 d)
219

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

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 liberation-data/drivine-python

Todos los issues de liberation-data/drivine-python

Issues similares

Más issues de Python

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.