HarperDB Connection

See the Connector Marketplace topic. Please request your administrator to start a trial or subscribe to the Premium HarperDB connector.

HarperDB is a distributed and versatile NoSQL and SQL database designed for simplicity, speed, and scalability in application development.

This topic describes how to authenticate to HarperDB and configure any necessary connection properties in the HarperDB connection connector.

Connection Configuration #

Each connection property available in the HarperDB connector is explained below.

Connection Name #

The name of the connection to be created should be provided. This is the name that will display on the list of available connections.

Connection Type #

Option to choose between either connecting securely using SSH Tunnel or, proceed with a Direct Connection when connecting to HarperDB.

If Connection Type value is SSH Tunnel, additional fields will be displayed.

To know more about SSH Tunneling with Gathr, see SSH Tunneling

SSH Tunnel #

If SSH Tunnel is selected, additional configuration parameters will get listed.

SSH Key #

The SSH key should be provided to authenticate the associated SSH host and SSH user.

SSH Host #

Public IP address of your SSH host.

SSH User #

Default SSH username.

If Connection Type value is Direct Connection, then proceed by updating the following fields.

Server #

The server or IP address of the HarperDB server.

Port #

The port for the HarperDB server.

Auth Scheme #

The type of authentication to use when connecting to HarperDB.

Possible Values

• Basic

• Token

Basic #

If Basic is selected, additional configuration parameter will get listed.

User #

The HarperDB user account used to authenticate.

Password #

The password used to authenticate the user.

Token #

If Token is selected, additional configuration parameters will get listed.

Operation Token #

The operation token used to authenticate to HarperDB.

Refresh Token #

The refresh token used to refresh an operation token.

Advanced Configuration #

This section contains advanced configuration parameters.

RefreshCachedSchemaAfterDDL #

Whether or not the connector should refresh cached metadata, whether cached in memory or cached otherwise.

This property is set to “false” by default, meaning that the connector will not attempt to refresh any cached metadata by default. Any cached metadata will be refreshed per the default timer for cache freshness.

Enable SSL #

Option to enable SSL. This field sets whether the connector will attempt to negotiate TLS/SSL connections to the server. By default, the connector checks the server’s certificate against the system’s trusted certificate store.

Upload Keystore File #

If SSL is enabled, a keystore file has to be uploaded using this option.

Add Configuration: Additional properties can be added using this option as key-value pairs.

After entering all the details, click on the TEST button.

If the connection service identification and authentication details are provided correctly, a success message stating “connection available” is generated.

Click on the CREATE button to save the changes.

If the details are incorrect or the server is down, you will get a message “Connection unavailable”.