Query Graphs
Helping people see and understand queries.
Description
Query Graphs is an investigation into graph visualization for query processing, such as for logical queries and their physical query evaluation plans. Current visualizations are tailored for artifacts from Tableau's query ecosystem: LogicalQuery XML, QueryFunction XML, and Hyper query-plan JSON.
This package provides the reusable core functionality, i.e. the loading and rendering of query plans. As an end-user, you probably want to use QueryGraphs through one of the following applications:
- The standalone server allows you to upload & visualize query plans
- The JupyterLab extension integrates query plan visualization into JupyterLab
- The Tableau Log Viewer can visualize query plans embeded into Tableau & Hyper log files
Development
Since this package only contains the core logic, it doesn't contain any concrete way to actually trigger the visualization of a query plan. For iterating on plan visualizations, we recommend to use the standalone server for testing and debugging the visualization of query plans.
We do have some automated test coverage which can be tested through
npm run test. However, this test coverage is still spotty. Hence,
you should manually check if all examples included in the standalone-server
still work as expected.
We use eslint to lint our JavaScript code.
To run eslint on the appropriate files, you can use npm run lint inside this directory.