View a markdown version of this page

Sintaks string koneksi dan opsi untuk driver ODBC - AWS IoT SiteWise
Koneksi proxy

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

Sintaks untuk menentukan opsi string koneksi 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) — Driver yang digunakan dengan ODBC.

    Defaultnya adalah AWS IoT SiteWise.

  • DSN— Nama sumber data (DSN) untuk digunakan untuk mengkonfigurasi koneksi.

    Nilai default-nya NONE.

  • Auth— Mode otentikasi. Ini harus salah satu dari berikut ini:

    • AWS_PROFILE— Gunakan rantai kredensi default.

    • IAM— Gunakan kreden AWS SIAL IAM.

    • AAD— Gunakan penyedia identitas Azure Active Directory (AD).

    • OKTA— Gunakan penyedia identitas Okta.

    Nilai default-nya AWS_PROFILE.

Opsi konfigurasi titik akhir

  • EndpointOverride- Penggantian titik akhir untuk AWS IoT SiteWise layanan. 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 kredensia

  • ProfileName— Nama profil dalam file AWS konfigurasi.

    Nilai default-nya NONE.

AWS Opsi otentikasi IAM

  • UIDatau 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.

  • PWDatau 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.

SAML-based opsi otentikasi untuk Okta

  • IdPHost— Nama host dari IdP yang ditentukan.

    Nilai default-nya NONE.

  • UIDatau 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.

  • PWDatau 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— Okta-provided ID unik yang terkait dengan AWS IoT SiteWise aplikasi. 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 pemanggil.

    Nilai default-nya NONE.

  • IdPARN— Nama Sumber Daya Amazon (ARN) dari penyedia SAML di IAM yang menjelaskan IdP.

    Nilai default-nya NONE.

SAML-based opsi otentikasi untuk Azure Active Directory

  • UIDatau IdPUserName — Nama pengguna untuk akun IdP yang ditentukan..

    Nilai default-nya NONE.

  • PWDatau 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 pemanggil.

    Nilai default-nya NONE.

  • IdPARN— Nama Sumber Daya Amazon (ARN) dari penyedia SAML di IAM yang menjelaskan IdP.

    Nilai default-nya NONE.

AWS Opsi SDK (lanjutan)

  • RequestTimeout- Waktu dalam milidetik dimana AWS SDK menunggu permintaan kueri sebelum waktu habis. Setiap nilai non-positif menonaktifkan batas waktu permintaan.

    Nilai default-nya 3000.

  • ConnectionTimeout- Waktu dalam milidetik dimana 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 upaya coba 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 terbuka secara bersamaan ke AWS IoT SiteWise layanan yang diizinkan. Nilainya harus positif.

    Nilai default-nya 25.

Opsi pencatatan driver ODBC

  • LogLevel— Level log untuk pencatatan driver. Harus salah satu dari:

    • 0 (MATI).

    • 1 (KESALAHAN).

    • 2 (PERINGATAN).

    • 3 (INFORMASI).

    • 4 (DEBUG).

    Defaultnya adalah 1 (ERROR).

    Peringatan: informasi pribadi dapat dicatat oleh pengemudi saat menggunakan mode pencatatan 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

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

SDK Log Level diatur menggunakan variabel lingkunganSW_AWS_LOG_LEVEL. Nilai yang valid adalah:

  • OFF

  • ERROR

  • WARN

  • INFO

  • DEBUG

  • TRACE

  • FATAL

Jika SW_AWS_LOG_LEVEL tidak disetel, level log SDK disetel ke default, yaituWARN.

Menghubungkan melalui proxy

Driver ODBC mendukung koneksi AWS IoT SiteWise melalui proxy. Untuk menggunakan fitur ini, konfigurasikan variabel lingkungan berikut berdasarkan pengaturan proxy Anda:

  • SW_PROXY_HOST— host proxy.

  • SW_PROXY_PORT— Nomor port proxy.

  • SW_PROXY_SCHEME— Skema proxy, baik http atauhttps.

  • 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_TYPEJenis 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.