Estabelecer conexão com o Neptune Using Java usando Java e SPARQL com assinatura do Signature versão 4 (RDF4J e Jena)

Esta seção mostra como se conectar ao Neptune usando RDF4J ou Apache Jena com autenticação do Signature versão 4.

Pré-requisitos

• Java 8 ou posterior.

• Apache Maven 3.3 ou posterior.

  Para obter informações sobre como instalar esses pré-requisitos em uma instância do EC2 executando o Amazon Linux, consulte Pré-requisitos no Amazon Linux EC2.

• Credenciais do IAM para assinar as solicitações. Para obter mais informações, consulte Using the Default Credential Provider Chain no Guia do desenvolvedor do AWS SDK for Java .

  nota

  Se você estiver usando credenciais temporárias, elas expirarão após um intervalo especificado, incluindo o token de sessão.

  Você deve atualizar o seu token de sessão ao solicitar novas credenciais. Para obter mais informações, consulte Como usar credenciais de segurança temporárias para solicitar acesso a AWS recursos no Guia do usuário do IAM.

• Defina a variável SERVICE_REGION como um dos seguintes, indicando a região da instância de banco de dados do Neptune:

  • Leste dos EUA (Norte da Virgínia): us-east-1

  • Leste dos EUA (Ohio): us-east-2

  • Oeste dos EUA (N. da Califórnia): us-west-1

  • Oeste dos EUA (Oregon): us-west-2

  • Canadá (Central): ca-central-1

  • América do Sul (São Paulo): sa-east-1

  • Europa (Estocolmo): eu-north-1

  • Europa (Irlanda): eu-west-1

  • Europa (Londres): eu-west-2

  • Europa (Paris): eu-west-3

  • Europa (Frankfurt): eu-central-1

  • Oriente Médio (Bahrein): me-south-1

  • Oriente Médio (Emirados Árabes Unidos): me-central-1

  • Israel (Tel Aviv):   il-central-1

  • África (Cidade do Cabo): af-south-1

  • Ásia-Pacífico (Hong Kong): ap-east-1

  • Ásia-Pacífico (Tóquio): ap-northeast-1

  • Ásia-Pacífico (Seul): ap-northeast-2

  • Ásia-Pacífico (Osaka): ap-northeast-3

  • Ásia-Pacífico (Singapura): ap-southeast-1

  • Ásia-Pacífico (Sydney): ap-southeast-2

  • Ásia-Pacífico (Mumbai): ap-south-1

  • China (Pequim): cn-north-1

  • China (Ningxia): cn-northwest-1

  • AWS GovCloud (Oeste dos EUA): us-gov-west-1

  • AWS GovCloud (Leste dos EUA): us-gov-east-1

Como se conectar ao Neptune usando RDF4J ou Apache Jena com a assinatura do Signature 4

1. Clone o repositório de amostra de. GitHub

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

2. Altere no diretório clonado.

   cd amazon-neptune-sparql-java-sigv4

3. Obtenha a versão mais recente do projeto marcando a ramificação com a última tag.

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

4. Digite um dos comandos a seguir para compilar e executar o código de exemplo.

   your-neptune-endpointSubstitua pelo nome do host ou endereço IP da sua instância de banco de dados Neptune. A porta padrão é 8182.

   nota

   Para obter informações sobre como localizar o nome do host da instância de banco de dados do Neptune, consulte a seção Conectar-se a endpoints do Amazon Neptune.

   Eclipse RDF4J

   Digite o seguinte para executar o exemplo RDF4J.

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

   Apache Jena

   Digite o seguinte para executar o Apache Jena de exemplo.

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

5. Para visualizar o código-fonte do exemplo, consulte os exemplos no diretório src/main/java/com/amazonaws/neptune/client/.

Para usar o driver de assinatura SigV4 no seu próprio aplicativo Java, adicione o pacote Maven amazon-neptune-sigv4-signer à seção <dependencies> do pom.xml. Recomendamos que você use os exemplos como um ponto de partida.