

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

# Menggunakan Python untuk terhubung ke instans DB Neptune
<a name="access-graph-gremlin-python"></a>

**penting**  
Memilih versi driver Apache TinkerPop Gremlin yang benar sangat penting untuk kompatibilitas dengan versi mesin Neptunus Anda. Menggunakan versi yang tidak kompatibel dapat mengakibatkan kegagalan koneksi atau perilaku yang tidak terduga. Untuk informasi kompatibilitas versi terperinci, lihat[Mengakses grafik Neptune dengan Gremlin](access-graph-gremlin.md).

Bagian berikut memandu Anda melalui proses berjalannya sampel Python yang menyambungkan ke instans Amazon Neptune DB dan melakukan traversal Gremlin.

Anda harus mengikuti petunjuk ini dari instans Amazon EC2 di virtual private cloud (VPC) yang sama seperti instans DB Neptune Anda.

Sebelum memulai, lakukan hal berikut:
+ Unduh dan pasang Python 3.6 atau yang lebih baru dari [Situs web Python.org](https://www.python.org/downloads/).
+ Pastikan Anda memiliki **pip** diinstal. Jika Anda tidak punya **pip** atau Anda tidak yakin, lihat [Apakah saya perlu menginstal pip?](https://pip.pypa.io/en/stable/installing/#do-i-need-to-install-pip) di dokumentasi **pip**.
+ Jika instalasi Python Anda belum memilikinya, unduh `futures` seperti berikut: `pip install futures`



**Untuk menyambung ke Neptune menggunakan Python**

1. Masukkan hal berikut untuk menginstal paket `gremlinpython`:

   ```
   pip install --user gremlinpython
   ```

1. Buat file bernama `gremlinexample.py`, lalu buka file tersebut dalam editor teks.

1. Salin hal berikut ke dalam file `gremlinexample.py`. Ganti *your-neptune-endpoint* dengan alamat cluster DB Neptunus Anda *your-neptune-port* dan dengan port cluster DB Neptunus Anda (default:8182). 

   Untuk informasi tentang menemukan alamat instans DB Neptune Anda, lihat bagian [Menghubungkan ke Titik Akhir Amazon Neptune.](feature-overview-endpoints.md).

    Contoh di bawah ini menunjukkan bagaimana untuk terhubung dengan Gremlin Python. 

   ```
   import boto3
   import os
   from botocore.auth import SigV4Auth
   from botocore.awsrequest import AWSRequest
   from gremlin_python.driver.driver_remote_connection import DriverRemoteConnection
   from gremlin_python.process.anonymous_traversal import traversal
   
   database_url = "wss://your-neptune-endpoint:your-neptune-port/gremlin"
   
   remoteConn = DriverRemoteConnection(database_url, "g")
   
   g = traversal().withRemote(remoteConn)
   
   print(g.inject(1).toList())
   remoteConn.close()
   ```

1. Masukkan perintah berikut untuk menjalankan sampel:

   ```
   python gremlinexample.py
   ```

   Kueri Gremlin pada akhir contoh ini mengembalikan vertex (`g.V().limit(2)`) dalam daftar. Daftar ini kemudian dicetak dengan fungsi `print` standar Python.
**catatan**  
Bagian akhir dari kueri Gremlin, `toList()`, diperlukan untuk mengirimkan traversal ke server untuk evaluasi. Jika Anda tidak menyertakan metode tersebut atau metode setara lain, kueri tidak diserahkan ke instans DB Neptune.

   Metode berikut mengirimkan kueri ke instans DB Neptune:
   + `toList()`
   + `toSet()`
   + `next()`
   + `nextTraverser()`
   + `iterate()`

   

   Contoh sebelumnya mengembalikan dua vertex pertama dalam grafik menggunakan traversal `g.V().limit(2).toList()`. Untuk mengajukan kueri untuk sesuatu yang lain, ganti dengan traversal Gremlin lain dengan salah satu metode ending yang tepat.

## Autentikasi IAM
<a name="access-graph-gremlin-python-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 petunjuk rinci dan contoh kode untuk menghubungkan dari klien Python, lihat. [Menghubungkan ke database Amazon Neptunus menggunakan otentikasi IAM dengan Python Gremlin](gremlin-python-iam-auth.md)