marivo.datasource#

Project-level datasource authoring and management API.

Registration & lifecycle#

`connect`	Open a live ibis backend for a datasource; caller disconnects.
`register`	Create or replace a project datasource file from a DatasourceSpec.
`load`	Load the project datasource catalog.
`list`	List configured project datasources as DatasourceSummary rows.
`remove`	Delete the named project datasource file.
`ref`	Reference a global project datasource by short name.
`test`	Round-trip the backend and persist validated env secrets.

Source constructors#

`csv`	Build a structured CSV source reference.
`parquet`	Build a structured parquet source reference.
`duckdb`	Declare a DuckDB datasource.
`postgres`	Declare a Postgres datasource.
`mysql`	Declare a MySQL datasource.
`clickhouse`	Declare a ClickHouse datasource.
`trino`	Declare a Trino datasource.
`table`	Build a structured table source reference.

Inspection & preview#

`preview`	Bounded, filtered preview of one datasource table.
`inspect_source`	Table metadata for a semantic entity source (table or file).
`inspect_table`	Schema, comments, nullability, and partition metadata for a table.
`inspect_columns`	Profile selected columns from a datasource source with bounded scan.
`probe_join_keys`	Probe join compatibility between two sources on specified key columns.

Discovery#

`help`	Print or return agent-facing help for the datasource surface.
`help_text`	Return help text as a string instead of printing it.
`describe`	Show literal fields and env refs for one datasource.

Source IR#

`DatasourceIR`	Project-level datasource configuration.
`CsvSourceIR`	Physical CSV source for an entity.
`ParquetSourceIR`	Physical parquet source for an entity.
`AiContextIR`	Immutable AI-facing context stored on semantic and datasource objects.
`DatasourceAiContextIR`

Catalog & refs#

`DatasourceCatalog`	Read-only catalog over configured project datasources.
`DatasourceRef`	Global datasource reference used by semantic declarations.
`DatasourceSummary`	Summary row for one configured project datasource.
`DatasourceDescription`	Literal fields and env refs for one datasource.
`DatasourceSourceLocation`	Absolute source location for datasource error reporting.
`DatasourceConnectionService`	Manages scoped and session-scoped backend connections.

Metadata#

`TableMetadata`
`ColumnMetadata`
`ColumnProfile`	Statistical profile of a single column from a datasource scan.
`PartitionMetadata`
`ScanScope`	Agent-safe scan configuration with bounded defaults.

Results & reports#

`DatasourceTestResult`	Result of a datasource connectivity round-trip.
`PreviewResult`
`PreviewSamplePolicy`
`ScanReport`	Summary of a completed datasource scan.
`ColumnInspection`	Column inspection result for a single datasource source.
`JoinKeyProbe`	Result of probing join compatibility between two sources.
`JoinSide`	One side of a join-key probe.

Warnings#

`MetadataWarning`
`PreviewWarning`