Ограничение

• onDelete: Ограничение Предотвращает удаление, если существуют какие-либо ссылающиеся записи.
• onUpdate: Restrict Предотвращает изменение идентификатора записи, на которую ссылаются.

Пример использования

  schema.prisma 
 
 
 1model Post { 
 
 2 id Int @id @default(autoincrement()) 
 
 3 title String 
 900 02 + автор Пользователь @отношение(поля: [authorId], ссылки: [id], onDelete: Restrict, onUpdate: Restrict) 
 
 5 authorId Int 
 
 6} 
 
 7 
 
 8model Пользователь { 
 
 9 id Int @id @default(autoincrement()) 
 
 10 сообщений Post[] 
 
 11} 
 

Результат использования

Пользователь с сообщениями не может быть удален . Идентификатор пользователя не может быть изменен .

Действие Restrict , а не доступно на Microsoft SQL Server и вызывает ошибку проверки схемы. Вместо этого вы можете использовать NoAction , который дает тот же результат и совместим с SQL Server.

NoAction

Действие NoAction аналогично действию Restrict , разница между ними зависит от используемой базы данных:

• PostgreSQL : NoAction 9 0014 разрешает проверку (если указанная строка в таблица существует) для откладывания на более поздний этап транзакции. Дополнительную информацию см. в документации PostgreSQL.
• MySQL : NoAction ведет себя точно так же, как Restrict . Дополнительную информацию см. в документации по MySQL.
• SQLite : Когда связанный первичный ключ изменяется или удаляется, никаких действий не предпринимается. Дополнительную информацию см. в документации по SQLite.
• SQL Server : при удалении или изменении ссылочной записи возникает ошибка. Дополнительные сведения см. в документации по SQL Server.
• MongoDB (в предварительной версии с версии 3.6.0): при изменении или удалении записи ничего не делается для связанных записей.

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

Пример использования

  schema.prisma 
 
 
 1model Post { 
 
 2 id Int @id @default(autoincrement()) 
 
 3 title String 
 
 + автор Пользователь @ отношение (поля: [authorId], ссылки : [id], onDelete: NoAction, onUpdate: NoAction) 
 
 5 authorId Int 
 
 6} 
 
 7 
 
 8model Пользователь { 
 
 9 id Int @id @default(autoincrement()) 
 
 10 сообщений Post[] 
 
 11} 
 

Результат использования

  schema.prisma 
 
 
 1model Post { 
 
 2 id Int @id @default(autoincrement()) 
 
 3 title String 
 
 + автор Пользователь? @relation(поля: [authorId], ссылки: [id], onDelete: SetNull, onUpdate: SetNull) 
 
 5 authorId Int? 
 
 6} 
 
 7 
 
 8model User { 
 
 9 id Int @id @default(autoincrement()) 
 
 10 сообщений Post[] 
 
 11} 
 

При изменении идентификатора пользователя authorId будет установлен на NULL для всех его авторских сообщений.

SetDefault

• onDelete: SetDefault Скалярному полю ссылающегося объекта будет присвоено значение поля по умолчанию.

• onUpdate: SetDefault Для скалярного поля ссылающегося объекта будет установлено значение поля по умолчанию.

Для этого требуется установить значение по умолчанию для скалярного поля отношения с @по умолчанию . Если ни для одного из скалярных полей не указаны значения по умолчанию, будет выдана ошибка времени выполнения.

  schema.prisma 
 
 
 1model Post { 
 
 2 id Int @id @default(autoincrement()) 
 
 3 title String 
 
 + authorUsername String? @default("anonymous") 
 
 + автор Пользователь? @relation(поля: [authorUsername], ссылки: [имя пользователя], onDelete: SetDefault, onUpdate: SetDefault) 
 
 6} 
 
 7 
 
 8model User { 
 
 9 имя пользователя String @id 
 
 10 сообщений Post[] 
 
 11} 
 

Результат использования

При удалении пользователя его существующих сообщений Значения поля authorUsername будут установлены как «анонимные».

При изменении имени пользователя пользователя значения поля authorUsername его существующих сообщений будут установлены на «анонимные».

Требования к базе данных

MongoDB и SQL Server предъявляют особые требования к ссылочным действиям, если в вашей модели данных есть самоотношения или циклические отношения. У SQL Server также есть особые требования, если у вас есть отношения с несколькими каскадными путями.

Пути обновления с версий 2.25.0 и более ранних

При обновлении можно выбрать несколько путей, которые дадут разные результаты в зависимости от желаемого результата.

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

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

