Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
91 commits
Select commit Hold shift + click to select a range
a30e0f0
continue docs
nikolasburk Mar 25, 2020
d0788d1
Remove numbers from urls
nilubava Mar 25, 2020
32559fb
Merge branch 'master' of github.com:prisma/prisma2-docs into content/…
nikolasburk Mar 25, 2020
94387aa
continue docs
nikolasburk Mar 25, 2020
556776c
Merge branch 'master' of github.com:prisma/prisma2-docs
nilubava Mar 25, 2020
eaf63db
continue docs
nikolasburk Mar 25, 2020
8aef877
Merge branch 'master' of github.com:prisma/prisma2-docs into content/…
nikolasburk Mar 25, 2020
92641e5
continue docs
nikolasburk Mar 25, 2020
9e310bd
Merge branch 'master' of github.com:prisma/prisma2-docs into content/…
nikolasburk Mar 25, 2020
2ba3253
continue docs
nikolasburk Mar 25, 2020
ab2b826
continue docs
nikolasburk Mar 25, 2020
843741d
continue docs
nikolasburk Mar 25, 2020
a49a310
Tech switcher
nilubava Mar 26, 2020
c9a8c8d
Select route
nilubava Mar 26, 2020
913817c
ajdust sidenav
nikolasburk Mar 27, 2020
0549b26
ajdust sidenav
nikolasburk Mar 27, 2020
68e2ed8
improve introduction
nikolasburk Mar 27, 2020
abd1ffe
Merge branch 'master' into content/init
nikolasburk Mar 27, 2020
84a1250
resolve merge conflict
nikolasburk Mar 27, 2020
046aeaa
Merge branch 'content/init' of github.com:prisma/prisma2-docs into co…
nikolasburk Mar 27, 2020
190614f
add landing page and adjust sidenav
nikolasburk Mar 27, 2020
ec94755
continue docs
nikolasburk Mar 27, 2020
6b039f0
continue docs
nikolasburk Mar 27, 2020
3e52a6b
landing page content
nikolasburk Mar 27, 2020
3b97ca3
continue docs
nikolasburk Mar 27, 2020
e4c5eb1
Merge branch 'master' of github.com:prisma/prisma2-docs into content/…
nikolasburk Mar 27, 2020
86ab3f3
Merge branch 'tech-switcher' of github.com:prisma/prisma2-docs into c…
nikolasburk Mar 27, 2020
4381320
continue docs
nikolasburk Mar 27, 2020
97cd0cb
default lang, db
nilubava Mar 27, 2020
e7dabc8
Merge branch 'tech-switcher' of github.com:prisma/prisma2-docs into c…
nikolasburk Mar 27, 2020
50432a8
Merged master
nilubava Mar 27, 2020
ff7134b
Bug fix for table
nilubava Mar 27, 2020
41ebbd3
add more tech combos for getting started
nikolasburk Mar 27, 2020
a23e07a
Added '*' to tech switcher + changed mongodb to sqlite
nilubava Mar 27, 2020
c58c9a5
Merged master
nilubava Mar 27, 2020
c704ea5
start new relation syntax
nikolasburk Mar 27, 2020
de76d03
new tech switcher
nikolasburk Mar 27, 2020
6cc181c
relations update
nikolasburk Mar 27, 2020
d046350
relations update
nikolasburk Mar 27, 2020
2d4e973
relations update
nikolasburk Mar 27, 2020
2b73996
relations update
nikolasburk Mar 27, 2020
6b6fc97
relations update
nikolasburk Mar 28, 2020
d13ffa4
resolve merge conflict
nikolasburk Mar 28, 2020
c4e9876
update quickstart with new relation syntax
nikolasburk Mar 28, 2020
27072f7
update setup guides with new relation syntax and more tech combos
nikolasburk Mar 28, 2020
2b8b56b
fix build
nikolasburk Mar 28, 2020
c357c83
fix build
nikolasburk Mar 28, 2020
fd43e21
adjhust to new relation syntax
nikolasburk Mar 28, 2020
4e9ff8f
adjhust to new relation syntax
nikolasburk Mar 28, 2020
97dd603
relation docs
nikolasburk Mar 28, 2020
ce24bf8
relation docs
nikolasburk Mar 28, 2020
8dd9e78
relation docs
nikolasburk Mar 28, 2020
9c49070
relation docs
nikolasburk Mar 28, 2020
303cca3
relation docs
nikolasburk Mar 28, 2020
f821b03
continue docs
nikolasburk Mar 28, 2020
52d1641
continue docs content
nikolasburk Mar 29, 2020
854d159
update links in GSE
nikolasburk Mar 29, 2020
edd560c
update links in Introduction
nikolasburk Mar 29, 2020
545eb3f
update links in Understand Prisma
nikolasburk Mar 29, 2020
956c844
update links in schema reference
nikolasburk Mar 29, 2020
f7b4565
update links in prisma client reference
nikolasburk Mar 29, 2020
3419891
update links in prisma client reference
nikolasburk Mar 29, 2020
0dfa33f
reslove merge conflicts
nikolasburk Mar 29, 2020
410b2a3
reslove merge conflicts
nikolasburk Mar 29, 2020
da4e519
reslove merge conflicts
nikolasburk Mar 29, 2020
c7a05f0
update links on more reference pages
nikolasburk Mar 29, 2020
d4b23df
update links on more reference pages
nikolasburk Mar 29, 2020
4a31f35
continue docs content
nikolasburk Mar 29, 2020
6b0e448
wrap up fixing links
nikolasburk Mar 29, 2020
59297da
wrap up fixing links
nikolasburk Mar 29, 2020
2f340bc
fix build
nikolasburk Mar 30, 2020
af525ce
Merge branch 'master' into content/init
nikolasburk Mar 30, 2020
7460033
fix build
nikolasburk Mar 30, 2020
fe7933f
Merge branch 'content/init' of github.com:prisma/prisma2-docs into co…
nikolasburk Mar 30, 2020
6f9cfdc
Merge branch 'master' of github.com:prisma/prisma2-docs into content/…
nikolasburk Mar 30, 2020
e1a3eec
attempt to fix build
nikolasburk Mar 30, 2020
109f12a
attempt to fix build
nikolasburk Mar 30, 2020
768d026
attempt to fix build
nikolasburk Mar 30, 2020
7adc701
attempt to fix build
nikolasburk Mar 30, 2020
7e4a63c
attempt to fix build
nikolasburk Mar 30, 2020
0f05de4
attempt to fix build
nikolasburk Mar 30, 2020
7dfb1d3
Merge branch 'master' into content/init
nikolasburk Mar 30, 2020
080b302
fix content on landing page
nikolasburk Mar 30, 2020
4f6c4d7
Merge branch 'content/init' of github.com:prisma/prisma2-docs into co…
nikolasburk Mar 30, 2020
7970762
add meta data
nikolasburk Mar 30, 2020
5c8ea9f
add meta data
nikolasburk Mar 30, 2020
e35217f
add meta data
nikolasburk Mar 30, 2020
1d6c173
add meta data
nikolasburk Mar 30, 2020
0b53474
Merge branch 'master' of github.com:prisma/prisma2-docs into content/…
nikolasburk Mar 30, 2020
230e672
add meta data
nikolasburk Mar 30, 2020
44bc580
add meta data
nikolasburk Mar 30, 2020
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions content/01-getting-started/01-quickstart.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Quickstart'
metaTitle: ''
metaDescription: ''
metaTitle: 'Quickstart (5 min)'
metaDescription: 'Get started with Prisma in 5 minutes. You will learn how to send queries to a SQL database in a plain Node.js or TypeScript script using Prisma Client.'
duration: '5 min'
langSwitcher: true
---
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Add to an existing project'
metaTitle: ''
metaDescription: ''
metaTitle: 'Add Prisma to an existing project (15 min)'
metaDescription: 'Learn how to add Prisma to an existing Node.js or TypeScript project by connecting it to your database and generating Prisma Client for database access.'
dbSwitcher: true
langSwitcher: true
---
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Start from scratch'
metaTitle: ''
metaDescription: ''
metaTitle: 'Setup a new projecct with Prisma from scratch (15 min)'
metaDescription: 'Learn how to create a new Node.js or TypeScript project from scratch by connecting Prisma to your database and generating Prisma Client for database access.'
dbSwitcher: true
langSwitcher: true
---
Expand Down Expand Up @@ -327,7 +327,7 @@ CREATE TABLE Profile (
You can create the tables using any MySQL client of your choice. If you're using `mysql`, you can now create the tables using the following command:

```
mysql < schema.sql
mysql <\ schema.sql
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this correct?

```

Great, you now created three tables in your database
Expand Down
4 changes: 2 additions & 2 deletions content/02-understand-prisma/01-introduction.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Introduction'
metaTitle: ''
metaDescription: ''
metaTitle: 'Introduction to Prisma'
metaDescription: 'This page gives a high-level overview of what Prisma is and how it works. It's a great starting point for Prisma newcomers!'
---

## Overview
Expand Down
4 changes: 2 additions & 2 deletions content/02-understand-prisma/02-why-prisma.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Why Prisma?'
metaTitle: ''
metaDescription: ''
metaTitle: 'Why Prisma? (Comparison with SQL query builders & ORMs)'
metaDescription: 'Learn about the motivation for Prisma and how it compares to other Node.js and TypeScript database tools like ORMs and SQL query builders.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'REST'
metaTitle: ''
metaDescription: ''
metaTitle: 'Building REST APIs with Prisma'
metaDescription: 'This page gives an overview of the most important things when building REST APIs with Prisma. It shows practical examples and the supported libraries.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'GraphQL'
metaTitle: ''
metaDescription: ''
metaTitle: 'Building GraphQL servers with Prisma'
metaDescription: 'This page gives explains how to build GraphQL servers with Prisma. It shows how Prisma fits into the GraphQL ecosystem and provides practical examples.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Is Prisma an ORM?'
metaTitle: ''
metaDescription: ''
metaTitle: 'Is Prisma an ORM?'
metaDescription: "Learn why Prisma is not an ORM. It shares similar goals with ORMs and wants to make working with databases easy, but it does not map classes to tables as ORMs do."
---

## Overview
Expand Down
4 changes: 2 additions & 2 deletions content/02-understand-prisma/04-data-modeling.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Data modeling'
metaTitle: ''
metaDescription: ''
metaTitle: 'Data modeling with Prisma'
metaDescription: 'Learn how data modeling with Prisma differs from data modeling with SQL or ORMs. Prisma uses a declarative data modeling language to describe a database schema.'
---

## What is data modeling?
Expand Down
4 changes: 2 additions & 2 deletions content/02-understand-prisma/05-under-the-hood.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Under the hood'
metaTitle: ''
metaDescription: ''
metaTitle: 'Prisma under the hood'
metaDescription: 'Learn about Prisma internals and how it works "under the hood". Prisma tools are based on an engine-layer which manages the communication with the database.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Prisma schema file'
metaTitle: ''
metaDescription: ''
metaTitle: 'Prisma schema file (Reference)'
metaDescription: 'The Prisma schema is the main configuration file when using Prisma. It is typically called schema.prisma and contains your database connection and data model.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Data sources'
metaTitle: ''
metaDescription: ''
metaTitle: 'Data sources (Reference)'
metaDescription: 'Data sources enable Prisma to connect to your database. This page explains how to configure data sources in your Prisma schema.'
---

## Overview
Expand Down Expand Up @@ -37,7 +37,7 @@ datasource postgresql {
}
```

Learn more about PostgreSQL connection strings [here]().
Learn more about PostgreSQL connection strings [here](../../database-connectors/postgresql).

**Specify a MySQL data source**

Expand All @@ -56,7 +56,7 @@ datasource mysql {
}
```

Learn more about PostgreSQL connection strings [here]().
Learn more about PostgreSQL connection strings [here](../../database-connectors/mysql).

**Specify a SQLite data source**

Expand All @@ -69,7 +69,7 @@ datasource sqlite {
}
```

Learn more about SQLite connection strings [here]().
Learn more about SQLite connection strings [here](../../database-connectors/sqlite).

**Specify a PostgreSQL data source via an environment variable**

Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: 'Generators'
metaTitle: ''
metaDescription: ''
metaTitle: 'Generators (Reference)'
metaDescription: 'Generators in your Prisma schema specify what assets are generated when the `prisma generate` command is invoked. This page explains how to configure generators.'
---

## Overview

A generator can be specified via the `generator` block in the Prisma schema.
A generator can be specified via the `generator` block in the Prisma schema. Generators in your Prisma schema specify what assets are generated when the `prisma generate` command is invoked.

## Fields

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Data model'
metaTitle: ''
metaDescription: ''
metaTitle: 'Data model (Reference)'
metaDescription: 'Learn about the concepts for building your data model with Prisma: Models, scalar types, enums, attributes, functions, IDs, default values and more.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Models'
metaTitle: ''
metaDescription: ''
metaTitle: 'Models (Reference)'
metaDescription: 'Learn about defining your application models with Prisma. Models represent tables in the database and serve as foundation for generated Prisma Client queries.'
---

## Overview
Expand Down Expand Up @@ -192,7 +192,7 @@ const allUsers = await prisma.user.findMany();

Prisma Client not only provides a query API for models, it also generates type definitions that reflect your model structures. These are part of the generated [`@prisma/client`](../prisma-client/generating-prisma-client#the-prisma-client-npm-module) node module in a file called `index.d.ts`.

When using TypeScript, these type definitions ensure that all your database queries are entirely type safe and validated at compile-time (even partial queries using [`select`](..//prisma-client/field-selection#select) or [`include`](..//prisma-client/field-selection#include)).
When using TypeScript, these type definitions ensure that all your database queries are entirely type safe and validated at compile-time (even partial queries using [`select`](../prisma-client/field-selection#select) or [`include`](../prisma-client/field-selection#include)).

Even when using plain JavaScript, the type definitions are still included in the generated `@prisma/client` node module, enabling features like [IntelliSense](https://code.visualstudio.com/docs/editor/intellisense)/autocompletion in your editor.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Relations'
metaTitle: ''
metaDescription: ''
metaTitle: 'Relations (Reference)'
metaDescription: 'A relation is a connection between two models in the Prisma schema. This page explains how you can define 1-1, 1-n and m-n relations in Prisma.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'API reference'
metaTitle: ''
metaDescription: ''
metaTitle: 'API Reference'
metaDescription: "This page gives an overview of the Prisma Client API and links to more detailled explanations. It's a great starting point for exploring Prisma Client."
---

## Overview
Expand All @@ -17,7 +17,7 @@ The setup instruction below provide a high-level overview of the steps needed to

### 1. Prerequisites

In order to set up Prisma Client, you need a [Prisma schema file](..//prisma-schema/prisma-schema-file) with your database connection, the Prisma Client generator and at least one model:
In order to set up Prisma Client, you need a [Prisma schema file](../prisma-schema/prisma-schema-file) with your database connection, the Prisma Client generator and at least one model:

```prisma
datasource postgresql {
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Generating Prisma Client'
metaTitle: ''
metaDescription: ''
metaTitle: 'Generating Prisma Client (Reference)'
metaDescription: 'This page explains how to generate Prisma Client. It also provides additional context on the generated npm module, typical workflows and Node.js configuration.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Configuring the Prisma Client API'
metaTitle: ''
metaDescription: ''
metaTitle: 'Configuring the Prisma Client API (Reference)'
metaDescription: 'Learn how you can decouple the naming of Prisma models from database tables to improve the ergonomics of the generated Prisma Client API.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'CRUD'
metaTitle: ''
metaDescription: ''
metaTitle: 'CRUD (Reference)'
metaDescription: 'This page provides a detailled reference of the auto-generated CRUD queries that are exposed in the Prisma Client API, such as findOne, findMany, create, ...'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Relation queries'
metaTitle: ''
metaDescription: ''
metaTitle: 'Relation queries (Reference)'
metaDescription: 'Prisma Client provides convenient queries for working with relations, such as a fluent API, nested writes (transactions), nested reads and relation filters.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Field selection'
metaTitle: ''
metaDescription: ''
metaTitle: 'Field selection (Reference)'
metaDescription: "This page explains how to select only a subset of a model's fields and/or include relations ("eager loading") in a Prisma Client query."
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Raw database access'
metaTitle: ''
metaDescription: ''
metaTitle: 'Raw database access (Reference'
metaDescription: 'Learn how you can send raw SQL queries to your database using the raw() method from the Prisma Client API.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Connection management'
metaTitle: ''
metaDescription: ''
metaTitle: 'Connection management (Reference)'
metaDescription: 'This page explains how database connections are handled with Prisma Client and how to manually connect and disconnect your database.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Advanced usage of generated types'
metaTitle: ''
metaDescription: ''
metaTitle: 'Advanced usage of generated types (Reference)'
metaDescription: 'Prisma Client provides full type safety for queries, even for partial queries or included relations. This page explains how to leverage the generated types.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Logging'
metaTitle: ''
metaDescription: ''
metaTitle: 'Logging (Reference)'
metaDescription: 'Learn how to configure Prismaa Client to log the raw SQL queries it sends to the database and other information.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Debugging'
metaTitle: ''
metaDescription: ''
metaTitle: 'Debugging (Reference)'
metaDescription: 'This page explains how to enable debugging output for Prisma Client by setting the `DEBUG` environment variable.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Error formatting'
metaTitle: ''
metaDescription: ''
metaTitle: 'Error formatting (Reference)'
metaDescription: 'This page expains how to configure the formatting of errors when using Prisma Client.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Transactions'
metaTitle: ''
metaDescription: ''
metaTitle: 'Transactions (Reference)'
metaDescription: 'This page explains the current transactions API of Prisma Client.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Deployment'
metaTitle: ''
metaDescription: ''
metaTitle: 'Deployment (Reference)'
metaDescription: 'Learn the basics about deploying Node.js and TypeScript applications that are using Prisma Client.'
---

Coming 🔜
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Query engine'
metaTitle: ''
metaDescription: ''
metaTitle: 'Query engine (Reference)'
metaDescription: "Prisma's query engine manages the comunication with the database when using Prisma Client. Learn how it works on this page."
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Module bundlers'
metaTitle: ''
metaDescription: ''
metaTitle: 'Module bundlers (Reference)'
metaDescription: 'This page gives an overview of the most important things to be aware of when using a module bundler to bundle an application that uses Prisma Client.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Database polyfills'
metaTitle: ''
metaDescription: ''
metaTitle: 'Database polyfills (Reference)'
metaDescription: 'Prisma Client provides features that are not achievable with relational databases. These features are referred to as "polyfills" and explained on this page.'
---

## Overview
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: 'Prisma Migrate'
metaTitle: ''
metaDescription: ''
metaTitle: 'Prisma Migrate (Reference)'
metaDescription: 'Prisma Migrate is a declarative data modeling and schema migration tool that is available via the Prisma CLI.'
experimental: true
---

Expand Down
Loading