Bring in your first file

This tutorial gives you a first, visible result. You will upload a small CSV and verify its location. It does not assume the file is ready for governed queries.

Before you begin

Complete Find your workspace and catalog. Download the sample CSV or save the following as orders.csv on your computer. It is sample data and contains no customer information.

order_id,region,amount
1001,East,240.00
1002,West,120.50
1003,East,89.99

Upload

  1. Open Data → Ingestion, stay on Connectors, and select the Upload files card.
  2. In Type, choose Table. This opens the structured-file wizard; Bucket opens a separate form for original files and folders.
  3. On Files, choose orders.csv, use a domain you can write to (the default domain may already be selected), and name the table orders. The identifier is filled from the name and can be edited.
  4. Continue to Columns. Review the detected names and types and any contract choices; then submit the upload.
  5. Use the result's link to open the table, or find it under Data → Catalog.

The upload type is an explicit choice. If you instead choose Bucket, the form asks for a catalog, domain, and existing bucket before accepting files. A bucket upload does not silently make a table.

Check the result

Find orders under catalog → domain → table and open its detail page. Use Schema to check the three sample columns and read its lifecycle status; a landed table is not necessarily queryable. If you took the Bucket path, find orders.csv under catalog → domain → bucket → file and open its detail page. If the request failed, use the error shown by the page; an empty list alone is not proof of an upload. A service-unreachable error needs an administrator to restore ingestion before retrying.

Next, read how resources and contracts fit together, then follow the query guide once your table is active.