Patch release 2026.4.1

.vitepress/theme/components/ConfigInspect.vue

@@ -15,12 +15,12 @@
       </div>
       <div class="vp-code-group vp-doc" v-else>
         <CodeGroup :groups="[
+          { id: 'env', label: '.env file',           lang: 'properties', group, code: propStr },
+          { id: 'yml', label: '.cdsrc.yaml',         lang: 'yml',        group, code: rcYmlStr },
+          { id: 'js',  label: '.cdsrc.js',           lang: 'js',         group, code: rcJsStr },
           { id: 'pkg-rc',   label: 'package.json',   lang: 'json',       group, code: pkgStr },
           // { id: 'pkg-priv', label: '~/.cdsrc.json',  lang: 'json',       group, code: rcJsonStr, private: true },
           // { id: 'pkg',      label: '.cdsrc.json',    lang: 'json',       group, code: rcJsonStr },
-          { id: 'js',  label: '.cdsrc.js',           lang: 'js',         group, code: rcJsStr },
-          { id: 'yml', label: '.cdsrc.yaml',         lang: 'yml',        group, code: rcYmlStr },
-          { id: 'env', label: '.env file',           lang: 'properties', group, code: propStr },
           // { id: 'shl', label: 'Linux/macOS Shells',  lang: 'sh',         group, code: 'export '+envStr, transient: true },
           // { id: 'shp', label: 'Powershell',          lang: 'powershell', group, code: '$Env:'+envStr, transient: true },
           // { id: 'shw', label: 'Cmd Shell',           lang: 'cmd',        group, code: 'set '+envStr, transient: true }
@@ -120,13 +120,13 @@
 
     pkgStr.value = JSON.stringify(pkg, null, 2)
     rcJsonStr.value = JSON.stringify(pkg.cds??{}, null, 2)
-    rcJsStr.value = 'module.exports = ' + rcJsonStr.value.replace(/"(\w*?)":/g, '$1:')
+    rcJsStr.value = 'exports.' + Object.keys(pkg.cds??{})[0] + ' = ' + JSON.stringify(Object.values(pkg.cds??{})[0], null, 2).replaceAll('"', '')
     rcYmlStr.value = yaml.stringify(pkg.cds)
 
     let envKey = fqn.replaceAll('_', '__').replaceAll(keyDel, '_')
     if (/^[a-z_]+$/.test(envKey)) envKey = envKey.toUpperCase() // only uppercase if not camelCase
     envStr.value = `${envKey}=${jsonVal ? JSON.stringify(jsonVal) : value}`
-    propStr.value = `${envKey}=${jsonVal ? JSON.stringify(jsonVal) : value}`
+    propStr.value = `${fqn} = ${jsonVal ? JSON.stringify(jsonVal) : value}`
 
     javaAppyml.value = yaml.stringify(pkg)
     javaEnvStr.value = `-D${propStr.value}`

cds/cdl.md

