Connexion à Neptune à l'aide de Java et SPARQL avec la signature Signature Version 4 (RDF4J et Jena)

Cette section vous montre comment vous connecter à Neptune à l'aide de RDF4J ou d'Apache Jena avec l'authentification Signature Version 4.

Prérequis

• Java 8 ou une version ultérieure.

• Apache Maven 3.3 ou version ultérieure.

  Pour plus d'informations sur l'installation de ces logiciels prérequis sur une instance EC2 exécutant Amazon Linux, consultez Prérequis pour Amazon Linux EC2.

• Informations d'identification IAM pour signer les demandes. Pour plus d'informations, consultez Utilisation de la chaîne de fournisseur d'informations d'identification par défaut dans le Manuel du développeur AWS SDK for Java .

  Note

  Si vous utilisez des informations d'identification temporaires, celles-ci expirent après un intervalle spécifique, y compris le jeton de session.

  Vous devez mettre à jour votre jeton de session lorsque vous demandez de nouvelles informations d'identification. Pour plus d'informations, consultez la section Utilisation d'informations d'identification de sécurité temporaires pour demander l'accès aux AWS ressources dans le guide de l'utilisateur IAM.

• Définissez la variable SERVICE_REGION sur l'une des valeurs suivantes, en indiquant la région de votre instance de base de données Neptune :

  • USA Est (Virginie du Nord) : us-east-1

  • USA Est (Ohio) : us-east-2

  • USA Ouest (Californie du Nord) : us-west-1

  • USA Ouest (Oregon) : us-west-2

  • Canada (Centre) : ca-central-1

  • Amérique du Sud (São Paulo) : sa-east-1

  • Europe (Stockholm) : eu-north-1

  • Europe (Irlande) : eu-west-1

  • Europe (Londres) : eu-west-2

  • Europe (Paris) : eu-west-3

  • Europe (Francfort) : eu-central-1

  • Moyen-Orient (Bahreïn) : me-south-1

  • Moyen-Orient (EAU) : me-central-1

  • Israël (Tel Aviv) : il-central-1

  • Afrique (Le Cap) : af-south-1

  • Asie-Pacifique (Hong Kong) : ap-east-1

  • Asie-Pacifique (Tokyo) : ap-northeast-1

  • Asie-Pacifique (Séoul) : ap-northeast-2

  • Asie-Pacifique (Osaka) : ap-northeast-3

  • Asie-Pacifique (Singapour) : ap-southeast-1

  • Asie-Pacifique (Sydney) : ap-southeast-2

  • Asie-Pacifique (Mumbai) : ap-south-1

  • Chine (Beijing) : cn-north-1

  • Chine (Ningxia) : cn-northwest-1

  • AWS GovCloud (US-Ouest) : us-gov-west-1

  • AWS GovCloud (USA Est) : us-gov-east-1

Pour se connecter à Neptune à l'aide de RDF4J ou d'Apache Jena avec la signature Signature Version 4

1. Clonez le référentiel d'échantillons à partir de GitHub.

   git clone https://github.com/aws/amazon-neptune-sparql-java-sigv4.git

2. Accédez au répertoire cloné.

   cd amazon-neptune-sparql-java-sigv4

3. Obtenez la dernière version du projet en vérifiant la branche avec la dernière balise.

   git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

4. Saisissez l'une des commandes suivantes pour compiler et exécuter l'exemple de code.

   Remplacez your-neptune-endpoint par le nom d'hôte ou l'adresse IP de votre instance de base de données Neptune. La valeur par défaut du port est 8182.

   Note

   Consultez la section Connexion aux points de terminaison Amazon Neptune pour découvrir comment trouver le nom d'hôte de votre instance de base de données Neptune.

   Eclipse RDF4J

   Saisissez la commande suivante pour exécuter l'exemple RDF4J.

   mvn compile exec:java \
       -Dexec.mainClass="com.amazonaws.neptune.client.rdf4j.NeptuneRdf4JSigV4Example" \
       -Dexec.args="https://your-neptune-endpoint:port"

   Apache Jena

   Saisissez la commande suivante pour exécuter l'exemple Apache Jena.

   mvn compile exec:java \
       -Dexec.mainClass="com.amazonaws.neptune.client.jena.NeptuneJenaSigV4Example" \
       -Dexec.args="https://your-neptune-endpoint:port"

5. Pour afficher le code source de l'exemple, consultez les exemples du répertoire src/main/java/com/amazonaws/neptune/client/.

Pour utiliser le pilote de signature SigV4 dans votre propre application Java, ajoutez le package Maven amazon-neptune-sigv4-signer à la section <dependencies> de votre fichier pom.xml. Nous vous recommandons d'utiliser les exemples comme point de départ.