INSERT and auto-generated keys in SQL

Introduction

We use INSERT to add new data into a table. Auto-generated keys help create unique IDs automatically for each new row, so we don't have to make them ourselves.

Adding a new user to a website where each user needs a unique ID.

Storing new orders in a sales database with automatically assigned order numbers.

Inserting new products into inventory with unique product IDs generated by the system.

Recording new blog posts where each post gets a unique post ID automatically.

Syntax

SQL

INSERT INTO table_name (column1, column2, ...) VALUES (value1, value2, ...);

-- To get the auto-generated key (example in PostgreSQL):
INSERT INTO table_name (column1, column2) VALUES (value1, value2) RETURNING id;

You list the columns you want to fill and then provide the matching values.

Auto-generated keys are often primary keys set to increase automatically (like SERIAL in PostgreSQL or AUTO_INCREMENT in MySQL).

Examples

Adds a new user named Alice with her email.

SQL

INSERT INTO users (name, email) VALUES ('Alice', '[e-mail]');

Adds Bob and returns the new user's auto-generated ID.

SQL

INSERT INTO users (name, email) VALUES ('Bob', '[e-mail]') RETURNING id;

Inserts a new product 'Pen' with price 1.5.

SQL

INSERT INTO products (product_name, price) VALUES ('Pen', 1.5);

Sample Program

This creates a customers table with an auto-incrementing customer_id. Then it inserts a new customer and returns the new customer_id.

SQL

CREATE TABLE customers (
  customer_id SERIAL PRIMARY KEY,
  name VARCHAR(50),
  email VARCHAR(50)
);

INSERT INTO customers (name, email) VALUES ('John Doe', '[e-mail]') RETURNING customer_id;

Important Notes

Different databases have different ways to auto-generate keys: SERIAL in PostgreSQL, AUTO_INCREMENT in MySQL, IDENTITY in SQL Server.

Using RETURNING or similar clauses helps you get the new key right after inserting.

Always specify columns in INSERT to avoid errors if table structure changes.

Summary

INSERT adds new rows to a table.

Auto-generated keys create unique IDs automatically.

RETURNING lets you get the new ID immediately after insert.

Practice

1. What does the INSERT statement do in SQL when adding a new row to a table with an auto-generated key?

easy

A. It updates the existing row with a new key.

B. It deletes an existing row based on the key.

C. It adds a new row and automatically creates a unique ID for that row.

D. It only creates a key without adding any row.

Solution

1. Step 1: Understand the purpose of INSERT

   The INSERT statement adds new rows to a table in a database.

2. Step 2: Recognize auto-generated keys

   When a table has an auto-generated key, the database automatically creates a unique ID for each new row inserted.

3. Final Answer:

   It adds a new row and automatically creates a unique ID for that row. -> Option C

4. Quick Check:

   INSERT adds row + auto key = It adds a new row and automatically creates a unique ID for that row. [OK]

Hint: INSERT adds rows; auto keys create unique IDs [OK]

Common Mistakes:

• Thinking INSERT deletes or updates rows
• Assuming keys must be manually provided
• Confusing INSERT with SELECT or DELETE

2. Which of the following is the correct syntax to insert a new row into a table users with columns name and email, letting the database auto-generate the id?

easy

A. INSERT INTO users (id, name, email) VALUES (1, 'Alice', '[e-mail]');

B. INSERT users (name, email) VALUES ('Alice', '[e-mail]');

C. INSERT INTO users VALUES ('Alice', '[e-mail]');

D. INSERT INTO users (name, email) VALUES ('Alice', '[e-mail]');

Solution

1. Step 1: Check correct INSERT syntax

   The correct syntax specifies the table name, columns, and values. Omitting the auto-generated key column lets the database handle it.

2. Step 2: Analyze each option

   INSERT INTO users (name, email) VALUES ('Alice', '[e-mail]'); correctly inserts only name and email, letting the database auto-generate the id. INSERT INTO users (id, name, email) VALUES (1, 'Alice', '[e-mail]'); provides an explicit id=1, overriding auto-generation. INSERT INTO users VALUES ('Alice', '[e-mail]'); misses column names and provides wrong number of values (2 vs 3 columns), causing error. INSERT users (name, email) VALUES ('Alice', '[e-mail]'); has wrong syntax (missing INTO).

