38
loading...
a first look at postgraphile with railway
PostGraphile builds a GraphQL API from a PostgreSQL schema that automatically detects tables, columns, indexes, relationships, views, types, functions, and comments. It combines PostgreSQL's role-based grant system and row-level security policies with Graphile Engine's GraphQL look-ahead and plugin expansion technologies.
There are two ways to setup a PostgreSQL database with Railway, through the dashboard or through the CLI.
Click dev.new and choose "Provision PostgreSQL" After the database is setup click "PostgreSQL" on the left and then choose "Connect". Copy and paste the PostgreSQL client command.
First you need to install the Railway CLI.
railway versionrailway version 0.2.40If you do not have a Railway account you will be prompted to create one.
railway loginRun the following command, select “Empty Project,” and give your project a name.
railway initRun the following command and select PostgreSQL to add a plugin to your Railway project.
railway addrailway connect postgresqlpsql (13.3, server 13.2)
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
Type "help" for help.
railway=#Run the following SQL commands to create a test table with seed data.
CREATE TABLE Post (title text, body text);
INSERT INTO Post VALUES ('This is a blog post', 'Wooooooo');
INSERT INTO Post VALUES ('Another blog post', 'Even better than the other!');
\dList of relations
Schema | Name | Type | Owner
-------------+------+-------+----------
public | post | table | postgres
(1 row)\d postTable "public.post"
Column | Type | Collation | Nullable | Default
-------------+------+-----------+----------+---------
title | text | | |
body | text | | |\qecho `railway variables get DATABASE_URL` | pbcopyIt is easy to install PostGraphile with npm, although the PostGraphile documentation does not recommend installing PostGraphile globally if you want to use plugins.
npm install -g postgraphileIf you do not globally install you will need to add
npx the beginning of all postgraphile commands in this tutorial.railway run postgraphile --watch --enhance-graphiql --dynamic-json --port 5001Open
localhost:5001/graphiql and send the following query.
curl \
--request POST \
--url "http://localhost:5001/graphql" \
--header "Content-Type: application/json" \
--data '{"query":"{ query { allPosts { totalCount nodes { body title } } } }"}'{
"data":{
"query":{
"allPosts":{
"totalCount":2,
"nodes":[
{
"body":"Wooooooo",
"title":"This is a blog post"
},
{
"body":"Even better than the other!",
"title":"Another blog post"
}
]
}
}
}
}./ngrok http 5001Session Status online
Account Anthony Campolo (Plan: Free)
Version 2.3.40
Region United States (us)
Web Interface http://127.0.0.1:4040
Forwarding http://363ef1ef5cf3.ngrok.io -> http://localhost:5001
Forwarding https://363ef1ef5cf3.ngrok.io -> http://localhost:5001
Connections ttl opn rt1 rt5 p50 p90
2 0 0.00 0.00 5.11 5.21Send the same query with your API tool of choice.
38