Neon Deploy: Learn how Neon helps developers ship faster with Postgres. Grab your ticket
Neon
    14.9kLog InSign Up

    Query your Postgres Database Using Azure Functions

    Learn how to query your Postgres database using Azure Functions

    In this guide, we will explore how to query a Postgres database hosted on Neon using Azure Functions. This combination allows you to take advantage of a flexible, high-performance infrastructure without worrying about server management.

    Prerequisites

    You will need:

    • An Azure account with a subscription to deploy Azure Functions.
    • A Neon account. If you don’t have one yet, you can sign up.
    • Basic knowledge of Node.js and SQL.
    • Familiarity with using Visual Studio Code.

    Why Neon?

    Neon stands out as a cloud-native Postgres solution with an innovative architecture that separates compute and storage, offering a truly serverless database. This means Neon automatically adjusts its resources based on your application’s needs, making it ideal for projects that require flexible scalability without directly managing the infrastructure. In other words, Neon allows you to accelerate project delivery by focusing solely on development, while having an infrastructure that scales on demand.

    You might be wondering, where does Azure Functions fit in? As I mentioned, we will use Azure Functions to query a Postgres database hosted on Neon.

    At the same time, Azure Functions enables you to run code in response to events without worrying about the underlying infrastructure. It will create microservices that respond to events, such as HTTP requests, without the need to deploy or manage servers.

    To illustrate this, we will discuss an example of client management (hotel reservation management), which is a common use case in application development. We will use the technologies mentioned above to query and process data.

    Context

    Imagine you are developing a solution to manage hotel reservations. You want to allow users (via an app or website) to view available reservations and interact with a Postgres database hosted on Neon.

    The application's features will include:

    • View available rooms: The application will allow users to check available hotel rooms for booking.
    • Add a new reservation: When a customer makes a reservation, their information will be stored in the Neon.
    • Cancel a reservation: Customers can cancel a reservation by deleting the corresponding record from the database.

    Step 1: Create and Configure the Database on Neon

    Sign up and create the database

    Sign up on Neon and follow the steps to create a Postgres database. The database will be named hotel_management.

    After creating the database, make sure to copy the connection details (such as host, user, password, database) somewhere safe, as they will be used to configure Azure Functions to connect to Neon.

    1. Creating the tables

      Once the database is created, you should see an option named "SQL Editor" on the left to write and execute queries.

      In the query editor, copy and paste the SQL code below to create the clients and hotels tables. These are reference tables, as the reservations table will refer to these tables via foreign keys:

      CREATE TABLE clients (
    client_id SERIAL PRIMARY KEY,
    first_name VARCHAR(100),
    last_name VARCHAR(100),
    email VARCHAR(100),
    phone_number VARCHAR(20)
);

CREATE TABLE hotels (
    hotel_id SERIAL PRIMARY KEY,
    name VARCHAR(100),
    location VARCHAR(100)
);

      Here is the SQL script to create the reservations table:

      CREATE TABLE reservations (
    reservation_id SERIAL PRIMARY KEY,
    room_number INT,
    client_name VARCHAR(100),
    email VARCHAR(100),
    check_in_date DATE,
    check_out_date DATE
);

    2. Inserting test data

      You can insert some example data into the database to ensure that everything is working fine up to this point.

      Here is the SQL script to insert data into the clients table:

      INSERT INTO clients (first_name, last_name, email, phone_number) VALUES
('Alice', 'Dupont', 'alice.dupont@example.com', '0123456789'),
('Bob', 'Martin', 'bob.martin@example.com', '0987654321'),
('Charlie', 'Rousseau', 'charlie.rousseau@example.com', '0147253689');

      Here is the SQL script to insert data into the hotels table:

      INSERT INTO hotels (name, location) VALUES
('Hotel Le Paris', 'Paris'),
('Hotel des Alpes', 'Annecy'),
('Hotel de la Plage', 'Nice');

      Here is the SQL script to insert data into the reservations table:

      INSERT INTO reservations (client_id, hotel_id, check_in_date, check_out_date, number_of_guests) VALUES
