Skip to main content

Quick Tour of the Dremio Console

This quick tour introduces you to the main areas of the Dremio console, including the AI agent, Open Catalog, and SQL Runner. You'll learn how to navigate the interface and access key features of your agentic lakehouse.

Console Navigation

The Dremio console has a top navigation bar and a side navigation bar. The top navigation bar provides access to the project name and semantic search. The side navigation bar provides links to key areas of the Dremio console.

Dremio console navigation
LocationDescription
1Project Name: Name of the current project being explored.
2Home: Central landing page when you log in.
3Open Catalog: Interface for exploring tables and views across the default Open Catalog, other catalogs, object storage, and database sources.
4SQL Runner: Editor for constructing and querying data.
5Jobs: History of executed SQL and job details.
6Admin: Configure and manage your project and organization.
7Help Center: Access point for documentation, the Community Forum, and the Support Portal.
8Account Settings: Section for managing general information, personal access tokens, appearance preferences, and logout options.
9Semantic Search: AI-enabled search for finding objects and entities across your data catalog. Click the search bar on the top of the page and type in your search criteria. For more information, see Search for Dremio Objects and Entities.

AI Agent

Dremio's AI Agent is a conversational interface for exploring, analyzing, and visualizing your data using natural language. On the Home page, type a question into the chat to get started, such as Which tables or views have customer location data?

AI Agent chat

The AI agent can also be accessed on any page via the keyboard shortcut Cmd + Shift + G on Mac or Ctrl + Shift + G on Windows. For more information, see Analyze Using Dremio's AI Agent.

Open Catalog

The Open Catalog page provides navigation and management for data in your Open Catalog, other catalogs, object stores, and databases. Access via in the side navigation bar.

Open Catalog page navigation and management interface.
LocationDescription
1Namespaces: Logical containers that organize data objects within Dremio's Open Catalog, providing hierarchical organization and access control for tables, views, and folders.
2Connections: Self-hosted catalogs, object stores, and databases.
3Path: Dot-separated identifier indicating the location of the object, starting with the source or catalog name, followed by any folders, and ending with the name of the table or view.

SQL Runner

The SQL Runner provides a query editor for running SQL. Access via in the side navigation bar.

SQL Runner interface
LocationDescription
1Data Panel: Area for exploring data across your Open Catalog, other catalogs, object stores, and databases, with drag-and-drop support for adding objects into the SQL editor.
2Scripts Panel: Panel for saved SQL scripts that can be reused and shared with other users in your organization. Each script includes creation/modification timestamps and editor context and requires VIEW privileges.
3Run: Execution of the SQL, which returns the complete result set.
4Preview: Option for previewing the result set, which returns a subset of rows in less time than running the SQL.
5Engine: Dropdown menu for selecting an engine for SQL execution. By default, Automatic is selected, which routes the query to the appropriate engine based on engine routing rules. For more details, see Manage Engines.
6Query Tabs: Tabs for managing multiple query sessions, each with its own SQL editor and results.
7Query Name: Name of the current query tab, which can be edited to help organize your work.
8Results Panel: Table displaying the results of your query with options to download, copy, or edit values.
9Columns: Column count and filter options for the results panel.
10Execution State: Indicator displaying the job status, record count, and execution time, with a link to view full job details. Includes options to download results as JSON, CSV, or Parquet files, or copy data to the clipboard.
11Details Panel: Right-side panel for viewing and managing dataset metadata, including columns, ownership, searchable labels, and wiki content.

Explain SQL

In the SQL Runner, you can ask the AI Agent to analyze and optimize your queries. To use this option, highlight your SQL, right-click, and select Explain SQL from the dropdown.

Limitations and Considerations

Row Limit: SELECT query results are limited to one million rows and may be truncated based on thread distribution. When truncated, a warning appears. To obtain complete results, use JDBC or ODBC drivers.

CSV Download: CSV download is unavailable for result sets with complex data types (union, map, array). The download and copy results options can be enabled or disabled for a specific project by navigating to Admin > Project > Preferences.