Перейти к основному содержимому

Как найти идентификаторы для dbt MCP

Некоторые переменные окружения и заголовки dbt MCP требуют числовых идентификаторов из вашей учетной записи dbt platform. В этом руководстве показано, где именно найти каждый из них.

Используйте числовые идентификаторы, а не полные URL-адреса

Переменные идентификаторов принимают целые числа, а не URL-адреса. Распространенная ошибка — копирование URL-адреса из адресной строки браузера.

# ✅ Правильно
DBT_HOST=cloud.getdbt.com            # https://cloud.getdbt.com тоже подходит
DBT_PROD_ENV_ID=54321
DBT_USER_ID=123

# ❌ Неправильно — идентификаторы должны быть числами, а не полными URL-адресами
DBT_PROD_ENV_ID=https://cloud.getdbt.com/deploy/12345/projects/67890/environments/54321
DBT_USER_ID=https://cloud.getdbt.com/settings/profile

DBT_HOST (имя хоста учетной записи)​

Имя хоста — это домен, который вы используете для доступа к dbt platform. Допускаются оба варианта: cloud.getdbt.com и https://cloud.getdbt.com.

  1. Войдите в свою учетную запись dbt platform.
  2. Перейдите в Account settings.
  3. Скопируйте значение Access URL.
Тип учетной записиПример Access URLЗначение DBT_HOST
Мультитенантная в СШАcloud.getdbt.comcloud.getdbt.com
Учетные записи с префиксом поддоменаabc123.us1.dbt.comabc123.us1.dbt.com
Однотенантнаяyour-company.getdbt.comyour-company.getdbt.com

Дополнительные сведения о регионах и размещении см. в разделе Доступ, регионы и IP-адреса.

DBT_ACCOUNT_ID (идентификатор учетной записи)​

  1. Войдите в свою учетную запись dbt platform.
  2. Перейдите в Account settings.
  3. Идентификатор учетной записи отображается на странице настроек. Его также можно найти в URL-адресе: https://cloud.getdbt.com/settings/accounts/ACCOUNT_ID/. Например, если URL-адрес — https://YOUR_ACCESS_URL/settings/accounts/12345/, идентификатор учетной записи — 12345.

Другие способы описаны в разделе Поиск идентификаторов пользователя и учетной записи.

DBT_PROD_ENV_ID (идентификатор производственной среды)​

  1. Войдите в свою учетную запись dbt platform.
  2. Перейдите в Orchestration → Environments.
  3. Нажмите на свою производственную среду.
  4. Идентификатор среды указан в URL-адресе: https://cloud.getdbt.com/deploy/ACCOUNT_ID/projects/PROJECT_ID/environments/ENVIRONMENT_ID. Например, если URL-адрес — https://YOUR_ACCESS_URL/deploy/12345/projects/67890/environments/54321, идентификатор среды — 54321.

Скопируйте только число в конце — например, 54321.

DBT_DEV_ENV_ID (идентификатор среды разработки)​

Выполните те же действия, что и для DBT_PROD_ENV_ID, но выберите среду разработки вместо производственной среды.

Эта переменная обязательна для execute_sql. Если у вас нет выделенной среды разработки, здесь можно использовать идентификатор производственной среды, хотя рекомендуется создать отдельную среду разработки.

DBT_USER_ID (идентификатор пользователя)​

  1. Войдите в свою учетную запись dbt platform.
  2. Перейдите в Account settings → Profile (или нажмите на свой профиль/аватар).
  3. Идентификатор пользователя указан в URL-адресе: https://cloud.getdbt.com/settings/profile/USER_ID. Например, если URL-адрес — https://YOUR_ACCESS_URL/settings/profile/123, идентификатор пользователя — 123.

Скопируйте только число.

Другой способ описан в разделе Поиск идентификаторов пользователя и учетной записи.

DBT_TOKEN (токен доступа)​

В следующих разделах объясняется, как найти персональный токен доступа (PAT) и сервисный токен.

Персональный токен доступа (PAT)​

Обязателен для execute_sql. Привязан к вашей личной учетной записи.

  1. Перейдите в Account settings → API tokens → Personal tokens.
  2. Нажмите + New token, задайте имя и скопируйте значение токена.
  3. Сохраните его в безопасном месте — после закрытия диалогового окна вы не сможете просмотреть его снова.

Сервисный токен​

Используется для общих или командных конфигураций. Лучше подходит для CI и автоматизации.

  1. Перейдите в Account settings → API tokens → Service tokens.
  2. Нажмите + New token, назначьте необходимые разрешения и скопируйте значение токена.
  3. Назначьте набор разрешений Developer, ограничив его действие либо проектом, которому принадлежит среда, используемая для x-dbt-prod-environment-id, либо распространив его на все проекты. Токен без этого набора разрешений отклоняется с кодом 401 при подключении MCP-клиента. Другие наборы разрешений не требуются. Назначить Developer сервисному токену можно только на тарифных планах Enterprise и Enterprise+; на других тарифных планах используйте OAuth.

Дополнительные сведения см. в разделах Пользовательские токены (PAT) и Сервисные токены.

Нашли ошибку?

0
Loading