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

О команде 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 и в ваш плагин. Подробнее см. руководство Build, test, document, and promote adapters.

  • Существующий проект: Если вы являетесь сопровождающим существующего проекта и хотите помочь новым пользователям быстро и легко подключиться к вашей базе данных, вы можете включить свой собственный пользовательский 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.

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

0
Loading