launch Connection Builder Assistant - Maple Help

Online Help

All Products    Maple    MapleSim

Home : Support : Online Help : Connectivity : Database Package : Database/ConnectionBuilder

Database[ConnectionBuilder] - launch Connection Builder Assistant

Calling Sequence

ConnectionBuilder( opts )

Database( opts )




(optional) equation of the form filename=file



The ConnectionBuilder command opens a Assistant to help you create a database connection. You can enter driver and connection parameters in the interface. The parameters correspond to the arguments you can specify for the LoadDriver and OpenConnection commands. The Assistant opens a connection to the specified database.


You can also use the Database package name as a top-level command to launch the Connection Builder Assistant.


If a connection is successfully established by the Assistant, it returns an expression sequence of length 2.  The first element is the driver module and the second is the connection module.


To facilitate specifying the files required for the connection, the Assistant allows you to search the file system.


The Connection Builder Assistant can also load and save connection settings to files.  These files are compatible with those used by the Save and LoadConnection commands.


It is recommended that you save connection settings. This allows you to easily re-establish connections.


Each connection stored in a file is associated with an identifier. This identifier allows multiple connections to be stored in a single file. To specify the identifier for connection settings, use the Connection combination box.


The ConnectionBuilder command accepts the optional filename=file equation, which allows you to specify the connection file (as a string) to use when opening the Assistant.  If not specified, the Assistant opens $HOME/maple/toolbox/Database/data/default.con, where $HOME is the value returned by kernelopts( homedir ).  If this file does not exist, no file is loaded.


If a file is successfully loaded, the connection with the identifier default is displayed by default. If no connection has the identifier default, the Assistant displays the connection properties for the connection with the alphabetically first identifier.


For more detailed information, see the Help menu in the Connection Builder Assistant.


The Connection Builder Assistant can be opened either by using the top-level Database command, as shown below, or by calling Database:-ConnectionBuilder.


result:=conn:-ExecuteQuerySELECT * FROM animals

result:=moduleoptionunload=Close;localhandle;exportNext,Previous,Last,First,GetRowNumber,GotoRow,GetRowCount,InsertRow,DeleteRow,UpdateRow,GetData,UpdateData,GetType,GetName,GetColumnCount,SetOptions,GetOptions,Close,ToMaple;end module


Show the results.

whiler:-Nextdor:-GetDataid,r:-GetDataname,r:-GetDatanumber,r:-GetDatamassend do












Perform a more complex SELECT and convert the output to a Maple table.

c:-ExecuteQuerySELECT id, name FROM animals WHERE mass > 5,'output'='table'



Perform another SELECT and convert the output to a Maple Array.

c:-ExecuteQuerySELECT name, mass FROM animals WHERE number BETWEEN 10 and 50,'output'='Array'



See Also

Database, Database[Connection][ExecuteQuery], Database[Connection][Save], Database[Driver], Database[Driver][OpenConnection], Database[LoadConnection], Database[LoadDriver], Database[usage]

Download Help Document

Was this information helpful?

Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam