Control-M for dbt

The dbt (Data Build Tool) job is a cloud-based computing platform that enables you to develop, test, schedule, document, and analyze data models.

Control-M for dbt enables you to do the following:

• Execute dbt jobs and override the predefined dbt job commands.
• Manage dbt credentials in a secure connection profile.
• Connect to any dbt endpoint.
• Integrate dbt jobs with other Control-M jobs into a single scheduling environment.
• Monitor the status, results, and output of dbt jobs in the Monitoring domain.
• Attach an SLA job to your dbt jobs.
• Introduce all Control-M capabilities to Control-M for dbt including advanced scheduling criteria, complex dependencies, Resource Pools, Lock Resources, and variables.
• Run 50 dbt jobs simultaneously per Agent.

Control-M for dbt Compatibility

The following table lists the prerequisites that are required to use the dbt plug-in, each with its minimum required version.

Component	Version
Control-M/EM	9.0.20.200
Control-M/Agent	9.0.20.200
Control-M Application Integrator	9.0.20.201
Control-M Automation API	9.0.20.250

Control-M for dbt is supported on Control-M Web and Control-M Automation API, but not on Control-M client.

To download the required installation files for each prerequisite, see Obtaining-Control-M-Installation-Files.

Setting up Control-M for dbt

This procedure describes how to deploy the dbt plug-in, create a connection profile, and define a dbt job in Control-M Web and Automation API.

Before You Begin

Verify that Automation API is installed, as described in Automation API Installation.

Begin

1. Create a temporary directory to save the downloaded files.
2. Download the dbt plug-in from the Control-M for dbt download page in the EPD site.
3. Install the dbt plug-in via one of the following methods:
   • (9.0.21 or higher) Use the Automation API Provision service:
     1. Log in to the Control-M/EM Server machine as an Administrator and store the downloaded zip file in the one of the following locations (within several minutes, the job type appears in Control-M Web):
        • Linux: $HOME/ctm_em/AUTO_DEPLOY
        • Windows: <EM_HOME>\AUTO_DEPLOY
     2. Log in to the Control-M/Agent machine and run the provision image command, as follows:
        • Linux: ctm provision image DBT_plugin.Linux
        • Windows: ctm provision image DBT_plugin.Windows
   • (9.0.20.200 or lower) Use the Automation API Deploy service, as described in deploy jobtype.
4. Create a dbt connection profile in Control-M Web or Automation API, as follows:
   • Web: Creating a Centralized Connection Profile with dbt Connection Profile Parameters
   • Automation API: ConnectionProfile:DBT
5. Define a dbt job in Control-M Web or Automation API, as follows:
   • Web: Creating a Job with dbt Job parameters
   • Automation API: Job:DBT