(1, 1, '2024-11-01', '2024-11-05', 2),
(2, 2, '2024-11-10', '2024-11-15', 1),
(3, 3, '2024-12-01', '2024-12-10', 4);

    Step 2: Create an Azure Function to Manage Products

    1. Sign in to Azure

      If you don't already have an account, sign up on the Microsoft Azure portal.

      We will initialize an Azure Functions project where we will create an HTTP Trigger function in Visual Studio Code (VS Code) using the Azure Functions extension.

    2. Install the Azure Functions extension:

      • Open VS Code, or install Visual Studio Code if it's not yet installed.
      • Go to the extensions tab or press Ctrl+Shift+X.
      • Search for "Azure Functions" and install the official extension.

    3. Create an Azure Functions Project

      Open the command palette or press Ctrl+Shift+P to open the command palette.

      • Type Azure Functions: Create New Project... and select that option.
      • Choose a directory where you want to create the project.
      • Select the programming language (JavaScript in our case).
      • Choose a JavaScript programming model (Model V4).
      • Choose a function template, and select HTTP trigger.
      • Give your function a name, for example, manageClients.

      Once confirmed, the project will be created with some default code.

    4. Install the Postgres client

      In the terminal of your Azure Functions project, install the pg package, which will be used to connect to Postgres:

      npm install pg

    5. Azure Functions Core Tools

      Install Azure Functions Core Tools to run functions locally.

      npm install -g azure-functions-core-tools@4 --unsafe-perm true

      suggested folder structure

      Since there are three tables in the database (Clients, Hotels, and Reservations), using a separate file for each feature or interaction with the database is a good practice to maintain clear and organized code.

      src/
  ├── index.js
  ├── functions/
  │   ├── manageClients.js
  │   ├── manageHotels.js
  │   └── manageReservations.js
  └── database/
      ├── client.js
      ├── hotel.js
      └── reservation.js

    6. Configure Environment Variables

      On the Neon dashboard, go to Connection string, select Node.js, and click .env. Then, click show password and copy the database connection string. If you don't click show password, you'll copy a connection string without the password (which is masked).

      Create a .env file at the root of the project to store your database connection information from the Neon.

      Here's an example of the connection string you'll copy:

      DATABASE_URL='postgresql://hotel_management_owner:************@ep-quiet-leaf-a85k5wbg.eastus2.azure.neon.tech/hotel_management?sslmode=require'

      For clarity, you can break this connection string down like this:

      DB_USER=hotel_management_owner
DB_HOST=ep-quiet-leaf-a85k5wbg.eastus2.azure.neon.tech
DB_NAME=hotel_management
DB_PASSWORD=your_db_password
DB_PORT=5432

    7. Modify the local.settings.json file

      The local.settings.json file is used by Azure Functions for local executions. Azure Functions does not directly read the .env file. Instead, it relies on local.settings.json to inject environment variable values during local execution. In production, you will define the same settings through App Settings in the Azure portal.

      {
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "",
    "FUNCTIONS_WORKER_RUNTIME": "node",
    "DB_USER": "hotel_management_owner",
    "DB_HOST": "ep-quiet-leaf-a85k5wbg.eastus2.azure.neon.tech",
    "DB_NAME": "hotel_management",
    "DB_PASSWORD": "your_db_password",
    "DB_PORT": "5432"
  }
}

      Install the dotenv package by opening the terminal in your Azure Functions project. This package will allow you to load environment variables from the .env file:

      npm install dotenv

    8. Manage Each Table

      a. Create a separate file for each table in the database/ folder.

      Example code for client.js

      // src/database/client.js
const { Client } = require("pg");
require("dotenv").config();

const client = new Client({
  user: process.env.DB_USER,
  host: process.env.DB_HOST,
  database: process.env.DB_NAME,
  password: process.env.DB_PASSWORD,
  port: process.env.DB_PORT || 5432,
});

const connectDB = async () => {
  if (!client._connected) {
    await client.connect();
  }
};

const getAllClients = async () => {
  await connectDB();
  const result = await client.query("SELECT * FROM clients");
  return result.rows;
};

module.exports = {
  getAllClients,
  client, // Optional if you need to close the connection elsewhere
};

      Example code for hotel.js

      // src/database/hotel.js
const { Client } = require("pg");
require("dotenv").config();

const client = new Client({
  user: process.env.DB_USER,
  host: process.env.DB_HOST,
  database: process.env.DB_NAME,
  password: process.env.DB_PASSWORD,
  port: process.env.DB_PORT || 5432,
});

const connectDB = async () => {
  if (!client._connected) {
    await client.connect();
  }
};

const getAllHotels = async () => {
  await connectDB();
  const result = await client.query("SELECT * FROM hotels");
  return result.rows;
};

