Data Connectors Overview
This is the documentation for ActiveViam’s Data Connectors library, with a section for users and a section for developers for both the Data Load Controller and Data Extract Engine libraries.
What is Data Connectors?
Data Connectors is a scalable, standard service to handle data loading/extraction within an ActivePivot application. This abstracts specific data loading/extraction implementations away from the client. Data Connectors sits on top of an ActivePivot application. Data Connectors contains target-specific modules that each yield a jar. Developers can pick and choose to include the artifacts they need in their pom file.
Requirements
ActivePivot Version
Data Connectors Version | Supported AP Versions |
---|---|
Data Connectors 1.x | AP versions 5.9.0+ |
Data Connectors 2.x | AP versions 5.10.1+ |
The Data Connectors jars rely on local ActivePivot repositories. We achieve this by marking all ActivePivot dependencies as <scope>provided</scope>
within Data Connectors pom files. This allows the ActivePivot dependencies to be inferred from the local file system and flexibly use different minor versions. This allows for easier ActivePivot upgrades as there is no need to rebuild/upgrade the Data-Connectors tool. The same is expected for the javax.servlet:javax.servlet-api
archetype if you are using the monitoring for XMLA.
Module Structure
Here we can see the Data Connectors module structure with all target modules (in blue).
Currently, Data Connectors supports the following targets for the DLC and DEE components. Targets are included in the following maven modules:
Target | Maven Artifact ID | DC 1.x Min Version AP | DC 2.x Min Version AP |
---|---|---|---|
Avro | data-connectors-avro |
5.9.0 | 5.10.1 |
AWS | data-connectors-aws |
5.9.0 | 5.10.1 |
Azure | data-connectors-azure |
5.9.0 | 5.10.1 |
CSV (Local FileSystem) | data-connectors-csv |
5.9.0 | 5.10.1 |
Google-Cloud-Platform | data-connectors-gcp |
5.9.0 | 5.10.1 |
InMemory (Extraction only) | data-connectors-core |
5.9.0 | 5.10.1 |
JDBC | data-connectors-jdbc |
5.9.0 | 5.10.1 |
Kafka | data-connectors-kafka |
5.9.0 | 5.10.1 |
Parquet | data-connectors-parquet |
5.9.2 | 5.10.1 |
RabbitMq | data-connectors-rabbitmq |
5.9.0 | 5.10.1 |
Users can import the target module required for either data Loading or Extraction by including the corresponding target’s module within their pom. Then the user will have access to both the Data Load Controller and Data Extract Engine components.
Here is an example of including Data Connectors for RabbitMq:
<dependency>
<groupId>com.activeviam.io</groupId>
<artifactId>data-connectors-rabbitmq</artifactId>
<version>2.0.0-AP5.10</version>
</dependency>
REST Services
Services URL
Both the DLC and DEE components are found at the following REST URLs:
/services/connectors/rest/dlc/<REST-version>/
/services/connectors/rest/dee/<REST-version>/
REST Service Version
Data Connectors REST endpoints contain a version number. This version number helps remote users ensure they are using the correct REST contract. The REST version is appended to the end of the base REST endpoint for both DLC and DEE components. More on each component can be found here: DLC REST Services and DEE REST Services.
Below we can see the REST version matrix for the different componenets of Data Connectors:
Data Connectors Component | REST Version |
---|---|
Data Load Controller | v1 |
Data Extract Engine | v1 |