# Conéctate a dbt

Once you’ve set up the initial data warehouse connection, you can add dbt jobs linked to the warehouse account.

{% hint style="info" %}
**NOTE:** this requires `Job Viewer` role access to a dbt Cloud account.
{% endhint %}

## Adding DBT

1. In the **Connections** tab, click on the connection that should have linked dbt jobs.
2. Go to the **dbt connections** section and click the **Add dbt connection** button.<br>

   <figure><img src="/files/ut6giCEOYcJCSC7fQaE3" alt="" width="375"><figcaption></figcaption></figure>
3. Fill in the form with the required details. See below for additional details.<br>

   <figure><img src="/files/dOi9eFdBs4jxticmE1Fc" alt=""><figcaption></figcaption></figure>

## Form Details

<details>

<summary>Account and job ID</summary>

In dbt Cloud, navigate to the **Jobs** list under the **Deploy** menu. Click on the job that you want to connect to Arcwise (if you have multiple jobs, please select the job that builds your dbt docs, i.e. it includes a dbt docs generate step). The URL should be in the form&#x20;

`https://cloud.getdbt.com/next/deploy/[ACCOUNT-ID]/projects/[PROJECT_ID]/jobs/[JOB_ID]`

Copy and paste the account and job numbers into the Arcwise form.

![](/files/8cBeat3xgi5YitlCmzI3)

</details>

<details>

<summary>Service token</summary>

See instructions in [dbt docs for generating a service token](https://docs.getdbt.com/docs/dbt-cloud-apis/service-tokens). The token must have access to both the **Metadata API** and **Job Admin**.

</details>

<details>

<summary>Semantic Layer Proxy URL</summary>

If you want to allow Arcwise to use [dbt metrics](https://docs.getdbt.com/docs/build/metrics), then you’ll need to link Arcwise to the dbt Semantic Layer. Follow the [semantic layer setup instructions from the dbt docs](https://docs.getdbt.com/docs/use-dbt-semantic-layer/setup-dbt-semantic-layer) (if you haven’t already) and paste the proxy URL from your job’s environment into Arcwise.

</details>

## Indexing

After the dbt connection has been successfully saved, navigate to the “Tables” tab and you should see the models and metrics belonging to your dbt job.

{% hint style="info" %}
By default, Arcwise will index all models and metrics linked to the job that have not been marked as hidden from dbt docs. To hide things from Arcwise, you can set the `docs` config to `show: false` - please see the [official dbt docs](https://docs.getdbt.com/reference/resource-configs/docs#mark-a-model-as-hidden) for how to do this for an individual model or entire folders.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.arcwise.app/espanol/configuracion-de-arcwise/conexion-de-herramientas-de-datos/conectate-a-dbt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.