Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

`es search --input-file` rejects the `sort` shorthand `[{"field":"asc"}]`

Ouverte
  • Quelque chose ne va pas ?
#802 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
3/5
Temps estimé
1-2 jours
Accessibilité débutants
63/100
Type d'issue
Bug
Clarté
Clairement spécifiée
Activité
Active
Stack technique
json, typescript
Domaine
cli

Piste de recherche

Start with the reproduction command using --input-file -, then read src/lib/json-schema-args.ts around lines 133-157 and src/factory.ts around lines 724-737 to see how unions are resolved and relaxed. Follow the sort value into _types__SortCombinations / _types__FieldSort from @elastic/schemas, then decide whether a CLI-side relaxation should mirror the existing object/array workaround or whether the schema fix must land upstream. Done means [{"@timestamp":"asc"}] passes validation for file-supplied bodies as it already does with --no-validate.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

Summary

Elasticsearch accepts "sort":[{"@timestamp":"asc"}], the form used throughout its search docs. The CLI's client-side validation rejects it when the body comes from --input-file.

Reproduction (v0.7.0, also unchanged on main at fd3359d)

echo '{"size":1,"sort":[{"@timestamp":"asc"}]}' | elastic es search --index my-index --input-file -
# Error: input validation failed:
# ✖ must be string → at .sort
# ✖ must be object → at .sort
# ✖ must be string → at .sort[0]
# ✖ must be object → at .sort[0]['@timestamp']
# exit 1
Body sort CLI Elasticsearch directly
[{"@timestamp":"asc"}] validation error, exit 1 OK
[{"@timestamp":{"order":"asc"}}] OK OK
["@timestamp"] OK OK
shorthand with --no-validate OK OK
"@timestamp:asc" passes validation, then a shard failure (No mapping found for [@timestamp:asc]), HTTP 200, exit 0 same shard failure

Sort shorthand nested inside a top_hits aggregation is accepted.

Mechanism

_types__SortCombinations in @elastic/schemas 0.10.0 accepts a string or _types__SortOptions. The additional properties of _types__SortOptions must be _types__FieldSort, which is an object, so the value "asc" fails. src/lib/json-schema-args.ts:133-157 resolves this union to the CLI string type, so the object/array relaxation in src/factory.ts:724-737 doesn't apply to a file-supplied sort.

Root cause

The schema is stricter than the specification. The spec marks FieldSort with @shortcut_property order (sort.ts L43-L44): a FieldSort may be written as just its order value. @elastic/schemas 0.10.0 emits _types__FieldSort as object-only, so "asc" fails.

The same loss affects 25 shortcut types in the spec, including term and match queries. Those pass in the CLI only because query is object-typed and covered by the relaxation described under Mechanism. sort isn't, so this is where the gap shows.

Reported upstream: elastic/schemas-js#125. A CLI-side workaround is to relax sort the same way, or to pass --no-validate, which already works. The schema fix covers every shortcut type.

Expected

Accept SortOrder strings ("asc" / "desc") as values in the sort object map, as the Elasticsearch spec does.

Related

  • elastic/cli#330 and elastic/cli#350 fixed the --sort field:direction flag. That flag works. This report is about the --input-file body.
  • elastic/cli#331: a different field (_source arrays) rejected by file-input validation.
Langage dominant
TypeScript
Étoiles
53
Forks
28
Merge moyen
4 j 12 h
PR mergées (30 j)
61

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de elastic/cli

Toutes les issues de elastic/cli

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.