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

Настройка BYOK для dbt Wizard Бета-версия

Вы можете использовать CLI dbt Wizard с собственными учетными данными (bring-your-own-key, BYOK): в этом случае вы предоставляете учетные данные поддерживаемого провайдера ИИ вместо использования инфраструктуры dbt Labs.

Приведенные на этой странице инструкции по настройке BYOK относятся только к CLI. О настройке BYOK для dbt platform см. Настройка BYOK для dbt Wizard в dbt platform.

Если вы не хотите самостоятельно заниматься настройкой и обслуживанием, вариант под управлением dbt Labs (управляемое подключение) готов к использованию без настройки и включает пробные и ежемесячные кредиты на использование.

Под «ключом» в BYOK понимаются любые учетные данные, которые выбранный провайдер использует для аутентификации API-запросов: API-ключ для OpenAI или Anthropic, токен Bearer для AWS Bedrock или токен/PAT для Snowflake Cortex. После настройки провайдера с этими учетными данными dbt Wizard использует их для прямого обращения к API провайдера, поэтому:

  • Расходы на использование отражаются в вашем аккаунте провайдера, а не в аккаунте dbt Labs.
  • Плату за токены взимает выбранный вами провайдер.

dbt Wizard поддерживает модели управляемое подключение (оплата через dbt Labs, управлять ключом не требуется) и модели с собственным ключом (BYOK) (оплата напрямую провайдеру).

Ниже перечислены поддерживаемые провайдеры ИИ в зависимости от того, где вы работаете. Полный список доступных моделей см. в таблице тарифов провайдеров моделей.

ПровайдерДоступ
OpenAIdbt управляемое подключение или BYOK
Anthropic†dbt управляемое подключение или BYOK
Модели с открытыми весами (например, DeepSeek, Kimi и другие).dbt управляемое подключение
Azure AI Foundry / Azure OpenAIBYOK
AWS BedrockBYOK
Google GeminiBYOK
Snowflake CortexBYOK
Databricks Unity AI GatewayBYOK

Вы также можете подключить личную подписку OpenAI ChatGPT вместо ключа.

†Корпоративные лицензии и лицензии по подписке Anthropic (например, Claude Enterprise) не поддерживаются согласно условиям использования Anthropic.

Посмотрите, как это работает, и поделитесь отзывом

Хотите увидеть dbt Wizard в действии? Посмотрите демонстрационное видео.

Нам было бы интересно узнать о вашем опыте работы с dbt Wizard. Поделитесь отзывом, выполнив слеш-команду /feedback в интерактивном сеансе терминала или перейдя в канал #dbt-wizard в Slack-сообществе dbt.

Большое спасибо за помощь в улучшении dbt Wizard и процесса разработки данных с помощью dbt!

Настройка провайдера​

Вы можете настроить провайдера одним из следующих способов:

  • Команды терминала: лучше всего подходят пользователям, которые хотят настраивать провайдеров из командной оболочки.
  • Интерактивный сеанс: лучше всего подходит большинству пользователей, работающих в текстовом пользовательском интерфейсе (TUI) dbt Wizard. Используйте слеш-команду /providers.
  • Переменные окружения: лучше всего подходят для запусков без пользовательского интерфейса, например wizard exec, автоматизации или временных локальных сеансов.

Настройка в терминале​

В терминале используйте подкоманду providers для просмотра списка, настройки и включения провайдеров:

wizard providers list
wizard providers configure PROVIDER_NAME
wizard providers enable PROVIDER_NAME

Замените PROVIDER_NAME именем поддерживаемого провайдера, например openai, anthropic, bedrock, azure, gemini, snowflake или databricks. Затем следуйте подсказкам, чтобы ввести учетные данные.

Команда wizard providers list показывает настроенных провайдеров и их текущее состояние:

➜  jaffle-shop git:(mwong-v2) wizard providers list
provider              enabled  route      auth         models
dbt                   true     remote     dbt          3
openai                false    local      missing      3
openai_subscription   false    local      missing      1
anthropic             false    local      missing      3
bedrock               true     local      configured   15
azure                 false    local      missing      3
snowflake             false    local      missing      3
gemini                false    local      missing      3

