API

This page contains a list of all functions and classes in MonetDBe-Python project (monetdbe).

Connection

This module contains the monetdbe connection class.

class monetdbe.connection.Connection(database: Optional[Union[str, pathlib.Path]] = None, uri: bool = False, timeout: int = 0, detect_types: int = 0, check_same_thread: bool = True, autocommit: bool = False, nr_threads: int = 0, memorylimit: int = 0, querytimeout: int = 0, logging: Optional[pathlib.Path] = None, username: Optional[str] = None, password: Optional[str] = None, port: Optional[int] = None)

Bases: object

exception DataError

Bases: monetdbe.exceptions.DatabaseError

Exception raised for errors that are due to problems with the processed data like division by zero, numeric value out of range, etc. It must be a subclass of DatabaseError.

exception DatabaseError

Bases: monetdbe.exceptions.Error

Exception raised for errors that are related to the database. It must be a subclass of Error.

exception Error

Bases: Exception

Exception that is the base class of all other error exceptions. You can use this to catch all errors with one single ‘except’ statement. Warnings are not considered errors and thus should not use this class as base. It must be a subclass of the Python StandardError (defined in the module exceptions).

exception IntegrityError

Bases: monetdbe.exceptions.DatabaseError

Exception raised when the relational integrity of the database is affected, e.g. a foreign key check fails. It must be a subclass of DatabaseError.

exception InterfaceError

Bases: monetdbe.exceptions.Error

Exception raised for errors that are related to the database interface rather than the database itself. It must be a subclass of Error.

exception InternalError

Bases: monetdbe.exceptions.DatabaseError

Exception raised when the database encounters an internal error, e.g. the cursor is not valid anymore, the transaction is out of sync, etc. It must be a subclass of DatabaseError.

exception NotSupportedError

Bases: monetdbe.exceptions.DatabaseError

Exception raised in case a method or database API was used which is not supported by the database, e.g. requesting a .rollback() on a connection that does not support transaction or has transactions turned off. It must be a subclass of DatabaseError.

exception OperationalError

Bases: monetdbe.exceptions.DatabaseError

Exception raised for errors that are related to the database’s operation and not necessarily under the control of the programmer, e.g. an unexpected disconnect occurs, the data source name is not found, a transaction could not be processed, a memory allocation error occurred during processing, etc. It must be a subclass of DatabaseError.

exception ProgrammingError

Bases: monetdbe.exceptions.DatabaseError

Exception raised for programming errors, e.g. table not found or already exists, syntax error in the SQL statement, wrong number of parameters specified, etc. It must be a subclass of DatabaseError.

exception Warning

Bases: Exception

Exception raised for important warnings like data truncations while inserting, etc. It must be a subclass of the Python StandardError (defined in the module exceptions).

backup(*args, **kwargs)
close(*args, **kwargs) → None
commit(*args, **kwargs) → Cursor
create_aggregate(*args, **kwargs)
create_collation(*args, **kwargs)
create_function(*args, **kwargs)
cursor(factory: Optional[Type[Cursor]] = None) → Cursor

Create a new cursor.

Parameters

factory – An optional factory. If supplied, this must be a callable returning an instance of Cursor or its subclasses.

Returns

a new cursor.

execute(query: str, args: Optional[Iterable] = None) → Cursor

Execute a SQL query

This is a nonstandard and SQLite compatible shortcut that creates a cursor object by calling the cursor() method, calls the cursor’s execute() method with the parameters given, and returns the cursor.

Parameters
  • query – The SQL query to execute

  • args – The optional SQL query arguments

Returns

A new cursor.

executemany(query: str, args_seq: Union[Iterator, Iterable[Iterable]]) → Cursor

Prepare a database query and then execute it against all parameter sequences or mappings found in the sequence seq_of_parameters.

This is a nonstandard and SQLite compatible shortcut that creates a cursor object by calling the cursor() method, calls the cursor’s execute() method with the parameters given, and returns the cursor.

Parameters
  • query – The SQL query to execute

  • args – The optional SQL query arguments

Returns

A new cursor.

executescript(sql_script: str)
property in_transaction
iterdump(*args, **kwargs)
rollback(*args, **kwargs)

Rolls back the current transaction.

set_authorizer(*args, **kwargs)
set_autocommit(value: bool) → None

Set the connection to auto-commit mode.

Parameters

