

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

# Sintaks string koneksi dan opsi untuk driver ODBC
<a name="query-ODBC-connecting"></a>

Sintaks untuk menentukan opsi koneksi-string untuk driver ODBC adalah sebagai berikut:

```
Driver={AWS IoT SiteWise ODBC Driver};(option)=(value);
```

Opsi yang tersedia adalah sebagai berikut:

**Opsi koneksi driver**
+ **`Driver`***(wajib)* — Pengemudi yang digunakan dengan ODBC.

  Defaultnya adalah AWS IoT SiteWise.
+ **`DSN`**— Nama sumber data (DSN) yang digunakan untuk mengkonfigurasi koneksi.

  Nilai default-nya `NONE`.
+ **`Auth`**— Mode otentikasi. Ini harus salah satu dari yang berikut:
  + `AWS_PROFILE`— Gunakan rantai kredensi default.
  + `IAM`— Gunakan kredensi AWS IAM.
  + `AAD`— Gunakan penyedia identitas Azure Active Directory (AD).
  + `OKTA`— Gunakan penyedia identitas Okta.

  Nilai default-nya `AWS_PROFILE`.

**Opsi konfigurasi titik akhir**
+ **`EndpointOverride`**— Pengesampingan titik akhir untuk layanan. AWS IoT SiteWise Ini adalah opsi lanjutan yang mengesampingkan wilayah. Contoh:

  ```
  iotsitewise.us-east-1.amazonaws.com
  ```
+ **`Region`**— Wilayah penandatanganan untuk titik akhir AWS IoT SiteWise layanan.

  Nilai default-nya `us-east-1`.

**Opsi penyedia kredensil**
+ **`ProfileName`**— Nama profil dalam file AWS konfigurasi.

  Nilai default-nya `NONE`.

**AWS Opsi otentikasi IAM**
+ **`UID`**atau **`AccessKeyId`**— Id kunci akses AWS pengguna. Jika keduanya `UID` dan `AccessKeyId` disediakan dalam string koneksi, `UID` nilainya akan digunakan kecuali kosong.

  Nilai default-nya `NONE`.
+ **`PWD`**atau **`SecretKey`**— Kunci akses rahasia pengguna AWS. Jika keduanya `PWD` dan `SecretKey` disediakan dalam string koneksi, `PWD` nilai dengan akan digunakan kecuali kosong.

  Nilai default-nya `NONE`.
+ **`SessionToken`**— Token sesi sementara yang diperlukan untuk mengakses database dengan otentikasi multi-faktor (MFA) diaktifkan. Jangan sertakan trailing ` = ` dalam input.

  Nilai default-nya `NONE`.

**Opsi otentikasi berbasis SAML untuk Okta**
+ **`IdPHost`**— Nama host dari iDP yang ditentukan.

  Nilai default-nya `NONE`.
+ **`UID`**atau **`IdPUserName`**— Nama pengguna untuk akun iDP yang ditentukan. Jika keduanya `UID` dan `IdPUserName` disediakan dalam string koneksi, `UID` nilainya akan digunakan kecuali kosong.

  Nilai default-nya `NONE`.
+ **`PWD`**atau **`IdPPassword`**— Kata sandi untuk akun iDP yang ditentukan. Jika keduanya `PWD` dan `IdPPassword` disediakan dalam string koneksi, `PWD` nilainya akan digunakan kecuali kosong.

  Nilai default-nya `NONE`.
+ **`OktaApplicationID`**— ID unik yang disediakan OKTA yang terkait dengan aplikasi. AWS IoT SiteWise Tempat untuk menemukan ID aplikasi (AppId) ada di `entityID` bidang yang disediakan dalam metadata aplikasi. Contohnya adalah:

  ```
  entityID="http://www.okta.com//(IdPAppID)
  ```

  Nilai default-nya `NONE`.
+ **`RoleARN`**— Nama Sumber Daya Amazon (ARN) dari peran yang diasumsikan oleh penelepon.

  Nilai default-nya `NONE`.
+ **`IdPARN`**— Nama Sumber Daya Amazon (ARN) dari penyedia SAMP di IAM yang menggambarkan IDP.

  Nilai default-nya `NONE`.

**Opsi otentikasi berbasis SAMP untuk Azure Active Directory**
+ **`UID`**atau **`IdPUserName`**— Nama pengguna untuk akun iDP yang ditentukan..

  Nilai default-nya `NONE`.
+ **`PWD`**atau **`IdPPassword`**— Kata sandi untuk akun iDP yang ditentukan.

  Nilai default-nya `NONE`.
+ **`AADApplicationID`**— Id unik dari aplikasi terdaftar di Azure AD.

  Nilai default-nya `NONE`.
