IN, OUT, and INOUT Parameters in SQL Stored Procedures – Explained with Examples
Introduction
In SQL, text data types are used to store alphanumeric values like names, addresses, emails, and descriptions. Choosing the correct text type — CHAR, VARCHAR, or TEXT — is important for optimizing storage space, query speed, and database performance.
In this section, you'll learn the definitions, differences, and best use cases for each text data type.
1. CHAR (Fixed-Length String)
CHAR is used to store fixed-length strings. If the stored string is shorter than the defined length, SQL automatically pads it with spaces to match the specified size.
Features:
- Fixed length
- Fast and predictable performance
- Uses extra storage if the data is often shorter than the specified length
Syntax:
column_name CHAR(length);
length = number of characters (1 to 255 depending on the database system)
Example:
CREATE TABLE countries (
country_code CHAR(2),
country_name CHAR(50)
);
country_code like 'US', 'IN', 'UK' will always take 2 characters.
When to Use CHAR:
- Data with a constant size, such as country codes, gender ('M', 'F'), state abbreviations
- Fixed-format fields like credit card types ('VISA', 'MC')
- When exact storage size is known and consistent
2. VARCHAR (Variable-Length String)
VARCHAR stands for Variable Character. It stores variable-length strings, meaning only the actual characters are stored without unnecessary padding.
Features:
- Variable length
- More space-efficient than CHAR for varying-length text
- Slightly slower than CHAR when processing large volumes (because of extra calculations for string lengths)
Syntax:
column_name VARCHAR(length);
length = maximum number of characters allowed
Example:
CREATE TABLE employees (
first_name VARCHAR(50),
email VARCHAR(100)
);
Names and emails can vary in length, making VARCHAR ideal.
When to Use VARCHAR:
- Data with unpredictable or variable length
- Names, emails, addresses, and descriptions under 255-65535 characters
- Most general-purpose text fields
3. TEXT (Large Text Field)
TEXT is used to store large amounts of text like long descriptions, blog posts, comments, or articles.
Features:
- Meant for large text storage (up to 65,535 characters for standard TEXT in MySQL)
- Cannot have a default value (in some databases like MySQL)
- TEXT fields are stored outside the main table with a pointer reference
- Different variants exist (TINYTEXT, MEDIUMTEXT, LONGTEXT) for various sizes
Syntax:
column_name TEXT;
Example:
CREATE TABLE articles (
id INT,
title VARCHAR(255),
body TEXT
);
body will store the full article content, which can be very large.
When to Use TEXT:
- Long-form text fields (comments, articles, reviews, reports)
- Data that exceeds normal VARCHAR limits
- When exact storage requirements are unknown or potentially very large
Quick Comparison: CHAR vs VARCHAR vs TEXT
Feature | CHAR | VARCHAR | TEXT |
---|---|---|---|
Storage | Fixed length | Variable length | Variable, large storage |
Max Size | Up to 255 chars | 65,535 bytes (typically) | 65,535+ chars (depends on type) |
Performance | Fast for fixed-size | Efficient for variable text | Slightly slower for queries |
Indexing | Full index support | Full index support | Limited in some DBs |
Best Use Case | Codes, fixed formats | Names, addresses, emails | Articles, long descriptions |
Important Tips
- Use CHAR only when all values will be exactly the same length
- VARCHAR is the best choice for most standard text fields
- Reserve TEXT for content that exceeds VARCHAR limits
- Consider VARCHAR(MAX) in SQL Server for large text that might need indexing
- Be aware that TEXT fields may have limitations on default values and full-text indexing
What Are Parameters in Stored Procedures?
In SQL, stored procedures can accept parameters to receive and/or return data. There are three types of parameters:
- IN - used to pass input values into the procedure
- OUT - used to pass output values back to the caller
- INOUT - used to pass values in and return updated values out
Understanding these is essential for building dynamic, reusable SQL procedures.
1. IN Parameter (Input Only)
Purpose: Used to send a value into the procedure. You cannot modify or return it.
Example:
DELIMITER //
CREATE PROCEDURE GreetUser(IN username VARCHAR(50))
BEGIN
SELECT CONCAT('Hello, ', username) AS greeting;
END //
DELIMITER ;
Usage:
CALL GreetUser('Alice');
This will output: Hello, Alice
2. OUT Parameter (Output Only)
Purpose: Used to return a value from the procedure to the caller.
Example:
DELIMITER //
CREATE PROCEDURE GetTotalCustomers(OUT total INT)
BEGIN
SELECT COUNT(*) INTO total FROM customers;
END //
DELIMITER ;
Usage:
CALL GetTotalCustomers(@customer_count);
SELECT @customer_count;
This returns the total number of customers stored in the @customer_count variable.
3. INOUT Parameter (Input and Output)
Purpose: Used to receive a value, modify it, and return the updated value.
Example:
DELIMITER //
CREATE PROCEDURE MultiplyByTwo(INOUT num INT)
BEGIN
SET num = num * 2;
END //
DELIMITER ;
Usage:
SET @myNum = 10;
CALL MultiplyByTwo(@myNum);
SELECT @myNum; -- Returns 20
The procedure takes 10 as input, multiplies it by 2, and returns 20.
Summary Table
Parameter Type | Direction | Modifiable in Procedure | Used For |
---|---|---|---|
IN | Caller → Procedure | No | Sending values into the procedure |
OUT | Procedure → Caller | Yes | Returning values from the procedure |
INOUT | Caller ↔ Procedure | Yes | Accepting input, modifying, and returning |