3. Final Answer:

   INSERT INTO users (name, email) VALUES ('Alice', '[e-mail]'); -> Option D

4. Quick Check:

   Omit auto key column to auto-generate [OK]

Hint: Omit auto key column in INSERT to auto-generate [OK]

Common Mistakes:

• Including auto-generated key column with a manual value
• Missing INTO keyword in INSERT
• Not specifying columns when table has auto keys

3. Given the table orders with columns order_id (auto-generated), product, and quantity, what will this query return?

INSERT INTO orders (product, quantity) VALUES ('Book', 3) RETURNING order_id;

medium

A. The new order_id generated for the inserted row.

B. The number of rows inserted (1).

C. An error because RETURNING is not valid here.

D. The product and quantity values inserted.

Solution

1. Step 1: Understand RETURNING clause

   RETURNING lets you get values from the inserted row immediately, such as auto-generated keys.

2. Step 2: Analyze the query

   The query inserts a new order with product 'Book' and quantity 3, then returns the auto-generated order_id.

3. Final Answer:

   The new order_id generated for the inserted row. -> Option A

4. Quick Check:

   INSERT ... RETURNING returns new keys [OK]

Hint: RETURNING fetches new auto-generated keys after insert [OK]

Common Mistakes:

• Thinking RETURNING returns row count
• Assuming RETURNING is invalid syntax
• Expecting all inserted columns returned by default

4. What is wrong with this SQL statement if id is an auto-generated key?

INSERT INTO customers (id, name) VALUES (NULL, 'John');

medium

A. Using NULL for id may cause an error or fail to auto-generate the key.

B. The syntax is correct and will auto-generate id.

C. You must provide a valid id value manually.

D. The table name is missing.

Solution

1. Step 1: Understand auto-generated key behavior

   Auto-generated keys (like SERIAL in Postgres or AUTO_INCREMENT) generate a value when the column is omitted, explicitly set to NULL, or DEFAULT. Explicit non-NULL values override it.

2. Step 2: Analyze the statement

   INSERT INTO customers (id, name) VALUES (NULL, 'John'); explicitly sets id to NULL, which invokes the default generator, so the database auto-generates the next unique id. Syntax is correct.

3. Final Answer:

   The syntax is correct and will auto-generate id. -> Option B

4. Quick Check:

   NULL in auto-key column triggers generation [OK]

Hint: NULL in auto-key triggers generation; omit also works [OK]

Common Mistakes:

• Thinking explicit NULL causes an error or inserts NULL
• Believing you must omit the column and can't use NULL
• Confusing NULL with providing a manual non-NULL id

5. You want to insert multiple rows into a products table with an auto-generated product_id and get all new IDs immediately. Which SQL approach is best?

hard

A. Use a single INSERT with multiple rows and RETURNING to get all new IDs at once.

B. Use multiple INSERT statements each with RETURNING to get IDs one by one.

C. Insert rows without RETURNING and then query the table for new IDs by timestamp.

D. Manually generate IDs in your application and insert them with the rows.

Solution

1. Step 1: Understand batch insert with RETURNING

   Modern SQL supports inserting multiple rows in one statement and returning all generated keys at once.

2. Step 2: Compare options

   Use a single INSERT with multiple rows and RETURNING to get all new IDs at once. is efficient and returns all new IDs immediately. Use multiple INSERT statements each with RETURNING to get IDs one by one. is slower with multiple statements. Insert rows without RETURNING and then query the table for new IDs by timestamp. is unreliable and complex. Manually generate IDs in your application and insert them with the rows. defeats auto-generation purpose.

3. Final Answer:

   Use a single INSERT with multiple rows and RETURNING to get all new IDs at once. -> Option A

4. Quick Check:

   Batch INSERT + RETURNING = all IDs fast [OK]

Hint: Batch insert with RETURNING gets all keys at once [OK]

Common Mistakes:

• Running many single inserts instead of batch
• Querying after insert instead of RETURNING
• Manually creating keys instead of auto-generation