MySQL Shell : the best DBA tool ?

1/18/2019 pre FOSDEM MySQL Day - MySQL Shell : the best DBA tool ?
ﬁle:///home/fred/ownCloud/Presentations/ORACLE/FOSDEM2019/MySQL%20Day%20-%20MySQL%20Shell/MySQL%20Day%20-%20MySQL%20Shell.… 1/53
1 / 53

2 / 532 / 532 / 53

MyMySQLSQL ShellShell:: the best DBA tool ?
How to use theHow to use the MyMySQLSQL ShellShell as a framework for DBAsas a framework for DBAs

Frédéric Descamps - MySQL Community Manager - Oracle
3 / 53


Safe Harbor Statement
The following is intended to outline our general product direction. It is intended for
information purpose only, and may not be incorporated into any contract. It is not a
commitment to deliver any material, code, or functionality, and should not be relied up in
making purchasing decisions. The development, release and timing of any features or
functionality described for Oracle´s product remains at the sole discretion of Oracle.
Copyright @ 2019 Oracle and/or its affiliates. All rights reserved.
4 / 53

about me - http://about.me/lefred
Who am I ?Who am I ?
5 / 53

Frédéric Descamps
@lefred
MySQL Evangelist
Hacking MySQL since 3.23
devops believer
living in Belgium 🇧🇪
http://lefred.be

6 / 53

a new tool
MyMySQLSQL ShellShell
7 / 53

MySQL Shell
The MySQL Shell is an interactive Javascript, Python, or SQL interface supporting
development and administration for the MySQL Server and is a component of the MySQL
Server. You can use the MySQL Shell to perform data queries and updates as well as
various administration operations.
8 / 53

MySQL Shell (2)
The MySQL Shell provides:
9 / 53

ﬁle:///home/fred/ownCloud/Presentations/ORACLE/FOSDEM2019/MySQL%20Day%20-%20MySQL%20Shell/MySQL%20Day%20-%20MySQL%20Shell… 10/53
MySQL Shell (2)
Both Interactive and Batch operations
10 / 53

MySQL Shell (2)
Document and Relational Models
11 / 53

MySQL Shell (2)
CRUD Document and Relational APIs via scripting
12 / 53

MySQL Shell (2)
Traditional Table, JSON, Tab Separated output results formats
13 / 53

MySQL Shell (2)
MySQL Standard and X Protocols
14 / 53

MySQL Shell (2)
MySQL Standard and X Protocols
and more...
15 / 53

MySQL Shell and Python
When using the python mode in the Shell, it's possible to use system modules (local).
16 / 53

MySQL Shell and Python (2)
Of course this can be any type of modules:
17 / 53

MySQL Shell and Python (2)
Of course this can be any type of modules:
18 / 53

we want more !
ExtendingExtending MyMySQLSQL ShellShell
19 / 53

Extending MySQL Shell
It's then possible to create your own modules to extend MySQL Shell.
20 / 53

For calling some long statements or group of operations or sometimes to replace a
missing functionality.
21 / 53

Recently, somebody pointed out that since the new DD it was not anymore possible to
delete all routines for a specific schema.
22 / 53

Recently, somebody pointed out that since the new DD it was not anymore possible to
delete all routines for a specific schema.
Jesper explained recently how the MySQL Shell could help here see
https://mysql.wisborg.dk/2018/12/02/mysql-8-drop-several-stored-events-
procedures-or-functions/
23 / 53

24 / 53

25 / 53

Or for example, retrieve the expiration period of passwords (see
https://lefred.be/content/mysql-when-will-the-password-of-my-users-expire/):
26 / 53

Another example, retrieve the tables potentially fragmented (see
https://lefred.be/content/overview-of-fragmented-mysql-innodb-tables/):
27 / 53

Recently somebody complained about the complexity of knowing what are the default
values of columns when expressions are used (https://forums.mysql.com/read.php?
101,670682,670682):
28 / 53

Contribute to MySQL Shell DBA Toolkit ?
Get the code from https://github.com/lefred/mysql-shell-mydba and Pull Requests are
welcome !
29 / 53

we want even more !
InnoInnotoptop
30 / 53

Innotop
As maintainer of Innotop, after doing so delayed maintenance, I started a poll on Twitter:
31 / 53

Innotop (2)
So Innotop is not dead... but it's very complex to maintain... Perl !
32 / 53

Innotop (2)
This is maybe the reason there is less and less contributors...
33 / 53

Innotop (2)
This is maybe the reason there is less and less contributors...
... so and MySQL Shell then ?
34 / 53

Innotop in MySQL Shell
35 / 53

00:05
36 / 53

Innotop in MySQL Shell
How to use it ?How to use it ?
37 / 53

How to use this module in MySQL Shell ?
The module is available on github: https://github.com/lefred/mysql-shell-innotop
38 / 53

$ mysqlsh --py root@localhost
importimport sys
sys.path.append('/home/fred/workspace/mysql-shell-innotop')
importimport innotop
Py> innotop.session_processlist.run()
39 / 53

$ mysqlsh --py root@localhost
importimport sys
Py> innotop.session_processlist.run()
Add in ~/.mysqlsh/mysqlshrc.py:
importimport sys
40 / 53

does it work everywhere ?
LimitationsLimitations
41 / 53

Limitations
requires ncurses
42 / 53

Limitations
requires ncurses
works almost exclusively on Gnu/Linux
43 / 53

I want to contribute !
How to write your own extension ?How to write your own extension ?
44 / 53

Creating you own extension
All extensions are a single file located in the modulesmodules folder:
[fred@imac2 mysql-shell-innotop] $ ls modules/*py
modules/common.py
modules/global_by_ le_by_bytes.py
modules/help.py
modules/__init__.py
modules/session_processlist.py
modules/thread_info.py
45 / 53

Skeleton of an extension
Every extension starts the same way and requires some mandatory modules:
46 / 53

importimport __builtin__
importimport curses
fromfrom datetime importimport datetime
fromfrom time importimport sleep
47 / 53

importimport curses
Then you need to specify the shortcuts that calls the functions:
48 / 53

importimport curses
innotop.shortcut['h']={'return': 'help', 'stdscr': FalseFalse}
49 / 53

importimport curses
innotop.shortcut['h']={'return': 'help', 'stdscr': FalseFalse}
return:return: name of the module (help.py)
stdscr:stdscr: use the same screen (and pass it to the function)
50 / 53

Skeleton of an extension - run()
defdef runrun(session, delay=1, back=False):
stdscr, info = innotop.common.setup(curses, session)
keep_running = TrueTrue
whilewhile keep_running:
time = datetime.now()
y,x = innotop.common.topbar(curses, stdscr, info)
<your code>
# Wait until delay seconds have passed while listening for the q key
whilewhile (datetime.now() - time).total_seconds() < delay:
c = stdscr.getch()
ifif c == ord("q"):
keep_running = FalseFalse
breakbreak
ifif notnot back:
# Reset the cures behavior and nish
curses.nocbreak()
stdscr.keypad(FalseFalse)
curses.echo()
curses.endwin
51 / 53

52 / 53

Thank you !
Any Questions ?
share your 💕 for MySQL on social media using @mysql #MySQL8isGreat
#MySQLDay #MySQLShell
53 / 53

MySQL Shell : the best DBA tool ?

Recommended

More Related Content

What's hot (20)

Similar to MySQL Shell : the best DBA tool ? (20)

More from Frederic Descamps (20)

Recently uploaded (20)

MySQL Shell : the best DBA tool ?