

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mengatur konsol Gremlin agar terhubung ke instans DB Neptune
<a name="access-graph-gremlin-console"></a>

Konsol Gremlin memungkinkan Anda bereksperimen dengan TinkerPop grafik dan kueri di lingkungan REPL (loop). read-eval-print 

## Menginstal konsol Gremlin dan menghubungkannya dengan cara biasa
<a name="access-graph-gremlin-console-usual-connect"></a>

Anda dapat menggunakan Konsol Gremlin untuk terhubung ke basis data grafik jarak jauh. Bagian berikut memandu Anda melalui penginstalan dan konfigurasi Konsol Gremlin untuk menghubungkan ke instans DB Neptune secara jarak jauh. Anda harus mengikuti petunjuk ini dari instans Amazon EC2 di virtual private cloud (VPC) yang sama seperti instans DB Neptune Anda.

Untuk bantuan menghubungkan ke Neptunus SSL/TLS dengan (yang diperlukan), lihat. [Konfigurasi SSL/TLS](access-graph-gremlin-java.md#access-graph-gremlin-java-ssl)

**catatan**  
Jika [autentikasi IAM diaktifkan](iam-auth-enable.md) di cluster DB Neptunus Anda, ikuti petunjuk [Menghubungkan ke database Amazon Neptunus menggunakan otentikasi IAM dengan konsol Gremlin](iam-auth-connecting-gremlin-console.md) untuk menginstal konsol Gremlin daripada instruksi di sini.

**Untuk memasang Konsol Gremlin dan menyambung ke Neptune**

1. Biner Konsol Gremlin memerlukan Java 8 atau Java 11. Instruksi ini mengasumsikan penggunaan Java 11. Anda dapat menginstal Java 11 pada instans EC2 Anda sebagai berikut:
   + Jika Anda menggunakan [Amazon Linux 2 (AL2)](https://aws.amazon.com/amazon-linux-2):

     ```
     sudo amazon-linux-extras install java-openjdk11
     ```
   + Jika Anda menggunakan [Amazon Linux 2023 (AL2023)](https://docs.aws.amazon.com/linux/al2023/ug/what-is-amazon-linux.html):

     ```
     sudo yum install java-11-amazon-corretto-devel
     ```
   + Untuk distribusi lain, gunakan salah satu dari berikut ini yang sesuai:

     ```
     sudo yum install java-11-openjdk-devel
     ```

     atau:

     ```
     sudo apt-get install openjdk-11-jdk
     ```

1. Masukkan yang berikut ini untuk mengatur Java 11 sebagai runtime default pada instans EC2 Anda.

   ```
   sudo /usr/sbin/alternatives --config java
   ```

   Saat diminta, masukkan nomor untuk Java 11.

1. Unduh versi Konsol Gremlin yang sesuai dari situs web Apache. Anda dapat memeriksa versi Gremlin mana yang didukung versi Neptunus Anda. [Mengakses grafik Neptune dengan Gremlin](access-graph-gremlin.md) Misalnya, jika Anda memerlukan versi 3.7.2, Anda dapat mengunduh [konsol Gremlin](https://archive.apache.org/dist/tinkerpop/3.7.2/apache-tinkerpop-gremlin-console-3.7.2-bin.zip) dari situs web [Apache Tinkerpop](https://tinkerpop.apache.org/download.html) ke instans EC2 Anda seperti ini:

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

1. Unzip file Konsol Gremlin.

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

1. Ubah direktori ke dalam direktori yang di-unzip.

   ```
   cd apache-tinkerpop-gremlin-console-3.7.2
   ```

1. Di sudirektori `conf` dari direktori yang diekstrak, buat sebuah file bernama `neptune-remote.yaml` dengan teks berikut. Ganti *your-neptune-endpoint* dengan nama host atau alamat IP instans DB Neptunus Anda. Tanda kurung persegi (`[ ]`) wajib diisi.
**catatan**  
Untuk informasi tentang menemukan nama host instans DB Neptune Anda, lihat bagian [Menghubungkan ke Titik Akhir Amazon Neptune.](feature-overview-endpoints.md).

   ```
   hosts: [your-neptune-endpoint]
   port: 8182
   connectionPool: { enableSsl: true }
   serializer: { className: org.apache.tinkerpop.gremlin.util.ser.GraphBinaryMessageSerializerV1,
                 config: { serializeResultToString: true }}
   ```
**catatan**  
 Serializer dipindahkan dari `gremlin-driver` modul ke `gremlin-util` modul baru di versi 3.7.0. Paket diubah dari org.apache.tinkerpop.gremlin.driver.ser menjadi org.apache.tinkerpop.gremlin.util.ser. 

1. Di terminal, bernavigasilah ke direktori Konsol Gremlin (`apache-tinkerpop-gremlin-console-3.7.2`), lalu masukkan perintah berikut untuk menjalankan Konsol Gremlin.

   ```
   bin/gremlin.sh
   ```

   Anda akan melihat output berikut:

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

   Anda sekarang berada di prompt `gremlin>`. Anda akan memasukkan langkah-langkah yang tersisa pada prompt ini.

1. Di prompt `gremlin>`, masukkan hal berikut untuk menyambung ke instans DB Neptune.

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

1. Di prompt `gremlin>`, masukkan hal berikut ini untuk beralih ke mode jarak jauh. Ini mengirimkan semua kueri Gremlin ke koneksi remote.

   ```
   :remote console
   ```

1. Masukkan hal berikut untuk mengirim kueri ke Gremlin Graph.

   ```
   g.V().limit(1)
   ```

1. Setelah Anda selesai, masukkan hal berikut untuk keluar dari Konsol Gremlin.

   ```
   :exit
   ```

**catatan**  
Gunakan titik koma (`;`) atau karakter baris baru (`\n`) untuk memisahkan setiap pernyataan.   
Setiap traversal sebelum traversal akhir harus diakhiri dengan `next()` yang akan dieksekusi. Hanya data dari traversal akhir yang dikembalikan.

Untuk informasi lebih lanjut tentang implementasi Neptune dari Gremlin, lihat [Kepatuhan standar Gremlin di Amazon Neptune](access-graph-gremlin-differences.md).

## Autentikasi IAM
<a name="access-graph-gremlin-console-iam"></a>

Neptunus [mendukung otentikasi IAM](iam-auth-enable.md) untuk mengontrol akses ke cluster DB Anda. Jika autentikasi IAM diaktifkan, Anda harus menggunakan penandatanganan Signature Version 4 untuk mengautentikasi permintaan Anda. Untuk instruksi terperinci dan contoh kode untuk menghubungkan dari konsol Gremlin, lihat. [Menghubungkan ke database Amazon Neptunus menggunakan otentikasi IAM dengan konsol Gremlin](iam-auth-connecting-gremlin-console.md)