diff --git a/docs/references/api/resource_embedding.rst b/docs/references/api/resource_embedding.rst index e410ba447..ed44c47cb 100644 --- a/docs/references/api/resource_embedding.rst +++ b/docs/references/api/resource_embedding.rst @@ -505,6 +505,25 @@ If you want to filter the films by actors but don't want to include them in the } ] +.. _top_level_order: + +Top-level Ordering +------------------ + +On :ref:`Many-to-One ` and :ref:`One-to-One ` relationships, you can use a column of the "to-one" end to sort the top-level. + +For example, to arrange the films in descending order using the director's last name. + +.. tabs:: + + .. code-tab:: http + + GET /films?select=title,directors(last_name)&order=directors(last_name).desc HTTP/1.1 + + .. code-tab:: bash Curl + + curl "http://localhost:3000/films?select=title,directors(last_name)&order=directors(last_name).desc" + .. _embedding_partitioned_tables: Embedding Partitioned Tables diff --git a/docs/releases/v11.0.0.rst b/docs/releases/v11.0.0.rst index a346e1797..5223369e1 100644 --- a/docs/releases/v11.0.0.rst +++ b/docs/releases/v11.0.0.rst @@ -14,6 +14,7 @@ Resource Embedding ~~~~~~~~~~~~~~~~~~ - New :ref:`empty_embed_filter`. +- New :ref:`top_level_order`. OpenAPI ~~~~~~~