From 00a04e33b3d78a44b2cbb47084d4255d9e89fe10 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 14:51:01 +0000 Subject: [PATCH 1/5] document virtual analytics datasets --- reporting-analytics/analytics.mdx | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/reporting-analytics/analytics.mdx b/reporting-analytics/analytics.mdx index 8461910..4db4441 100644 --- a/reporting-analytics/analytics.mdx +++ b/reporting-analytics/analytics.mdx @@ -56,6 +56,36 @@ 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/). +## Creating virtual (SQL) datasets + +In the Analytics admin portal, a dataset can be created from: + +* A physical table or view (select it from the **Table** dropdown). +* A **virtual dataset**, defined by a SQL query. + +To create a virtual dataset, do the following: + +1. Navigate to **Datasets** and click **+ Dataset**. +2. Select a **Database** and **Schema**. +3. In **Dataset**, select the option that creates a dataset from a SQL query. +4. Enter the SQL query. +5. Click **Create dataset** (or **Create dataset and create chart**, depending on your workflow). + +### Tips and best practices + +* Enter a non-empty SQL query. Creating a virtual dataset requires SQL that is not empty or whitespace. + +### Troubleshooting + +* **Dataset creation fails with an “SQL query cannot be empty or whitespace” error**: Edit the dataset and provide a SQL query with at least one non-whitespace character. + +## When a dataset already exists + +When creating datasets programmatically (for example, via internal services that call the analytics API), dataset creation can be configured to either: + +* **Reuse** an existing dataset when the dataset already exists. +* **Recreate** an existing dataset by deleting it first and then creating a new one. + ## Connecting to external data sources Here's what you can do to connect OpenOps Analytics to external data sources such as CSV files: From 78456a9a199e269c7e8341d9385a1d7ea40e3d0f 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 14:51:43 +0000 Subject: [PATCH 2/5] tighten virtual dataset instructions --- reporting-analytics/analytics.mdx | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/reporting-analytics/analytics.mdx b/reporting-analytics/analytics.mdx index 4db4441..e0116b3 100644 --- a/reporting-analytics/analytics.mdx +++ b/reporting-analytics/analytics.mdx @@ -63,13 +63,7 @@ In the Analytics admin portal, a dataset can be created from: * A physical table or view (select it from the **Table** dropdown). * A **virtual dataset**, defined by a SQL query. -To create a virtual dataset, do the following: - -1. Navigate to **Datasets** and click **+ Dataset**. -2. Select a **Database** and **Schema**. -3. In **Dataset**, select the option that creates a dataset from a SQL query. -4. Enter the SQL query. -5. Click **Create dataset** (or **Create dataset and create chart**, depending on your workflow). +Create a virtual dataset in the Analytics admin portal by using the portal’s dataset creation flow and providing a SQL query. ### Tips and best practices From 27987b2adafe25d98ea0d9d5577616d79d12e60c 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 14:54:08 +0000 Subject: [PATCH 3/5] clarify virtual dataset sql requirement From fee45d9d39ddf9fdbb5ab25b2f1593ceed88e81b 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 14:54:40 +0000 Subject: [PATCH 4/5] remove redundant sql tip duplication From 58f7192b494896c121de63cd04fca3e27b6ddeea 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 14:55:20 +0000 Subject: [PATCH 5/5] document recreate-if-exists for datasets --- reporting-analytics/analytics.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reporting-analytics/analytics.mdx b/reporting-analytics/analytics.mdx index e0116b3..a284982 100644 --- a/reporting-analytics/analytics.mdx +++ b/reporting-analytics/analytics.mdx @@ -78,7 +78,7 @@ Create a virtual dataset in the Analytics admin portal by using the portal’s d When creating datasets programmatically (for example, via internal services that call the analytics API), dataset creation can be configured to either: * **Reuse** an existing dataset when the dataset already exists. -* **Recreate** an existing dataset by deleting it first and then creating a new one. +* **Recreate** an existing dataset by deleting it first and then creating a new one (a delete-and-recreate flow). ## Connecting to external data sources