From 8123c2736c1e0fca2dbf778feb34e2ec6576330b Mon Sep 17 00:00:00 2001
From: "sg-doc-holiday[bot]"
 <219201796+sg-doc-holiday[bot]@users.noreply.github.com>
Date: Thu, 19 Feb 2026 09:26:24 +0000
Subject: [PATCH 1/2] document virtual datasets in analytics guide

---
 reporting-analytics/analytics.mdx | 33 +++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/reporting-analytics/analytics.mdx b/reporting-analytics/analytics.mdx
index 8461910..bfb586b 100644
--- a/reporting-analytics/analytics.mdx
+++ b/reporting-analytics/analytics.mdx
@@ -56,6 +56,39 @@ To configure a new chart based on an OpenOps table to display in the **Analytics
 
 For more information on how to create charts, see the [Superset documentation](https://superset.apache.org/docs/intro/).
 
+## Virtual datasets (SQL)
+
+OpenOps Analytics supports creating a dataset using a SQL query (a "virtual dataset").
+
+### Overview
+
+Use a virtual dataset when a single OpenOps table (or view) is not enough and the dataset needs to be defined by a query.
+
+### Prerequisites
+
+* Access to the Analytics admin portal.
+* A database connection that contains the tables or views referenced by the SQL query.
+
+### Create a virtual dataset
+
+1. Navigate to **Datasets**.
+2. Click **+ Dataset**.
+3. Select the target **Database** and **Schema**.
+4. Select **Virtual dataset**.
+5. Enter a SQL query.
+
+   
+   The SQL query must not be empty or only whitespace.
+6. Click **Create dataset**.
+
+### Tips and best practices
+
+* Start by validating the SQL query in the database first, then paste it into the virtual dataset.
+
+### Troubleshooting
+
+* **A virtual dataset fails to create with an empty query**: Enter a non-empty SQL query.
+
 ## Connecting to external data sources
 
 Here's what you can do to connect OpenOps Analytics to external data sources such as CSV files:

From c9f3f92206718761da827b4dfaea08a7e3d3525c Mon Sep 17 00:00:00 2001
From: "sg-doc-holiday[bot]"
 <219201796+sg-doc-holiday[bot]@users.noreply.github.com>
Date: Thu, 19 Feb 2026 09:30:05 +0000
Subject: [PATCH 2/2] clarify virtual dataset requirements

---
 reporting-analytics/analytics.mdx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/reporting-analytics/analytics.mdx b/reporting-analytics/analytics.mdx
index bfb586b..50feac3 100644
--- a/reporting-analytics/analytics.mdx
+++ b/reporting-analytics/analytics.mdx
@@ -77,7 +77,6 @@ Use a virtual dataset when a single OpenOps table (or view) is not enough and th
 4. Select **Virtual dataset**.
 5. Enter a SQL query.
 
-   
    The SQL query must not be empty or only whitespace.
 6. Click **Create dataset**.