Set Up OCF Connector for dbt

Alation Cloud Service Applies to Alation Cloud Service instances of Alation

Customer Managed Applies to customer-managed instances of Alation

Install the Connector

To install an OCF connector:

  1. Ensure that the OCF connector Zip file is available on your local machine.

  2. Install the connector on the Connectors Dashboard page using the steps in Install Connectors.

Configure dbt Gen2 Data Source

Important

If you have configured an add-on connector for dbt for dbt Cloud on any data source, as a best practice, we recommend that you disable it before configuring the dbt Gen2 data source. To disable, turn off the Configure the DBT OCF Connector toggle from the data sources where you have configured the add-on connector for dbt. To view the list of data sources that support the dbt add-on connector, See Supported Data Sources for dbt Gen2 OCF Connector.

The video below demonstrates how to configure the dbt Gen2 data source.

Follow these steps to configure the dbt Gen2 data source:

  1. Log in to Alation as a Server Admin.

  2. From the Catalog menu on the left-side navigation, select ELT Sources.

    Note

    ELT sources are not available by default and can only be added to the catalog if they have been enabled for your instance by Alation Support. These steps assume that ELT support is already enabled.

  3. Click Add ELT Sources.

  4. Enter details for title and description.

  5. Select the dbt Gen2 OCF connector from the dropdown and click on Add Source.

    The name of this connector is dbt Gen2 OCF Connector. You will be navigated to the General Settings tab of the newly added connector for configuration.

    Note

    Using the connector names in the dropdown list, you can distinguish between connectors installed on an agent and non-agent connectors. The agent-based connector will have the agent name appended to the connector name in parenthesis. For example, dbt Gen2 OCF Connector (Siorex-agent-for dbt).