Airbyte
Airbyte is a data integration platform for connecting data sources to warehouses. It integrates with MotherDuck for loading data from operational systems, APIs, files, or event streams.
How it works with MotherDuck
Airbyte can load data into MotherDuck with the MotherDuck destination connector.
Prerequisites
- An Airbyte workspace with permission to create destinations.
- A MotherDuck access token.
- An existing MotherDuck database to use as the destination.
Setup
- In MotherDuck, create an access token for Airbyte.
- In Airbyte, create a new destination and select MotherDuck.
- Set Destination DB to an
md:database path, for examplemd:analytics. - Paste the token into MotherDuck Access Token.
- Optional: set Schema Name. Airbyte namespaces map to MotherDuck schemas.
- Save the destination and use it in a connection.
Authentication and configuration
- Use Airbyte's MotherDuck Access Token field instead of putting the token in the
md:URI. - Use
destination_pathfor the database path. - Use the Airbyte schema field to control the default schema for loaded streams.
Important notes
- Airbyte warns against putting the token in the connection string because it can be printed in execution logs.
- The destination supports full refresh and incremental sync modes.
- Airbyte's connector reference includes local DuckDB file options. For MotherDuck, use the
md:destination path.
Use cases
- Replicate SaaS, API, file, or database sources into MotherDuck.
- Land Airbyte streams into a dedicated MotherDuck schema.
- Use Airbyte Destinations V2 final tables as downstream analytics sources in MotherDuck.