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

Справочник по командам dbt

Вы можете запускать dbt, используя следующие инструменты:

  • В браузере с помощью Studio IDE
  • В интерфейсе командной строки, используя Cloud CLI или open-source версию dbt Core.

Ключевое различие между упомянутыми инструментами заключается в том, что Cloud CLI и Studio IDE спроектированы для поддержки безопасного параллельного выполнения команд dbt, используя инфраструктуру dbt и её широкий набор возможностей. В отличие от них, dbt Core не поддерживает безопасное параллельное выполнение нескольких вызовов в рамках одного процесса. Подробнее см. в разделе параллельное выполнение.

Ключевое различие между упомянутыми инструментами заключается в том, что dbt Cloud CLI и IDE разработаны для поддержки безопасного параллельного выполнения команд dbt, используя инфраструктуру dbt Cloud и его обширные функции. В отличие от них, dbt-core не поддерживает безопасное параллельное выполнение для нескольких вызовов в одном процессе. Узнайте больше в разделе параллельное выполнение.

dbt позволяет выполнять команды параллельно, повышая эффективность без ущерба для целостности данных. Это дает возможность запускать несколько команд одновременно. Однако важно понимать, какие команды можно выполнять параллельно, а какие — нет.

dbt Cloud позволяет выполнять команды одновременно, повышая эффективность без ущерба для целостности данных. Это позволяет запускать несколько команд одновременно. Однако важно понимать, какие команды можно выполнять параллельно, а какие нет.

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

Чтобы ваши рабочие процессы dbt были как эффективными, так и безопасными, вы можете запускать разные типы команд dbt одновременно (параллельно) — например, dbt build (операция записи) может безопасно выполняться одновременно с dbt parse (операция чтения). Однако вы не можете запускать dbt build и dbt run (обе операции записи) одновременно.

Команды dbt могут быть командами чтения или командами записи:

Тип командыОписание
Пример
ЗаписьЭти команды выполняют действия, которые изменяют данные или метаданные в вашей платформе данных.

Ограничены одним вызовом в любой момент времени, что предотвращает возможные конфликты, такие как перезапись одной и той же таблицы в вашей платформе данных одновременно.
dbt build
dbt run
ЧтениеЭти команды включают операции, которые извлекают или читают данные без внесения изменений в вашу платформу данных.

Могут иметь несколько вызовов параллельно и не ограничены одним вызовом в любой момент времени. Это означает, что команды чтения могут выполняться параллельно с другими командами чтения и одной командой записи.
dbt parse
dbt compile
Loading table...

Доступные команды

Следующие разделы описывают команды, поддерживаемые dbt, и их соответствующие флаги. Они доступны во всех инструментах и всех поддерживаемых версиях, если не указано иное. Вы можете запускать эти команды в вашем конкретном инструменте, добавляя к ним префикс dbt — например, чтобы запустить команду test, введите dbt test.

Для получения информации о выборе моделей в командной строке обратитесь к Синтаксис выбора моделей.

Команды с ('❌') указывают на команды записи, команды с ('✅') указывают на команды чтения, а команды с (N/A) указывают на то, что они не имеют отношения к параллелизации команд dbt.

к сведению

Некоторые команды пока не поддерживаются в dbt Fusion Engine или имеют ограниченную функциональность. Подробности см. на странице Fusion supported features.

CommandDescriptionParallel execution
Caveats
buildСобирает и тестирует все выбранные ресурсы (models, seeds, tests и другие)Все инструменты
Все поддерживаемые версии
cancelОтменяет последний запуск.N/ACloud CLI
Требуется dbt v1.6 или выше
cleanУдаляет артефакты, присутствующие в dbt‑проектеВсе инструменты
Все поддерживаемые версии
cloneКлонирует выбранные модели из указанного состоянияВсе инструменты
Требуется dbt v1.6 или выше
compileКомпилирует (но не выполняет) модели в проектеВсе инструменты
Все поддерживаемые версии
debugВыполняет отладку подключений и проектов dbtВсе инструменты
Все поддерживаемые версии
depsЗагружает зависимости для проектаВсе инструменты
Все поддерживаемые версии
docsГенерирует документацию для проектаВсе инструменты
Все поддерживаемые версии
Пока не поддерживается в Fusion
environmentПозволяет взаимодействовать с вашим окружением dbt.N/ACloud CLI
Требуется dbt v1.5 или выше
helpОтображает справочную информацию для любой командыN/Adbt Core, Cloud CLI
Все поддерживаемые версии
initИнициализирует новый dbt‑проектFusion
dbt Core
Все поддерживаемые версии
invocationПозволяет пользователям отлаживать длительные сессии, взаимодействуя с активными запусками.N/ACloud CLI
Требуется dbt v1.5 или выше
listВыводит список ресурсов, определённых в dbt‑проектеВсе инструменты
Все поддерживаемые версии
parseРазбирает проект и записывает подробную информацию о времени выполненияВсе инструменты
Все поддерживаемые версии
reattachПовторно подключается к последнему запуску для получения логов и артефактов.N/ACloud CLI
Требуется dbt v1.6 или выше
retryПовторно запускает последнюю команду dbt с точки сбояВсе инструменты
Требуется dbt v1.6 или выше
Пока не поддерживается в Fusion
runВыполняет модели в проектеВсе инструменты
Все поддерживаемые версии
run-operationВызывает макрос, включая выполнение произвольного обслуживающего SQL в базе данныхВсе инструменты
Все поддерживаемые версии
seedЗагружает CSV‑файлы в базу данныхВсе инструменты
Все поддерживаемые версии
showПредварительно просматривает строки таблиц после трансформацииВсе инструменты
Все поддерживаемые версии
snapshotВыполняет задания типа "snapshot", определённые в проектеВсе инструменты
Все поддерживаемые версии
sourceПредоставляет инструменты для работы с исходными данными (включая проверку «свежести» источников)Все инструменты
Все поддерживаемые версии
testВыполняет тесты, определённые в проектеВсе инструменты
Все поддерживаемые версии
В Fusion флаги --store-failures, --fail-fast, --warn-error пока не поддерживаются
Loading table...

Примечание: используйте флаг --version, чтобы отобразить установленную версию dbt Core или Cloud CLI. (Не применяется к Studio IDE). Доступно во всех поддерживаемых версиях.

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

0
Loading