Mountainash Data

An intelligent textbook for the mountainash-data unified database and lakehouse connectivity library.

Transitional publishing: This manual remains on the central site until its per-repository cutover.

Open textbook

Chapters

1. Foundation Concepts
2. Backend Protocol
3. Inspection Model
4. Ibis Backend
5. Dialect System
6. Settings and Configuration
7. Adapters and Auth
8. Iceberg Backend
9. Advanced Integration

Key Topics

• Backend protocol -- runtime-checkable structural protocol defining a universal contract for connecting to 20+ SQL databases and Apache Iceberg catalogs
• Ibis and Iceberg backends -- IbisBackend for SQL databases with fluent queries and DDL/DML, plus IcebergBackend for REST, Hive, and Glue catalogs
• Inspection model -- CatalogInfo, NamespaceInfo, TableInfo, and ColumnInfo metadata dataclasses for uniform catalog introspection
• Dialect system -- DialectSpec registry for backend-specific connection routing and operation dispatch across database engines
• Adapters and auth -- credential transformation pipeline supporting OAuth, JWT, cloud-native authentication, and SSL with per-backend AuthSettings