Skip to Content
We are live but in Staging 🎉
TablesAPI ReferenceTablesOverview

Tables — API Reference

Package: dodil.k3.tables.v1 · Service: TableService

Tables are bucket-scoped Delta Lake tables managed by K3’s HTAP layer. Two creation modes — manual (you define the schema) or pipeline-generated (a Scriptum template owns it). See Core Concepts → Table.

RPCHTTPPage
CreateTablePOST /:bucket/tablesCreate
CreateTablePipelinePOST /:bucket/tables/pipelinesCreate
ListTablesGET /:bucket/tablesLifecycle
GetTableGET /:bucket/tables/:table_nameLifecycle
DeleteTableDELETE /:bucket/tables/:table_nameLifecycle
AlterTablePATCH /:bucket/tables/:table_name/schemaSchema
DescribeTableGET /:bucket/tables/:table_name/describeSchema
ListPartitionsGET /:bucket/tables/:table_name/partitionsSchema

Sub-pages

  • Create — CreateTable (manual mode) and CreateTablePipeline (Scriptum template-backed). Pick manual when the row schema is known up-front; pick the pipeline variant when a warehouse-compatible template owns the schema and materializes it lazily on first ingest.
  • Lifecycle — GetTable, ListTables, DeleteTable. Read / enumerate / remove existing tables. For pipeline-generated tables, the bound pipeline and auto-generated rule are not cascade-deleted by DeleteTable.
  • Schema — AlterTable (ADD COLUMN only), DescribeTable (schema + Delta + HTAP sidecar stats — the richest single-table read, incl. last_drain_* row classification), ListPartitions (per-partition file counts for spotting skew).

See also

OverviewCreate