Skip to content

Documentation Update: 0.6.20 #328

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sg-doc-holiday wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Documentation Update: 0.6.20 #328

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8123c27
document virtual datasets in analytics guide
sg-doc-holiday[bot] Feb 19, 2026
c9f3f92
clarify virtual dataset requirements
sg-doc-holiday[bot] Feb 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions reporting-analytics/analytics.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,38 @@ 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:
Expand Down