Server component database queries in NextJS - Mini Project: Build & Apply

Server Component Database Queries in Next.js

📖 Scenario: You are building a simple blog homepage using Next.js. The blog posts are stored in a database. You want to fetch the posts on the server side and display them in a list.

🎯 Goal: Create a Next.js server component that queries a database for blog posts and renders their titles in a list.

📋 What You'll Learn

Use a server component in Next.js

Create a mock database query function

Fetch data inside the server component

Render the list of blog post titles

💡 Why This Matters

🌍 Real World

Fetching data on the server side is common in web apps to improve performance and SEO. Server components in Next.js let you do this easily.

💼 Career

Understanding server components and database queries is essential for building modern React apps with Next.js, a popular framework in the industry.

1

Set up mock blog posts data

Create a constant called posts that is an array of objects. Each object should have id and title properties. Use these exact entries: { id: 1, title: 'Hello World' }, { id: 2, title: 'Learning Next.js' }, { id: 3, title: 'Server Components' }.

NextJS

# Your code here

Hint

Use const posts = [ ... ] with objects inside the array.

2

Create a mock database query function

Create an async function called getPosts that returns the posts array.

NextJS

const posts = [
  { id: 1, title: 'Hello World' },
  { id: 2, title: 'Learning Next.js' },
  { id: 3, title: 'Server Components' }
];

// Your code here

Hint

Define async function getPosts() { return posts; }

3

Fetch posts inside the server component

Create a default exported async function component called BlogList. Inside it, call await getPosts() and store the result in a variable called allPosts.

NextJS

const posts = [
  { id: 1, title: 'Hello World' },
  { id: 2, title: 'Learning Next.js' },
  { id: 3, title: 'Server Components' }
];

async function getPosts() {
  return posts;
}

// Your code here

Hint

Use export default async function BlogList() { const allPosts = await getPosts(); }

4

Render the list of blog post titles

Inside the BlogList component, return a <ul> element. Use allPosts.map with post as the iterator to create <li> elements. Each <li> should have a key attribute set to post.id and display post.title.

NextJS

const posts = [
  { id: 1, title: 'Hello World' },
  { id: 2, title: 'Learning Next.js' },
  { id: 3, title: 'Server Components' }
];

async function getPosts() {
  return posts;
}

export default async function BlogList() {
  const allPosts = await getPosts();
  
  // Your code here
}

Hint

Return JSX with <ul> and map allPosts to <li key={post.id}>{post.title}</li>.

Practice

1. What is the main advantage of using server components in Next.js for database queries?

easy

A. They fetch data securely on the server without exposing credentials to the client.

B. They allow direct database access from the browser.

C. They require no async/await syntax for queries.

D. They automatically cache data on the client side.

Solution

1. Step 1: Understand server components role

   Server components run on the server, so they can safely access databases without exposing secrets to the client.

2. Step 2: Compare options

   Only They fetch data securely on the server without exposing credentials to the client. correctly states the security advantage. Options A, C, and D are incorrect because database access is not done in the browser, async/await is needed, and caching is not automatic on client side.

3. Final Answer:

   They fetch data securely on the server without exposing credentials to the client. -> Option A

4. Quick Check:

   Server components = secure server data fetching [OK]

Hint: Server components run on server, so data stays secure there [OK]

Common Mistakes:

• Thinking database queries run in the browser
• Ignoring async/await for fetching data
• Assuming client-side caching is automatic

2. Which of the following is the correct way to fetch data from a database inside a Next.js server component?

easy

A. const data = await db.query('SELECT * FROM users')

B. const data = fetch('api/data')

C. const data = db.query('SELECT * FROM users')

D. const data = useEffect(() => db.query('SELECT * FROM users'), [])

Solution

1. Step 1: Identify async database query syntax

   Database queries inside server components must use async/await to wait for the query result.

2. Step 2: Evaluate options

   const data = await db.query('SELECT * FROM users') uses await correctly. const data = fetch('api/data') uses fetch which is client-side. const data = db.query('SELECT * FROM users') misses await, so it returns a promise. const data = useEffect(() => db.query('SELECT * FROM users'), []) uses useEffect, which is a client hook and invalid in server components.

