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

# Konektor Amazon Athena Vertica
<a name="connectors-vertica"></a>

Vertica adalah platform basis data kolumnar yang dapat digunakan di cloud atau di tempat yang mendukung gudang data skala exabyte. Anda dapat menggunakan konektor Amazon Athena Vertica dalam kueri gabungan untuk mengkueri sumber data Vertica dari Athena. Misalnya, Anda dapat menjalankan kueri analitis atas data warehouse di Vertica dan danau data di Amazon S3.

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

## Prasyarat
<a name="connectors-vertica-prerequisites"></a>
+ Menyebarkan konektor ke Anda Akun AWS menggunakan konsol Athena atau. AWS Serverless Application Repository 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).
+ Siapkan VPC dan grup keamanan sebelum Anda menggunakan konektor ini. Untuk informasi selengkapnya, lihat [Buat VPC untuk konektor atau koneksi sumber data AWS Glue](athena-connectors-vpc-creation.md).

## Batasan
<a name="connectors-vertica-limitations"></a>
+ Karena konektor Athena Vertica membaca file Parket yang diekspor dari Amazon S3, kinerja konektor bisa lambat. Saat Anda menanyakan tabel besar, kami sarankan Anda menggunakan [CREATE TABLE AS (SELECT...)](ctas.md) query dan predikat SQL.
+ Saat ini, karena masalah yang diketahui di Kueri Federasi Athena, konektor menyebabkan Vertica mengekspor semua kolom tabel kueri ke Amazon S3, tetapi hanya kolom yang ditanyakan yang terlihat di hasil di konsol Athena.
+ Menulis operasi DDL tidak didukung.
+ Batas Lambda yang relevan. Untuk informasi selengkapnya, lihat [Kuota Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html) dalam *Panduan Pengembang AWS Lambda *.

## Alur kerja
<a name="connectors-vertica-workflow"></a>

Diagram berikut menunjukkan alur kerja kueri yang menggunakan konektor Vertica.

![Alur kerja kueri Vertica dari Amazon Athena](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/connectors-vertica-1.png)


1. Kueri SQL dikeluarkan terhadap satu atau lebih tabel di Vertica.

1. Konektor mem-parsing query SQL untuk mengirim bagian yang relevan ke Vertica melalui koneksi JDBC.

1. String koneksi menggunakan nama pengguna dan kata sandi yang disimpan AWS Secrets Manager untuk mendapatkan akses ke Vertica.

1. Konektor membungkus query SQL dengan `EXPORT` perintah Vertica, seperti pada contoh berikut.

   ```
   EXPORT TO PARQUET (directory = 's3://amzn-s3-demo-bucket/{{folder_name}}, 
      Compression='Snappy', fileSizeMB=64) OVER() as 
   SELECT
   PATH_ID,
   ...
   SOURCE_ITEMIZED,
   SOURCE_OVERRIDE
   FROM DELETED_OBJECT_SCHEMA.FORM_USAGE_DATA
   WHERE PATH_ID <= 5;
   ```

1. Vertica memproses kueri SQL dan mengirimkan hasil yang disetel ke bucket Amazon S3. Untuk throughput yang lebih baik, Vertica menggunakan `EXPORT` opsi untuk memparalelkan operasi penulisan beberapa file Parket.

1. Athena memindai bucket Amazon S3 untuk menentukan jumlah file yang akan dibaca untuk set hasil.

1. Athena membuat beberapa panggilan ke fungsi Lambda dan menggunakan Apache `ArrowReader` untuk membaca file Parket dari kumpulan data yang dihasilkan. Beberapa panggilan memungkinkan Athena untuk memparalelkan pembacaan file Amazon S3 dan mencapai throughput hingga 100GB per detik.

1. Athena memproses data yang dikembalikan dari Vertica dengan data yang dipindai dari danau data dan mengembalikan hasilnya.

## Istilah
<a name="connectors-vertica-terms"></a>

