# О команде dbt system

`dbt system` предоставляет команды для управления установленной версией dbt. Версия v2 представляет собой единый скомпилированный исполняемый файл без зависимостей от других библиотек. После установки `dbt system` позволяет обновлять и удалять dbt, а также управлять драйверами напрямую, без pip, brew или среды Python.

`dbt system update` и `dbt system uninstall` поддерживаются только для dbt v2, [установленного через CDN](https://docs.getdbt.tech/docs/local/install-dbt.md). Если вы установили dbt v2 через Pip, Homebrew или Winget, для обновления или удаления dbt необходимо использовать эти инструменты.

В dbt v1 аналогичной команды нет.

## Использование

```shell
dbt system <subcommand> [flags]
```

## Подкоманды

| Подкоманда                   | Описание                                                             |
| ---------------------------- | -------------------------------------------------------------------- |
| `dbt system update`          | Обновить dbt до последней (или указанной) версии                     |
| `dbt system uninstall`       | Удалить dbt v2 из вашей системы                                      |
| `dbt system install-drivers` | Предварительно установить все поддерживаемые драйверы адаптеров ADBC |

## dbt system update

`dbt system update` обновляет исполняемый файл CLI на месте. По умолчанию команда обновляет его до последней стабильной версии. Также можно указать именованный канал или конкретный номер версии.

```shell
dbt system update [flags]
```

### Параметры

| Флаг                | Описание                                                                                                                                                      |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--version VERSION` | Обновить до конкретной версии (например, `2.0.1`) или версии из именованного канала (`canary`, `dev`). По умолчанию используется последняя стабильная версия. |
| `--package PACKAGE` | Пакет для обновления. Допустимые значения: `dbt` или `all`. По умолчанию используется `dbt`.                                                                  |

### Каналы версий

| Канал         | Описание                                                                                   |
| ------------- | ------------------------------------------------------------------------------------------ |
| *(не указан)* | Последняя стабильная версия                                                                |
| `canary`      | Самая свежая предварительная сборка (проходит активное тестирование и может быть отозвана) |
| `dev`         | Сборка для разработки (может быть нестабильной)                                            |

### Примеры

Обновление до последней стабильной версии:

```shell
dbt system update
```

Обновление до конкретной версии:

```shell
dbt system update --version 2.0.1
```

Обновление до версии из канала canary:

```shell
dbt system update --version canary
```

## dbt system uninstall

`dbt system uninstall` удаляет исполняемый файл CLI из вашей системы. В macOS и Linux команда загружает и запускает официальный скрипт `uninstall.sh`. В Windows удаление выполняет скрипт PowerShell после завершения текущего процесса (чтобы снять блокировку файла запущенной программы).

```shell
dbt system uninstall
```

Эта команда не принимает дополнительных флагов.

## dbt system install-drivers

`dbt system install-drivers` загружает и кэширует все поддерживаемые библиотеки драйверов адаптеров ADBC (`.dylib`, `.so`, `.dll`) сразу для всех поддерживаемых платформ данных. Обычно dbt загружает драйверы при первом использовании, когда вы выполняете команду для новой платформы данных. Используйте `dbt system install-drivers` для предварительного заполнения кэша (например, перед переходом в автономный режим или переключением между проектами, использующими разные хранилища данных).

```shell
dbt system install-drivers
```

Эта команда не принимает дополнительных флагов.

Примечание о сетевом доступе

`dbt system install-drivers` загружает файлы с `https://public.cdn.getdbt.com`. Если в вашей среде ограничен исходящий сетевой доступ, убедитесь, что этот адрес добавлен в список разрешённых. Полный список адресов см. в разделе [Требования dbt v2 к сетевому доступу](https://docs.getdbt.tech/docs/local/dbt-networking-requirements.md).

## Связанные команды

* [`dbt debug`](https://docs.getdbt.tech/reference/commands/debug.md) — Проверка проекта dbt и конфигурации подключения.
* [Требования dbt v2 к сетевому доступу](https://docs.getdbt.tech/docs/local/dbt-networking-requirements.md) — Список адресов, исходящий доступ к которым необходим для dbt v2.