SQL database resolvers in GraphQL - Mini Project: Build & Apply

Build SQL Database Resolvers for GraphQL

📖 Scenario: You are building a simple GraphQL API for a bookstore. The data is stored in a SQL database. You want to create resolvers that fetch data from the SQL database when a client queries the GraphQL API.

🎯 Goal: Create SQL database resolvers in GraphQL that fetch book data from a SQL database table called books. You will set up the initial data structure, add configuration for the database connection, write the core resolver logic, and complete the resolver setup.

📋 What You'll Learn

Create a GraphQL resolver function named getBooks that queries the books table

Add a configuration variable dbClient to connect to the SQL database

Write the SQL query inside the resolver to select all columns from books

Complete the resolver export so it can be used in the GraphQL server

💡 Why This Matters

🌍 Real World

GraphQL APIs often need to fetch data from SQL databases. Writing resolvers that query SQL tables is a common task in backend development.

💼 Career

Backend developers and full-stack engineers frequently write database resolvers to connect GraphQL APIs with SQL databases, enabling efficient data retrieval and manipulation.

1

DATA SETUP: Create the resolver function skeleton

Create a function called getBooks that takes parent, args, and context as parameters. The function should be asynchronous and return an empty array for now.

GraphQL

async function getBooks(parent, args, context) {
  // Your code here
}

Hint

Define an async function named getBooks with the parameters parent, args, and context. Return an empty array inside.

2

CONFIGURATION: Add the database client variable

Add a constant variable called dbClient that represents the SQL database client connection. For this example, set it to { query: async () => ({ rows: [] }) } to simulate a database client.

GraphQL

const dbClient = { query: async () => ({ rows: [] }) };

async function getBooks(parent, args, context) {
  return [];
  // Your code here
}

Hint

Create a constant dbClient that has a query method returning an object with an empty rows array.

3

CORE LOGIC: Write the SQL query inside the resolver

Inside the getBooks function, use dbClient.query to run the SQL query SELECT * FROM books;. Await the result and return the rows property from the query result.

GraphQL

const dbClient = { query: async () => ({ rows: [] }) };

async function getBooks(parent, args, context) {
  // Your code here
}

Hint

Use await dbClient.query('SELECT * FROM books;') and return the rows from the result.

4

COMPLETION: Export the resolver function

Add an export statement that exports an object with a Query property. Inside Query, assign the getBooks function to the books field.

GraphQL

const dbClient = { query: async () => ({ rows: [] }) };

async function getBooks(parent, args, context) {
  const result = await dbClient.query('SELECT * FROM books;');
  return result.rows;
}

// Your code here

Hint

Export an object named resolvers with a Query property that maps books to getBooks.

Practice

1. What is the main role of SQL database resolvers in a GraphQL server?

easy

A. To format the GraphQL query results into JSON

B. To define the GraphQL schema types and fields

C. To handle user authentication and authorization

D. To fetch or modify data in the SQL database based on GraphQL queries or mutations

Solution

1. Step 1: Understand the purpose of resolvers

   Resolvers are functions that connect GraphQL queries or mutations to the actual data source, here an SQL database.

2. Step 2: Identify the role in data fetching and modification

   Resolvers run SQL commands to get or change data as requested by the GraphQL operations.

3. Final Answer:

   To fetch or modify data in the SQL database based on GraphQL queries or mutations -> Option D

4. Quick Check:

   Resolvers connect queries to SQL data [OK]

Hint: Resolvers link GraphQL queries to SQL commands [OK]

Common Mistakes:

• Confusing resolvers with schema definitions
• Thinking resolvers handle authentication
• Assuming resolvers format output only

2. Which of the following is the correct way to define a resolver function for a GraphQL query named getUser that fetches user data from an SQL database?

easy

A. const resolvers = { Query: { getUser: () => db.query('SELECT * FROM users') } };

B. const resolvers = { Mutation: { getUser: () => db.query('SELECT * FROM users') } };

C. const resolvers = { Query: { getUser: 'SELECT * FROM users' } };

D. const resolvers = { getUser: () => db.query('SELECT * FROM users') };

Solution

1. Step 1: Identify the correct resolver structure for a query

   Resolvers for queries are defined inside the Query object with function values.

2. Step 2: Check the syntax for calling the database query

   The resolver should be a function returning the result of db.query with the SQL command string.

3. Final Answer:

   const resolvers = { Query: { getUser: () => db.query('SELECT * FROM users') } }; -> Option A

4. Quick Check:

   Query resolvers are functions inside Query object [OK]

Hint: Query resolvers go inside Query object as functions [OK]

Common Mistakes:

• Placing query resolver inside Mutation
• Assigning SQL string directly instead of a function
• Defining resolver outside Query or Mutation objects

3. Given the resolver below, what will be the output when the GraphQL query { getUserById(id: 2) { name } } is executed?

const resolvers = {
  Query: {
    getUserById: (_, args) => {
      const users = [
        { id: 1, name: 'Alice' },
        { id: 2, name: 'Bob' },
        { id: 3, name: 'Carol' }
      ];
      return users.find(user => user.id === args.id);
    }
  }
};

medium

A. { "data": { "getUserById": { "name": "Alice" } } }

B. { "data": { "getUserById": { "name": "Bob" } } }

C. { "data": { "getUserById": null } }

D. Error: args.id is undefined

Solution

1. Step 1: Understand the resolver logic

   The resolver searches the users array for an object with id equal to args.id.

2. Step 2: Match the query argument with the array data

   The query requests id: 2, so the resolver returns the user with id: 2, which is { id: 2, name: 'Bob' }.

3. Final Answer:

   { "data": { "getUserById": { "name": "Bob" } } } -> Option B

4. Quick Check:

   Find user with id 2 = Bob [OK]

Hint: Find user by id in array using args.id [OK]

Common Mistakes:

• Confusing id 2 with id 1 or 3
• Forgetting to access args.id
• Assuming resolver returns entire user object without filtering

4. Identify the error in this resolver code snippet for a mutation that inserts a new user into the SQL database:

const resolvers = {
  Mutation: {
    addUser: (parent, args) => {
      db.query(`INSERT INTO users (name, email) VALUES (${args.name}, ${args.email})`);
      return { success: true };
    }
  }
};

medium

A. SQL injection risk due to string interpolation without parameterization

B. Missing return statement for the inserted user data

C. Incorrect resolver placement inside Mutation instead of Query

D. Using backticks instead of single quotes for SQL string

Solution

1. Step 1: Analyze the SQL query construction

   The SQL command uses string interpolation to insert args.name and args.email directly into the query string.

2. Step 2: Identify security risk

   This approach allows SQL injection attacks if user input contains malicious SQL code. Proper parameterization or prepared statements are needed.

3. Final Answer:

   SQL injection risk due to string interpolation without parameterization -> Option A

4. Quick Check:

   Unsafe string interpolation causes SQL injection [OK]

Hint: Never insert variables directly into SQL strings [OK]

Common Mistakes:

• Ignoring SQL injection vulnerability
• Thinking backticks cause errors
• Expecting mutation in Query object

5. You want to write a resolver that fetches all orders for a user, but only if the user is active. The SQL tables are users(id, active) and orders(id, user_id, total). Which resolver implementation correctly enforces this condition efficiently?

hard

A. const resolvers = { Query: { userOrders: (_, args) => db.query(`SELECT * FROM orders WHERE user_id = ${args.userId}`) } };

B. const resolvers = { Query: { userOrders: (_, args) => { const user = db.query(`SELECT * FROM users WHERE id = ${args.userId}`); if (user.active) { return db.query(`SELECT * FROM orders WHERE user_id = ${args.userId}`); } else { return []; } } } };

C. const resolvers = { Query: { userOrders: (_, args) => db.query(`SELECT * FROM orders WHERE user_id = ${args.userId} AND EXISTS (SELECT 1 FROM users WHERE id = ${args.userId} AND active = TRUE)`) } };

D. const resolvers = { Query: { userOrders: (_, args) => db.query(`SELECT * FROM users WHERE id = ${args.userId} AND active = TRUE`) } };

Solution

1. Step 1: Understand the requirement

   Fetch orders only if the user is active, combining the check and data fetch efficiently.

2. Step 2: Evaluate each option

   const resolvers = { Query: { userOrders: (_, args) => db.query(`SELECT * FROM orders WHERE user_id = ${args.userId} AND EXISTS (SELECT 1 FROM users WHERE id = ${args.userId} AND active = TRUE)`) } }; uses a single SQL query with EXISTS to check user active status and fetch orders in one call, which is efficient and correct.
   const resolvers = { Query: { userOrders: (_, args) => { const user = db.query(`SELECT * FROM users WHERE id = ${args.userId}`); if (user.active) { return db.query(`SELECT * FROM orders WHERE user_id = ${args.userId}`); } else { return []; } } } }; fetches user first then orders separately, causing multiple queries and possible async issues.
   const resolvers = { Query: { userOrders: (_, args) => db.query(`SELECT * FROM orders WHERE user_id = ${args.userId}`) } }; fetches orders without checking user active status.
   const resolvers = { Query: { userOrders: (_, args) => db.query(`SELECT * FROM users WHERE id = ${args.userId} AND active = TRUE`) } }; fetches user data only, not orders.

3. Final Answer:

   const resolvers = { Query: { userOrders: (_, args) => db.query(`SELECT * FROM orders WHERE user_id = ${args.userId} AND EXISTS (SELECT 1 FROM users WHERE id = ${args.userId} AND active = TRUE)`) } }; -> Option C

4. Quick Check:

   Single query with EXISTS enforces condition efficiently [OK]

Hint: Use EXISTS in SQL to combine condition and fetch in one query [OK]

Common Mistakes:

• Running multiple queries instead of one
• Not checking user active status before fetching orders
• Returning user data instead of orders