Chapters

This textbook covers the mountainash-data unified database and lakehouse connectivity library across 9 chapters, progressing from foundational concepts through the Backend protocol, inspection model, Ibis and Iceberg backends, dialect system, settings, adapters, and advanced integration patterns.

Chapter List

1. Foundation Concepts — SQL databases, Python protocols, Pydantic models, and the registry pattern
2. Backend Protocol — The runtime-checkable Backend protocol defining the universal contract
3. Inspection Model — Frozen metadata dataclasses for backend-agnostic catalog introspection
4. Ibis Backend — IbisBackend class with fluent queries, DDL, DML, and inspection
5. Dialect System — DialectSpec registry for backend-specific connection and operation routing
6. Settings and Configuration — ConnectionProfile, BackendSpec, ParameterSpec, DATABASES registry, and provider auth settings
7. Adapters and Auth — Credential transformation pipeline for OAuth, JWT, cloud-native auth, and SSL
8. Iceberg Backend — IcebergBackend for Apache Iceberg catalogs with REST, Hive, Glue, and SQL catalog types
9. Advanced Integration — Cross-backend queries, capability matrix, Iceberg operations, and known limitations