Amazon Neptune Neptune-Konnektivität JDBC

Amazon Neptune hat einen JDBCOpen-Source-Treiber veröffentlicht, der GremlinopenCypher, -Gremlin und Abfragen unterstützt. SQL SPARQL JDBCKonnektivität macht es einfach, mit Business Intelligence (BI) -Tools wie Tableau eine Verbindung zu Neptune herzustellen. Für die Nutzung des JDBC Treibers mit Neptune fallen keine zusätzlichen Kosten an — Sie zahlen immer noch nur für die verbrauchten Neptun-Ressourcen.

Der Treiber ist mit JDBC 4.2 kompatibel und benötigt mindestens Java 8. Informationen zur Verwendung eines JDBC Treibers finden Sie in der JDBCAPIDokumentation.

Das GitHub Projekt, in dem Sie Probleme einreichen und Funktionsanfragen öffnen können, enthält eine ausführliche Dokumentation für den Treiber:

JDBCTreiber für Amazon Neptune

• Verwendung SQL mit dem Treiber JDBC

• Gremlin mit dem Treiber verwenden JDBC

• Mit dem Treiber verwenden openCypher JDBC

• Verwendung SPARQL mit dem JDBC Treiber

Erste Schritte mit dem Neptune-Treiber JDBC

Um den JDBC Neptune-Treiber für die Verbindung mit einer Neptune-Instance zu verwenden, muss der JDBC Treiber entweder auf einer EC2 Amazon-Instance in derselben Weise VPC wie Ihr Neptune-DB-Cluster bereitgestellt werden, oder die Instance muss über einen Tunnel oder Load Balancer verfügbar sein. SSH Ein SSH Tunnel kann intern oder extern im Treiber eingerichtet werden.

Sie können den Treiber hier herunterladen. Der Treiber wird als einzelne JAR Datei mit einem Namen wie geliefertneptune-jdbc-1.0.0-all.jar. Um ihn zu verwenden, platzieren Sie die JAR Datei in classpath Ihrer Anwendung. Oder, wenn Ihre Anwendung Maven oder Gradle verwendet, können Sie die entsprechenden Maven- oder Gradle-Befehle verwenden, um den Treiber von zu installieren. JAR

Der Treiber benötigt eine JDBC VerbindungURL, um eine Verbindung mit Neptune herzustellen, und zwar in einer Form wie dieser:

jdbc:neptune:(connection type)://(host);property=value;property=value;...;property=value

In den Abschnitten für jede Abfragesprache im GitHub Projekt werden die Eigenschaften beschrieben, die Sie in der JDBC Verbindung URL für diese Abfragesprache festlegen können.

Wenn sich die JAR Datei in Ihrer Anwendung befindetclasspath, ist keine weitere Konfiguration erforderlich. Sie können den Treiber über die JDBC DriverManager Schnittstelle und eine Neptune-Verbindungszeichenfolge verbinden. Wenn Ihr Neptune-DB-Cluster beispielsweise über den Endpunkt neptune-example.com auf Port 8182 zugänglich ist, könnten Sie sich wie folgt verbinden openCypher :

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.Statement;

void example() {
    String url = "jdbc:neptune:opencypher://bolt://neptune-example:8182";

    Connection connection = DriverManager.getConnection(url);
    Statement statement = connection.createStatement();

    connection.close();
}

In den Dokumentationsabschnitten des GitHub Projekts für jede Abfragesprache wird beschrieben, wie die Verbindungszeichenfolge erstellt wird, wenn diese Abfragesprache verwendet wird.

Verwenden von Tableau mit dem Neptune-Treiber JDBC

Um Tableau mit dem JDBC Neptune-Treiber zu verwenden, laden Sie zunächst die neueste Version von Tableau Desktop herunter und installieren Sie sie. Laden Sie die JAR Datei für den JDBC Neptune-Treiber und auch die Neptune Tableau-Connector-Datei (eine Datei) herunter. .taco

Herstellen einer Verbindung zu Tableau for Neptune auf einem Mac-Computer

1. Platzieren Sie die JDBC JAR Neptune-Treiberdatei in dem /Users/(your user name)/Library/Tableau/Drivers Ordner.

2. Platzieren Sie die Neptune-Tableau-Connector-Datei .taco im Ordner /Users/(your user name)/Documents/My Tableau Repository/Connectors.

