Using the Query Builder

Using the Query Builder

When you click Query Builder (to the right of the AI Assistant / SQL / Results tabs), a full-screen interface appears. This is a visual tool that helps you construct queries with more control. The Query Builder screen is divided into three main sections. Here’s how it works.

Query Builder

Left Column: Visualization and Data Table

  • Chart (Top) Displays a visual representation of your query results, such as a line or bar chart.

  • Data Table (Bottom) Shows the raw or aggregated data used by the chart. Each row and column corresponds to the fields and filters defined in your query.

Center Column: Query Composer and AI Assistant

  • Query Panel (Top) Displays the SQL code that runs behind the scenes. You can edit this code manually or let the AI Assistant generate it for you. A Run Query button often appears here, allowing you to execute or re-run your query.

  • AI Assistant (Bottom) Provides a conversational interface where you can type requests in natural language. The AI will respond by generating or modifying the SQL query in the panel above.

Right Column: Schema Browser, Tables, and Descriptions

  • List of Available Tables Shows database tables like BLOCKS, TRANSACTIONS, and others, each with expandable sections to reveal columns and descriptions.

  • Contextual Info Provides brief explanations or documentation about the data, helping you understand each table’s purpose or schema.

How It All Works Together

  • Left: Visualize and confirm your data (chart + data table).

  • Center: Manage your query, either via direct SQL edits or the AI Assistant’s help.

  • Right: Explore available tables and columns, expanding them to decide what data you want to include.

Exploring the Schema

In the right column of the Query Builder, you’ll see a list of available tables, each containing specific data about the blockchain. Selecting a table (e.g., BLOCKS) displays its columns and a short description. These details help you decide which fields to include in your queries.

We’ll go through each table one by one to give you a clear understanding of all available data.

Last updated