Documentation Home
MySQL 8.4 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 40.2Mb
PDF (A4) - 40.3Mb
Man Pages (TGZ) - 261.9Kb
Man Pages (Zip) - 367.5Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


22.4.4.1 Insert Records into Tables

You can use theinsert() method with thevalues() method to insert records into an existing relational table. Theinsert() method accepts individual columns or all columns in the table. Use one or morevalues() methods to specify the values to be inserted.

Insert a Complete Record

To insert a complete record, pass to theinsert() method all columns in the table. Then pass to thevalues() method one value for each column. For example, to add a new record to the city table in theworld_x database, insert the following record and pressEnter twice.

mysql-py> db.city.insert("ID", "Name", "CountryCode", "District", "Info").values(None, "Olympia", "USA", "Washington", '{"Population": 5000}')

The city table has five columns: ID, Name, CountryCode, District, and Info. Each value must match the data type of the column it represents.

Insert a Partial Record

The following example inserts values into the ID, Name, and CountryCode columns of the city table.

mysql-py> db.city.insert("ID", "Name", "CountryCode").values(None, "Little Falls", "USA").values(None, "Happy Valley", "USA")

When you specify columns using theinsert() method, the number of values must match the number of columns. In the previous example, you must supply three values to match the three columns specified.

Related Information