One of the major requirements for any online business is to have a backend that either provides or can be extended to provide an API response. Building  websites with static HTML and simple jquery ajax is coming to an end. In this era, Javascript frameworks rules the market. Hence, it is a good decision for the database to support JSON, as JSON is becoming the glue that connects the frontend and backend.

Rails have an inbuilt support for generating JSON, as it’s our swiss army knife of web development, and encourages the REST URL structure . And its a good choice for building API. It is good enough to a particular point of growth. Very soon you will reach bottlenecks, where you have more requests than you can handle and you have to either spawn up more servers or use some concurrent languages like elixir, go, etc. Before we go to that scale and burn down the existing codebase, we can use database to generate JSON responses for us, which is 10 times faster in generating JSON than Rails (though more verbose).

Since PostgreSQL 9.2, the database has taken a major leap in supporting JSON. The support that PostgreSQL provides can be divided into two

  • Storing data in JSON and JSONB format
  • Generating JSON results from the query itself

In this article, we will talk about generating JSON(an introduction) from the query itself.

Getting Started

One of the advantages of using a database to generate JSON is that I have found it fast while generating smaller JSON but much more faster in generating complex JSON. (Note: The speed is in comparison with rails not with respect to the database itself)

How to generate JSON

Simplest way to do that is row_to_json()
For example: Query to return user with id 1 as JSON


if you want to send only some specific fields


Now let’s see how to generate more complex JSON with sub JSON, and arrays.

This would return the JSON response

The issue with the above code is that it is more verbose (has more text)  when compared to a ruby code. We need to make sure that while we do a bit of sacrifice there, is worthwhile. So while working with API’s  use it only where you see a delay in JSON generation.

Similarly ,to the ‘array_agg’ method that we used above to aggregate values to an array then to JSON, we aggregate them as JSON using json_agg.

can be shortened to


Since the above method of array generation can be tedious, in PostgreSQL 9.4, they have introduced a new method called json_build_object. Simple usage of the function can be as below

which will output

Also, we can use it to build complex JSON tree by creating functions within the PostgreSQL database. Of course, as we do that, we are moving more and more logic of the code into the DB and we would need to run migrations every time when we want to update a function. So as I said before, we are sacrificing our convenience here .So we should only use this, as the complexity of our JSON generation increases.

I will be covering how to write PostgreSQL functions to help generate more complex JSON structure easier in the second part of this particle.