value – a boolean value

set_progress_handler(*args, **kwargs)
set_trace_callback(*args, **kwargs)

Cursor

class monetdbe.cursor.Cursor(con: monetdbe.connection.Connection)

Bases: object

close(*args, **kwargs)

Shut down the connection.

commit()monetdbe.cursor.Cursor

Commit the current pending transaction.

Returns

the current cursor

create(table, values, schema=None)

Creates a table from a set of values or a pandas DataFrame.

execute(operation: str, parameters: Optional[Iterable] = None)monetdbe.cursor.Cursor

Execute operation

Parameters
  • operation – the query you want to execute

  • parameters – an optional iterable containing arguments for the operation.

Returns

the cursor object itself

Raises

OperationalError – if the execution failed

executemany(operation: str, seq_of_parameters: Union[Iterator, Iterable[Iterable]])monetdbe.cursor.Cursor

Prepare a database operation (query or command) and then execute it against all parameter sequences or mappings found in the sequence seq_of_parameters.

Parameters
  • operation – the SQL query to execute

  • seq_of_parameters – An optional iterator or iterable containing an iterable of arguments

executescript(sql_script: str) → None

This is a nonstandard convenience and SQLite compatibility method for executing multiple SQL statements at once. It issues a COMMIT statement first, then executes the SQL script it gets as a parameter.

Parameters

sql_script – A string containing one or more SQL statements, split by ;

Raises

Error – If the previous call to .execute*() did not produce any result set or no call was issued yet.

fetchall() → List[Tuple]

Fetch all (remaining) rows of a query result, returning them as a list of tuples).

Returns

all (remaining) rows of a query result as a list of tuples

Raises

Error – If the previous call to .execute*() did not produce any result set or no call was issued yet.

fetchdf() → pandas.core.frame.DataFrame

Fetch all results and return a Pandas DataFrame.

like .fetchall(), but returns a Pandas DataFrame.

fetchmany(size=None)

Fetch the next set of rows of a query result, returning a list of tuples). An empty sequence is returned when no more rows are available.

Parameters

size – The number of rows to fetch. Fewer rows may be returned.

Returns: A number of rows from a query result as a list of tuples

Raises

Error – If the previous call to .execute*() did not produce any result set or no call was issued yet.

fetchnumpy() → numpy.ndarray

Fetch all results and return a numpy array.

like .fetchall(), but returns a numpy array.

fetchone() → Optional[Tuple]

Fetch the next row of a query result set, returning a single tuple, or None when no more data is available.

Returns

One row from a result set.

Raises

Error – If the previous call to .execute*() did not produce any result set or no call was issued yet.

insert(table: str, values: Union[pandas.core.frame.DataFrame, Dict[str, numpy.ndarray]], schema: str = 'sys')

Inserts a set of values into the specified table.

Parameters
  • table – The table to insert into

  • values – The values. must be either a pandas DataFrame or a dictionary of values.

  • schema – The SQL schema to use. If no schema is specified, the “sys” schema is used.

lastrowid = 0
scroll(count: int, mode: str = 'relative')

Scroll the cursor in the result set to a new position according to mode.

We dont support scrolling, since the full result is available.

setinputsizes(*args, **kwargs) → None

This method would normally be used before the .execute*() method is invoked to reserve memory.

MonetDBe-Python does not require this, so calling this function has no effect.

setoutputsize(*args, **kwargs) → None

This method would normally set a column buffer size for fetchion of large columns.

MonetDBe-Python does not require this, so calling this function has no effect.

transaction()

Start a new transaction

Returns

the current cursor

class monetdbe.cursor.Description(name, type_code, display_size, internal_size, precision, scale, null_ok)

Bases: tuple

property display_size

Alias for field number 2

property internal_size

Alias for field number 3

property name

Alias for field number 0

property null_ok

Alias for field number 6

property precision

Alias for field number 4

property scale

Alias for field number 5

property type_code

Alias for field number 1

Row

class monetdbe.row.Row(cur: monetdbe.cursor.Cursor, row: Union[tuple, Generator[Optional[Any], Any, None]])

Bases: object

A Row is a non-standard SQLite compatible data container. It tries to mimic a tuple in most of its features.

It supports mapping access by column name and index, iteration, representation, equality testing and len().

If two Row objects have exactly the same columns and their members are equal, they compare equal.

keys() → Tuple[Any]