SQL Runner provides a way to directly access your database and to leverage that access in a variety of ways. Using SQL Runner, you can easily navigate the tables in your schema, use an ad hoc Explore from a SQL query, run prewritten descriptive queries on your data, see your SQL Runner history, download results, share queries, add to a LookML project as a derived table, and perform other useful tasks.
- Using SQL Runner to create queries and Explores
- Using SQL Runner to create derived tables
- Managing database functions with SQL Runner
Navigating to SQL Runner
- In the Develop menu, select SQL Runner.
- From an Explore, click SQL on the Data bar to see the SQL. Then click Open in SQL Runner to see the query in SQL Runner, or click Explain in SQL Runner to open SQL Runner and request the database’s execution plan for the query.
Basic SQL Runner usage
This section describes how to use SQL Runner to directly access tables in your schema, run a SQL query on your data, and see query results.
- Select the connection you want to query.
- Select the schema you want to query.
- Select a table to show its columns in the Results area.
- Click to collapse/expand the left panel.
- Check the database SQL dialect used for the query.
- Write a SQL command in the Query area.
- Click Run to execute the SQL query.
- Look at information returned by the database in the Results area.
SQL Runner visualizations
If your Looker admin has enabled the SQL Runner Vis Labs feature, you can create visualizations directly in SQL Runner.
For more information, see the Using SQL Runner to create queries and Explores documentation page.
Supported database dialects for SQL Runner features
For Looker to support SQL Runner features in your Looker project, your database dialect must also support them. The following table shows which dialects support SQL Runner features in Looker 22.6: