Skip to content

Explorer ​

Explorer lets you explore SQL run results, chart data sources, and table preview data through a GUI. You can analyze data with filtering, sorting, aggregation, and pivoting without writing SQL, and even add charts or SQL blocks to the notebook from the results.

Key features ​

FeatureDescription
Switching viewsSwitch the exploration approach between Raw data, Aggregated data, and Pivot.
Setting conditionsSpecify Filter, Sort, Limit, and more through a GUI.
Result tabsSwitch between Processed data, Distribution, Chart, SQL, and Source data.
Column header operationsAdd sorting, filters, or column statistics from a table's column.
Using exploration resultsAdd a chart or SQL block, or download data.

Opening Explorer ​

You can open Explorer in any of the following ways.

Doc page ​

  • Once a SQL block has run successfully, select Explore in the run result header.
  • Select Explore from the float menu of a chart, or Open in Explorer in the chart's fullscreen view header.
  • Select Explore on a Table preview block.
  • On a run result or table preview table, select Open Explorer from the float menu, or Open in Explorer in the fullscreen view header.
  • Right-click a table cell and select Open in Explorer to open Explorer filtered by that cell's value.
  • From the icon on a value cell in column stats, select Open explorer.

Grid page ​

  • On a grid page, select Open Explorer from the float menu of a Query result table, or Explore from the float menu of a Chart.
  • Open in Explorer is also available in the fullscreen view header of a query result or chart, and in the right-click menu on a table cell.

When opened from a grid page, you can't add a chart or SQL block. Only exploration and downloading (if allowed) are available.

Layout ​

Explorer opens as a full-screen view, divided mainly into the following areas.

AreaContent
HeaderTitle, auto-run toggle, adding a chart or SQL block, Download.
Left paneData source (column list) and the condition form.
Right paneResult tabs.

Exploring data ​

  1. At the top of the condition form in the left pane, choose Raw data, Aggregated data, or Pivot.
  2. Drag and drop columns from Data source, or add fields using each item's selector. Use Filter columns to narrow the list. You can toggle the display between By data type and In original order.
  3. Set Filter, Sort, and Limit in common conditions.
  4. If the right pane shows Conditions changed. Please re-run the query., select Run query, or turn on Auto-run in the header.
  5. Review the results in the tabs of the right pane.

Turning on Auto-run re-runs SQL automatically whenever conditions change, for as long as Explorer stays open. It turns off again when you close Explorer.

Using exploration results ​

When opened from a doc page and you have edit permission on the notebook, you can do the following.

OperationDescription
Add chartAdds a chart suggested from the current exploration conditions, and closes Explorer.
Add chart and continueAdds the chart while keeping Explorer open.
Edit in chart editorOpens the chart editor, and closes Explorer.
Add SQL blockCreates a new SQL block with SQL equivalent to the current conditions, and closes Explorer.
Add SQL block and continueAdds the SQL block while keeping Explorer open.
DownloadDownloads data based on the current Explorer conditions.

Adding a chart is available when Explorer was opened from a SQL block's run result (or a chart under it). When opened from a table preview, select Add SQL block first, then add the chart.

Views ​

Field settings carry over as much as possible when you switch views in the condition form. Details for each view are as follows.

Raw data ​

Explores unaggregated raw data.

ItemDescription
Target data > ColumnsSpecifies the columns to display.
Common conditionsFilter / Sort / Limit.

Aggregated data ​

Explores data grouped and aggregated by selected columns.

