API Reference

Connections

The connect() function is the primary entry point for the SingleStore package. It connects to a SingleStore database using either DB-API compliant parameters, or a connection string in the form of a URL.

connect([host, user, password, port, ...])

Return a SingleStoreDB connection.

Connection

Connection objects are created by the singlestoredb.connect() function. They are used to create Cursor objects for querying the database.

Connection(**kwargs)	SingleStoreDB connection.
Connection.autocommit([value])	Set autocommit mode.
Connection.close()	Close the database connection.
Connection.commit()	Commit the pending transaction.
Connection.rollback()	Rollback the pending transaction.
Connection.cursor()	Create a new cursor object.
Connection.is_connected()	Determine if the database is still connected.
Connection.enable_data_api([port])	Enable the data API in the server.
Connection.disable_data_api()	Disable the data API.

The Connection.show attribute of the connection objects allow you to access various information about the server. The available operations are shown below.

Connection.show.aggregates()	Show all aggregate functions in the current database.
Connection.show.columns(table[, full])	Show the column information for the given table.
Connection.show.create_aggregate(name)	Show the function creation code for the given aggregate function.
Connection.show.create_function(name)	Show the function creation code for the given function.
Connection.show.create_pipeline(name[, extended])	Show the pipeline creation code for the given pipeline.
Connection.show.create_table(name)	Show the table creation code for the given table.
Connection.show.create_view(name)	Show the view creation code for the given view.
Connection.show.databases([extended])	Show all databases in the server.
Connection.show.database_status()	Show status of the current database.
Connection.show.errors()	Show errors.
Connection.show.functions()	Show all functions in the current database.
Connection.show.global_status()	Show global status of the current server.
Connection.show.indexes(table)	Show all indexes in the given table.
Connection.show.partitions([extended])	Show partitions in the current database.
Connection.show.pipelines()	Show all pipelines in the current database.
Connection.show.plan(plan_id[, json])	Show the plan for the given plan ID.
Connection.show.plancache()	Show all query statements compiled and executed.
Connection.show.procedures()	Show all procedures in the current database.
Connection.show.processlist()	Show details about currently running threads.
Connection.show.reproduction([outfile])	Show troubleshooting data for query optimizer and code generation.
Connection.show.schemas()	Show schemas in the server.
Connection.show.session_status()	Show server status information for a session.
Connection.show.status([extended])	Show server status information.
Connection.show.table_status()	Show table status information for the current database.
Connection.show.tables([extended])	Show tables in the current database.
Connection.show.warnings()	Show warnings.

ShowResult

The results of the above methods and attributes are in the form of a ShowResult object. This object is primarily used to display information to the screen or web browser, but columns from the output can also be accessed using dictionary-like key access syntax or attributes.

ShowResult(*args, **kwargs)

Simple result object.

Cursor

Cursors are used to query the database and download results. They are created using the Connection.cursor() method.

Cursor(connection)	Database cursor for submitting commands and queries.
Cursor.callproc(name[, params])	Call a stored procedure.
Cursor.close()	Close the cursor.
Cursor.execute(query[, args])	Execute a SQL statement.
Cursor.executemany(query[, args])	Execute SQL code against multiple sets of parameters.
Cursor.fetchone()	Fetch a single row from the result set.
Cursor.fetchmany([size])	Fetch size rows from the result.
Cursor.fetchall()	Fetch all rows in the result set.
Cursor.nextset()	Skip to the next available result set.
Cursor.setinputsizes(sizes)	Predefine memory areas for parameters.
Cursor.setoutputsize(size[, column])	Set a column buffer size for fetches of large columns.
Cursor.scroll(value[, mode])	Scroll the cursor to the position in the result set.
Cursor.next()	Return the next row from the result set for use in iterators.
Cursor.is_connected()	Is the cursor still connected?

Utiliites

get_jwt(email[, url, clusters, databases, ...])

Retrieve a JWT token from the SingleStoreDB single-sign-on URL.

Management API

The management objects allow you to create, destroy, and interact with workspaces in the SingleStoreDB Cloud.

manage_workspaces([access_token, version, ...])

Retrieve a SingleStoreDB workspace manager.

WorkspaceManager

WorkspaceManager objects are returned by the manage_workspaces() function. They allow you to retrieve information about workspaces in your account, or create new ones.

WorkspaceManager([access_token, version, ...])	SingleStoreDB workspace manager.
WorkspaceManager.workspace_groups	Return a list of available workspace groups.
WorkspaceManager.regions	Return a list of available regions.
WorkspaceManager.create_workspace_group(...)	Create a new workspace group.
WorkspaceManager.create_workspace(name, ...)	Create a new workspace.
WorkspaceManager.get_workspace_group(id)	Retrieve a workspace group definition.
WorkspaceManager.get_workspace(id)	Retrieve a workspace definition.

WorkspaceGroup

WorkspaceGroup objects are retrieved from WorkspaceManager.get_workspace_group() or by retrieving an element from WorkspaceManager.workspace_groups.

WorkspaceGroup(name, id, created_at, region, ...)	SingleStoreDB workspace group definition.
WorkspaceGroup.workspaces	Return a list of available workspaces.
WorkspaceGroup.create_workspace(name[, ...])	Create a new workspace.
WorkspaceGroup.refresh()	Update teh object to the current state.
WorkspaceGroup.update([name, ...])	Update the cluster definition.
WorkspaceGroup.terminate([force, ...])	Terminate the workspace group.

Workspace

Workspaces are created within WorkspaceGroups. They can be created using either WorkspaceGroup.create_workspace() or retrieved from WorkspaceManager.workspaces.

Workspace(name, workspace_id, ...[, ...])	SingleStoreDB workspace definition.
Workspace.connect(**kwargs)	Create a connection to the database server for this workspace.
Workspace.refresh()	Update the object to the current state.
Workspace.terminate([wait_on_terminated, ...])	Terminate the workspace.

Region

Region objects are accessed from the WorkspaceManager.regions attribute.

Region(id, name, provider)

Cluster region information.

Configuration

The following functions are used to get and set package configuration settings. Execute the describe_option() function with no parameters to see the documentation for all options.

get_option(key)	Get the value of an option.
set_option(*args, **kwargs)	Set the value of an option.
describe_option(*keys, **kwargs)	Print the description of one or more options.

In addition to the function above, you can access options through the singlestoredb.options object. This gives you attribute-like access to the option values.

In [1]: import singlestoredb as s2
In [2]: s2.describe_option('local_infile')
local_infile : bool
    Should it be possible to load local files?
    [default: False] [currently: False]
In [3]: s2.options.local_infile
Out[3]: False
In [4]: s2.options.local_infile = True
In [5]: s2.describe_option('local_infile')
local_infile : bool
    Should it be possible to load local files?
    [default: False] [currently: True]