Skip to content

Commit 1e63dab

Browse files
authored
docs: adopt instant database terminology in hand-written prose (#176)
Rename "managed database" / "managed catalog" to "instant database" / "instant catalog" in hand-written prose (integration test docstring and comments, changelog note). Documentation only: public API symbols keep their existing "managed" naming for compatibility, and quoted server error messages are left verbatim. Generated modules and docs echo the OpenAPI spec prose and will pick up the new wording on the next regeneration from the updated spec. Co-authored-by: Eddie A Tejeda <669988+eddietejeda@users.noreply.github.com>
1 parent 12aedd4 commit 1e63dab

2 files changed

Lines changed: 9 additions & 4 deletions

File tree

CHANGELOG.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
99

1010
### Changed
1111

12+
- docs: adopt "instant database" / "instant catalog" terminology in hand-written
13+
prose. Documentation only — all public API symbols (`ManagedTableResponse`,
14+
`load_managed_table`, the `managed` source type, etc.) are unchanged for
15+
compatibility. Generated docstrings pick up the new wording on the next client
16+
regeneration from the updated OpenAPI spec.
1217
- feat(query): add dialect parameter to query request
1318

1419
## [0.10.0] - 2026-08-18

tests/integration/test_managed_tables_lifecycle.py

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
"""Scenario: managed_tables_lifecycle.
22
33
The heaviest scenario — it ties databases, uploads, and managed tables together
4-
against a fresh scratch database (whose default catalog is a managed catalog):
4+
against a fresh scratch database (whose default catalog is an instant catalog):
55
66
1. declare a schema and a table on the database's default catalog connection,
77
2. upload a small parquet file,
88
3. load it into the table (load_managed_table) and verify the load response,
99
4. delete the managed table.
1010
11-
Notes on managed-catalog semantics (all confirmed against prod). A managed
11+
Notes on instant-catalog semantics (all confirmed against prod). An instant
1212
catalog rejects the maintenance ops that apply to external catalogs, so this
1313
scenario deliberately omits them:
1414
15-
* No `refresh` step — rejected with 400 on a managed catalog ("use the loads
15+
* No `refresh` step — rejected with 400 on an instant catalog ("use the loads
1616
endpoint to update its data"); `load_managed_table` is itself the load.
1717
* No `purge_table_cache` step — rejected with 400 ("purge not supported for
1818
managed catalogs").
@@ -55,7 +55,7 @@ def test_managed_tables_lifecycle(
5555
uploads_api: UploadsApi,
5656
scratch_database: str,
5757
) -> None:
58-
# The database's auto-provisioned default catalog is a managed catalog,
58+
# The database's auto-provisioned default catalog is an instant catalog,
5959
# addressed through its default_connection_id.
6060
connection_id = databases_api.get_database(scratch_database).default_connection_id
6161
schema_name = "sdkci_mt"

0 commit comments

Comments
 (0)