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

Aberta Para iniciantes
#529 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
1/5
Tempo estimado
Menos de uma hora
Facilidade para iniciantes
90/100
Tipo de issue
Documentação
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
neo4j, postgresql, python

Direção de pesquisa

Atualize docs/06-object-manager.md ao lado da documentação de seek. Leia a explicação existente de seek e compare-a com o exemplo e o parágrafo sobre Drivine4j citados na issue. Documente que as propriedades usadas para ordenação devem ser não nulas para que as linhas sejam alcançadas em páginas posteriores e que os usuários podem filtrar valores nulos em where ou ordenar por uma propriedade que sempre tenha um valor.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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.

Linguagem predominante
Python
Estrelas
2
Forks
0
Merge médio
3h 40min
PRs com merge (30d)
219

Preparar o ambiente

Este projeto não oferece contêiner de desenvolvimento, Dockerfile nem guia de contribuição, então a configuração fica por sua conta: comece pelo README e veja nosso guia da primeira contribuição para os passos gerais.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de liberation-data/drivine-python

Todas as issues de liberation-data/drivine-python

Issues semelhantes

Mais issues de Python

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.