Getting started
Ingest your first data
Ingest your first data
Create a small table and read the record back. You need a writable catalog.
1. Choose a destination
Run altertable catalog to find a writable catalog. If none exists, create an Altertable catalog in the app.
Use a new table name for this example. Replace my_catalog with your catalog name.
2. Append a record
Altertable CLI
altertable append '{"event":"onboarding_test","source":"quickstart"}' --to my_catalog.main.onboarding_events
Append creates a missing table and infers its columns. Processing is asynchronous, so allow a few seconds before querying.
3. Read it back
Altertable CLI
altertable query "SELECT event, source FROM my_catalog.main.onboarding_events WHERE event = 'onboarding_test' LIMIT 10"
Confirm that the result contains onboarding_test and quickstart. If the record is missing, inspect the append result and ingestion troubleshooting.
Do this with your agent
Agent prompt
Read https://altertable.ai/docs/getting-started/ingest-data.md for context.
Help me ingest my first data into Altertable. Inspect my available catalogs, ask which data I want to load, explain the destination and write operation, and verify the resulting rows.