Команда configure предлагает ввести учетные данные для выбранного провайдера. Чтобы использовать переменные окружения или задать ключ, не сохраняя его в истории команд оболочки, см. Настройка API-ключа.

Например, если вы используете OpenAI, выполните следующие команды и следуйте подсказкам для его настройки:

wizard providers configure openai
wizard providers enable openai

Чтобы сохранить API-ключ, не записывая его в историю команд оболочки:

printf '%s' 'sk-...' | wizard providers set-key PROVIDER_NAME

Учетные данные хранятся в ~/.dbt/wizard/provider-auth.json. Настройки провайдеров хранятся в ~/.dbt/wizard/providers.json.

Настройка в TUI​

Вы можете настраивать провайдеров в активном сеансе TUI CLI с помощью слеш-команды /providers:

/providers

В меню провайдеров вы можете:

  • Включить или отключить провайдера.
  • Добавить или обновить учетные данные.
  • Выбрать доступные модели.
  • Проверить, прошел ли провайдер аутентификацию и активен ли он.

Пример меню провайдеров:

/providers

  Model Providers
  Select a provider to inspect or update it.
 
› 1. dbt                  enabled; 3/3 models selected; uses dbt login; active
  2. openai               disabled; 3/3 models selected; missing credentials; needs setup
  3. openai_subscription  disabled; 1/1 models selected; not connected; needs setup
  4. anthropic            disabled; 3/3 models selected; authenticated; needs setup
  5. bedrock              enabled; 15/15 models selected; authenticated; active
  6. azure                disabled; 3/3 models selected; missing credentials; needs setup
  7. snowflake            disabled; 3/3 models selected; missing credentials; needs setup
  8. gemini               disabled; 3/3 models selected; missing credentials; needs setup

Настройка API-ключа​

При первом запуске dbt Wizard в проекте мастер начальной настройки предложит выбрать провайдера.

  1. В запросе Configure a Provider выберите провайдера.
  2. Когда появится соответствующий запрос, вставьте API-ключ или учетные данные провайдера.
  3. Выберите модель ИИ, чтобы завершить настройку.

Чтобы позднее добавить или сменить провайдера в активном сеансе, введите /providers в TUI.

При настройке провайдера через dbt Wizard учетные данные сохраняются в ~/.dbt/wizard/provider-auth.json.

Чтобы сохранить учетные данные провайдера для дальнейшего использования, воспользуйтесь одним из следующих вариантов:

  • wizard providers configure PROVIDER_NAME
  • wizard providers set-key PROVIDER_NAME
  • Переменная окружения провайдера

Выбор модели ИИ​

По умолчанию CLI dbt Wizard использует модели под управлением dbt Labs. Переключиться на модель BYOK можно следующими способами:

СпособОписаниеПример
Интерактивный сеансИзмените модель ИИ интерактивно в TUI./model
Флаг запускаИзмените модель ИИ при запуске с помощью флага -m.wizard -m gpt-4o "refactor stg_orders to use incremental materialization"
Файл конфигурацииЗадайте модель ИИ по умолчанию в файле конфигурации (~/.dbt/wizard/config.toml); настройка применяется ко всем последующим сеансам. Выполните wizard debug models, чтобы получить список идентификаторов доступных моделей.model = "gpt-4o"

После изменения модели перезапустите CLI dbt Wizard.

Примеры​

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

AWS Bedrock​

AWS Bedrock поддерживается только в CLI. В настоящее время dbt Wizard поддерживает Bedrock через API-ключ Amazon Bedrock, а не через полную цепочку учетных данных AWS. Убедитесь, что ваш аккаунт AWS имеет доступ к моделям Bedrock, которые вы планируете использовать, а ваш API-ключ Bedrock дает разрешение на их вызов.

export AWS_BEARER_TOKEN_BEDROCK="ABSK..."
wizard providers enable bedrock
wizard providers bedrock set-region us-east-1
wizard providers list
wizard debug models

Чтобы задать модель Bedrock по умолчанию, добавьте идентификатор модели в ~/.dbt/wizard/config.toml:

model = "BEDROCK_MODEL_ID"

