Как организовать схему Prisma в нескольких файлах: новая возможность в версии 5.15

С выходом версии 5.15 Prisma ORM представила долгожданную функцию, позволяющую разделить схему базы данных на несколько файлов. Эта новая возможность значительно упрощает работу с крупными проектами и улучшает организацию кода. В этой статье мы подробно рассмотрим, как использовать эту функцию, какие преимущества она дает и как правильно структурировать ваши схемы Prisma.

Что такое многофайловая схема Prisma?

Многофайловая схема Prisma - это новая функция, позволяющая разделить вашу схему базы данных на несколько .prisma файлов. До этого обновления вся схема должна была находиться в одном файле schema.prisma, что могло создавать трудности при работе с большими и сложными проектами.

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

Как включить поддержку многофайловых схем

Чтобы начать использовать эту новую функцию, вам нужно выполнить несколько простых шагов:

1. Обновите prisma и @prisma/client до версии 5.15.0 или выше.

2. Обновите расширение Prisma для Visual Studio Code до версии 5.15.0.

3. Включите превью-функцию prismaSchemaFolder, добавив ее в поле previewFeatures внутри generator.

Давайте рассмотрим последний шаг подробнее. В вашем основном файле схемы (обычно это schema.prisma) добавьте следующую настройку:

generator client {
  provider        = "prisma-client-js"
  previewFeatures = ["prismaSchemaFolder"]
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

В этом примере:

• generator client определяет настройки для генерации клиента Prisma.
• provider = "prisma-client-js" указывает, что мы используем JavaScript/TypeScript клиент.
• previewFeatures = ["prismaSchemaFolder"] включает новую функцию многофайловых схем.
• datasource db определяет источник данных (в данном случае PostgreSQL).
• url = env("DATABASE_URL") указывает на переменную окружения с URL базы данных.

Структура многофайловой схемы

После включения функции prismaSchemaFolder, вы можете организовать вашу схему следующим образом:

1. Создайте подкаталог schema в вашем каталоге prisma.

2. Переместите ваш основной файл schema.prisma в этот подкаталог.

3. Создайте дополнительные .prisma файлы в каталоге schema для различных частей вашей схемы.

Например, вы можете создать следующую структуру:

prisma/
  ├── schema/
  │   ├── main.prisma
  │   ├── user.prisma
  │   └── post.prisma

В этой структуре:

- main.prisma содержит основные настройки (generator и datasource).

- user.prisma может содержать модели, связанные с пользователями.

- post.prisma может содержать модели, связанные с постами или статьями.

Пример использования многофайловой схемы

Давайте рассмотрим пример, как может выглядеть разделение схемы на несколько файлов:

В файле user.prisma:

// user.prisma
model User {
  id    Int     @id @default(autoincrement())
  name  String
  posts Post[]
}

В этом примере:

• model User определяет структуру таблицы пользователей.
• id - это уникальный идентификатор пользователя.
• name - имя пользователя.
• posts Post[] - связь с моделью Post, указывающая, что у пользователя может быть несколько постов.

В файле post.prisma:

// post.prisma
model Post {
  id       Int     @id @default(autoincrement())
  title    String
  content  String
  authorId Int
  author   User    @relation(fields: [authorId], references: [id])
}

В этом примере:

• model Post определяет структуру таблицы постов.
• id - уникальный идентификатор поста.
• title и content - заголовок и содержание поста соответственно.
• authorId и author определяют связь с моделью User.

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

Преимущества использования многофайловых схем

Разделение схемы Prisma на несколько файлов предоставляет ряд существенных преимуществ:

1. Улучшенная организация: вы можете группировать связанные модели в отдельные файлы, что упрощает навигацию по проекту.
2. Облегчение командной работы: уменьшается вероятность конфликтов при одновременной работе нескольких разработчиков над разными частями схемы.
3. Повышение читаемости: меньшие по размеру файлы легче читать и понимать, особенно для новых членов команды.
4. Упрощение поддержки: изменения в одной части схемы не затрагивают другие части, что упрощает поддержку и развитие проекта.
5. Лучшая масштабируемость: по мере роста проекта вы можете легко добавлять новые файлы для новых доменов или функциональностей.

Лучшие практики организации многофайловых схем

При использовании многофайловых схем Prisma рекомендуется придерживаться следующих принципов:

1. Организация по доменам: группируйте связанные модели в одном файле. Например, все модели, связанные с пользователями, могут находиться в user.prisma, а модели, связанные с заказами - в order.prisma.
2. Четкие соглашения об именовании: используйте понятные и краткие имена для файлов схемы. Например, user.prisma, post.prisma, product.prisma.
3. Основной файл схемы: сохраните один "главный" файл схемы (например, main.prisma или schema.prisma).

Обновление рабочего процесса с Prisma CLI

С введением многофайловых схем, некоторые команды Prisma CLI были обновлены для поддержки этой функциональности:

• prisma generate: эта команда теперь объединяет все файлы схемы перед генерацией клиента.
• prisma validate: проверяет правильность всех файлов схемы.
• prisma format: форматирует все файлы схемы в каталоге schema.

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

Заключение

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