DOC: clean-up docstrings of sql

@mangecoeur I don't think I changed some real content, just some adjustments for the numpy docstring standards. Only for has_table I corrected the parameters.