dbt_scooters

Описание проекта

Проект на базе dbt, предназначенный для управления и трансформации данных, связанных с использованием скутеров кикшеринга. Позволяет выстроить аналитику данных о передвижениях и использовании скутеров.

Каталог данных

Каталог dbt, который автоматически обновляется из ветки main:

https://inzhenerka.github.io/dbt-scooters

Быстрый старт

1. Убедитесь, что у вас установлен пакетный менеджер uv:

uv --version

2. Установите зависимости проекта (dbt и адаптер postgres):

uv sync

3. Клонируйте репозиторий, а затем перейдите в директорию проекта:

cd dbt_scooters

4. Активируйте PostGIS в базе PostgreSQL, если еще этого не делали:

create extension postgis schema public;

Конфигурация

Обновите конфигурационный файл ~/.dbt/profiles.yml с вашими данными доступа к базе данных.

Основные команды dbt

• dbt debug - проверка подключения к хранилищу данных (проверка профиля)
• dbt parse - парсинг файлов проекта (проверка корректности)
• dbt compile - компилирует dbt-модели и создает SQL-файлы
• dbt run - материализация моделей в таблицы и представления
• dbt test - запускает тесты для проверки качества данных
• dbt seed - загружает данные в таблицы из CSV-файлов
• dbt build - основная команда, комбинирует run, test и seed
• dbt source freshness - проверка актуальности данных в источниках
• dbt docs generate - генерирует документацию проекта
• dbt docs serve - запускает локальный сервер для просмотра документации

Примечание: если виртуальное окружение не активно, используйте uv run dbt <command>.

Полезные макросы

• dbt run-operation create_role --args "name: finance" - создание роли в базе (на примере роли "finance")