Skip to content

RDoc-4136 + RDoc-2561 Exploration queries - #2726

Open
Danielle9897 wants to merge 2 commits into
ravendb:mainfrom
Danielle9897:RDoc-4136-reorganization-exploration-queries
Open

Danielle9897 wants to merge 2 commits into
ravendb:mainfrom
Danielle9897:RDoc-4136-reorganization-exploration-queries

Conversation

@Danielle9897

Copy link
Copy Markdown
Member

Issue links

https://issues.ravendb.net/issue/RDoc-2651/Indexes-Querying-Exploration-queries-Fix-article
https://issues.ravendb.net/issue/RDoc-4136/Per-feature-reorganization-Exploration-queries

Additional description

  • Moved the article to Querying > Filtering Query Results > Exploration Queries
  • Expanded it with corrected explanations, examples, and API limitations.
  • Updated the Java, Node.js, Python, and PHP versions to match.

C#
@maciejaszyk pls review docs/querying/filtering-query-results/content/_exploration-queries-csharp.mdx

Python
@poissoncorp pls review docs/querying/filtering-query-results/content/_exploration-queries-python.mdx

PHP
@M4xymm pls review docs/querying/filtering-query-results/content/_exploration-queries-php.mdx

Node.js
@M4xymm pls review docs/querying/filtering-query-results/content/_exploration-queries-nodejs.mdx

Java
@LielNagar pls review docs/querying/filtering-query-results/content/_exploration-queries-java.mdx


Type of change

  • Content - docs
  • Content - cloud
  • Content - Quill
  • Content - guides
  • Content - start pages/other
  • New docs feature (consider updating /templates or readme)
  • Bug fix
  • Optimization
  • Other

Changes in docs URLs

  • No changes in docs URLs
  • Articles are restructured, URLs will change, mapping is required (update /scripts/redirects.json file, set Documents Moved PR label)

Changes in UX/UI

  • No changes in UX/UI
  • Changes in UX/UI (include screenshots and description)

Comment on lines +1500 to +1501
#### Negating the entire condition

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

add the reference:
The Java filter API handles this automatically. See Java filter API.

Again as said I didnt check the syntax of the documentation references

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

added

* Calling `search()` on the query adds a `where search(...)` condition; it does not add a filter condition.

* Calling `filter` more than once combines the conditions with `and`.

@LielNagar LielNagar Nov 4, 2026 •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add this not API behavior:

* Starting the condition with `not()` is handled by the client, so the RQL pitfall
  described in [Negating the entire condition](#negating-the-entire-condition) does not apply.
  The generated RQL depends on what follows `not()`:

  | Java                                                   | Generated RQL                                   |
  |--------------------------------------------------------|-------------------------------------------------|
  | `f.not().equals("Address.Country", "USA")`             | `filter Address.Country != $p0`                 |
  | `f.not().greaterThan("PricePerUnit", 10)`              | `filter exists(PricePerUnit) and not PricePerUnit > $p0` |
  | `f.not().openSubclause() ... .closeSubclause()`        | `filter true and not (...)`                     |

Note that the exists(...) form excludes documents that don't have the field.

There is documentation references which I havent checked the syntax (Negating the entire.....)

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

added


<ContentFrame>

### Query and DocumentQuery {/* #documentquery-asyncdocumentquery-and-group-by-queries */}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

java has no async API, drop asyncdocumentquery please.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants