Configurar o console do Gremlin para conectar-se a uma instância de banco de dados do Neptune

Como instalar o console do Gremlin e se conectar ao Neptune

1. Os binários do console do Gremlin exigem o Java 8 ou 11. Essas instruções pressupõem o uso do Java 11. Você pode instalar o Java 11 na instância do EC2 da seguinte forma:

   • Se você estiver usando o Amazon Linux 2 (AL2):

     sudo amazon-linux-extras install java-openjdk11

   • Se você estiver usando o Amazon Linux 2023 (AL2023):

     sudo yum install java-11-amazon-corretto-devel

   • Para outras distribuições, use qualquer uma das seguintes opções que seja apropriada:

     sudo yum install java-11-openjdk-devel

     ou:

     sudo apt-get install openjdk-11-jdk

2. Insira o seguinte para definir o Java 11 como o runtime padrão na instância do EC2.

   sudo /usr/sbin/alternatives --config java

   Quando solicitado, insira o número do Java 11.

3. Baixe a versão apropriada do Gremlin Console no site do Apache. Você pode verificar e Acessar o grafo do Neptune com o Gremlin determinar qual versão do Gremlin sua versão do Neptune suporta. Por exemplo, se você precisar da versão 3.7.2, poderá baixar o console Gremlin do site do Apache Tinkerpop para sua instância do EC2 da seguinte forma:

   wget https://archive.apache.org/dist/tinkerpop/3.7.2/apache-tinkerpop-gremlin-console-3.7.2-bin.zip

4. Descompacte o arquivo zip do Gremlin Console.

   unzip apache-tinkerpop-gremlin-console-3.7.2-bin.zip

5. Altere os diretórios para o diretório descompactado.

   cd apache-tinkerpop-gremlin-console-3.7.2

6. No subdiretório conf do diretório extraído, crie um arquivo chamado neptune-remote.yaml com o seguinte texto. your-neptune-endpointSubstitua pelo nome do host ou endereço IP da sua instância de banco de dados Neptune. Os colchetes ([ ]) são necessários.

   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.

   hosts: [your-neptune-endpoint]
   port: 8182
   connectionPool: { enableSsl: true }
   serializer: { className: org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1,
                 config: { serializeResultToString: true }}

   nota

   Os serializadores foram movidos do módulo gremlin-driver para o novo módulo gremlin-util na versão 3.7.0. O pacote mudou de org.apache.tinkerpop.gremlin.driver.ser para org.apache.tinkerpop.gremlin.util.ser.

7. Em um terminal, navegue até o diretório do Gremlin Console (apache-tinkerpop-gremlin-console-3.7.2) e, em seguida, insira o comando a seguir para executar o Gremlin Console.

   bin/gremlin.sh

   A seguinte saída deverá ser mostrada:

            \,,,/
            (o o)
   -----oOOo-(3)-oOOo-----
   plugin activated: tinkerpop.server
   plugin activated: tinkerpop.utilities
   plugin activated: tinkerpop.tinkergraph
   gremlin> 

   Agora você está no prompt do gremlin>. Você inserirá as etapas restantes nesse prompt.

8. No prompt gremlin>, insira o seguinte para conectar-se a instâncias de banco de dados do Neptune.

   :remote connect tinkerpop.server conf/neptune-remote.yaml

9. No prompt gremlin>, insira o seguinte para alternar para modo remoto. Isso envia todas as consultas do Gremlin para a conexão remota.

   :remote console

10. Insira o seguinte para enviar uma consulta para o Gremlin Graph.

    g.V().limit(1)

11. Ao terminar, insira o seguinte para sair do Gremlin Console.

    :exit