Snowflake Cortex Предварительная версия​

Поддержка BYOK для Snowflake Cortex в CLI находится на стадии предварительной версии. Доступность и порядок настройки могут измениться. Убедитесь, что ваш аккаунт Snowflake имеет необходимые права для использования функций больших языковых моделей (LLM) Cortex. См. документацию Snowflake Cortex.

Вы можете пройти аутентификацию в Snowflake Cortex с помощью API-токена или токена программного доступа (Programmatic Access Token, PAT) (для пользователей SSO и Okta).

wizard providers list
wizard providers enable snowflake
wizard providers configure snowflake
wizard providers list
wizard debug models

Команда wizard providers configure snowflake последовательно выводит следующие запросы:

Enable this provider? [Y/n]:
Models to enable [1]:
Snowflake account ID:
Snowflake API base override (optional):
Paste API key/token, or press enter to configure it later:
ЗапросЧто ввести
Snowflake account IDИдентификатор вашего аккаунта Snowflake (например, myorg-myaccount)
Snowflake API base override (optional)Оставьте поле пустым — оно требуется только для нестандартных или частных конечных точек Snowflake
Paste API key/tokenВаш токен аутентификации — см. Варианты аутентификации в следующем разделе

Варианты аутентификации​

Поле ключа/токена принимает обычный API-токен или токен программного доступа (PAT) в зависимости от конфигурации вашего аккаунта Snowflake. Оба типа вводятся в одном и том же месте: в ответ на запрос Paste API key/token в терминале или через Set key/token (пункт 3) в TUI.

  1. В своем аккаунте Snowflake создайте API-токен или PAT.
  2. Выберите Generate token и скопируйте значение токена.
  3. Вернитесь в dbt Wizard и вставьте PAT в ответ на запрос ключа/токена.

Чтобы задать модель Snowflake Cortex по умолчанию, добавьте идентификатор модели в ~/.dbt/wizard/config.toml:

model = "SNOWFLAKE_CORTEX_MODEL_ID"

Databricks Unity AI Gateway Бета-версия​

dbt Wizard подключается к Databricks через Unity Catalog AI Gateway, поэтому вы используете собственные модели, обслуживаемые в вашем рабочем пространстве Databricks. Убедитесь, что конечные точки обслуживания моделей, которые вы планируете использовать, развернуты, а ваш токен Databricks дает разрешение на отправку запросов к ним.

export DATABRICKS_API_KEY="dapi..."
wizard providers configure databricks
wizard providers enable databricks
wizard providers list
wizard debug models

Команда wizard providers configure databricks сначала запрашивает URL вашего рабочего пространства, а затем имя конечной точки обслуживания для каждой включаемой модели:

Enable this provider? [Y/n]:
Models to enable [1]:
Databricks workspace URL (e.g. https://adb-1234567890.azuredatabricks.net):
Endpoint name for databricks/claude-sonnet-4-6:
Paste API key/token, or press enter to configure it later:
ЗапросЧто ввести
Databricks workspace URLURL вашего рабочего пространства Databricks (например, https://adb-1234567890.azuredatabricks.net)
Endpoint nameИмя конечной точки обслуживания для каждой модели (например, databricks-claude-sonnet-4-6). dbt Wizard предлагает имя конечной точки по умолчанию для каждой модели
Paste API key/tokenВаш персональный токен доступа Databricks (PAT)

По умолчанию dbt Wizard сопоставляет следующие модели с конечными точками обслуживания Databricks. Во время настройки вы можете переопределить любое имя конечной точки:

МодельИмя конечной точки по умолчанию
claude-sonnet-4-6databricks-claude-sonnet-4-6
claude-opus-4-7databricks-claude-opus-4-7
claude-haiku-4-5databricks-claude-haiku-4-5
gpt-5.5databricks-gpt-5-5
gpt-5.4databricks-gpt-5-4
gpt-5.4-minidatabricks-gpt-5-4-mini

Чтобы задать модель Databricks по умолчанию, добавьте идентификатор модели в ~/.dbt/wizard/config.toml:

model = "databricks/claude-sonnet-4-6"

Связанная документация​

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

0
Loading