3. Final Answer:

   const data = await db.query('SELECT * FROM users') -> Option A

4. Quick Check:

   Async query = await db.query(...) [OK]

Hint: Use await with db queries inside async server components [OK]

Common Mistakes:

• Omitting await causing unresolved promises
• Using client hooks like useEffect in server components
• Using fetch instead of direct DB queries

3. Given this Next.js server component code, what will be rendered if the database returns [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }]?

export default async function Users() {
  const users = await db.query('SELECT id, name FROM users');
  return (
    <ul>
      {users.map(user => <li key={user.id}>{user.name}</li>)}
    </ul>
  );
}

medium

A. 12

B. AliceBob

C. Error: users.map is not a function

D. {user.name}{user.name}

Solution

1. Step 1: Understand data and rendering

   The database returns an array of user objects with id and name. The component maps over users and renders each name inside <li>.

2. Step 2: Check output correctness

   • Alice
   • Bob
   correctly shows the list with names Alice and Bob.
   • 1
   • 2
   shows ids instead of names. Error: users.map is not a function would happen if users was not an array.
   • {user.name}
   • {user.name}
   shows JSX code as text, which is incorrect.

3. Final Answer:

   <ul><li>Alice</li><li>Bob</li></ul> -> Option B

4. Quick Check:

   Mapping array to list items = names shown [OK]

Hint: Map array to JSX list to render names correctly [OK]

Common Mistakes:

• Rendering ids instead of names
• Forgetting to use key prop in list items
• Trying to render raw objects instead of properties

4. Identify the error in this Next.js server component fetching data from a database:

export default function Products() {
  const products = await db.query('SELECT * FROM products');
  return (
    <div>{products.length} products found</div>
  );
}

medium

A. products.length is invalid for query result

B. Cannot use await inside server components

C. Missing async keyword on the component function

D. db.query should be inside useEffect hook

Solution

1. Step 1: Check async usage in server component

   Await can only be used inside async functions. The component lacks the async keyword.

2. Step 2: Validate other options

   Cannot use await inside server components is wrong because await is allowed in server components if async is used. db.query should be inside useEffect hook is wrong because useEffect is client-only. products.length is invalid for query result is wrong because products is expected to be an array with length.

3. Final Answer:

   Missing async keyword on the component function -> Option C

4. Quick Check:

   Await requires async function [OK]

Hint: Add async before function to use await inside [OK]

Common Mistakes:

• Forgetting async keyword on server component
• Using client hooks like useEffect in server components
• Assuming query result is not an array

5. You want to fetch user data and their posts in a Next.js server component. Which approach correctly fetches both from the database before rendering?

export default async function UserPosts() {
  const user = await db.query('SELECT * FROM users WHERE id = 1');
  const posts = await db.query('SELECT * FROM posts WHERE userId = 1');
  return (
    <section>
      <h1>{user.name}</h1>
      <ul>
        {posts.map(post => <li key={post.id}>{post.title}</li>)}
      </ul>
    </section>
  );
}

What is the best way to optimize these queries?

hard

A. Fetch posts on the client side using useEffect

B. Run the second query inside the map function for posts

C. Combine both queries into one SQL join query

D. Run both queries in parallel using Promise.all before rendering

Solution

1. Step 1: Understand query optimization

   Running queries sequentially waits for the first before starting the second, slowing response.

2. Step 2: Evaluate options for optimization

   Run both queries in parallel using Promise.all before rendering runs both queries in parallel with Promise.all, improving speed. Run the second query inside the map function for posts runs queries inside map, causing many queries (bad). Fetch posts on the client side using useEffect moves fetching to client, losing server benefits. Combine both queries into one SQL join query is possible but may complicate data handling.

3. Final Answer:

   Run both queries in parallel using Promise.all before rendering -> Option D

4. Quick Check:

   Parallel queries = faster data fetching [OK]

Hint: Use Promise.all to fetch multiple queries simultaneously [OK]

Common Mistakes:

• Running queries one after another sequentially
• Fetching data inside loops causing many queries
• Moving server data fetching to client side unnecessarily