Table::insert

Insert table rows

&reftitle.description; public `mysql_xdevapi\TableInsert` `mysql_xdevapi\Table::insert` `mixed` `columns` `mixed` `more_columns`

Inserts rows into a table.

&reftitle.parameters;

`columns`

- The columns to insert data into. Can be an array with one or more values, or a string.

`more_columns`

- Additional columns definitions.

&reftitle.returnvalues;

A TableInsert object; use the execute() method to execute the insert statement.

&reftitle.examples;

### `mysql_xdevapi\Table::insert` example

    <?php
    $session = mysql_xdevapi\getSession("mysqlx://user:password@localhost");

    $session->sql("DROP DATABASE IF EXISTS addressbook")->execute();
    $session->sql("CREATE DATABASE addressbook")->execute();
    $session->sql("CREATE TABLE addressbook.names(name text, age int)")->execute();
    $session->sql("INSERT INTO addressbook.names values ('John', 42), ('Sam', 33)")->execute();

    $schema = $session->getSchema("addressbook");
    $table  = $schema->getTable("names");

    $table ->insert("name", "age")
      ->values(["Suzanne", 31],["Julie", 43])
      ->execute();
    ?>