insert

The insert Change Type inserts data into an existing table.

Uses

You can typically use the insert Change Type when you want to add and deploy the specific data or values to the existing table in your database. It can include columns and another attributes listed in this documentation.

Running the `update` Change Type

To insert the needed data and update a table in your database, follow these steps:

Add the insertChange Type to your changeset with the needed attributes as it is shown in the examples.
Deploy your changeset by running the update command:

liquibase update

Now, you should see that your data has been inserted into the table.

Available attributes

Name	Description	Required for	Supports	Since
`catalogName`	Name of the catalog		all	3.0
`dbms`	Specifies which database type(s) a changeset is to be used for. See valid database type names on Liquibase Database Tutorials. Separate multiple databases with commas. Specify that a changeset is not applicable to a particular database type by prefixing with `!`. The keywords `all` and `none` are also available.		all	3.0
`schemaName`	Name of the schema		all
`tableName`	Name of the table to insert data into	all	all

Nested tags

Name Description Required for Supports Multiple allowed

Name	Description	Required for	Supports	Multiple allowed
`column`	The data to insert into columns. Note: YAML and JSON changelogs using the `column` tag must nest it within a `columns` tag.	--	all	all

column

The data to insert into columns.

Note: YAML and JSON changelogs using the column tag must nest it within a columns tag.

all

XML example

...
<changeSet  author="liquibase-docs"  id="insert-example">  
    <insert  catalogName="department"  
            dbms="!h2, mysql"  
            schemaName="public"  
            tableName="person">  
        <column  name="address"  value="address value"/>  
    </insert>  
</changeSet>
...

YAML example

...
-  changeSet:  
    id:  insert-example  
    author:  liquibase-docs  
    changes:  
    -  insert:  
        catalogName:  department  
        columns:  
        -  column:  
            name:  address  
            value:  address value  
        dbms:  '!h2,  mysql'  
        schemaName:  public  
        tableName:  person
...

JSON example

...
{
  "changeSet":{
	 "id":"insert-example",
	 "author":"liquibase-docs",
	 "changes":[
		{
		  "insert":{
             "catalogName":"department",
			 "columns":[
			    {
				  "column":{
				     "name":"address",
					 "value":"address value"
			      }
			    }
		     ],
			 "dbms":"!h2, mysql",
			 "schemaName":"public",
	         "tableName":"person"
		   }
	     }
	   ]
     }
   }
...

SQL example

...
--changeset liquibase-docs:insert-example
INSERT  INTO  department.person  (address)  VALUES  ('address value');
...

Database support