Istilah-istilah berikut berhubungan dengan konektor Vertica.
+ **Instans database** — Setiap instance dari database Vertica yang digunakan di Amazon EC2.
+ **Handler** - Handler Lambda yang mengakses instance database Anda. Handler bisa untuk metadata atau untuk catatan data.
+ **Metadata handler** — Penangan Lambda yang mengambil metadata dari instance database Anda.
+ **Record handler** - Handler Lambda yang mengambil catatan data dari instance database Anda.
+ **Composite handler** — Handler Lambda yang mengambil data metadata dan data dari instance database Anda.
+ **Properti atau parameter** - Properti database yang digunakan oleh penangan untuk mengekstrak informasi database. Anda mengonfigurasi properti ini sebagai variabel lingkungan Lambda.
+ **Connection String** — Sebuah string teks yang digunakan untuk membuat koneksi ke instance database.
+ **Katalog** —AWS Glue Non-katalog yang terdaftar di Athena yang merupakan awalan yang diperlukan untuk properti. `connection_string`

## Parameter
<a name="connectors-vertica-parameters"></a>

Gunakan parameter di bagian ini untuk mengkonfigurasi konektor Vertica.

### AWS Glue Data Catalog konektor federasi
<a name="connectors-vertica-gc"></a>

Kami menyarankan Anda mengonfigurasi konektor Vertica dengan menggunakan objek koneksi Glue. Untuk melakukan ini, atur variabel `glue_connection` lingkungan dari konektor Vertica Lambda ke nama koneksi Glue yang akan digunakan.

**Properti koneksi lem**

Gunakan perintah berikut untuk mendapatkan skema untuk objek koneksi Glue. Skema ini berisi semua parameter yang dapat Anda gunakan untuk mengontrol koneksi Anda.

```
aws glue describe-connection-type --connection-type VERTICA
```

**Properti lingkungan Lambda**

Properti lingkungan Lambda berikut hanya berlaku ketika Anda menggunakan konektor dengan fungsi Lambda di akun Anda.
+ **glue\_connection** - Menentukan nama koneksi Glue yang terkait dengan konektor federasi. 
+ **casing\_mode** - (Opsional) Menentukan bagaimana menangani casing untuk skema dan nama tabel. `casing_mode`Parameter menggunakan nilai-nilai berikut untuk menentukan perilaku casing:
  + **none** — Jangan mengubah kasus skema dan nama tabel yang diberikan. Ini adalah default untuk konektor yang memiliki koneksi lem terkait. 
  + **atas** — huruf besar semua skema yang diberikan dan nama tabel.
  + **lower** — huruf kecil semua skema dan nama tabel yang diberikan.

**catatan**  
Semua konektor yang menggunakan koneksi AWS Glue Data Catalog federasi harus digunakan AWS Secrets Manager untuk menyimpan kredensil.
Konektor Vertica yang dibuat menggunakan koneksi AWS Glue Data Catalog federasi tidak mendukung penggunaan handler multiplexing.
Konektor Vertica yang dibuat menggunakan koneksi AWS Glue Data Catalog federasi hanya mendukung `ConnectionSchemaVersion` 2.

### Konektor federasi katalog data Athena
<a name="connectors-vertica-legacy"></a>

Konektor Amazon Athena Vertica memperlihatkan opsi konfigurasi melalui variabel lingkungan Lambda. Anda dapat menggunakan variabel lingkungan Lambda berikut untuk mengkonfigurasi konektor. 
+  **AthenaCatalogName**— Nama fungsi Lambda 
+  **ExportBucket**- Bucket Amazon S3 tempat hasil kueri Vertica diekspor. 
+  **SpillBucket**— Nama bucket Amazon S3 tempat fungsi ini dapat menumpahkan data. 
+  **SpillPrefix**— Awalan untuk `SpillBucket` lokasi di mana fungsi ini dapat menumpahkan data. 
+  **SecurityGroupIds**— Satu atau lebih IDs yang sesuai dengan grup keamanan yang harus diterapkan pada fungsi Lambda (misalnya,, `sg1``sg2`, atau`sg3`). 
+  **SubnetIds**— Satu atau lebih subnet IDs yang sesuai dengan subnet yang dapat digunakan fungsi Lambda untuk mengakses sumber data Anda (misalnya,, `subnet1` atau). `subnet2` 
+  **SecretNameOrPrefix**— Nama atau awalan dari satu set nama di Secrets Manager yang fungsi ini memiliki akses ke (misalnya,`vertica-*`) 
+  **VerticaConnectionString**— Detail koneksi Vertica untuk digunakan secara default jika tidak ada koneksi khusus katalog yang ditentukan. String secara opsional dapat menggunakan AWS Secrets Manager sintaks (misalnya,`${secret_name}`). 
+  ID **VPC — ID** VPC yang akan dilampirkan ke fungsi Lambda. 

