Before proceeding, ensure you have configured your environment.
Download the latest version of DBeaver to use the Driver in DBeaver.
-
Download the Neptune JDBC driver
JAR
file and note the directory it is saved/located in. -
Launch the DBeaver application.
-
Navigate to Database > Driver Manager and click New to add a new Driver.
-
Under the
Libraries
tab, click Add File and add theJAR
file. -
Click
Find Class
to populate theDriver class
in the dropdown menu. -
Fill out the fields on the right with a
Driver Name
,Class Name
, andURL Template
.Class Name
should match theDriver class
in theLibraries
tab. -
The
Default Port
for Neptune is 8182, but this can be left blank if it is in theURL Template
. CheckNo authentication
andAllow Empty Password
as desired.
Example for connecting to an instance without IAM authentication:
Example for connecting to an instance with IAM authentication. Note that your AWS credentials must be configured.
- If connecting from outside the Neptune cluster's VPC, ensure you have followed the configuration instructions.
- Navigate to Database > New Database Connection.
- Select the Neptune driver that was added in the previous steps.
- Click
Finish
to complete setup.
DBeaver has the ability to configure the SSH tunnel within the application.
-
Navigate to Database > New Database Connection.
-
Select the Neptune driver that was added in the previous steps.
-
Navigate to the SSH tab and fill out the fields. Fill out the HOST/IP, User Name, and select Public Key as the Authentication Method. A Private key is required. The configuration instructions mentioned above can provide more context for why this is required. Under Advanced settings the Local host and Local port if following the above instructions should be your localhost and the port used for Neptune. The Remote host and Remote port should be the Neptune URL and port.
- Click
Test tunnel configuration
to validate the SSH tunnel, and thenFinish
to complete setup.
- Click