Postgres: Tables Basics

Introduction​

Adding tables allows you to define the GraphQL types of your schema including their corresponding fields.

Creating tables​

Let's say we want to create two simple tables for articles and author schema:

author (
  id SERIAL PRIMARY KEY,
  name TEXT
)

articles (
  id SERIAL PRIMARY KEY,
  title TEXT,
  content TEXT,
  rating INT,
  author_id INT
)

• Console

• CLI

• API

Open the Hasura Console and head to the Data tab and click on the button on the left side bar to open up an interface to create tables.

For example, here is the schema for the articles table in this interface:

Tracking tables​

Tables can be present in the underlying Postgres database without being exposed over the GraphQL API. In order to expose a table over the GraphQL API, it needs to be tracked.

• Console

• CLI

• API

When a table is created via the Hasura Console, it gets tracked by default.

You can track any existing tables in your database from the Data -> Schema page:

Generated GraphQL schema types​

As soon as a table is created and tracked, the corresponding GraphQL schema types and query/mutation fields will be automatically generated.

The following object type is generated for the articles table we just created and tracked:

# Object type
type Articles {
  id: Int
  title: String
  content: String
  rating: Int
  author_id: Int
}

Let's analyze the above type:

• Articles is the name of the type

• id, title, content, rating and author_id are fields of the Articles type

• Int and String are types that fields can have

The following query/mutation fields are generated for the articles table we just created and tracked:

# Query field
articles (
  where: articles_bool_exp
  limit: Int
  offset: Int
  order_by: [articles_order_by!]
): [articles!]!

# insert/upsert mutation field
insert_articles (
  objects: [articles_insert_input!]!
  on_conflict: articles_on_conflict
): articles_mutation_response

# update mutation field
update_articles (
  where: articles_bool_exp!
  _inc: articles_inc_input
  _set: articles_set_input
): articles_mutation_response

# delete mutation field
delete_articles (
  where: articles_bool_exp!
): articles_mutation_response

These auto-generated fields will allow you to query and mutate data in our table.

See the query and mutation API references for the full specifications.

GraphQL types documentation​

Hasura automatically picks up any comments that might have been added to your tables and columns and adds them as GraphQL descriptions of the auto-generated types and fields.

Try out basic GraphQL requests​

At this point, you should be able to try out basic GraphQL queries/mutations on the newly created tables from the API tab in the Console. (You may want to add some sample data into the tables first)

• Query all rows in the articles table:

  Query Variables

  Request Headers

• Insert data in the author table:

  Query Variables

  Request Headers

Note

author's id does not need to be passed as an input as it is of type serial (auto incrementing integer).