save the Connection settings
connection:-Save( name, opts )
(optional) string; identifier for this connection
(optional) equation(s) of the form option=value where option is one of password, filename, overwrite, or create
Save stores all the information necessary to re-establish connection (with the possible exception of the password) in a file. This connection can be re-established using the LoadConnection command.
Save can store multiple connections within a file by associating each connection with an identifier. If specified, name is used as the identifier. Otherwise, "default" is used as the identifier.
The opts argument can contain one or more of the following equations.
filename = string
The filename option specifies the file in which this connection is saved. When not given, saved connections are placed in $HOME/maple/toolbox/Database/data/default.con, where $HOME is the value returned by kernelopts( homedir ).
create = true or false
The create option controls whether Save creates the directories necessary to save to the default filename. If create is true these directories are created. If it is false they are not. By default, create is false.
overwrite = true or false
The overwrite option controls whether the connection being saved overwrites a saved connection with the same identifier. If overwrite is true the connection is overwritten. Otherwise, it is not. By default, overwrite is false.
password = string or one of the literal symbols none or hidden
The password option controls the storage of a database password. The Database does not store the passwords used to connect to databases unless explicitly told to do so. If no password is stored, you must specify one when calling LoadConnection. By using the password option, you store a password with the connection. This allows the connection to be re-established without entering the password at load time. If a string is given, that string is used as the password. If hidden is given, a Maplet application is opened to allow you to enter your password without it appearing in the worksheet. The default value is none.
Important: The password is stored on disk in plain text.
Along with saving the parameters necessary to re-establish the connection, Save also stores the connection's current settings, as returned by GetOptions. When this connection is loaded these settings will also be used.
The Save command returns nothing.
Create a connection.
driver ≔ DatabaseLoadDriver⁡:
conn ≔ driver:-OpenConnection⁡url,name,pass:
Save the connection to disk using the default file and the default identifier.
Close the connection.
Re-establish the connection saved as default.
driver,conn ≔ DatabaseLoadConnection⁡password='hidden':
Modify this connection's options.
Save using a different identifier and specify the password.
Re-establish the "ac1" connection.
driver,conn ≔ DatabaseLoadConnection⁡ac1:
Check this connection's options.
Download Help Document