Update README

Signed-off-by: Manuel Carmona <manu.carmona90@gmail.com>

Author: mcarmonaa

README.md

@@ -27,18 +27,91 @@ We are continuously adding more functionality to go-mysql-server. We support a s
 
 |                        |                                     Supported                                     |
 |:----------------------:|:---------------------------------------------------------------------------------:|
-| Comparison expressions | !=, ==, >, <, >=,<=, BETWEEN                                |
-| Null check expressions | IS NULL, IS NOT NULL                               |
-|  Grouping expressions  | COUNT, MIN, MAX ,AVG                                  |
-|  Standard expressions  | ALIAS, LITERAL, STAR (*)                             |
-| Statements       | CROSS JOIN, INNER JOIN, DESCRIBE, FILTER (WHERE), GROUP BY, LIMIT, SELECT, SHOW TABLES, SORT, DISTINCT  |
-| Functions | SUBSTRING |
+| Comparison expressions | !=, ==, >, <, >=,<=, BETWEEN, REGEXP, IN, NOT IN |
+| Null check expressions  | IS NULL, IS NOT NULL |
+| Grouping expressions | COUNT, MIN, MAX ,AVG |
+| Standard expressions  | ALIAS, LITERAL, STAR (*) |
+| Statements  | CROSS JOIN, INNER JOIN, DESCRIBE, FILTER (WHERE), GROUP BY, LIMIT/OFFSET, SELECT, SHOW TABLES, SORT, DISTINCT, CREATE TABLE, INSERT |
+| Functions | SUBSTRING, ARRAY_LENGTH |
 | Time functions | YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, DAYOFYEAR |
 
 ## Custom functions
 
 - `IS_BINARY(blob)`: returns whether a BLOB is a binary file or not
 
+## Example
+
+`go-mysql-server` has a sql engine and a server implementation, so to start a server you must instantiate the engine and give it your `sql.Database` implementation that will be in charge to handle all the logic about retrieving the data from your source :
+
+```go
+...
+driver := sqle.New()
+driver.AddDatabase(createTestDatabase())
+
+auth := mysql.NewAuthServerStatic()
+auth.Entries["user"] = []*mysql.AuthServerStaticEntry{{
+    Password: "pass",
+}}
+
+config := server.Config{
+    Protocol: "tcp",
+    Address:  "localhost:5432",
+    Auth:     auth,
+}
+
+s, err := server.NewDefaultServer(config, driver)
+if err != nil {
+    panic(err)
+}
+
+s.Start()
+...
+```
+
+Then, you can connect to the server with any mysql client:
+```bash
+> mysql --host=127.0.0.1 --port=5123 -u user -ppass db -e "SELECT * FROM mytable"
++----------+-------------------+-------------------------------+---------------------+
+| name     | email             | phone_numbers                 | created_at          |
++----------+-------------------+-------------------------------+---------------------+
+| John Doe | john@doe.com      | ["555-555-555"]               | 2018-04-18 10:42:58 |
+| John Doe | johnalt@doe.com   | []                            | 2018-04-18 10:42:58 |
+| Jane Doe | jane@doe.com      | []                            | 2018-04-18 10:42:58 |
+| Evil Bob | evilbob@gmail.com | ["555-666-555","666-666-666"] | 2018-04-18 10:42:58 |
++----------+-------------------+-------------------------------+---------------------+
+```
+
+See the complete example [here](_example/main.go).
+
+### Queries examples
+
+```
+SELECT count(name) FROM mytable
++---------------------+
+| COUNT(mytable.name) |
++---------------------+
+|                   4 |
++---------------------+
+
+SELECT name,year(created_at) FROM mytable
++----------+--------------------------+
+| name     | YEAR(mytable.created_at) |
++----------+--------------------------+
+| John Doe |                     2018 |
+| John Doe |                     2018 |
+| Jane Doe |                     2018 |
+| Evil Bob |                     2018 |
++----------+--------------------------+
+
+SELECT email FROM mytable WHERE name = 'Evil Bob'
++-------------------+
+| email             |
++-------------------+
+| evilbob@gmail.com |
++-------------------+
+```
+
+
 ## Powered by go-mysql-server
 
 * [gitquery](https://github.com/src-d/gitquery)