addAutoIncrement

Converts an existing column to be an auto-increment (a.k.a 'identity') column.

Available attributes

Attribute Description Required for Supports
catalogName

Name of the catalog

-- all
columnDataType

Data type of the column.

To help make scripts database-independent, Liquibase automatically converts the following generic data types to the correct database implementation: BIGINT, BLOB, BOOLEAN, CHAR, CLOB, CURRENCY, DATE, DATETIME, DECIMAL, DOUBLE, FLOAT, INT, MEDIUMINT, NCHAR, NUMBER, NVARCHAR, SMALLINT, TIME, TIMESTAMP, TINYINT, UUID, VARCHAR, XML.

Also, specifying a java.sql.Types.* type is converted to the correct type as well. For example:

  • java.sql.Types.TIMESTAMP
  • java.sql.Types.VARCHAR(255)
asany, h2, hsqldb, informix, ingres, mariadb, mysql, sybase, unsupported all
columnName

Name of the column

all all
defaultOnNull

When using generationType of BY DEFAULT then defaultOnNull=true allows the identity to be used if the identity column is referenced, but a value of NULL is specified.

-- oracle
generationType

Type of the generation in GENERATED %s AS IDENTITY. Default: "|".

-- all
incrementBy

Integer amount to increment by at each call

-- all
schemaName

Name of the schema

-- all
startWith

Initial integer value of the increment

-- all
tableName

Name of the table

all all

Examples

<databaseChangeLog
    xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext"
    xmlns:pro="http://www.liquibase.org/xml/ns/pro"
    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd
        http://www.liquibase.org/xml/ns/dbchangelog-ext http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd
        http://www.liquibase.org/xml/ns/pro http://www.liquibase.org/xml/ns/pro/liquibase-pro-latest.xsd">

    <changeSet author="liquibase-docs" id="addAutoIncrement-example">
        <addAutoIncrement catalogName="cat"
            columnDataType="int"
            columnName="id"
            defaultOnNull="false"
            generationType="ALWAYS"
            incrementBy="1"
            schemaName="public"
            startWith="100"
            tableName="person"/>
    </changeSet>

</databaseChangeLog>
databaseChangeLog:
- changeSet:
    id: addAutoIncrement-example
    author: liquibase-docs
    changes:
    - addAutoIncrement:
        catalogName: cat
        columnDataType: int
        columnName: id
        defaultOnNull: false
        generationType: ALWAYS
        incrementBy: 1
        schemaName: public
        startWith: 100
        tableName: person
{
    "databaseChangeLog": [
        {
            "changeSet": {
                "id": "addAutoIncrement-example",
                "author": "liquibase-docs",
                "changes": [
                    {
                        "addAutoIncrement": {
                            "catalogName": "cat",
                            "columnDataType": "int",
                            "columnName": "id",
                            "defaultOnNull": false,
                            "generationType": "ALWAYS",
                            "incrementBy": 1,
                            "schemaName": "public",
                            "startWith": 100,
                            "tableName": "person"
                        }
                    }
                ]
            }
        }
    ]
}
--liquibase formatted sql

--changeset liquibase-docs:addAutoIncrement-example
ALTER TABLE cat.person MODIFY id INT AUTO_INCREMENT;  
ALTER TABLE cat.person AUTO_INCREMENT=100;

Database support

Database Notes Auto Rollback
DB2/LUW Supported No
DB2/z Not Supported No
Derby Not Supported No
Firebird Not Supported No
H2 Supported No
HyperSQL Supported No
INGRES Supported No
Informix Supported No
MariaDB Supported No
MySQL Supported No
Oracle Not Supported No
PostgreSQL Supported No
Snowflake Not Supported No
SQL Server Not Supported No
SQLite Supported: If the column type is not INTEGER it is converted to INTEGER No
Sybase Supported No
Sybase Anywhere Supported No