Merge branch '2.2' into develop

This commit is contained in:
Markus Mäkelä
2018-01-03 14:07:09 +02:00
29 changed files with 667 additions and 57 deletions

View File

@ -44,7 +44,7 @@ The top filter has one mandatory parameter, `filebase`, and a number of optional
### Filebase
The basename of the output file created for each session. A session index is added to the filename for each file written. This is a mandatory parameter.
The basename of the output file created for each session. The session ID is added to the filename for each file written. This is a mandatory parameter.
```
filebase=/tmp/SqlQueryLog

View File

@ -34,6 +34,7 @@ For any problems you encounter, please consider submitting a bug report at
* [MXS-1581](https://jira.mariadb.org/browse/MXS-1581) CREATE TABLE AS not supported
* [MXS-1580](https://jira.mariadb.org/browse/MXS-1580) Invalid handling of BIT values
* [MXS-1527](https://jira.mariadb.org/browse/MXS-1527) SELECT with session var is not supported
* [MXS-1516](https://jira.mariadb.org/browse/MXS-1516) existing connection don't change routing even if master switched
## Packaging

View File

@ -87,6 +87,11 @@ multi-statement or a compound statement modifies the state of the
session. This is not a good practice and a change in the client side
behavior is advised.
### Top Filter
The top filter now uses the session ID instead of an internal counter for the
names of the log file names.
## Dropped Features
## New Features

View File

@ -197,6 +197,18 @@ Start or stop the binary log to Avro conversion. The first parameter is the name
of the service to stop and the second parameter tells whether to start the
conversion process or to stop it.
### `avrorouter::purge SERVICE`
This command will delete all files created by the avrorouter. This includes all
.avsc schema files and .avro data files as well as the internal state tracking
files. Use this to completely reset the conversion process.
**Note:** Once the command has completed, MaxScale must be restarted to restart
the conversion process. Issuing a `convert start` command **will not work**.
**WARNING:** You will lose any and all converted data when this command is
executed.
# Files Created by the Avrorouter
The avrorouter creates two files in the location pointed by _avrodir_:
@ -205,6 +217,14 @@ the locations of the GTIDs in the .avro files. The _avro-conversion.ini_ contain
the last converted position and GTID in the binlogs. If you need to reset the
conversion process, delete these two files and restart MaxScale.
# Resetting the Conversion Process
To reset the binlog conversion process, issue the `purge` module command by
executing it via MaxAdmin and stop MaxScale. If manually created schema files
were used, they need to be recreated once MaxScale is stopped. After stopping
MaxScale and optionally creating the schema files, the conversion process can be
started by starting MaxScale.
# Example Client
The avrorouter comes with an example client program, _cdc.py_, written in Python 3.