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

Руководство по стилю Copilot

Это руководство предоставляет обзор файла Copilot dbt-styleguide.md, описывая его структуру, рекомендуемое использование и лучшие практики для эффективного применения в ваших проектах dbt.

dbt-styleguide.md — это шаблон для создания руководства по стилю для проектов dbt. Он включает в себя:

  • Рекомендации по стилю SQL (например, использование ключевых слов в нижнем регистре и завершающих запятых)
  • Организацию моделей и соглашения об именовании
  • Конфигурации моделей и практики тестирования
  • Рекомендации по использованию pre-commit hooks для принудительного соблюдения правил стиля

Это руководство помогает обеспечить согласованность и понятность в проектах dbt.

dbt-styleguide.md для Copilot

Используя Copilot в Studio IDE, вы можете автоматически сгенерировать шаблон руководства по стилю с именем dbt-styleguide.md. Если руководство по стилю добавляется или редактируется вручную, оно также должно следовать этому соглашению об именовании. Любое другое имя файла не может быть использовано с Copilot.

Добавьте файл dbt-styleguide.md в корень вашего проекта. Copilot будет использовать его как контекст для большой языковой модели (LLM) при генерации data tests, metrics, semantic models и documentation.

Обратите внимание: создавая dbt-styleguide.md для Copilot, вы переопределяете руководство по стилю dbt по умолчанию.

Создание dbt-styleguide.md в Studio IDE

  1. Откройте файл в Studio IDE.
  2. Нажмите Copilot на панели инструментов.
  3. Выберите Generate ... Style guide в меню.
Генерация руководства по стилю в CopilotГенерация руководства по стилю в Copilot
  1. Шаблон руководства по стилю появится в Studio IDE. Нажмите Save.
    Файл dbt-styleguide.md будет добавлен на корневом уровне вашего проекта.

Если вы ранее не генерировали файл руководства по стилю, последняя версия будет автоматически получена из dbt platform.

Если dbt-styleguide.md уже существует

Если файл dbt-styleguide.md уже существует и вы попытаетесь сгенерировать новое руководство по стилю, появится модальное окно со следующими вариантами:

  • Cancel — Выйти без внесения изменений.
  • Restore — Вернуться к последней версии из dbt platform.
  • Edit — Вручную изменить существующее руководство по стилю.
Руководство по стилю уже существуетРуководство по стилю уже существует

Дополнительные материалы

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

0
Loading