Plugins

Connector plugin management and transformer plugin definitions.

Plugin Manager

type: PluginManager

PluginManager manages the configured plugins, grouped by category.

Property	Type	Required	Description
`source`	Plugin []	No	List of configured source plugins.
List of configured source plugins.
`target`	Plugin []	No	List of configured target plugins.
List of configured target plugins.
`transformer`	Plugin []	No	List of configured transformer plugins.
List of configured transformer plugins.

type: Plugin

Plugin defines an Amfelt plugin configuration.

Example

plugin: postgres
version: 1.2.3
registry: local

Property	Type	Required	Description
`address`	string	No	Address is the network address (host:port) of the plugin’s gRPC server. Only used when Registry is “grpc”.
Address is the network address (host:port) of the plugin’s gRPC server. Only used when Registry is “grpc”.
`insecure`	boolean	No	Insecure disables TLS for the gRPC connection to this plugin. Only used when Registry is “grpc”. Default: false (TLS required).
Insecure disables TLS for the gRPC connection to this plugin. Only used when Registry is “grpc”. Default: false (TLS required).
`path`	string	No	Path of the plugin relative to the project’s Amfelt directory.
Path of the plugin relative to the project’s Amfelt directory.
`plugin`	string	Yes	Name of the plugin.
Name of the plugin.
`registry`	string	No	Plugin registry to use.
Plugin registry to use.
`version`	string	No	Semantic version of the plugin.
Semantic version of the plugin.

type: Transformer

A transformer plugin and the jobs it runs after data has landed in a target.

Property	Type	Required	Description
`jobs`	TransformerJob []	Yes	Jobs lists the transformation jobs this transformer runs.
Jobs lists the transformation jobs this transformer runs.
`plugin`	string	Yes	Plugin is the name of the transformer plugin used to run these jobs (e.g. “dbt”). Must match a plugin configured in Plugins.Transformer.
Plugin is the name of the transformer plugin used to run these jobs (e.g. “dbt”). Must match a plugin configured in Plugins.Transformer.

type: TransformerJob

One transformation job: which source and target objects it transforms between, and how objects are selected.

Property	Type	Required	Description
`name`	string	Yes	Name identifies this transformer job within its transformer’s Jobs list.
Name identifies this transformer job within its transformer’s Jobs list.
`select`	Select	No	Select is the glob-based object selection this transformer job operates over.
Select is the glob-based object selection this transformer job operates over.
`source`	string	Yes	Source is the name of the source this transformer job reads from. Must match the name of an entry in the project’s sources list.
Source is the name of the source this transformer job reads from. Must match the name of an entry in the project’s sources list.
`target`	string	Yes	Target is the name of the target this transformer job writes to. Must match the name of an entry in the project’s targets list.
Target is the name of the target this transformer job writes to. Must match the name of an entry in the project’s targets list.

Last updated on November 1, 2026