SQL CREATE TABLE Statement

In this tutorial you will learn how to create a table inside the database using SQL.

Creating a Table

In the previous chapter we have learned how to create a database on the database server. Now it's time to create some tables inside our database that will actually hold the data. A database table simply organizes the information into rows and columns.

The SQL CREATE TABLE statement is used to create a table.

Syntax

The basic syntax for creating a table can be given with:

CREATE TABLE table_name (
    column1_name data_type constraints,
    column2_name data_type constraints,
    ....
);

To understand this syntax easily, let's create a table in our demo database. Type the following statement on MySQL command-line tool and press enter:

-- Syntax for MySQL Database 
CREATE TABLE persons (
    id INT NOT NULL PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50) NOT NULL,
    birth_date DATE,
    phone VARCHAR(15) NOT NULL UNIQUE
);
 
-- Syntax for SQL Server Database 
CREATE TABLE persons (
    id INT NOT NULL PRIMARY KEY IDENTITY(1,1),
    name VARCHAR(50) NOT NULL,
    birth_date DATE,
    phone VARCHAR(15) NOT NULL UNIQUE
);

The above statement creates a table named persons with four columns id, name, birth_date and phone. Notice that each column name is followed by a data type declaration; this declaration specifies that what type of data the column will store, whether integer, string, date, etc.

Some data types can be declared with a length parameter that indicates how many characters can be stored in the column. For example, VARCHAR(50) can hold up to 50 characters.

The following table summarizes the most commonly used data types supported by MySQL.

Data Type      

Please check out the reference section SQL DB data types for the detailed information on all the data types available in popular RDBMS like MySQL, SQL Server, etc.

There are a few additional constraints (also called modifiers) that are set for the table columns in the preceding statement. Constraints define rules regarding the values allowed in columns.

• The NOT NULL constraint ensures that the field cannot accept a NULL value.
• The PRIMARY KEY constraint marks the corresponding field as the table's primary key.
• The AUTO_INCREMENT attribute is a MySQL extension to standard SQL, which tells MySQL to automatically assign a value to this field if it is left unspecified, by incrementing the previous value by 1. Only available for numeric fields.
• The UNIQUE constraint ensures that each row for a column must have a unique value.

We will learn more about the SQL constraints in next chapter.

Create Table If Not Exists

If you try to create a table that is already exists inside the database you'll get an error message. To avoid this in MySQL you can use an optional clause IF NOT EXISTS as follow:

CREATE TABLE IF NOT EXISTS persons (
    id INT NOT NULL PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50) NOT NULL,
    birth_date DATE,
    phone VARCHAR(15) NOT NULL UNIQUE
);