ItemDescription
Aggregation conditions > Group bySpecifies the columns to group by (equivalent to a chart's dimensions).
Aggregation conditions > ValuesSpecifies the columns to aggregate and the aggregation method (equivalent to a chart's metrics).
Aggregate display settingsWhen you specify multi-level Group by fields, you can choose Flat (default) or Grid for the row hierarchy. Grid is initially expanded and doesn't show subtotals. Collapsing a group displays its aggregate values in the parent row.
Common conditionsFilter / Sort / Limit.

Either Group by or Values is required. See Dimensions and metrics for details on aggregation method.

Pivot ​

Explores data aggregated across two dimensions: rows and columns.

ItemDescription
Pivot conditions > RowsSpecifies the columns to use as the row axis.
Pivot conditions > ColumnsSpecifies the columns to use as the column axis.
Pivot conditions > ValuesSpecifies the aggregated values shown in each cell. Required.
Pivot conditions > Row sort / Column sortSpecifies the order of each axis. Defaults to descending value order when the first Value supports subtotals, and ascending label order otherwise.
Pivot display settingsFor multi-level row axes, you can choose Grid (default) or Tree for the row hierarchy. Multi-level column axes are displayed as collapsible groups. Both are initially expanded. When all Value aggregation methods cannot be re-aggregated, totals are not displayed and the aggregate cells of collapsed groups are left empty.
Pivot conditions > Max row items / Max column itemsShown when both rows and columns are specified and SQL-based processing is used. Sets the unique-item limit for each axis (default 30 each if both are unset; excess items are grouped into (Others) at the end of the axis). (Max row items + 1) × (Max column items + 1) must be 1,000 or less. If you set only one of them, the unspecified side is treated as the maximum that fits within the rendering limit when checking this product. See Pivot Table for details.
Common conditionsFilter (no Sort or Limit).

Common conditions and options ​

Filter ​

Filter narrows down data by combining a column, an operator, and a value. Operators and the handling of Custom SQL are the same as a chart's source filter. Custom SQL isn't available for snapshot sharing (such as reports).

Sort ​

Raw data and Aggregated data let you specify Sort. You can sort by multiple columns.

Limit ​

Raw data and Aggregated data let you specify Limit between 1 and 1000. See Limits for the upper bound.

Disabling in-memory processing ​

Turning on Options > Disable in-memory processing re-runs SQL according to the current conditions instead of processing already-fetched data.

By default, if the result has 1000 rows or fewer and there's no Custom SQL, filtering and aggregation can be done through in-memory processing in the browser. If the source data has more than 1000 rows and has been truncated, SQL needs to be re-run. See Chart concepts for how this relates to the same option on charts.

Result tabs ​

TabDescription
Data / Processed dataShows a table as Data when no conditions are set, or Processed data once conditions are set. In the pivot view, this is a pivot table.
DistributionChoose Parallel or Scatter plot matrix as the display method, and check the distribution of up to 5 target columns. Requires 2 or more columns.
ChartSwitch between suggested chart candidates for the current conditions using chart type, and preview the appearance after adjusting quick settings.
SQLShows the processing SQL issued based on the current conditions.
Source dataShows the source data before processing.

Column header operations ​

Select a column header in the Processed data table to access the following operations. For columns generated as Pivot values, subtotals, or totals, Column width operations are available. Column statistics are also available when Explorer can identify the source column. Applying a filter operation replaces the filter conditions already applied to that column.

OperationDescription
SortSorts by Asc or Desc. Use Append to add to existing sort conditions.
Filter by valueSwitch between Filter by value (IN) and Exclude by value (NOT IN), select candidate values, then select Apply. If the result is truncated, use Fetch non-sampled values to load candidates from all rows.
Filter by conditionApplies a condition such as Equal, Not equal, Between, or Greater than.
Filter NULLApplies IS NULL or IS NOT NULL.
Column statisticsShows statistics for the source column over all rows of the SQL result before processing in a modal: Count, Unique count, and Number of NULL, plus Max value / Min value / Avg value depending on the values. Statistics are computed by running SQL.
Pin to left / Pin to rightIn Raw data, pins an individual column. In Aggregated data, only Group by columns are eligible, and in Pivot, only row-axis columns are eligible; Pin all aggregate columns to left pins all eligible columns in their configured order. Select the active option again to unpin them.
Column widthUse Fit to values or Reset to initial width for the selected column. Use Fit all columns to values or Reset all columns to initial widths for every column.

Where you can use it ​

LocationAvailability
Notebook
(doc page / grid page)
Available. Add operations are limited to editing a doc page.
ReportAvailable for interactive reports with Enable explorer turned on in the publish settings. Disabled by default.
Signed embedAvailable when Enable explorer is turned on in the publish options. Disabled by default.
Public linkNot available.

See Sharing for a comparison of notebook sharing methods.