MySQLdb.connections.Connection

Package MySQLdb :: Module connections :: Class Connection

[show private | hide private]

Type Connection

object --+    
         |    
connection --+
             |
            Connection

MySQL Database Connection Object

Method Summary
	`__init__(self, args, *kwargs)` Create a connection to the database.
	`__enter__(self)`
	`__exit__(self, exc, value, tb)`
	`begin(self)` Explicitly begin a connection.
	`cursor(self, cursorclass)` Create a cursor on which queries may be performed.
	`errorhandler(connection, cursor, errorclass, errorvalue)` If cursor is not None, (errorclass, errorvalue) is appended to cursor.messages; otherwise it is appended to connection.messages.
	`literal(self, o)` If o is a single object, returns an SQL literal as a string.
	`set_character_set(self, charset)` Set the connection character set to charset.
	`set_sql_mode(self, sql_mode)` Set the connection sql_mode.
	`show_warnings(self)` Return detailed information about warnings as a sequence of tuples of (Level, Code, Message).
Inherited from object
	`__delattr__(...)` x.__delattr__('name') <==> del x.name
	`__getattribute__(...)` x.__getattribute__('name') <==> x.name
	`__hash__(x)` x.__hash__() <==> hash(x)
	`__reduce__(...)` helper for pickle
	`__reduce_ex__(...)` helper for pickle
	`__setattr__(...)` x.__setattr__('name', value) <==> x.name = value
	`__str__(x)` x.__str__() <==> str(x)

Class Variable Summary
`type`	`default_cursor` = `MySQLdb.cursors.Cursor`

Method Details

init(self, *args, **kwargs)
(Constructor)

Create a connection to the database. It is strongly recommended that you only use keyword parameters. Consult the MySQL C API documentation for more information.

host: string, host to connect
user: string, user to connect as
passwd: string, password to use
db: string, database to use
port: integer, TCP/IP port to connect to
unix_socket: string, location of unix_socket to use
conv: conversion dictionary, see MySQLdb.converters
connect_timeout: number of seconds to wait before the connection attempt fails.
compress: if set, compression is enabled
named_pipe: if set, a named pipe is used to connect (Windows only)
init_command: command which is run once the connection is created
read_default_file: file from which default client values are read
read_default_group: configuration group to use from the default file
cursorclass: class object, used to create cursors (keyword only)
use_unicode: If True, text-like columns are returned as unicode objects using the connection's character set. Otherwise, text-like columns are returned as strings. columns are returned as normal strings. Unicode objects will always be encoded to the connection's character set regardless of this setting.
charset: If supplied, the connection character set will be changed to this character set (MySQL-4.1 and newer). This implies use_unicode=True.
sql_mode: If supplied, the session SQL mode will be changed to this setting (MySQL-4.1 and newer). For more details and legal values, see the MySQL documentation.
client_flag: integer, flags to use or 0 (see MySQL docs or constants/CLIENTS.py)
ssl: dictionary or mapping, contains SSL connection parameters; see the MySQL documentation for more details (mysql_ssl_set()). If this is set, and the client does not support SSL, NotSupportedError will be raised.
local_infile: integer, non-zero enables LOAD LOCAL INFILE; zero disables

There are a number of undocumented, non-standard methods. See the documentation for the MySQL C API for some hints on what they do.

Overrides:: _mysql.connection.__init__

begin(self)

Explicitly begin a connection. Non-standard. DEPRECATED: Will be removed in 1.3. Use an SQL BEGIN statement instead.

cursor(self, cursorclass=None)

Create a cursor on which queries may be performed. The optional cursorclass parameter is used to create the Cursor. By default, self.cursorclass=cursors.Cursor is used.

errorhandler(connection, cursor, errorclass, errorvalue)

If cursor is not None, (errorclass, errorvalue) is appended to cursor.messages; otherwise it is appended to connection.messages. Then errorclass is raised with errorvalue as the value.

You can override this with your own error handler by assigning it to the instance.

literal(self, o)

If o is a single object, returns an SQL literal as a string. If o is a non-string sequence, the items of the sequence are converted and returned as a sequence.

Non-standard. For internal use; do not use this in your applications.

set_character_set(self, charset)

Set the connection character set to charset. The character set can only be changed in MySQL-4.1 and newer. If you try to change the character set from the current value in an older version, NotSupportedError will be raised.

Overrides:: _mysql.connection.set_character_set

set_sql_mode(self, sql_mode)

Set the connection sql_mode. See MySQL documentation for legal values.

show_warnings(self)

Return detailed information about warnings as a sequence of tuples of (Level, Code, Message). This is only supported in MySQL-4.1 and up. If your server is an earlier version, an empty sequence is returned.

Generated by Epydoc 2.1 on Sat Mar 3 21:14:16 2007

http://epydoc.sf.net