@@ -861,7 +861,7 @@ To add or update CDS views without redeploying the database schema, annotate the
 
 Runtime views must be simple [projections](#as-projection-on), not using *aggregations*, *join*, *union* or *subqueries* in the *from* clause, but may have a *where* condition if they are only used to read.
 
-In CAP Java, runtime views are enabled by default, in Node.js enable them via <Config>cds.features.runtime_views: true</Config>.
+In CAP Java, runtime views are enabled by default. Node.js does not support it yet.
 
 [Learn more about runtime views in CAP Java.](../java/working-with-cql/query-execution#runtimeviews) {.learn-more}
 

get-started/index.md

@@ -18,7 +18,7 @@ On macOS, Linux and WSL (Windows Subsystem for Linux), we recommend using [Homeb
 ```shell [macOS]
 bash -c "$( curl https://raw.githubusercontent.com/homebrew/install/HEAD/install.sh )"
 ```
-```shell [Linux / WSL]
+```shell [Linux]
 # install curl (required to get Homebrew) and git (required to run Homebrew)
 sudo apt install curl git -y
 bash -c "$( curl https://raw.githubusercontent.com/homebrew/install/HEAD/install.sh )"
@@ -34,7 +34,7 @@ bash -c "$( curl https://raw.githubusercontent.com/homebrew/install/HEAD/install
 ### Node.js and _cds-dk_ {.required}
 
 ::: code-group
-```shell [macOS / Linux / WSL]
+```shell [macOS/Linux]
 brew install node     # Node.js LTS
 npm i -g @sap/cds-dk  # install CAP's cds-dk globally
 ```
@@ -59,7 +59,7 @@ sqlite3 -version
 ### Java and Maven {.optional}
 
 ::: code-group
-```shell [macOS / Linux / WSL]
+```shell [macOS/Linux]
 brew install sapmachine-jdk
 brew install maven
 ```
@@ -92,7 +92,7 @@ brew install git       # Git CLI
 brew install gh        # GitHub CLI
 brew install github    # GitHub Desktop App
 ```
-```shell [Linux / WSL]
+```shell [Linux]
 brew install git       # Git CLI
 brew install gh        # GitHub CLI
 
@@ -127,7 +127,7 @@ git -v # display Git cli version
 ```shell [macOS]
 brew install --cask visual-studio-code            # VS Code itself
 ```
-```bash [Linux / WSL]
+```bash [Linux]
 # VS Code on Homebrew is only supported for macOS
 sudo snap install --classic code
 code -v # display VS Code's version

guides/databases/_menu.md

@@ -10,3 +10,4 @@
  ## [ PostgreSQL ](postgres.md)
 # [ Schema Evolution ](schema-evolution.md) 
 # [ Performance Guide ](performance.md)
+# [ Vector Embeddings ](vector-embeddings.md)

guides/databases/hana.md

@@ -261,86 +261,6 @@ See the [Deploying to Cloud](../deploy/index.md) guide for information about how
 
 The HANA Service provides dedicated support for native SAP HANA features as follows.
 
-### Vector Embeddings
-
-Vector embeddings let you add semantic search, recommendations, and generative AI features to your CAP application. Embeddings are numeric arrays that represent the meaning of unstructured data (text, images, etc.), making it possible to compare and search for items that are semantically related to each other or a user query.
-
-#### Choose an Embedding Model
-
-Choose an embedding model that fits your use case and data (for example english or multilingual text). The model determines the number of dimensions of the resulting output vector. Check the documentation of the respective embedding model for details.
-
-Use the [SAP Generative AI Hub](https://community.sap.com/t5/technology-blogs-by-sap/how-sap-s-generative-ai-hub-facilitates-embedded-trustworthy-and-reliable/ba-p/13596153) for unified consumption of embedding models and LLMs across different vendors and open source models. Check for available models on the [SAP AI Launchpad](https://help.sap.com/docs/ai-launchpad/sap-ai-launchpad-user-guide/models-and-scenarios-in-generative-ai-hub-fef463b24bff4f44a33e98bb1e4f3148#models).
-
-#### Add Embeddings to Your CDS Model
-Use the `cds.Vector` type in your CDS model to store embeddings on SAP HANA Cloud. Set the dimension to match your embedding model (for example, 1536 embedding dimensions for OpenAI *text-embedding-3-small*).
-
-   ```cds
-   entity Books : cuid {
-     title       : String(111);
-     description : LargeString;
-     embedding   : Vector(1536); // adjust dimensions to embedding model
-   }
-   ```
-
-#### Generate Embeddings
-Use an embedding model to convert your data (for example, book descriptions) into vectors. The [SAP Cloud SDK for AI](https://sap.github.io/ai-sdk/) makes it easy to call SAP AI Core services to generate these embeddings.
-
-:::details Example using SAP Cloud SDK for AI
-```Java
-var aiClient = OpenAiClient.forModel(OpenAiModel.TEXT_EMBEDDING_3_SMALL);
-var response = aiClient.embedding(
-   new OpenAiEmbeddingRequest(List.of(book.getDescription())));
-book.setEmbedding(CdsVector.of(response.getEmbeddingVectors().get(0)));
-```
-:::
-
-#### Query for Similarity
-At runtime, use SAP HANA's built-in vector functions to search for similar items. For example, find books with embeddings similar to a user question:
-
-::: code-group
-```Java [Java]
-// Compute embedding for user question
-var request = new OpenAiEmbeddingRequest(List.of("How to use vector embeddings in CAP?"));
-CdsVector userQuestion = CdsVector.of(
- aiClient.embedding(request).getEmbeddingVectors().get(0));
-
-// Compute similarity between user question and book embeddings
-var similarity = CQL.cosineSimilarity( // computed on SAP HANA
-  CQL.get(Books.EMBEDDING), userQuestion);
-
-// Find Books related to user question ordered by similarity
-hana.run(Select.from(BOOKS).limit(10)
-  .columns(b -> b.ID(), b -> b.title(), b -> similarity.as("similarity"))
-  .orderBy(b -> b.get("similarity").desc())
-);
-```
-
-```js [Node.js]
-const response = await new AzureOpenAiEmbeddingClient(
- 'text-embedding-3-small'
-).run({
- input: 'How to use vector embeddings in CAP?'
-});
-
-const questionEmbedding = response.getEmbedding();
-let similarBooks = await SELECT.from('Books')
-  .where`cosine_similarity(embedding, to_real_vector(${questionEmbedding})) > 0.9`;
-```
-:::
-
-:::tip Evolve embeddings with your model
-Store embeddings when you create or update your data. Regenerate embeddings if you change your embedding model.
-:::
-
-:::tip Use SAP Cloud SDK for AI
-Use the [SAP Cloud SDK for AI](https://sap.github.io/ai-sdk/) for unified access to embedding models and large language models (LLMs) from [SAP AI Core](https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/what-is-sap-ai-core).
-:::
-
-Learn more about the [SAP Cloud SDK for AI (Java)](https://sap.github.io/ai-sdk/docs/java/getting-started) or the [SAP Cloud SDK for AI (JavaScript)](https://sap.github.io/ai-sdk/docs/js/getting-started) {.learn-more}
-
-[Learn more about Vector Embeddings in CAP Java](../../java/cds-data#vector-embeddings) {.learn-more}
-
-
 ### Geospatial Functions
 
 CDS supports the special syntax for SAP HANA geospatial functions:

guides/databases/vector-embeddings.md

@@ -0,0 +1,109 @@
+---
+label: Vector Embeddings
+---
+# Vector Embeddings
+
+Vector embeddings convert unstructured content (text, images, and so on) into numeric vectors that encode semantics (meaning). Comparing these vectors enables semantic search, recommendations, and enhanced generative AI features in your CAP application. For example retrieving related records, ranking results by relevance, or augmenting prompts for LLMs.
+
+## Choose an Embedding Model
+
+Choose an embedding model that fits your use case and data (for example English or multilingual text). The model determines the number of dimensions of the resulting output vector. Check the documentation of the respective embedding model for details.
+
+Use the [SAP Generative AI Hub](https://www.sap.com/products/artificial-intelligence/generative-ai-hub.html) for unified consumption of embedding models and LLMs across different vendors and open-source models. Check for available models on the [SAP AI Launchpad](https://help.sap.com/docs/ai-launchpad/sap-ai-launchpad-user-guide/models-and-scenarios-in-generative-ai-hub-fef463b24bff4f44a33e98bb1e4f3148#models).
+
+## Add Embeddings to Your CDS Model
+Use the built-in CDL [Vector type](../../cds/types) in your CDS model to store embeddings. Set the vector dimensions to match the embedding model (for example, 768 for *SAP_GXY.20250407*).
+
+```cds
+extend Incidents with {
+  embedding : Vector(768);
+}
+```
+
+## Generate Embeddings
+Use an embedding model to convert your data (for example, incident titles and summaries) into vectors.
+
+:::warning Evolve embeddings with your model
+Store embeddings when you create or update your data. Regenerate embeddings if you change your embedding model.
+:::
+
+### Generate Embeddings on the Database
+
+To generate vector embeddings on write in SAP HANA, you can use the [vector_embedding](https://help.sap.com/docs/hana-cloud-database/sap-hana-cloud-sap-hana-database-sql-reference-guide/vector-embedding-function-vector) function as calculated element [on-write](../../cds/cdl#on-write) with embedding models from [SAP HANA NLP](https://help.sap.com/docs/hana-cloud-database/sap-hana-cloud-sap-hana-database-vector-engine-guide/creating-text-embeddings-with-nlp-51eb170d038d4099a9bbb85c08fda888) or a configured remote source from SAP AI Core:
+
+```cds
+extend Incidents with {
+  @cds.api.ignore
+  embedding : Vector(768) = vector_embedding( 
+    'Title: ' || title || ', Summary: ' || summary, 
+    'DOCUMENT', 'SAP_GXY.20250407'
+  ) stored; 
+}
+```
+
+:::tip Prefer calculated elements for vector embeddings
+If the database calculates vector embeddings on write it automatically regenerates the embedding if the input data changes.
+:::
+
+::: info Local Testing with H2 and SQLite
+On H2 and SQLite the `CQL.vectorEmbedding` function is emulated to support local testing.
+:::
+
+> [!warning] Java only and <Beta/>
+> The `vector_embedding` function is currently in beta and only supported by the CAP Java runtime.
+
+[Learn more about Vector Embeddings in CAP Java](../../java/cds-data#vector-embeddings) {.learn-more}
+
+### Generate Embeddings Programmatically
+
+Alternatively, you can compute vector embeddings in your application layer using the [SAP Cloud SDK for AI](https://sap.github.io/ai-sdk/) to call SAP AI Core services for generating embeddings.
+
+:::details Example using SAP Cloud SDK for AI
+```Java
+var aiClient = OpenAiClient.forModel(OpenAiModel.TEXT_EMBEDDING_3_SMALL);
+var response = aiClient.embedding(
+   new OpenAiEmbeddingRequest(List.of(book.getDescription())));
+book.setEmbedding(CdsVector.of(response.getEmbeddingVectors().get(0)));
+```
+:::
+
+:::tip Use SAP Cloud SDK for AI
+Use the [SAP Cloud SDK for AI](https://sap.github.io/ai-sdk/) for unified access to embedding models and large language models (LLMs) from [SAP AI Core](https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/what-is-sap-ai-core).
+:::
+
+Learn more about the [SAP Cloud SDK for AI (Java)](https://sap.github.io/ai-sdk/docs/java/getting-started) or the [SAP Cloud SDK for AI (JavaScript)](https://sap.github.io/ai-sdk/docs/js/getting-started) {.learn-more}
+
+## Query for Similarity
+At runtime, use vector functions to search for similar items. In an example Retrieval-Augmented Generation (RAG) scenario, use `CQL.cosineSimilarity` to enhance the context of a user query for the LLM. First, compute the vector embedding of the user query and use it to find related incidents.
+
+::: code-group
+```Java [Java]
+// Compute embedding for user question
+var query = CQL.val(
+  "Any incidents with solar inverters this month? How were they resolved?");
+var embedding = CQL.vectorEmbedding(query, TextType.QUERY, "SAP_GXY.20250407");
+
+// Compute similarity between user question and incident embeddings
+var similarity = CQL.cosineSimilarity(CQL.get(Incidents.EMBEDDING), embedding);
+
+// Find Incidents related to user question ordered by relevance
+Select.from(INCIDENTS)
+   .columns(i -> similarity.times(100).as("relevance"), 
+            i -> i.ID(), i -> i.title(), i -> i.summary(), i -> i.date())
+   .where(i -> similarity.gt(0.75))
+   .orderBy(i -> i.get("relevance").desc());
+```
+
+```js [Node.js]
+const response = await new AzureOpenAiEmbeddingClient(
+ 'text-embedding-3-small'
+).run({
+ input: 'Any incidents with solar inverters this month? How were they resolved?'
+});
+
+const questionEmbedding = response.getEmbedding();
+let similarIncidents = await SELECT.from('Incidents')
+  .where`cosine_similarity(embedding, to_real_vector(${questionEmbedding})) > 0.75`;
+```
+:::
+

guides/extensibility/customization.md

@@ -1039,7 +1039,7 @@ In case something unexpected happens, set the variable `DEBUG=cli` in your shell
 
 ::: code-group
 
-```sh [Mac/Linux]
+```sh [macOS/Linux]
 export DEBUG="cli"
 ```
 

guides/multitenancy/index.md

@@ -817,7 +817,7 @@ The SAP HANA Tenant Management Service (TMS) v2 service provides direct support
 > - **Not suitable for existing applications** as there is **no migration from Service Manager** available yet. This will be provided as HANA tool later.<br>
 > There **won't be support for both Service Manager and TMS v2** together in one application.
 
-[For more information, see the SAP HANA documentation](https://help.sap.com/docs/hana-cloud/sap-hana-cloud-multitenancy-guide-internal/introducing-sap-hana-cloud-multitenancy){.learn-more}
+[For more information, see the SAP HANA documentation](https://help.sap.com/docs/hana-cloud/sap-hana-cloud-multitenancy/introducing-sap-hana-cloud-multitenancy){.learn-more}
 [Find the TMS v2 API on the SAP Business Accelerator Hub](https://api.sap.com/api/TenantAPI/overview){.learn-more}
 
 #### Configure MTXS for Tenant Management Service
@@ -965,7 +965,7 @@ so clustering the upgrade by database does not work properly.
 ## SaaS Dependencies {#saas-dependencies}
 Some of the xsuaa-based services your application consumes need to be registered as _reuse services_ to work in multitenant environments. This holds true for the usage of both the SaaS Registry service and the Subscription Manager Service (SMS).
 
-CAP Java as well as `@sap/cds-mtxs`, each offer an easy way to integrate these dependencies. They support some services out of the box and also provide a simple API for applications. Most notably, you need such dependencies for the following SAP BTP services: [Audit Log](https://discovery-center.cloud.sap/serviceCatalog/audit-log-service), [Event Mesh](https://discovery-center.cloud.sap/serviceCatalog/event-mesh), [Destination](https://discovery-center.cloud.sap/serviceCatalog/destination), [HTML5 Application Repository](https://discovery-center.cloud.sap/serviceCatalog/html5-application-repository-service), and [Cloud Portal](https://discovery-center.cloud.sap/serviceCatalog/cloud-portal-service).
+CAP Java as well as `@sap/cds-mtxs`, each offer an easy way to integrate these dependencies. They support some services out of the box and also provide a simple API for applications. Most notably, you need such dependencies for the following SAP BTP services: [Audit Log](https://discovery-center.cloud.sap/serviceCatalog/audit-log-service), [Event Mesh](https://discovery-center.cloud.sap/serviceCatalog/event-mesh), [Destination](https://discovery-center.cloud.sap/serviceCatalog/destination-service), [HTML5 Application Repository](https://discovery-center.cloud.sap/serviceCatalog/html5-application-repository-service), and [Cloud Portal](https://discovery-center.cloud.sap/serviceCatalog/cloud-portal-service).
 
 For CAP Java, all these services are supported natively and SaaS dependencies are automatically created if such a service instance is bound to the CAP Java application, that is, the `srv` module.