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

# Konektor Amazon Athena Neptunus
<a name="connectors-neptune"></a>

Amazon Neptune adalah layanan basis data grafik yang cepat, andal, terkelola penuh yang memudahkan membangun dan menjalankan aplikasi yang bekerja dengan set data yang sangat terhubung. Neptunus yang dibuat khusus, mesin basis data grafik berperforma tinggi menyimpan miliaran hubungan secara optimal dan grafik kueri dengan latensi hanya milidetik. Untuk informasi selengkapnya, lihat [ Panduan Pengguna Neptune](https://docs.aws.amazon.com/neptune/latest/userguide/intro.html).

Konektor Amazon Athena Neptune memungkinkan Athena untuk berkomunikasi dengan contoh basis data grafik Neptune Anda, membuat data grafik Neptune Anda dapat diakses oleh kueri SQL.

Konektor ini tidak menggunakan Glue Connections untuk memusatkan properti konfigurasi di Glue. Konfigurasi koneksi dilakukan melalui Lambda.

Jika Anda mengaktifkan Lake Formation di akun Anda, peran IAM untuk konektor Lambda federasi Athena yang Anda gunakan harus memiliki akses baca di AWS Serverless Application Repository Lake Formation ke. AWS Glue Data Catalog

## Prasyarat
<a name="connectors-neptune-prerequisites"></a>

Menggunakan konektor Neptunus membutuhkan tiga langkah berikut.
+ Menyiapkan cluster Neptunus
+ Menyiapkan sebuah AWS Glue Data Catalog
+ Menyebarkan konektor ke Anda Akun AWS. Untuk informasi selengkapnya, lihat [Buat koneksi sumber data](connect-to-a-data-source.md) atau [Gunakan AWS Serverless Application Repository untuk menyebarkan konektor sumber data](connect-data-source-serverless-app-repo.md). Untuk detail tambahan khusus tentang penerapan konektor Neptunus, lihat [Menerapkan Konektor Neptunus Amazon Athena di.com](https://github.com/awslabs/aws-athena-query-federation/tree/master/athena-neptune/docs/neptune-connector-setup). GitHub

## Batasan
<a name="connectors-neptune-limitations"></a>

Saat ini, Konektor Neptunus memiliki batasan berikut.
+ Memproyeksikan kolom, termasuk kunci utama (ID), tidak didukung. 

## Menyiapkan cluster Neptunus
<a name="connectors-neptune-setting-up-a-neptune-cluster"></a>

Jika Anda tidak memiliki cluster Amazon Neptunus dan kumpulan data grafik properti di dalamnya yang ingin Anda gunakan, Anda harus mengaturnya.

Pastikan Anda memiliki gateway internet dan gateway NAT di VPC yang menampung cluster Neptunus Anda. Subnet pribadi yang digunakan oleh fungsi Lambda konektor Neptunus harus memiliki rute ke internet melalui NAT Gateway ini. Fungsi Lambda konektor Neptunus menggunakan NAT Gateway untuk berkomunikasi dengannya. AWS Glue

Untuk petunjuk cara menyiapkan kluster Neptunus baru dan memuatnya dengan kumpulan data sampel, lihat Contoh Pengaturan Kluster [Neptunus](https://github.com/awslabs/aws-athena-query-federation/tree/master/athena-neptune/docs/neptune-cluster-setup) di.com. GitHub

## Menyiapkan sebuah AWS Glue Data Catalog
<a name="connectors-neptune-setting-up-an-aws-glue-data-catalog"></a>

Tidak seperti penyimpanan data relasional tradisional, node dan tepi DB grafik Neptunus tidak menggunakan skema yang ditetapkan. Setiap entri dapat memiliki bidang dan tipe data yang berbeda. Namun, karena konektor Neptunus mengambil metadata dari, Anda harus membuat database AWS Glue Data Catalog yang memiliki tabel AWS Glue dengan skema yang diperlukan. Setelah Anda membuat AWS Glue database dan tabel, konektor dapat mengisi daftar tabel yang tersedia untuk kueri dari Athena.

### Mengaktifkan pencocokan kolom case insensitive
<a name="connectors-neptune-glue-case-insensitive-column-matching"></a>

Untuk menyelesaikan nama kolom dari tabel Neptunus Anda dengan casing yang benar bahkan ketika nama kolom semuanya lebih rendah, Anda dapat mengonfigurasi konektor Neptunus untuk AWS Glue pencocokan yang tidak peka huruf besar/kecil.

Untuk mengaktifkan fitur ini, atur variabel lingkungan fungsi konektor Neptunus Lambda ke. `enable_caseinsensitivematch` `true` 

### Menentukan parameter tabel AWS Glue glabel untuk nama tabel cased
<a name="connectors-neptune-glue-glabel-parameter-for-table-names"></a>

Karena hanya AWS Glue mendukung nama tabel huruf kecil, penting untuk menentukan parameter `glabel` AWS Glue tabel saat Anda membuat tabel untuk Neptunus dan nama AWS Glue tabel Neptunus Anda menyertakan casing. 

Dalam definisi AWS Glue tabel Anda, sertakan `glabel` parameter dan atur nilainya ke nama tabel Anda dengan casing aslinya. Ini memastikan bahwa casing yang benar dipertahankan saat AWS Glue berinteraksi dengan tabel Neptunus Anda. Contoh berikut menetapkan nilai `glabel` untuk nama tabel`Airport`.

```
glabel = Airport
```

![\[Mengatur properti glabel AWS Glue tabel untuk mempertahankan casing nama tabel untuk tabel Neptunus\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/connectors-neptune-1.png)


Untuk informasi selengkapnya tentang pengaturan AWS Glue Data Catalog untuk bekerja dengan Neptunus, [lihat AWS Glue Mengatur](https://github.com/awslabs/aws-athena-query-federation/tree/master/athena-neptune/docs/aws-glue-sample-scripts) Katalog di.com. GitHub

## Performa
<a name="connectors-neptune-performance"></a>

Konektor Athena Neptunus melakukan pushdown predikat untuk mengurangi data yang dipindai oleh kueri. Namun, predikat yang menggunakan kunci utama mengakibatkan kegagalan kueri. `LIMIT`klausa mengurangi jumlah data yang dipindai, tetapi jika Anda tidak memberikan predikat, Anda harus mengharapkan `SELECT` kueri dengan `LIMIT` klausa untuk memindai setidaknya 16 MB data. Konektor Neptunus tahan terhadap pelambatan karena konkurensi.

## Kueri passthrough
<a name="connectors-neptune-passthrough-queries"></a>

[Konektor Neptunus mendukung kueri passthrough.](federated-query-passthrough.md) Anda dapat menggunakan fitur ini untuk menjalankan kueri Gremlin pada grafik properti dan menjalankan kueri SPARQL pada data RDF.

Untuk membuat kueri passthrough dengan Neptunus, gunakan sintaks berikut:

```
SELECT * FROM TABLE(
        system.query(
            DATABASE => 'database_name',
            COLLECTION => 'collection_name',
            QUERY => 'query_string'
        ))
```

Berikut contoh filter query passthrough Neptunus untuk bandara dengan kode. `ATL` Kutipan tunggal berlipat ganda adalah untuk melarikan diri.

```
SELECT * FROM TABLE(
        system.query(
            DATABASE => 'graph-database',
            COLLECTION => 'airport',
            QUERY => 'g.V().has(''airport'', ''code'', ''ATL'').valueMap()' 
        ))
```

## Sumber daya tambahan
<a name="connectors-neptune-additional-resources"></a>

Untuk informasi tambahan tentang konektor ini, kunjungi [situs terkait](https://github.com/awslabs/aws-athena-query-federation/tree/master/athena-neptune) GitHub di.com.