Connection Object

class pymysql.connections.Connection(host=None, user=None, password='', database=None, port=0, unix_socket=None, charset='', sql_mode=None, read_default_file=None, conv=None, use_unicode=None, client_flag=0, cursorclass=<class 'pymysql.cursors.Cursor'>, init_command=None, connect_timeout=10, ssl=None, read_default_group=None, compress=None, named_pipe=None, no_delay=None, autocommit=False, db=None, passwd=None, local_infile=False, max_allowed_packet=16777216, defer_connect=False, auth_plugin_map={}, read_timeout=None, write_timeout=None, bind_address=None)

Representation of a socket with a mysql server.

The proper way to get an instance of this class is to call connect().

Establish a connection to the MySQL database. Accepts several arguments:

  • host – Host where the database server is located
  • user – Username to log in as
  • password – Password to use.
  • database – Database to use, None to not use a particular one.
  • port – MySQL port to use, default is usually OK. (default: 3306)
  • bind_address – When the client has multiple network interfaces, specify the interface from which to connect to the host. Argument can be a hostname or an IP address.
  • unix_socket – Optionally, you can use a unix socket rather than TCP/IP.
  • charset – Charset you want to use.
  • sql_mode – Default SQL_MODE to use.
  • read_default_file – Specifies my.cnf file to read these parameters from under the [client] section.
  • conv – Conversion dictionary to use instead of the default one. This is used to provide custom marshalling and unmarshaling of types. See converters.
  • use_unicode – Whether or not to default to unicode strings. This option defaults to true for Py3k.
  • client_flag – Custom flags to send to MySQL. Find potential values in constants.CLIENT.
  • cursorclass – Custom cursor class to use.
  • init_command – Initial SQL statement to run when connection is established.
  • connect_timeout – Timeout before throwing an exception when connecting. (default: 10, min: 1, max: 31536000)
  • ssl – A dict of arguments similar to mysql_ssl_set()’s parameters. For now the capath and cipher arguments are not supported.
  • read_default_group – Group to read from in the configuration file.
  • compress – Not supported
  • named_pipe – Not supported
  • autocommit – Autocommit mode. None means use server default. (default: False)
  • local_infile – Boolean to enable the use of LOAD DATA LOCAL command. (default: False)
  • max_allowed_packet – Max size of packet sent to server in bytes. (default: 16MB) Only used to limit size of “LOAD LOCAL INFILE” data packet smaller than default (16KB).
  • defer_connect – Don’t explicitly connect on contruction - wait for connect call. (default: False)
  • auth_plugin_map – A dict of plugin names to a class that processes that plugin. The class will take the Connection object as the argument to the constructor. The class needs an authenticate method taking an authentication packet as an argument. For the dialog plugin, a prompt(echo, prompt) method can be used (if no authenticate method) for returning a string from the user. (experimental)
  • db – Alias for database. (for compatibility to MySQLdb)
  • passwd – Alias for password. (for compatibility to MySQLdb)
autocommit_mode = None

specified autocommit mode. None means use server default.


Begin transaction.


Send the quit message and close the socket


Commit changes to stable storage


Create a new cursor to execute queries with


Check if the server is alive


Roll back the current transaction


Set current db