Ingestron for VS Code

Write Ingestron projects with problems marked as you type, completion that knows your project, and previews of the files Ingestron generates.

Ingestron turns YAML your team reviews into the files you would otherwise write by hand: Databricks bundles and pipelines, Azure Data Factory pipelines, Synapse serverless views and DuckDB SQL, with your organisation's standard applied. It runs on your machine, never connects to your sources or your cloud, and never overwrites a file someone edited by hand.

Write the definitions

A project is a folder of YAML files: connections, flows, contracts and transforms. The extension reads them as you type.

• Problems as you type: a broken link, a setting the standard fixes, a method that cannot read a source. Quick fixes repair a broken link.
• Hover: says what a setting means and where its value came from.
• Completion: offers only what the project allows.
• Navigation: go to definition, find references and rename across files.

See what it generates

Plan lists what would change, Apply writes it, and the files appear in your project, one set for every environment.

• Plan, Apply and Check from the Command Palette, the editor title and the right-click menu. Check reports generated files that are out of date.
• Show generated files opens what a table becomes, next to its flow.
• Select environment chooses the environment the editor shows: problems, previews and what each line becomes.
• Auto-apply writes the files each time you save, if you turn it on.

New project starts a project in one of three ways: from a connection, a starter or a published standard. The Project and Reference views sit beside the editor.

Know what a source holds

Ingestron never connects to your sources, so someone who can reach one sends the columns and types of its tables as a file.

• Request source metadata opens what to ask for as a Markdown document to send, filled in for your project: who to ask, the query or call to run and where to save the result. Nothing is written to your project.
• Import source metadata… reads the file they send into sources/<connection>.yaml, and tells you what changed. It keeps names and types, never the values in a row. Run it from the Command Palette or the Explorer's right-click menu. It asks which connection the file describes when the file's place in the project does not say, and which table when the file does not say.
• Import on save: a file you save or create under a project's sources/ folder is imported once the save settles. Several files imported together give one notice that says how many tables changed.

Add a guide for coding assistants

Add assistant files writes AGENTS.md, a guide to your project for coding assistants, and a short file for each assistant that needs one. Plan and Apply keep it current, and leave a section you edited by hand.

Documentation: docs.ingestron.io.

Install

Requires Visual Studio Code 1.104 or later.

Install Ingestron from the Visual Studio Marketplace, or search for "Ingestron" in the Extensions view, or run:

code --install-extension ingestron.ingestron-vscode

Open a folder that holds a project.yaml, or run Ingestron: New project from the Command Palette. The extension includes its Ingestron dependencies; you do not need to install the CLI separately.

Privacy

The extension sends no telemetry and makes no network calls of its own. It reads and writes only the files in your workspace. Questions: privacy@ingestron.io.

Contact

Questions and feedback: hello@ingestron.io. Security reports: security@ingestron.io (see SECURITY.md). Privacy: privacy@ingestron.io.

Licence

Licensed under the Apache License 2.0; see NOTICE.