This post is part of an entire series
Hana Smart Data Integration - Overview
- Hana Smart Data Integration - Adapters
- Hana Adapter SDK - Setup
- Hana Adapter SDK - The first adapter
- Hana Adapter SDK - The Open Source Adapters from Github
- Hana Adapter SDK - Running and debugging the Adapter
- Hana Adapter SDK - Design Considerations and SQL commands
- Hana Smart Data Integration - Batch Dataflows
- Hana Smart Data Integration - Realtime Table Replication
- Hana Smart Data Integration - Realtime Sources with Transformations
- Hana Smart Data Integration - Realtime Sources with History Preserving
In order to import the adapters, the easiest method is using the Github for Windows application.
It is installed from here and provides a fairly simple to use interface for the normal git operations.
Once installed, the github web page with the Hana Native Adapter repository is opened
SAP/hana-native-adapters · GitHub
and by clicking on the Clone in Desktop button a local copy of the github repository is created.
(see here for the official help page of github)
This is really just a local copy on the local disk drive with no side effect on the files located in github. The local files can be modified at will.
The last step is to go to Eclipse/Hana Studio and import the Existing Project into Workspace using the Files - Import menu item.
As example the HelloWorldAdapter2 can be imported as a first project.
This adapter has no dependencies to other libraries, so it can be started right away. A right click on the Project and selecting the Debug As - Debug Configurations popup menu item does open the next screen.
In this screen the AgentConfig Launch Configuration should be visible. If it is not, it can be imported as shown in the previous chapter, by import - Debug - LaunchConfiguration and pointing to the /ui directory of the installed agent.
As every adapter has its own dependencies, the required bundles have to be listed and can be validated if any are missing. But actually, that is quite simple.
- Deselect all from the Target Platform tree
- Click on the Add Required Bundles
- Check if all Bundles in the required version are available by hitting the Validate Bundles button.
If the Adapter SDK feature was added as described in the previous chapter and the individual libraries required by each adapter are present, the validation does not return any errors and the Adapter Agent can be started by hitting the Debug button.
Once started, the console window shows the current information of the running plugins.Using the Stop icon at the top of it, it can be stopped at any time.
With these steps the Adapter is running within the Eclipse environment but not known or connected to any Hana instance yet. Basically there are three ways to make the agent and adapter known to Hana.
- Execute the create-agent, create adapter etc commands from the SQL console in Hana.
- In the Agent install directory run the \configTool\dpagentconfigtool.exe application. It will talk to the Eclipse Agent via TCP and after connecting to Hana it will issue the required Hana commands for registering the agent and the adapters.
- In the Console run the command "dplogin hostname port username password". This will create/update the agent using the hostname as agent name and install all adapters started.