module.exports = {
  getAllHotels,
  client,
};

      Example code for reservation.js

      // src/database/reservation.js
const { Client } = require("pg");
require("dotenv").config();

const client = new Client({
  user: process.env.DB_USER,
  host: process.env.DB_HOST,
  database: process.env.DB_NAME,
  password: process.env.DB_PASSWORD,
  port: process.env.DB_PORT || 5432,
});

const connectDB = async () => {
  if (!client._connected) {
    await client.connect();
  }
};

const getAvailableReservations = async () => {
  await connectDB();
  const result = await client.query(
    "SELECT * FROM reservations WHERE status = $1",
    ["available"]
  );
  return result.rows;
};

module.exports = {
  getAvailableReservations,
  client,
};

      b. Modify the functions/ folder by adding the function files:

      In the functions/ folder, remove the default file, and then add three function management files (manageClients.js, manageHotels.js, and manageReservations.js).

      Example for manageClients.js

      // src/functions/manageClients.js
const { app } = require("@azure/functions");
const { getAllClients } = require("../database/client");

app.http("manageClients", {
  methods: ["GET"],
  authLevel: "anonymous",
  handler: async (request, context) => {
    context.log(`HTTP function processed request for url "${request.url}"`);

    try {
      const clients = await getAllClients();
      return {
        body: clients,
      };
    } catch (error) {
      context.log("Error fetching clients:", error);
      return {
        status: 500,
        body: "Error retrieving clients.",
      };
    }
  },
});

      Example for manageHotels.js

      // src/functions/manageHotels.js
const { app } = require("@azure/functions");
const { getAllHotels } = require("../database/hotel");

app.http("manageHotels", {
  methods: ["GET"],
  authLevel: "anonymous",
  handler: async (request, context) => {
    context.log(`HTTP function processed request for url "${request.url}"`);

    try {
      const hotels = await getAllHotels();
      return {
        body: hotels,
      };
    } catch (error) {
      context.log("Error fetching hotels:", error);
      return {
        status: 500,
        body: "Error retrieving hotels.",
      };
    }
  },
});

      Example for manageReservations.js

      // src/functions/manageReservations.js
const { app } = require("@azure/functions");
const { getAvailableReservations } = require("../database/reservation");

app.http("manageReservations", {
  methods: ["GET"],
  authLevel: "anonymous",
  handler: async (request, context) => {
    context.log(`HTTP function processed request for url "${request.url}"`);

    try {
      const reservations = await getAvailableReservations();
      return {
        body: reservations,
      };
    } catch (error) {
      context.log("Error fetching reservations:", error);
      return {
        status: 500,
        body: "Error retrieving available reservations.",
      };
    }
  },
});

      Feel free to extend this structure to include features such as adding new clients, creating new reservations, or even updating and deleting data, each with its own file and its own logic.

    Step 3: Test the Function Locally

    1. Run the Function Locally:

      • Open the integrated terminal in VS Code.

      • Run the following command npm run start, which will execute func start to start the project and launch the functions:

        npm run start

    2. Test with a Browser or Postman:

      • Open a browser and navigate to http://localhost:7071/api/manageClients to test your function.
      • You can also use a tool like Postman to send HTTP requests.

    Step 4: Test and Deploy the Function to Azure

    1. Deploy Your Function:

      • Open the command palette with Ctrl+Shift+P and type Azure Functions: Deploy to Function App....
      • Follow the instructions to select your Azure subscription and choose or create a Function App, then complete the deployment process.

    2. Test the Function:

      Use a tool like Postman to send an HTTP request to the Azure Function, for example:

      https://your-azure-function-url?client_id=1234

      This will return the information of the client with the ID 1234, if present in the database.

    Conclusion

    We have demonstrated how combining Neon and Azure Functions enables the development of fast, scalable applications while reducing the complexity associated with managing infrastructure. With this combination, you can efficiently query your Postgres database without worrying about server maintenance. Moreover, Neon simplifies the scalability of your applications, making it an ideal choice for many modern projects.

    Additional Resources

    Need help?

    Join our Discord Server to ask questions or see what others are doing with Neon. Users on paid plans can open a support ticket from the console. For more details, see Getting Support.

    PreviousScale your Laravel application with Neon Postgres Read Replicas
    NextBuilding a Multi-Step Form with Laravel Volt, Folio, and Neon Postgres
    Was this page helpful?