#### String koneksi
<a name="connectors-vertica-connection-string"></a>

Gunakan string koneksi JDBC dalam format berikut untuk terhubung ke instance database.

```
vertica://jdbc:vertica://{{host_name}}:{{
                        port}}/{{database}}?user={{vertica-username}}&password=
                        {{vertica-password}}
```

#### Menggunakan handler koneksi tunggal
<a name="connectors-vertica-using-a-single-connection-handler"></a>

Anda dapat menggunakan metadata koneksi tunggal berikut dan penangan rekaman untuk terhubung ke satu instance Vertica.


****  

| Jenis handler | Kelas | 
| --- | --- | 
| Handler komposit | VerticaCompositeHandler | 
| Penangan metadata | VerticaMetadataHandler | 
| Rekam handler | VerticaRecordHandler | 

#### Parameter handler koneksi tunggal
<a name="connectors-vertica-single-connection-handler-parameters"></a>


****  

| Parameter | Deskripsi | 
| --- | --- | 
| default | Wajib. String koneksi default. | 

Penangan koneksi tunggal mendukung satu instance database dan harus menyediakan parameter string `default` koneksi. Semua string koneksi lainnya diabaikan.

#### Memberikan kredensi
<a name="connectors-vertica-providing-credentials"></a>

Untuk memberikan nama pengguna dan kata sandi untuk database Anda dalam string koneksi JDBC Anda, Anda dapat menggunakan properti string koneksi atau. AWS Secrets Manager
+ **Connection String** - Nama pengguna dan kata sandi dapat ditentukan sebagai properti dalam string koneksi JDBC.
**penting**  
Sebagai praktik keamanan terbaik, jangan gunakan kredensi hardcode dalam variabel lingkungan atau string koneksi Anda. *Untuk informasi tentang memindahkan rahasia hardcode Anda AWS Secrets Manager, lihat [Memindahkan rahasia hardcode ke AWS Secrets Manager dalam Panduan](https://docs.aws.amazon.com/secretsmanager/latest/userguide/hardcoded.html) Pengguna.AWS Secrets Manager *
+ **AWS Secrets Manager**[— Untuk menggunakan fitur Query Federasi Athena dengan, VPC AWS Secrets Manager yang terhubung ke fungsi Lambda Anda harus memiliki [akses internet atau](https://aws.amazon.com/premiumsupport/knowledge-center/internet-access-lambda-function/) titik akhir VPC untuk terhubung ke Secrets Manager.](https://docs.aws.amazon.com/secretsmanager/latest/userguide/vpc-endpoint-overview.html)

  Anda dapat memasukkan nama rahasia ke AWS Secrets Manager dalam string koneksi JDBC Anda. Konektor menggantikan nama rahasia dengan `password` nilai `username` dan dari Secrets Manager.

  Untuk instans database Amazon RDS, dukungan ini terintegrasi erat. Jika Anda menggunakan Amazon RDS, kami sangat menyarankan penggunaan AWS Secrets Manager dan rotasi kredenal. Jika database Anda tidak menggunakan Amazon RDS, simpan kredensialnya sebagai JSON dalam format berikut:

  ```
  {"username": "${username}", "password": "${password}"}
  ```

**Contoh string koneksi dengan nama rahasia**  
String berikut memiliki nama rahasia $ {`vertica-username`} dan`${vertica-password}`. 

```
vertica://jdbc:vertica://{{
                        host_name}}:{{port}}/{{database}}?user=${vertica-username}&password=${vertica-password}
```

Konektor menggunakan nama rahasia untuk mengambil rahasia dan memberikan nama pengguna dan kata sandi, seperti pada contoh berikut.

```
vertica://jdbc:vertica://{{
                        host_name}}:{{port}}/{{database}}?user=sample-user&password=sample-password
```

Saat ini, konektor Vertica mengenali properti `vertica-username` dan `vertica-password` JDBC. 

#### Parameter tumpahan
<a name="connectors-vertica-spill-parameters"></a>

Lambda SDK dapat menumpahkan data ke Amazon S3. Semua instance database yang diakses oleh fungsi Lambda yang sama tumpah ke lokasi yang sama.


****  

| Parameter | Deskripsi | 
| --- | --- | 
| spill\_bucket | Wajib. Nama ember tumpahan. | 
| spill\_prefix | Wajib. Tumpahkan key prefix bucket. | 
| spill\_put\_request\_headers | (Opsional) Peta header permintaan dan nilai yang disandikan JSON untuk permintaan Amazon S3 yang digunakan untuk menumpahkan (misalnya,). putObject {"x-amz-server-side-encryption" : "AES256"} Untuk kemungkinan header lainnya, lihat [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)di Referensi API Amazon Simple Storage Service. | 

## Dukungan tipe data
<a name="connectors-vertica-data-type-support"></a>

Tabel berikut menunjukkan tipe data yang didukung untuk konektor Vertica.


****  

| Boolean | 
| --- | 
| BigInt | 
| Pendek | 
| Bilangan Bulat | 
| Panjang | 
| Desimal | 
| Ganda | 
| Date | 
| Varchar | 
| Byte | 
| BigDecimal | 
| TimeStamp sebagai Varchar | 

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

Fungsi Lambda melakukan pushdown proyeksi untuk mengurangi data yang dipindai oleh 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 Vertica tahan terhadap pelambatan karena konkurensi.

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

Konektor Vertica mendukung kueri [passthrough](federated-query-passthrough.md). Kueri passthrough menggunakan fungsi tabel untuk mendorong kueri lengkap Anda ke sumber data untuk dieksekusi.

Untuk menggunakan kueri passthrough dengan Vertica, Anda dapat menggunakan sintaks berikut:

```
SELECT * FROM TABLE(
        system.query(
            query => '{{query string}}'
        ))
```

Contoh query berikut mendorong ke bawah query ke sumber data di Vertica. Kueri memilih semua kolom dalam `customer` tabel, membatasi hasilnya menjadi 10.

```
SELECT * FROM TABLE(
        system.query(
            query => 'SELECT * FROM customer LIMIT 10'
        ))
```

## Informasi lisensi
<a name="connectors-vertica-license-information"></a>

Dengan menggunakan konektor ini, Anda mengakui penyertaan komponen pihak ketiga, daftar yang dapat ditemukan dalam file [pom.xml](https://github.com/awslabs/aws-athena-query-federation/blob/master/athena-vertica/pom.xml) untuk konektor ini, dan menyetujui persyaratan dalam masing-masing lisensi pihak ketiga yang disediakan dalam file [LICENSE.txt](https://github.com/awslabs/aws-athena-query-federation/blob/master/athena-vertica/LICENSE.txt) di .com. GitHub

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

Untuk informasi versi driver JDBC terbaru, lihat file [pom.xml](https://github.com/awslabs/aws-athena-query-federation/blob/master/athena-vertica/pom.xml) untuk konektor Vertica di.com. GitHub

*Untuk informasi tambahan tentang konektor ini, lihat [situs terkait](https://github.com/awslabs/aws-athena-query-federation/tree/master/athena-vertica) GitHub di.com dan [Menanyakan sumber data Vertica di Amazon Athena menggunakan Athena Federated Query](https://aws.amazon.com/blogs/big-data/querying-a-vertica-data-source-in-amazon-athena-using-the-athena-federated-query-sdk/) SDK di Blog Big Data.AWS *