Skip to main content

Run your first query

Before you start​

  • Your administrator has provided a workspace URL and an account.
  • You have completed password setup and email verification.
  • Your role allows query submission. In the reviewed backend, this requires workspace-write permission: organization owners, administrators, and data engineers have it. Analyst and viewer roles do not currently have query-submission permission.
  • Your workspace has a working query service and at least one available catalog.

This walkthrough does not create a connection, database, table, or organization. It uses literal sample values, so no dataset import is required.

Sign in

Open the workspace URL, enter your email and password, and complete any email-verification or authenticator prompt. See Sign in and secure your account.

Open Query

Select Query in the sidebar. Choose an available catalog. If a schema selector is available, you may leave it unset for this example.

Run the example

Replace the editor contents with the SQL below and select Run query.

SELECT
  'sample-order-001' AS order_id,
  'Completed' AS status,
  3 AS item_count;

Check the result

Wait for the terminal result rather than stopping at a queued or running status. The result grid should contain one row with three columns: order_id, status, and item_count.

Open the entry in History to inspect it again. If the query fails, copy its identifier and the sanitized error message for your administrator.

Next: explore a real table​

Open Tables under Data Catalog, choose a table you are allowed to read, and inspect its columns before querying it. Replace the example name below with the exact catalog, schema, and table shown in your workspace:

SELECT *
FROM iceberg.training.orders
LIMIT 20;

iceberg.training.orders is an illustration, not a pre-installed dataset. If it does not exist, use a table from your catalog or follow Build your first pipeline.

Something did not work?

Check sign-in, permissions, catalog availability, and query failures.