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

# Konektor Amazon Athena Azure Synapse
<a name="connectors-azure-synapse"></a>

Konektor Amazon Athena untuk analitik [Azure Synapse memungkinkan Amazon](https://docs.microsoft.com/en-us/azure/synapse-analytics/overview-what-is) Athena menjalankan kueri SQL pada database Azure Synapse Anda menggunakan JDBC.

Konektor ini dapat didaftarkan dengan Glue Data Catalog sebagai katalog federasi. Ini mendukung kontrol akses data yang didefinisikan dalam Lake Formation di katalog, database, tabel, kolom, baris, dan tingkat tag. Konektor ini menggunakan Glue Connections untuk memusatkan properti konfigurasi di Glue.

## Prasyarat
<a name="connectors-synapse-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).

## Batasan
<a name="connectors-azure-synapse-limitations"></a>
+ Menulis operasi DDL tidak didukung.
+ Dalam pengaturan multiplexer, bucket tumpahan dan awalan dibagikan di semua instance database.
+ 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 *.
+ Dalam kondisi filter, Anda harus mentransmisikan tipe `Date` dan `Timestamp` data ke tipe data yang sesuai.
+ Untuk mencari nilai negatif dari jenis `Real` dan`Float`, gunakan `>=` operator `<=` atau.
+ Tipe `rowversion` data `binary` `varbinary``image`,, dan tidak didukung.

## Ketentuan
<a name="connectors-azure-synapse-terms"></a>

Istilah-istilah berikut berhubungan dengan konektor Synapse.
+ **Instans database** — Instance apa pun dari database yang digunakan di tempat, di Amazon EC2, atau di Amazon RDS.
+ **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`
+ **Multiplexing handler** - Handler Lambda yang dapat menerima dan menggunakan beberapa koneksi database.

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

Gunakan parameter di bagian ini untuk mengkonfigurasi konektor Synapse.

**catatan**  
Konektor sumber data Athena dibuat pada 3 Desember 2024 dan kemudian menggunakan koneksi. AWS Glue   
Nama parameter dan definisi yang tercantum di bawah ini adalah untuk konektor sumber data Athena yang dibuat sebelum 3 Desember 2024. Ini dapat berbeda dari [properti AWS Glue koneksi](https://docs.aws.amazon.com/glue/latest/dg/connection-properties.html) yang sesuai. Mulai 3 Desember 2024, gunakan parameter di bawah ini hanya jika Anda [menggunakan konektor sumber data Athena versi sebelumnya secara manual](connect-data-source-serverless-app-repo.md).

### Koneksi lem (disarankan)
<a name="connectors-azure-synapse-gc"></a>

Kami menyarankan Anda mengkonfigurasi konektor Synapse dengan menggunakan objek koneksi Glue. Untuk melakukan ini, atur variabel `glue_connection` lingkungan dari konektor Synapse 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 SYNAPSE
```

**Properti lingkungan Lambda**
+ **glue\$1connection** - Menentukan nama koneksi Glue yang terkait dengan konektor federasi. 
+ **casing\$1mode** - (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 Glue harus digunakan AWS Secrets Manager untuk menyimpan kredensil.
Konektor Synapse yang dibuat menggunakan koneksi Glue tidak mendukung penggunaan handler multiplexing.
Konektor Synapse yang dibuat menggunakan koneksi Glue hanya mendukung `ConnectionSchemaVersion` 2.

### Koneksi lama (disarankan)
<a name="connectors-azure-synapse-legacy"></a>

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

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

```
synapse://${jdbc_connection_string}
```

#### Menggunakan handler multiplexing
<a name="connectors-azure-synapse-using-a-multiplexing-handler"></a>

Anda dapat menggunakan multiplexer untuk terhubung ke beberapa instance database dengan satu fungsi Lambda. Permintaan dirutekan dengan nama katalog. Gunakan kelas berikut di Lambda.


****  

| Handler | Kelas | 
| --- | --- | 
| Pawang komposit | SynapseMuxCompositeHandler | 
| Penangan metadata | SynapseMuxMetadataHandler | 
| Rekam handler | SynapseMuxRecordHandler | 

##### Parameter handler multiplexing
<a name="connectors-azure-synapse-multiplexing-handler-parameters"></a>


****  

| Parameter | Deskripsi | 
| --- | --- | 
| \$1catalog\$1connection\$1string | Wajib. Sebuah string koneksi instance database. Awalan variabel lingkungan dengan nama katalog yang digunakan di Athena. Misalnya, jika katalog terdaftar di Athena adalahmysynapsecatalog, maka nama variabel lingkungan adalah. mysynapsecatalog\$1connection\$1string | 
| default | Wajib. String koneksi default. String ini digunakan saat katalognya lambda:\$1\$1 AWS\$1LAMBDA\$1FUNCTION\$1NAME\$1. | 

Contoh properti berikut adalah untuk fungsi Synapse MUX Lambda yang mendukung dua instance database`synapse1`: (default), dan. `synapse2`


****  

| Properti | Nilai | 
| --- | --- | 
| default | synapse://jdbc:synapse://synapse1.hostname:port;databaseName=<database\$1name>;\$1\$1secret1\$1name\$1 | 
| synapse\$1catalog1\$1connection\$1string | synapse://jdbc:synapse://synapse1.hostname:port;databaseName=<database\$1name>;\$1\$1secret1\$1name\$1 | 
| synapse\$1catalog2\$1connection\$1string | synapse://jdbc:synapse://synapse2.hostname:port;databaseName=<database\$1name>;\$1\$1secret2\$1name\$1 | 

##### Memberikan kredensi
<a name="connectors-azure-synapse-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 \$1 \$1secret\$1name\$1.

```
synapse://jdbc:synapse://hostname:port;databaseName=<database_name>;${secret_name}
```

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

```
synapse://jdbc:synapse://hostname:port;databaseName=<database_name>;user=<user>;password=<password>
```

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

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


****  

| Jenis handler | Kelas | 
| --- | --- | 
| Pawang komposit | SynapseCompositeHandler | 
| Penangan metadata | SynapseMetadataHandler | 
| Rekam handler | SynapseRecordHandler | 

##### Parameter handler koneksi tunggal
<a name="connectors-azure-synapse-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.

Properti contoh berikut adalah untuk instance Synapse tunggal yang didukung oleh fungsi Lambda.


****  

| Properti | Nilai | 
| --- | --- | 
| default | synapse://jdbc:sqlserver://hostname:port;databaseName=<database\$1name>;\$1\$1secret\$1name\$1 | 

#### Mengkonfigurasi otentikasi Direktori Aktif
<a name="connectors-azure-synapse-configuring-active-directory-authentication"></a>

Konektor Amazon Athena Azure Synapse mendukung Otentikasi Direktori Aktif Microsoft. Sebelum Anda mulai, Anda harus mengkonfigurasi pengguna administratif di portal Microsoft Azure dan kemudian gunakan AWS Secrets Manager untuk membuat rahasia.

**Untuk mengatur pengguna administratif Direktori Aktif**

1. [Menggunakan akun yang memiliki hak administratif, masuk ke portal Microsoft Azure dihttps://portal.azure.com/.](https://portal.azure.com/)

1. Di kotak pencarian, masukkan **Azure Synapse Analytics, lalu pilih **Azure** Synapse Analytics**.  
![\[Pilih Azure Synapse Analytics.\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/connectors-azure-synapse-1.png)

1. Buka menu di sebelah kiri.  
![\[Pilih menu portal Azure.\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/connectors-azure-synapse-2.png)

1. Di panel navigasi, pilih **Azure Active** Directory.

1. Pada tab **Set admin**, atur **admin Active Directory** ke pengguna baru atau yang sudah ada.  
![\[Gunakan tab Set admin\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/connectors-azure-synapse-3.png)

1. Di AWS Secrets Manager, simpan nama pengguna admin dan kredenal kata sandi. Untuk informasi tentang cara membuat rahasia di Secrets Manager, lihat [Membuat AWS Secrets Manager rahasia](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html).

**Untuk melihat rahasia Anda di Secrets Manager**

1. Buka konsol Secrets Manager di [https://console.aws.amazon.com/secretsmanager/](https://console.aws.amazon.com/secretsmanager/).

1. Di panel navigasi, pilih **Rahasia**.

1. Pada halaman **Rahasia**, pilih tautan ke rahasia Anda.

1. Pada halaman detail untuk rahasia Anda, pilih **Ambil nilai rahasia**.  
![\[Melihat rahasia di AWS Secrets Manager.\]](http://docs.aws.amazon.com/id_id/athena/latest/ug/images/connectors-azure-synapse-4.png)

##### Memodifikasi string koneksi
<a name="connectors-azure-synapse-modifying-the-connection-string"></a>

Untuk mengaktifkan Otentikasi Direktori Aktif untuk konektor, ubah string koneksi menggunakan sintaks berikut:

```
synapse://jdbc:synapse://hostname:port;databaseName=database_name;authentication=ActiveDirectoryPassword;{secret_name}
```

##### Menggunakan ActiveDirectoryServicePrincipal
<a name="connectors-azure-synapse-using-activedirectoryserviceprincipal"></a>

Konektor Amazon Athena Azure Synapse juga mendukung. `ActiveDirectoryServicePrincipal` Untuk mengaktifkan ini, ubah string koneksi sebagai berikut.

```
synapse://jdbc:synapse://hostname:port;databaseName=database_name;authentication=ActiveDirectoryServicePrincipal;{secret_name}
```

Untuk`secret_name`, tentukan aplikasi atau ID klien sebagai nama pengguna dan rahasia identitas utama layanan dalam kata sandi.

#### Parameter tumpahan
<a name="connectors-azure-synapse-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\$1bucket | Wajib. Nama ember tumpahan. | 
| spill\$1prefix | Wajib. Tumpahkan key prefix bucket. | 
| spill\$1put\$1request\$1headers | (Opsional) Peta header permintaan dan nilai yang disandikan JSON untuk permintaan Amazon S3 yang digunakan untuk menumpahkan (misalnya,). putObject \$1"x-amz-server-side-encryption" : "AES256"\$1 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-azure-synapse-data-type-support"></a>

Tabel berikut menunjukkan tipe data yang sesuai untuk Synapse dan Apache Arrow.


****  

| Sinaps | Panah | 
| --- | --- | 
| bit | TINYINT | 
| tinyint | SMALLINT | 
| smallint | SMALLINT | 
| int | INT | 
| bigint | BIGINT | 
| desimal | DECIMAL | 
| numerik | FLOAT8 | 
| uang kecil | FLOAT8 | 
| money | DECIMAL | 
| mengapung [24] | FLOAT4 | 
| mengapung [53] | FLOAT8 | 
| real | FLOAT4 | 
| datetime | Tanggal (MILLISECOND) | 
| tanggal2 | Tanggal (MILLISECOND) | 
| smalldatetime | Tanggal (MILLISECOND) | 
| date | Tanggal (HARI) | 
| Waktu | VARCHAR | 
| datetimeoffset | Tanggal (MILLISECOND) | 
| arang [n] | VARCHAR | 
| varchar [n/maks] | VARCHAR | 
| nchar [n] | VARCHAR | 
| nvarchar [n/max] | VARCHAR | 

## Partisi dan split
<a name="connectors-azure-synapse-partitions-and-splits"></a>

Partisi diwakili oleh kolom partisi tunggal tipe`varchar`. Synapse mendukung partisi rentang, sehingga partisi diimplementasikan dengan mengekstrak kolom partisi dan rentang partisi dari tabel metadata Synapse. Nilai rentang ini digunakan untuk membuat split.

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

Memilih subset kolom secara signifikan memperlambat runtime kueri. Konektor menunjukkan pelambatan yang signifikan karena konkurensi.

Konektor Athena Synapse melakukan pushdown predikat untuk mengurangi data yang dipindai oleh kueri. Predikat sederhana dan ekspresi kompleks didorong ke konektor untuk mengurangi jumlah data yang dipindai dan mengurangi waktu eksekusi kueri.

### Predikat
<a name="connectors-synapse-performance-predicates"></a>

Predikat adalah ekspresi dalam `WHERE` klausa kueri SQL yang mengevaluasi nilai Boolean dan menyaring baris berdasarkan beberapa kondisi. Konektor Athena Synapse dapat menggabungkan ekspresi ini dan mendorongnya langsung ke Synapse untuk meningkatkan fungsionalitas dan untuk mengurangi jumlah data yang dipindai.

Operator konektor Athena Synapse berikut mendukung pushdown predikat:
+ **Boolean:** DAN, ATAU, TIDAK
+ **KESETARAAN: SAMA, NOT\$1EQUAL**, LESS\$1THAN, LESS\$1THAN\$1OR\$1EQUAL, GREATER\$1THAN, GREATER\$1THAN\$1OR\$1EQUAL, NULL\$1IF, IS\$1NULL
+ **Aritmatika:** TAMBAHKAN, KURANGI, KALIKAN, BAGI, MODULUS, MENIADAKAN
+ **Lainnya:** LIKE\$1PATTERN, IN

### Contoh pushdown gabungan
<a name="connectors-synapse-performance-pushdown-example"></a>

Untuk kemampuan kueri yang ditingkatkan, gabungkan jenis pushdown, seperti pada contoh berikut:

```
SELECT * 
FROM my_table 
WHERE col_a > 10 
    AND ((col_a + col_b) > (col_c % col_d)) 
    AND (col_e IN ('val1', 'val2', 'val3') OR col_f LIKE '%pattern%');
```

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

Konektor Synapse 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 Synapse, Anda dapat menggunakan sintaks berikut:

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

Contoh query berikut mendorong ke bawah query ke sumber data di Synapse. 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-synapse-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-synapse/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-synapse/LICENSE.txt) di .com. GitHub

## Sumber daya tambahan
<a name="connectors-synapse-additional-resources"></a>
+ *Untuk artikel yang menunjukkan cara menggunakan Quick dan Amazon Athena Federated Query untuk membuat dasbor dan visualisasi pada data yang disimpan dalam database Microsoft Azure Synapse, lihat Melakukan [analitik multi-cloud menggunakan Quick, Amazon Athena Federated Query,](https://aws.amazon.com/blogs/business-intelligence/perform-multi-cloud-analytics-using-amazon-quicksight-amazon-athena-federated-query-and-microsoft-azure-synapse/) dan Microsoft Azure Synapse di Blog Big Data.AWS *
+ Untuk informasi versi driver JDBC terbaru, lihat file [pom.xml](https://github.com/awslabs/aws-athena-query-federation/blob/master/athena-synapse/pom.xml) untuk konektor Synapse di.com. GitHub
+ Untuk informasi tambahan tentang konektor ini, kunjungi [situs terkait](https://github.com/awslabs/aws-athena-query-federation/tree/master/athena-synapse) GitHub di.com.