Implementing a Connection to Zoomdata
ADDING THE CONNECTOR SERVER
When an administrator adds a connector to Zoomdata, Zoomdata queries the connector to describe itself. This description tells Zoomdata which connection type it serves, as well as some metadata about the data store to which it can connect. The connector uses a method called
to describe itself to Zoomdata.
Your connector server must include in its response, at the very least, a field called
storageType. It is a string that uniquely identifies the data store with which the connector interfaces.
The other data store information is optional, but can tell Zoomdata the minimum and maximum supported versions of the data store, as well as provide an icon for the Zoomdata UI to show with the connection type.
Although the API supports multiple types for legacy, the current implementation expects the icon to be a valid SVG file converted to binary. For our example connector to the hypothetical MyDB data store, the connector might return the following description.
|storageType||MYDB||Because we know that there will be no other connector server for MyDBs, we can just use MYDB as the storageType.|
|minSupportedVersion||0.8||In the example, the connector works with MyDB versions as old as version 0.8.x.|
|Icon||(binary SVG file)||If you do not provide an icon, Zoomdata will use a default image.|
We also provide the following connection parameters.
|USER_NAME||ParameterString||false||Usernames and passwords are only required if the data store requires them.|
|PASSWORD||ParameterPassword||false||Password parameter values are never shown in plain text.|
Each connection parameter can also have a description that explains its purpose to a user creating a data source. Give a brief, informative description when possible.
can return more than one
ServerDescription, the best practice is for a single connector to return a single