Далее предполагается, что вы выполнили обновление до версии 2.26.0 или более поздней версии и включили флаг функции предварительного просмотра либо выполнили обновление до версии 3.0.0 или более поздней версии: будут отражены в вашей схеме Prisma. Если вы использовали Prisma Migrate или prisma db push для управления схемой базы данных, скорее всего, это значения по умолчанию для версии 2.25.0 и более ранних.

Когда вы запускаете Introspection, Prisma сравнивает все внешние ключи в базе данных со схемой, если операторы SQL ON DELETE и ON UPDATE соответствуют значениям по умолчанию , а не , они будут явно установлены в файл схемы.

После самоанализа вы можете просмотреть нестандартные предложения в своей схеме. Самый важный пункт для рассмотрения - onDelete , что по умолчанию равно Cascade в 2.25.0 и более ранних версиях.

Если вы используете методы delete() или deleteMany() , теперь будут выполняться каскадные удаления , так как функция предварительного просмотра referentialActions удалила систему безопасности в клиенте Prisma, которая ранее предотвращала каскадные удаления в время выполнения . Обязательно проверьте свой код и внесите соответствующие коррективы.

Убедитесь, что вы довольны каждым случаем onDelete: Каскад в вашей схеме. Если нет, то:

• Измените схему Prisma и db push или dev migrate для изменения базы данных

или

• базовая база данных, если вы используете рабочий процесс только для самоанализа

Следующий пример приведет к каскадному удалению: если Пользователь удален, то все его Post также будут удалены.

Пример схемы блога

 
 
 model Post { 
 
 id Int @id @default(autoincrement()) 
 
 title String 
 
 author User @relation(fields: [authorId], references: [id], onDelete : Cascade) 
 
 authorId Int 
 
 } 
 
 model User { 
 
 id Int @id @default(autoincrement()) 
 
 posts Post[] 
 
 } 
 
90 056
 Использование миграции 
 При выполнении миграции ( или  prisma db push  command) к вашей базе данных будут применены новые значения по умолчанию.
  
 В отличие от того, когда вы запускаете Introspect в первый раз, новый пункт и свойство ссылочных действий будут  а не  автоматически добавлены в вашу схему prisma расширением Prisma VSCode.
