(skywalking-banyandb) branch main updated: docs: add property ordering and v0.11 version table (#1083)

[ha...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

hanahmily pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/skywalking-banyandb.git


The following commit(s) were added to refs/heads/main by this push:
     new 0bb071abd docs: add property ordering and v0.11 version table (#1083)
0bb071abd is described below

commit 0bb071abd4325dd03d83c5f57da907183e2a7fe4
Author: Gao Hongtao <ha...@gmail.com>
AuthorDate: Wed Apr 22 16:51:14 2026 +0800

    docs: add property ordering and v0.11 version table (#1083)
---
 docs/installation/versions.md        |  2 ++
 docs/interacting/bydbctl/property.md | 32 ++++++++++++++++++++++++++++++++
 docs/interacting/bydbql.md           |  9 +++++++++
 3 files changed, 43 insertions(+)

diff --git a/docs/installation/versions.md b/docs/installation/versions.md
index 431919c65..6c7df5690 100644
--- a/docs/installation/versions.md
+++ b/docs/installation/versions.md
@@ -5,6 +5,8 @@ OAP releases, you need to pick the proper API versions.
 
 | API Version | BanyanDB Release Version |
 |-------------|--------------------------|
+| 0.11        | 0.11                     |
+| 0.10        | 0.10                     |
 | 0.9         | 0.9                      |
 | 0.8         | 0.8                      |
 
diff --git a/docs/interacting/bydbctl/property.md b/docs/interacting/bydbctl/property.md
index fcb596d0d..75a194b5d 100644
--- a/docs/interacting/bydbctl/property.md
+++ b/docs/interacting/bydbctl/property.md
@@ -148,6 +148,38 @@ name: temp_data
 EOF
 ```
 
+## Sorted Query
+
+Property queries support sorting results by tag values using the `order_by` field. This allows you to retrieve properties in a specific order based on a tag's value.
+
+### Examples of sorted queries
+
+Sort properties by a string tag in ascending order:
+
+```shell
+bydbctl property query -f - <<EOF
+groups: ["sw"]
+name: temp_data
+order_by:
+  tag_name: "name"
+  sort: SORT_ASC
+EOF
+```
+
+Sort properties by a string tag in descending order:
+
+```shell
+bydbctl property query -f - <<EOF
+groups: ["sw"]
+name: temp_data
+order_by:
+  tag_name: "name"
+  sort: SORT_DESC
+EOF
+```
+
+The `sort` field accepts `SORT_ASC` for ascending order and `SORT_DESC` for descending order.
+
 ## API Reference
 
 [PropertyService v1](../../api-reference.md#propertyservice)
diff --git a/docs/interacting/bydbql.md b/docs/interacting/bydbql.md
index c22cd9ba3..c6917ac75 100644
--- a/docs/interacting/bydbql.md
+++ b/docs/interacting/bydbql.md
@@ -737,6 +737,8 @@ ORDER BY value DESC;
 
 BydbQL for properties is designed for simple key-value lookups and metadata filtering. It maps to the `banyandb.property.v1.QueryRequest` message.
 
+> **Note**: As of BanyanDB v0.10.0, Property queries support `ORDER BY` for sorted results.
+
 ### 7.1. Grammar
 
 ```
@@ -782,6 +784,13 @@ WHERE datacenter = 'dc-101' AND in_service = 'true'
 LIMIT 50
 ORDER BY ip;
 
+-- Find properties and sort by an integer tag
+SELECT ip, owner, priority
+FROM PROPERTY server_metadata IN datacenter-1
+WHERE in_service = 'true'
+ORDER BY priority ASC
+LIMIT 20;
+
 -- Retrieve a specific property by its unique ID
 SELECT *
 FROM PROPERTY server_metadata IN datacenter-1