DOC: clean-up docstrings of sql
DOC: fix sql docs (write example data to database)
Merge pull request #6298 from jorisvandenbossche/sql-docstring

DOC: clean-up docstrings of sql + fix doc build