+ **`AADClientSecret`**— Rahasia klien yang terkait dengan aplikasi terdaftar di Azure AD digunakan untuk mengotorisasi pengambilan token.

  Nilai default-nya `NONE`.
+ **`AADTenant`**— ID Penyewa Azure AD.

  Nilai default-nya `NONE`.
+ **`RoleARN`**— Nama Sumber Daya Amazon (ARN) dari peran yang diasumsikan oleh penelepon.

  Nilai default-nya `NONE`.
+ **`IdPARN`**— Nama Sumber Daya Amazon (ARN) dari penyedia SAMP di IAM yang menggambarkan IDP.

  Nilai default-nya `NONE`.

**AWS Opsi SDK (lanjutan)**
+ **`RequestTimeout`**— Waktu dalam milidetik AWS SDK menunggu permintaan kueri sebelum waktu habis. Setiap nilai non-positif menonaktifkan batas waktu permintaan.

  Nilai default-nya `3000`.
+ **`ConnectionTimeout`**— Waktu dalam milidetik AWS SDK menunggu data ditransfer melalui koneksi terbuka sebelum waktu habis. Nilai 0 menonaktifkan batas waktu koneksi. Nilai ini tidak boleh negatif.

  Nilai default-nya `1000`.
+ **`MaxRetryCountClient`**— Jumlah maksimum percobaan ulang untuk kesalahan yang dapat dicoba ulang dengan kode kesalahan 5xx di SDK. Nilainya tidak boleh negatif.

  Nilai default-nya `0`.
+ **`MaxConnections`**— Jumlah maksimum koneksi HTTP yang diizinkan secara bersamaan terbuka ke AWS IoT SiteWise layanan. Nilainya harus positif.

  Nilai default-nya `25`.

**Opsi pencatatan driver ODBC**
+ **`LogLevel`**— Tingkat log untuk logging driver. Harus menjadi salah satu dari:
  + **0** (MATI).
  + **1** (KESALAHAN).
  + **2** (PERINGATAN).
  + **3** (INFO).
  + **4** (DEBUG).

  Defaultnya adalah `1` (ERROR).

  **Peringatan:** informasi pribadi dapat dicatat oleh pengemudi saat menggunakan mode logging DEBUG.
+ **`LogOutput`**— Folder tempat menyimpan file log.

  Defaultnya adalah:
  + **Windows:**`%USERPROFILE%`, atau jika tidak tersedia,`%HOMEDRIVE%%HOMEPATH%`.
  + **macOS dan Linux:**`$HOME`, atau jika tidak tersedia, bidang `pw_dir` dari fungsi `getpwuid(getuid())` mengembalikan nilai.

**Opsi pencatatan SDK**

Level log AWS SDK terpisah dari level log driver AWS IoT SiteWise ODBC. Pengaturan yang satu tidak mempengaruhi yang lain.

Tingkat Log SDK diatur menggunakan variabel `SW_AWS_LOG_LEVEL` lingkungan. Nilai yang valid adalah:
+ `OFF`
+ `ERROR`
+ `WARN`
+ `INFO`
+ `DEBUG`
+ `TRACE`
+ `FATAL`

Jika tidak `SW_AWS_LOG_LEVEL` disetel, tingkat log SDK diatur ke default, yaitu`WARN`.

## Menghubungkan melalui proxy
<a name="query-ODBC-connecting-proxy"></a>

Driver ODBC mendukung koneksi ke AWS IoT SiteWise melalui proxy. Untuk menggunakan fitur ini, konfigurasikan variabel lingkungan berikut berdasarkan setelan proxy Anda:
+ **`SW_PROXY_HOST`**— host proxy.
+ **`SW_PROXY_PORT`**— Nomor port proxy.
+ **`SW_PROXY_SCHEME`**— Skema proxy, baik `http` atau`https`.
+ **`SW_PROXY_USER`**— Nama pengguna untuk otentikasi proxy.
+ **`SW_PROXY_PASSWORD`**— Kata sandi pengguna untuk otentikasi proxy.
+ **`SW_PROXY_SSL_CERT_PATH`**— File Sertifikat SSL yang digunakan untuk menghubungkan ke proxy HTTPS.
+ **`SW_PROXY_SSL_CERT_TYPE`**— Jenis sertifikat SSL klien proxy.
+ **`SW_PROXY_SSL_KEY_PATH`**— File kunci pribadi yang digunakan untuk menghubungkan ke proxy HTTPS.
+ **`SW_PROXY_SSL_KEY_TYPE`**— Jenis file kunci pribadi yang digunakan untuk terhubung ke proxy HTTPS.
+ **`SW_PROXY_SSL_KEY_PASSWORD`**— Frasa sandi ke file kunci pribadi yang digunakan untuk terhubung ke proxy HTTPS.