MySQL Partition Manager

The sqlpart (MySQL Partition Manager) can be used to manage existing yearweek range paritioned MySQL tables.

NAME:
   sqlpart - MySQL partition manager

USAGE:
   sqlpart [global options] command [command options] [arguments...]

VERSION:
   1.0.0

AUTHOR:
   Bardia Keyoumarsi <bardia@keyoumarsi.com>

COMMANDS:
   template  outputs a config file template
   yearweek  outputs the current yearweek value
   validate  validate your configuration file
   status    status of current partitioned tables
   update    update database partitions based on given configuration
   help, h   Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h     show help (default: false)
   --version, -v  print the version (default: false)

Installation

git clone github.com/qeubar/mysql-partition-mgr
cd mysql-partition-mgr/
go install

Example

create table:

CREATE TABLE `logs` (
  `id` BIGINT(21) NOT NULL AUTO_INCREMENT,
  `yearweek` INT(11) NOT NULL,
  `user_id` BIGINT(21) NOT NULL,
  `message` TEXT NOT NULL,
  `created_at` BIGINT(21) NOT NULL,
  PRIMARY KEY (`id`, `yearweek`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
PARTITION BY RANGE(yearweek) (
      PARTITION p202024 VALUES LESS THAN (202024),
      PARTITION p202025 VALUES LESS THAN (202025)
);

setup config:

cat > myconfig.json
{
        "tables": [
                {
                        "name": "logs",
                        "partition_schema": "yearweek",
                        "retention": 5,
                        "max_future_partitions": 5
                }
        ]
}

run update:

sqlpart update -c myconfig.json
Partitions to add to the logs table [202029 202030 202031 202032]
+-------+----------------+----------------------+-----------------------+----------------+-----------------------+-----------------+-------------------+---------+
| TABLE | PARTITION NAME | PARTITION EXPRESSION | PARTITION DESCRIPTION | NUMBER OF ROWS | AVERAGE ROW SIZE (MB) | INDEX SIZE (MB) | STORAGE SIZE (MB) | COMMENT |
+-------+----------------+----------------------+-----------------------+----------------+-----------------------+-----------------+-------------------+---------+
| logs  | p202024        | yearweek             |                202024 |              0 |                     0 |               0 |          0.015625 |         |
| logs  | p202025        | yearweek             |                202025 |              0 |                     0 |               0 |          0.015625 |         |
| logs  | p202029        | yearweek             |                202029 |              0 |                     0 |               0 |          0.015625 |         |
| logs  | p202030        | yearweek             |                202030 |              0 |                     0 |               0 |          0.015625 |         |
| logs  | p202031        | yearweek             |                202031 |              0 |                     0 |               0 |          0.015625 |         |
| logs  | p202032        | yearweek             |                202032 |              0 |                     0 |               0 |          0.015625 |         |
+-------+----------------+----------------------+-----------------------+----------------+-----------------------+-----------------+-------------------+---------+

TODOs

• Support more range types like yearmonth