This document discusses PostGraphQL, which allows automatically generating a GraphQL API from a PostgreSQL database schema without writing any code. It describes how PostGraphQL can define the data model in PostgreSQL, handle permissions, generate CRUD operations and mutations, and connect to a PostgreSQL database. It also mentions how PostGraphQL supports features like pagination, sorting, access control, and computed properties through PostgreSQL functions.

1. PostGraphQL
Creating a Relay compatible GraphQL
server without a line of coding

2. PostGraphQL
or why the shift key has become
the most used key on my keyboard

3. auto generated backends

4. GET /articles

5. GET /articles
GET /articles/123

6. GET /articles
GET /articles/123
PUT /articles

7. GET /articles
GET /articles/123
PUT /articles

8. GET /articles
GET /articles/123
PUT /articles
GET /authors/abc

9. GET /articles
GET /articles/123
PUT /articles
GET /authors/abc
PUT /subscriptions/tag

10. GET /articles
GET /articles/123
PUT /articles
GET /authors/abc
PUT /subscriptions/tag
GET /articles?version=mobile

11. GET /articles
GET /articles/123
PUT /articles
GET /authors/abc
PUT /subscriptions/tag
GET /articles?version=mobile

12. client defined queries
per field access control
pagable connections
predictable mutations

13. define data-model
not custom views
define permissions
not protected routes
define cursors
not custom pagination
standardised mutations
not individual CRUD operations

14. auto-generated
backends

15. postgraphql

16. postgreSQL express graphQL
+ =

17. A GraphQL schema created by
reflection over a PostgreSQL schema

18. define your data graph in postgres
define your business logic in postgres
define your access control in postgres

19. schema definition

20. articles categories
1 1
1
n
authors

21. articles categories
articles_authors
1 1
1
1
authors
1 1

22. id title
article1 Reederei Rickmers kündigt…
id article_id author_id
1 article1 author1
2 article1 author2
id name
author1 Daniel
author2 Marc

23. ready for take off

24. PostGraphQL server listening on port 5000 🚀
‣ Connected to Postgres instance postgres://localhost:5432
‣ Introspected Postgres schema(s) public
‣ GraphQL endpoint served at http://localhost:5000/graphql
‣ GraphiQL endpoint served at http://localhost:5000/graphiql
postgraphql --watch
yarn global add postgraphql

26. relay pagination
sorting
conditions
connections

27. mutations
auto generated delete, update and
create mutations for all tables
custom mutations possible
relay compatible

28. demo

29. access control

30. connectDB('root','root','localhost:5432')

31. limited access
client API database
full access

32. CREATE ROLE 'viewer';
GRANT SELECT ON articles TO viewer;

33. CREATE ROLE 'editor';
GRANT ALL ON articles TO editor;
CREATE ROLE 'viewer';
GRANT SELECT ON articles TO viewer;

34. limited access
client API database
scoped access

35. Header
JWT
{
aud: 'postgraphql',
role: 'editor'
}
mutation {
createArticle(…) {
article {
…
}
}
}
Body
GraphQL
query

36. query {
allArticles {
nodes {
…
}
}
}
Body
GraphQL
query
defaultRole = 'viewer'

37. CREATE ROLE 'editor';
GRANT ALL ON articles TO editor;
CREATE ROLE 'viewer';
GRANT SELECT ON articles TO viewer;

38. id title status
1 Reederei Rickmers kündigt… PUBLISHED
2 Trump will Entscheidung… DRAFT
3 Protest gegen Abschiebung… DEPUBLISHED
4 FC Bayern wird Deutscher… SCHEDULED

39. SET row_security = on;
CREATE POLICY published ON articles
FOR SELECT TO viewer
USING status = 'PUBLISHED';

40. computed properties

41. {
article {
id: '123'
shareURL: 'https://br24.de/123'
}
}

42. CREATE FUNCTION
article_share_url(article articles) as $$
SELECT 'https://br24.de/' || article.id;
$$
LANGUAGE SQL STABLE;

43. {
searchArticles(term: "Merkel") {
edges {
node {
title
}
}
}
}

44. demo

45. even more postgres

46. JSON support
event triggers
full text search
geospatial information

47. PostGraphQL
@danielbuechele
=