О команде dbt init

dbt init помогает начать работу с dbt Core!

Новый проект

Если вы используете этот инструмент впервые, он:

• попросит вас назвать ваш проект
• спросит, какой адаптер базы данных вы используете (или обратитесь к Поддерживаемые платформы данных)
• запросит каждую часть информации, необходимую dbt для подключения к этой базе данных: такие как account, user, password и т.д.

Затем он:

• Создаст новую папку с именем вашего проекта и образцами файлов, достаточно для начала работы с dbt
• Создаст профиль подключения на вашем локальном компьютере. Местоположение по умолчанию — ~/.dbt/profiles.yml. Подробнее читайте в настройка вашего профиля.

При использовании dbt init для инициализации вашего проекта, включите флаг --profile, чтобы указать существующий profiles.yml в качестве ключа profile:, который будет использоваться вместо создания нового. Например, dbt init --profile profile_name.

Если профиль не существует в profiles.yml или команда выполняется внутри существующего проекта, команда вызовет ошибку.

Существующий проект

Если вы только что клонировали или загрузили существующий проект dbt, dbt init все равно может помочь вам настроить ваш профиль подключения, чтобы вы могли быстро начать работу. Он запросит информацию о подключении, как указано выше, и добавит профиль (используя имя profile из проекта) в ваш локальный profiles.yml, или создаст файл, если он еще не существует.

profile_template.yml

dbt init знает, как запрашивать информацию о подключении, находя файл с именем profile_template.yml. Он будет искать этот файл в двух местах:

• Плагин адаптера: Каков минимальный профиль Postgres? Каков тип каждого поля, каковы его значения по умолчанию? Эта информация хранится в файле под названием dbt/include/postgres/profile_template.yml. Если вы являетесь сопровождающим плагина адаптера, мы настоятельно рекомендуем добавить profile_template.yml в ваш плагин. Обратитесь к руководству Создание, тестирование, документирование и продвижение адаптеров для получения дополнительной информации.

• Существующий проект: Если вы являетесь сопровождающим существующего проекта и хотите помочь новым пользователям быстро и легко подключиться к вашей базе данных, вы можете включить свой собственный пользовательский profile_template.yml в корень вашего проекта, рядом с dbt_project.yml. Для общих атрибутов подключения установите значения в fixed; оставьте пользовательские атрибуты в prompts, но с пользовательскими подсказками и значениями по умолчанию, как вам нравится.

profile_template.yml

fixed:
  account: abc123
  authenticator: externalbrowser
  database: analytics
  role: transformer
  type: snowflake
  warehouse: transforming
prompts:
  target:
    type: string
    hint: your desired target name
  user:
    type: string
    hint: yourname@jaffleshop.com
  schema:
    type: string
    hint: usually dbt_<yourname>
  threads:
    hint: "your favorite number, 1-10"
    type: int
    default: 8

$ dbt init
Running with dbt=1.0.0
Setting up your profile.
user (yourname@jaffleshop.com): summerintern@jaffleshop.com
schema (usually dbt_<yourname>): dbt_summerintern
threads (your favorite number, 1-10) [8]: 6
Profile internal-snowflake written to /Users/intern/.dbt/profiles.yml using project's profile_template.yml and your supplied values. Run 'dbt debug' to validate the connection.