Package rdkit :: Package Dbase :: Module DbConnection :: Class DbConnect

Class DbConnect

object --+
         |
        DbConnect

This class is intended to abstract away many of the details of
interacting with databases.

It includes some GUI functionality

Instance Methods

[hide private]

__init__(self, dbName='', tableName='', user='sysdba', password='masterkey')
Constructor

source code

UpdateTableNames(self, dlg)
Modifies a connect dialog to reflect new table names

source code

GetTableNames(self, includeViews=0)
gets a list of tables available in a database

source code

GetColumnNames(self, table='', join='', what='*', where='', **kwargs)
gets a list of columns available in the current table

source code

GetColumnNamesAndTypes(self, table='', join='', what='*', where='', **kwargs)
gets a list of columns available in the current table along with their types

source code

GetColumns(self, fields, table='', join='', **kwargs)
gets a set of data from a table

source code

GetData(self, table=None, fields='*', where='', removeDups=-1, join='', transform=None, randomAccess=1, **kwargs)
a more flexible method to get a set of data from a table

source code

GetDataCount(self, table=None, where='', join='', **kwargs)
returns a count of the number of results a query will return

source code

GetCursor(self)
returns a cursor for direct manipulation of the DB...

source code

KillCursor(self)
closes the cursor

source code

AddTable(self, tableName, colString)
adds a table to the database

source code

InsertData(self, tableName, vals)
inserts data into a table

source code

InsertColumnData(self, tableName, columnName, value, where)
inserts data into a particular column of the table

source code

AddColumn(self, tableName, colName, colType)
adds a column to a table

source code

Commit(self)
commits the current transaction

source code

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __str__, __subclasshook__

Properties

[hide private]

Inherited from object: __class__

Method Details

[hide private]

init(self, dbName='', tableName='', user='sysdba', password='masterkey')
(Constructor)

source code

Constructor

**Arguments**  (all optional)

  - dbName: the name of the DB file to be used

  - tableName: the name of the table to be used

  - user: the username for DB access

  - password: the password to be used for DB access

Overrides: object.__init__

UpdateTableNames(self, dlg)

source code

Modifies a connect dialog to reflect new table names

**Arguments**

  - dlg: the dialog to be updated

GetTableNames(self, includeViews=0)

source code

gets a list of tables available in a database

**Arguments**

- includeViews: if this is non-null, the views in the db will
  also be returned

**Returns**

    a list of table names

**Notes**

 - this uses _DbInfo.GetTableNames_

GetColumnNames(self, table='', join='', what='*', where='', **kwargs)

source code

gets a list of columns available in the current table

**Returns**

    a list of column names

**Notes**

 - this uses _DbInfo.GetColumnNames_

GetColumnNamesAndTypes(self, table='', join='', what='*', where='', **kwargs)

source code

gets a list of columns available in the current table along with their types

**Returns**

    a list of 2-tuples containing:

      1) column name

      2) column type

**Notes**

 - this uses _DbInfo.GetColumnNamesAndTypes_

GetColumns(self, fields, table='', join='', **kwargs)

source code

gets a set of data from a table

**Arguments**

 - fields: a string with the names of the fields to be extracted,
   this should be a comma delimited list

**Returns**

    a list of the data

**Notes**

  - this uses _DbUtils.GetColumns_

GetData(self, table=None, fields='*', where='', removeDups=-1, join='', transform=None, randomAccess=1, **kwargs)

source code

a more flexible method to get a set of data from a table

**Arguments**

 - table: (optional) the table to use
 
 - fields: a string with the names of the fields to be extracted,
   this should be a comma delimited list

 - where: the SQL where clause to be used with the DB query

 - removeDups: indicates which column should be used to recognize
   duplicates in the data.  -1 for no duplicate removal.

**Returns**

    a list of the data

**Notes**

  - this uses _DbUtils.GetData_

GetDataCount(self, table=None, where='', join='', **kwargs)

source code

returns a count of the number of results a query will return

**Arguments**

 - table: (optional) the table to use
 
 - where: the SQL where clause to be used with the DB query

 - join: the SQL join clause to be used with the DB query


**Returns**

    an int

**Notes**

  - this uses _DbUtils.GetData_

GetCursor(self)

source code

returns a cursor for direct manipulation of the DB
only one cursor is available

AddTable(self, tableName, colString)

source code

adds a table to the database

**Arguments**

  - tableName: the name of the table to add

  - colString: a string containing column defintions

**Notes**

  - if a table named _tableName_ already exists, it will be dropped

  - the sqlQuery for addition is: "create table %(tableName) (%(colString))"

InsertData(self, tableName, vals)

source code

inserts data into a table

**Arguments**

  - tableName: the name of the table to manipulate

  - vals: a sequence with the values to be inserted

InsertColumnData(self, tableName, columnName, value, where)

source code

inserts data into a particular column of the table

**Arguments**

  - tableName: the name of the table to manipulate

  - columnName: name of the column to update

  - value: the value to insert

  - where: a query yielding the row where the data should be inserted

AddColumn(self, tableName, colName, colType)

source code

adds a column to a table

**Arguments**

  - tableName: the name of the table to manipulate

  - colName: name of the column to insert

  - colType: the type of the column to add

Class DbConnect

__init__(self, dbName='', tableName='', user='sysdba', password='masterkey') (Constructor)

UpdateTableNames(self, dlg)

GetTableNames(self, includeViews=0)

GetColumnNames(self, table='', join='', what='*', where='', **kwargs)

GetColumnNamesAndTypes(self, table='', join='', what='*', where='', **kwargs)

GetColumns(self, fields, table='', join='', **kwargs)

GetData(self, table=None, fields='*', where='', removeDups=-1, join='', transform=None, randomAccess=1, **kwargs)

GetDataCount(self, table=None, where='', join='', **kwargs)

GetCursor(self)

AddTable(self, tableName, colString)

InsertData(self, tableName, vals)

InsertColumnData(self, tableName, columnName, value, where)

AddColumn(self, tableName, colName, colType)

init(self, dbName='', tableName='', user='sysdba', password='masterkey')
(Constructor)