3. Wenn Sie die IAM Authentifizierung aktiviert haben, richten Sie die Umgebung dafür ein. Beachten Sie, dass Umgebungsvariablen, die in .zprofile/, .zshenv/, .bash_profile usw. festgelegt sind, nicht funktionieren. Die Umgebungsvariablen müssen so eingestellt sein, dass sie von einer GUI Anwendung geladen werden können.

   Eine Möglichkeit für die Einrichtung Ihrer Anmeldeinformationen besteht darin, Ihren Zugriffsschlüssel und Geheimschlüssel in der Datei /Users/(your user name)/.aws/credentials zu platzieren.

   Eine einfache Möglichkeit für die Einrichtung der Serviceregion besteht in der Öffnung eines Terminals und der Eingabe des folgenden Befehls unter Verwendung der Region Ihrer Anwendung (z. B. us-east-1):

   launchctl setenv SERVICE_REGION region name

   Es gibt andere Möglichkeiten, Umgebungsvariablen festzulegen, die nach einem Neustart bestehen bleiben. Unabhängig davon, welche Methode Sie verwenden, müssen jedoch Variablen gesetzt werden, auf die eine GUI Anwendung zugreifen kann.

4. Um Umgebungsvariablen in eine GUI auf dem Mac zu laden, geben Sie diesen Befehl auf einem Terminal ein:

   /Applications/Tableau/Desktop/2021.1.app/Contents/MacOS/Tableau

Herstellen einer Verbindung zu Tableau for Neptune auf einem Windows-Computer

1. Platzieren Sie die JDBC JAR Neptune-Treiberdatei in dem C:\Program Files\Tableau\Drivers Ordner.

2. Platzieren Sie die Neptune-Tableau-Connector-Datei .taco im Ordner C:\Users\(your user name)\Documents\My Tableau Repository\Connectors.

3. Wenn Sie die IAM Authentifizierung aktiviert haben, richten Sie die Umgebung dafür ein.

   Dies kann so einfach wie die Einrichtung wie das Einstellen von der Umgebungsvariablen ACCESS_KEY, SECRET_KEY und SERVICE_REGION für Benutzer.

Wählen Sie bei geöffnetem Tableau links im Fenster Mehr aus. Wenn die Tableau-Connector-Datei richtig gefunden wurde, können Sie Amazon Neptune auswählen, indem Sie AWSin der Liste, die angezeigt wird:

Sie sollten den Port nicht bearbeiten oder Verbindungsoptionen hinzufügen müssen. Geben Sie Ihren Neptune-Endpunkt ein und legen Sie Ihre IAM SSL Konfiguration fest (Sie müssen sie aktivieren, SSL wenn Sie verwendenIAM).

Wenn Sie Anmelden auswählen, kann es länger als 30 Sekunden dauern, bis die Verbindung hergestellt ist, wenn Ihr Diagramm groß ist. Tableau sammelt Eckpunkt- und Kantentabellen, verbindet Eckpunkte an Kanten und erstellt Visualisierungen.

Fehlerbehebung bei einer Treiberverbindung JDBC

Wenn der Treiber keine Verbindung zum Server herstellen kann, überprüfen Sie isValid anhand der Funktion des JDBC Connection Objekts, ob die Verbindung gültig ist. Wenn die Funktion zurückkehrtfalse, was bedeutet, dass die Verbindung ungültig ist, überprüfen Sie, ob der Endpunkt, mit dem Sie verbunden sind, korrekt ist und ob Sie sich in Ihrem Neptune-DB-Cluster befinden oder ob Sie einen gültigen SSH Tunnel zum Cluster haben. VPC

Wenn Sie die Antwort No suitable driver found for (connection string) für den Aufruf DriverManager.getConnection erhalten, liegt wahrscheinlich ein Problem zu Beginn der Verbindungszeichenfolge vor. Stellen Sie sicher, dass die Verbindungszeichenfolge wie folgt beginnt:

jdbc:neptune:opencypher://...

Um weitere Informationen zur Verbindung zu erhalten, können Sie der Verbindungszeichenfolge wie folgt ein LogLevel hinzufügen:

jdbc:neptune:opencypher://(JDBC URL):(port);logLevel=trace

Alternativ können Sie in Ihren Eingabeeigenschaften properties.put("logLevel", "trace") hinzufügen, um Ablaufverfolgungsinformationen zu protokollieren.