Querious Support

Still have a question? Ask us.


URL Scheme

URL Scheme

Querious registers the custom URL scheme "querious://" with macOS so that certain links can trigger actions within Querious. This allows integration with certain automation/convenience tools like third party launchers.

querious://connect/saved?…

Opens a new window and connects to an existing saved connection.

Parameters:

  • name: The name of the saved connection as shown in Querious.
  • select: A database name or database.table identifier to select once the connection has been made.

Example:

querious://connect/saved?name=Seth%27s_fkiMac&select=sakila.film

querious://connect/new?…

Opens a new window and makes a connection directly from the given parameters.

Parameters:

  • host: The MySQL host.
  • port: The port MySQL is running on.
  • user: The MySQL username.
  • password: The MySQL user’s password.
  • database: The database to connect to when the connection is made.
  • unix-socket: The path to the unix socket file to use for the connection if connecting through one.
  • use-compression: Choices: [true, false]
  • security: Which kind of security to use for the connection. Can be one of: [ssl, ssh, ssl,ssh].
  • use-cleartext: Choices: [`true`, `false`]
  • auth-plugin: A string value for the authentication plugin if you want to override it.
  • ssl-client-key-file: The absolute file path of the client’s key.
  • ssl-client-cert-file: The absolute file path of the client’s certificate.
  • ssl-ca-cert-file: The absolute file path of the certificate authority’s certificate.
  • ssl-cipher: A named cipher to use if one must be specified.
  • ssh-host: The remote host SSH is running on.
  • ssh-user: The SSH username.
  • ssh-password: The SSH user’s password.
  • ssh-key-file: An absolute path to the SSH private key to use for authentication.
  • ssh-port: The remote port SSH is running on.
  • ssh-local-port: An integer port value if connecting through an existing SSH tunnel. Do not specify if Querious should create the tunnel.

Example:

querious://connect/new?host=127.0.0.1&user=webadmin&password=thepassword&use-compression=false