Вам придется добавить их вручную, если вы хотите использовать что-либо кроме новых значений по умолчанию.
 Явное определение ссылочных действий в вашей схеме Prisma необязательно. Если вы явно не определяете ссылочное действие для отношения, Prisma использует новые значения по умолчанию.
 Обратите внимание, что ссылочные действия могут добавляться в каждом конкретном случае. Это означает, что вы можете добавить их в одно отношение, а для остальных оставить значения по умолчанию, ничего не указывая вручную.
 Проверка на наличие ошибок 
  До обновления  до версии 2.26.0 и включения ссылочных действий  функция предварительного просмотра  Prisma предотвращала удаление записей при использовании  delete()  или  deleteMany()  для сохранения ссылочных целостность. Клиент Prisma выдает пользовательскую ошибку времени выполнения с кодом ошибки 9.0013 P2014  .
  После обновления  и включения ссылочных действий  функции предварительного просмотра  Prisma больше не выполняет проверки во время выполнения. Вместо этого вы можете указать пользовательское ссылочное действие, чтобы сохранить ссылочную целостность между отношениями.
 При использовании  NoAction  или  Restrict  для предотвращения удаления записей сообщения об ошибках после 2.26.0 будут отличаться от сообщений об ошибках до 2.26.0. Это потому, что теперь они запускаются базой данных и  вместо  Клиент Prisma. Ожидаемый новый код ошибки —  P2003 .
 Чтобы убедиться, что вы ловите эти новые ошибки, вы можете соответствующим образом изменить свой код.
 Пример перехвата ошибок 
 В следующем примере используется приведенная ниже схема блога с отношением "один ко многим" между  Post  и  User  и установка  Restrict  ссылочных действий в поле  author .
 Это означает, что если у пользователя есть сообщение, этот пользователь (и его сообщения)  нельзя удалить .
  schema.prisma 
 
 
 1model Post { 
 
 2 id Int @id @default(autoincrement()) 
 
 3 title String 
 
 4 автор Пользователь @relation(поля: [authorId], ссылки : [идентификатор] , onDelete: Restrict) 
 
 5 authorId String 
 
 6} 
 
 7 
 
 8model User { 
 
 9 id Int @id @default(autoincrement()) 
 
 10 сообщений Post[] 9 0003 
 11} 
 
 До обновления и включения функции предварительного просмотра  ссылочных действий  код ошибки, который вы получите при попытке удалить пользователя, у которого есть сообщения, будет  P2014 , а его сообщение:
 «Изменение, которое вы пытаетесь внести нарушит требуемое отношение '{relation_name}' между моделями {model_a_name} и {model_b_name}."
 
 
 импорт { PrismaClient } из '@prisma/client' 
 
 const prisma = new PrismaClient() 
 
 асинхронная функция main() { 
 
 try { 
 
 await prisma. user.delete({ 
 
 где: { 
 
 id: 'some-long-id', 
 
 }, 
 
 }) 
 
 } catch (ошибка) { 
 
 if (экземпляр ошибки Prisma.PrismaClientKnownRequestError) { 
 
 if (error.code === 'P2014') { 
 
 console.log(error.message) 
 
 } 
 
 } 90 003 
 } 
 
 } 
 
 main() 
 
 .catch((e) => { 
 
 throw e 
 
 }) 
 
 .finally(async () => { 
 
 await prisma.$disconnect() 
 
 }) 
 
 найдите  P2003  , который доставит сообщение:
 «Ошибка ограничения внешнего ключа для поля: {field_name}»
 
 
 import { PrismaClient } from '@prisma/client' 
 9000 2 const prisma = новый ПризмаКлиент() 
 
 асинхронная функция main() { 
 
 try { 
 
 await prisma.user.delete({ 
 
 где: { 
 
 id: 'some-long-id' 
 
 } 
 
 }) 
 
 } поймать (ошибка ) { 
 
 if (экземпляр ошибки Prisma.PrismaClientKnownRequestError) { 
 
 if (error. code === 'P2014') { 
 
 if (error.code === 'P2003') { 
 
 console.log(ошибка .message) 
 
 } 
 
 } 
 
 } 
 
 } 
 
 main() 
 
 .catch(e => { 
 
 throw e 
 
 }) 
 
 .finally(async () => { 
 
 await prisma.$disconnect() 
 
 }) 
 
 Поведение без использования referentialAction s 
 В версии 2.25.0 применяется следующее поведение. и ранее, а также с 2.26.0 до 3.0.0  без  флаг предварительного просмотра  referentialActions . То есть, если реализована функция ссылочных действий , а не .
 При вызове  delete()  или  deleteMany()  методов, использующих клиент Prisma для требуемых отношений, выполняется проверка во время выполнения и предотвращается удаление записей, если они ссылаются на связанные объекты.  Это предотвращает каскадное поведение  .
 Текущее поведение без обновления и включения флага функции вообще не позволяет устанавливать ссылочные действия.
 Ссылочные действия по умолчанию 
 Пункт
 Необязательные отношения
 Обязательные отношения
  onDelete 
  SetNull 
  Каскад 
  onUpdate 
  Cascade 
  Cascade 
 Если вам действительно нужно использовать каскадное поведение настроены в базе данных, вы можете  использовать  $raw  SQL-запросы для удаления нескольких записей, на которые ссылаются (например, сообщения в блогах пользователей), и удаление будет успешным. Это связано с тем, что Prisma Client будет , а не  выполнять проверки необработанных запросов во время выполнения.
 Было ли это полезно? 
 Редактировать эту страницу на GitHub
 Рациональный дизайн бактериального транскрипционного каскада для усиления способности экспрессии генов 
 1.
 
  Stragier P. and
 Лосик, Р. (1990) Пересмотр каскадов сигма-факторов. Мол. Микробиолог., 4, 1801–1806. [PubMed] [Google Scholar]
 2. Banuett F. (1998)
 Сигнализация в дрожжах: информационный каскад со ссылками на
 нитчатые грибы. микробиол. Мол. биол. Обр., 62, 249–274. [Бесплатная статья PMC] [PubMed] [Google Scholar]
 3. Fischer H.M. (1994)
 Генетическая регуляция азотфиксации у ризобий. микробиол.
 Обр., 58, 352–386. [Бесплатная статья PMC] [PubMed] [Google Scholar]
 4. Дорман С.Дж. и
 Портер, М.Э. (1998) Вирулентность  Shigella  генный регуляторный каскад: парадигма механизмов контроля бактериальных генов. Мол.
 Микробиология, 29, 677–684. [PubMed] [Google Scholar]
 5. Хараяма С. и
 Тиммис, К.Н. (1989) Катаболизм ароматических углеводородов.
 к  Псевдомонада  . В Хопвуде Д.
 и Чейтер, К. (ред.),  Генетика бактериального разнообразия.  Академический
 Press, Лондон, Великобритания, стр. 151–174.
  
 6. Гальегос М.Т.,
 Шлейф Р. , Байрох А., Хофманн К. и Рамос, Дж.Л. (1997)
 Семейство регуляторов транскрипции AraC/XylS. микробиол.
 Мол. биол. Обр., 61, 393–410. [Бесплатная статья PMC] [PubMed] [Google Scholar]
 7. Мермод Н.,
 Лербах П.Л., Райнеке В. и Тиммис, К.Н. (1984) Транскрипция
 оперона катаболического пути толуата плазмиды TOL  Псевдомонада
 putida  определяется парой координатно и положительно
 регулируемые перекрывающиеся промоторы. EMBO J., 3, 2461–2466. [Бесплатная статья PMC] [PubMed] [Google Scholar]
 8. Ramos J.L.,
 Мермод, Н. и Тиммис, К.Н. (1987) Регуляторные схемы управления
 транскрипция плазмидного оперона TOL, кодирующего путь мета-расщепления
 для разложения алкилбензоатов  Pseudomonas  . Мол. Микробиология, 1, 293–300. [PubMed] [Google Scholar]
 9. Рамос Дж. Л.,
 Маркес, С. и Тиммис, К.Н. (1997) Транскрипция
 контроль катаболической плазмиды 
  Pseudomonas  TOL
 оперонов достигается за счет взаимодействия факторов хозяина и кодируемых плазмидой
 регуляторы. Анну. Rev. Microbiol., 51, 341–373. [PubMed] [Google Scholar]
 10. Диксон Р. (1986)
 Промотор  xylABC  из  Pseudomonas
 Плазмида putida  TOL активируется генами, регулирующими азот
 в  Escherichia coli  . Мол.
 Генерал Генетика, 203, 129–136. [PubMed] [Академия Google]
 11. Маркес С. и
 Рамос, Дж.Л. (1993) Транскрипционный контроль катаболических путей плазмиды  Pseudomonas putida  TOL. Мол. Микробиология, 9, 923–929. [PubMed] [Google Scholar]
 12. Кесслер Б.,
 Эрреро М., Тиммис К.Н. и де Лоренцо, В. (1994) Генетические данные
 что регулятор XylS мета--оперона TOL 
   Pseudomonas  контролирует промотор  Pm  посредством слабого ДНК-белкового взаимодействия. Дж. Бактериол .  , 176, 3171–3176. [Бесплатная статья PMC] [PubMed] [Google Scholar]
 13. Маркес С.,
 Холтель А., Тиммис К. и Рамос, Дж.Л. (1994) Транскрипционная индукция
 кинетика от промоторов катаболических путей плазмиды TOL
 pWW0 из  Pseudomonas putida  для метаболизма ароматических соединений. Дж. Бактериол .  , 176, 2517–2524. [бесплатная статья PMC] [PubMed] [Google Scholar]
 14. Йен К.-М. и
 Сердар, С.М. (1988) Генетика метаболизма нафталина.
 в псевдомонадах. крит. Rev. Microbiol., 15, 247–268. [PubMed] [Академия Google]
 15. Шелл М.А. (1993)
 Молекулярная биология семейства регуляторов транскрипции LysR. Анну.
 Rev. Microbiol., 47, 597–626. [PubMed] [Google Scholar]
 16. Рамос Дж. Л.,
 Штольц А., Райнеке В. и Тиммис, К.Н. (1986) Измененный эффектор
 особенности регуляторов экспрессии генов: плазмида TOL 
 , мутанты xylS  и их использование для расширения ассортимента деградируемых ароматических соединений.
 бактериями. проц. Натл акад. науч. США, 83, 8467–8471. [Бесплатная статья PMC] [PubMed] [Google Scholar]
 17. Чеболла А.,
 Соуза, К. и де Лоренцо, В. (1997) Мутанты эффекторной специфичности
 активатора транскрипции NahR деградации нафталина  Pseudomonas  определяют белковые сайты, участвующие в связывании ароматических индукторов. Дж. Биол. Chem., 272, 3986–3992. [PubMed] [Google Scholar]
 18. Сэмбрук Дж.,
 Фрич, Э.Ф. и Маниатис, Т. (1989)  Молекулярный
 Клонирование: Лабораторное руководство  . Холодная весна
 Harbour Laboratory Press, Колд-Спринг-Харбор, Нью-Йорк.
 19. Миллер Дж. Х. (1972)  Эксперименты по молекулярной генетике.  Лабораторный пресс Колд-Спринг-Харбор, Колд-Спринг-Харбор, Нью-Йорк.
 20. Рамос Дж.Л.,
 Карреро, М. и Тиммис, К.Н. (1988) Выражение широкого спектра хозяев
 векторы, содержащие регуляторные пути манипулированного мета-расщепления
 элементы плазмиды TOL. Письма ФЭБС, 226, 241–246. [PubMed] [Google Scholar]
 21. Майерс Р.М.,
 Лерман, Л.С. и Маниатис, Т. (1985) Общий метод
 для мутагенеза с насыщением клонированных фрагментов ДНК. Наука, 229, 242–247. [PubMed] [Google Scholar]
 22. Кункель Т.А.,
 Робертс, Дж.Д. и Закур, Р.А. (1987) Быстрое и эффективное
 мутагенез без фенотипического отбора. Methods Enzymol., 154, 367–382. [PubMed] [Google Scholar]
 23. Кесслер Б.,
 Тиммис, К.Н. и де Лоренцо, В. (1994) Организация
 промотора  Pm  TOL
 плазмида отражает структуру родственного ей белка-активатора
 КсилС. Мол. Генерал Генетика, 244, 596–605. [PubMed] [Академия Google]
 24 де
 Лоренцо В., Фернандес С.,
 Эрреро М., Якубзик У. и Тиммис, К.Н. (1993) Инженерия
 экспрессии генов, реагирующих на алкил- и галоароматические соединения, с помощью мини-транспозонов
 содержащие регулируемые промоторы путей биодеградации  Pseudomonas  . Джин, 130, 41–46. [PubMed] [Google Scholar]
 25. Шелл М. и
 Сукордхаман, М. (1989) Доказательства того, что активатор транскрипции
 кодируется геном  Pseudomonas putida nahR .
 эволюционно связаны с активаторами транскрипции, кодируемыми
 к  Гены Rhizobium meliloti nodD . Дж. Бактериол . , 171, 1952–1959. [Бесплатная статья PMC] [PubMed] [Google Scholar]
 26. de
 Лоренцо В. и Тиммис, К.Н. (1994)
 Анализ и построение стабильных фенотипов у грамотрицательных
 бактерии с минитранспозонами, производными Tn  5  - и Tn  10  . Methods Enzymol., 235, 386–405. [PubMed] [Google Scholar]
 27. Эрреро М.,
 де Лоренцо, В. и Тиммис, К.Н. (1990) Векторы транспозонов, содержащие
 маркеры селекции нерезистентности к антибиотикам для клонирования и стабильных
 Хромосомная вставка чужеродных генов у грамотрицательных бактерий. Дж.
 Бактериол  .  , 172, 6557–6567. [Бесплатная статья PMC] [PubMed] [Google Scholar]
 28. Cebolla A.,
 Гусман, С. и де Лоренцо, В. (1996) Неразрушающее обнаружение
 активности катаболических промоторов  Pseudomonas  с антигенной поверхностной репортерной системой. заявл. Окружающая среда. микробиол., 62, 214–220. [Бесплатная статья PMC] [PubMed] [Google Scholar]
 29. Huang J.Z. и
 Шелл, Массачусетс (1991) In vivo взаимодействия транскрипционного
 активатора с его целевыми последовательностями. Опосредованные индуктором изменения, приводящие к
 в активации транскрипции. Дж. Биол. Chem., 266, 10830–10838. [PubMed] [Академия Google]
 30. Главачек В.С. и
 Саважо, М.А. (1996) Правила парного выражения
 регуляторные и эффекторные гены в индуцируемых цепях. Дж. Мол.
 биол., 255, 121–139. [PubMed] [Google Scholar]
 31. Иган С.М. и
 Шлейф, Р.Ф. (1993) Регуляторный каскад в индукции  rhaBAD . Дж. Мол. биол., 234, 87–98. [PubMed] [Google Scholar]
 32. ДиРита В.Дж.,
 Парсо, К., Джандер, Г. и Мекаланос, Дж.Дж. (1991) Регуляторный каскад
 контролирует вирулентность  Vibrio cholerae  . проц.
 Натл акад. науч. США, 88, 5403–5407. [Бесплатная статья PMC] [PubMed] [Google Scholar]
 33. Гальегос М.Т.,
 Михан, К. и Рамос, Дж.Л. (1993) КсилС/АраК
 семейство регуляторов. Nucleic Acids Res., 21, 807–810. [Бесплатная статья PMC] [PubMed] [Google Scholar]
 34. Elowitz M.B. и
 Лейблер, С. (2000) Синтетическая колебательная сеть транскрипционных
 регуляторы. Природа, 403, 335–338. [PubMed] [Google Scholar]
 35. Гарднер Т.С.,
 Кантор, К.Р. и Коллинз, Дж.Дж. (2000) Строительство
 генетический тумблер в  Кишечная палочка  .