Untuk kemampuan serupa dengan Amazon Timestream LiveAnalytics, pertimbangkan Amazon Timestream untuk InfluxDB. Ini menawarkan konsumsi data yang disederhanakan dan waktu respons kueri milidetik satu digit untuk analitik waktu nyata. Pelajari lebih lanjut [di sini](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# ODBC
[Driver ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/tree/main) open-source untuk Amazon Timestream LiveAnalytics untuk menyediakan antarmuka relasional SQL ke Timestream LiveAnalytics untuk pengembang dan memungkinkan konektivitas dari alat intelijen bisnis (BI) seperti Power BI Desktop dan Microsoft Excel. Driver Timestream untuk LiveAnalytics ODBC saat ini tersedia di [Windows, macOS dan Linux, dan](https://github.com/awslabs/amazon-timestream-odbc-driver/releases) juga mendukung SSO dengan Okta dan Microsoft Azure Active Directory (AD).
Untuk informasi selengkapnya, lihat [Amazon Timestream untuk dokumentasi driver LiveAnalytics ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/index.md). GitHub
**Topics**
+ [Menyiapkan Timestream untuk driver LiveAnalytics ODBC](ODBC-setup.md)
+ [Sintaks string koneksi dan opsi untuk driver ODBC](ODBC-connecting.md)
+ [Contoh string koneksi untuk Timestream untuk driver LiveAnalytics ODBC](ODBC-connecting-examples.md)
+ [Memecahkan masalah koneksi dengan driver ODBC](ODBC-connecting-troubleshooting.md)
# Menyiapkan Timestream untuk driver LiveAnalytics ODBC
## Mengatur akses ke Timestream untuk LiveAnalytics di akun Anda AWS
Jika Anda belum menyiapkan AWS akun untuk bekerja dengan Timestream LiveAnalytics, ikuti insructions di. [Mengakses Timestream untuk LiveAnalytics](accessing.md)
## Instal driver ODBC di sistem Anda
Unduh penginstal driver Timestream ODBC yang sesuai untuk sistem Anda dari [ GitHubrepositori ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/releases), dan ikuti petunjuk penginstalan yang berlaku untuk sistem Anda:.
+ [Panduan instalasi Windows](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-installation-guide.md)
+ [Panduan penginstalan macOS](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-installation-guide.md)
+ [Panduan instalasi Linux](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-installation-guide.md)
## Siapkan nama sumber data (DSN) untuk driver ODBC
Ikuti petunjuk dalam panduan konfigurasi DSN untuk sistem Anda:
+ [Konfigurasi DSN Windows](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-dsn-configuration.md)
+ [konfigurasi macOS DSN](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-dsn-configuration.md)
+ [Konfigurasi DSN Linux](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-dsn-configuration.md)
## Siapkan aplikasi intelijen bisnis (BI) Anda untuk bekerja dengan driver ODBC
Berikut adalah petunjuk untuk mengatur beberapa aplikasi BI umum untuk bekerja dengan driver ODBC:
+ [Menyiapkan Microsoft Power BI.](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-power-bi.md)
+ [Menyiapkan Microsoft Excel](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-excel.md)
+ [Menyiapkan Tableau](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/tableau.md)
Untuk aplikasi lain
# Sintaks string koneksi dan opsi untuk driver ODBC
Sintaks untuk menentukan opsi koneksi-string untuk driver ODBC adalah sebagai berikut:
```
DRIVER={Amazon Timestream ODBC Driver};(option)=(value);
```
Opsi yang tersedia adalah sebagai berikut:
**Opsi koneksi driver**
+ **`Driver`***(wajib)* — Pengemudi yang digunakan dengan ODBC.
Defaultnya adalah Amazon Timestream.
+ **`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 Timestream untuk layanan. LiveAnalytics Ini adalah opsi lanjutan yang mengesampingkan wilayah. Contoh:
```
query-cell2.timestream.us-east-1.amazonaws.com
```
+ **`Region`**— Wilayah penandatanganan untuk Timestream untuk titik akhir LiveAnalytics layanan.
Nilai default-nya `us-east-1`.
**Opsi penyedia kredensial**
+ **`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 Timestream untuk aplikasi. LiveAnalytics 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 terbuka bersamaan yang diizinkan ke layanan Timestream. 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 Timestream untuk tingkat log driver LiveAnalytics ODBC. Pengaturan yang satu tidak mempengaruhi yang lain.
Tingkat Log SDK diatur menggunakan variabel `TS_AWS_LOG_LEVEL` lingkungan. Nilai yang valid adalah:
+ `OFF`
+ `ERROR`
+ `WARN`
+ `INFO`
+ `DEBUG`
+ `TRACE`
+ `FATAL`
Jika tidak `TS_AWS_LOG_LEVEL` disetel, tingkat log SDK diatur ke default, yaitu`WARN`.
## Menghubungkan melalui proxy
Driver ODBC mendukung koneksi ke Amazon Timestream melalui LiveAnalytics proxy. Untuk menggunakan fitur ini, konfigurasikan variabel lingkungan berikut berdasarkan setelan proxy Anda:
+ **`TS_PROXY_HOST`**— host proxy.
+ **`TS_PROXY_PORT`**— Nomor port proxy.
+ **`TS_PROXY_SCHEME`**— Skema proxy, baik `http` atau`https`.
+ **`TS_PROXY_USER`**— Nama pengguna untuk otentikasi proxy.
+ **`TS_PROXY_PASSWORD`**— Kata sandi pengguna untuk otentikasi proxy.
+ **`TS_PROXY_SSL_CERT_PATH`**— File Sertifikat SSL yang digunakan untuk menghubungkan ke proxy HTTPS.
+ **`TS_PROXY_SSL_CERT_TYPE`**— Jenis sertifikat SSL klien proxy.
+ **`TS_PROXY_SSL_KEY_PATH`**— File kunci pribadi yang digunakan untuk menghubungkan ke proxy HTTPS.
+ **`TS_PROXY_SSL_KEY_TYPE`**— Jenis file kunci pribadi yang digunakan untuk terhubung ke proxy HTTPS.
+ **`TS_PROXY_SSL_KEY_PASSWORD`**— Frasa sandi ke file kunci pribadi yang digunakan untuk terhubung ke proxy HTTPS.
# Contoh string koneksi untuk Timestream untuk driver LiveAnalytics ODBC
## Contoh menghubungkan ke driver ODBC dengan kredensi IAM
```
Driver={Amazon Timestream ODBC Driver};Auth=IAM;AccessKeyId=(your access key ID);secretKey=(your secret key);SessionToken=(your session token);Region=us-east-2;
```
## Contoh menghubungkan ke driver ODBC dengan profil
```
Driver={Amazon Timestream ODBC Driver};ProfileName=(the profile name);region=us-west-2;
```
Pengemudi akan mencoba untuk terhubung menggunakan kredensional yang disediakan di`~/.aws/credentials`, atau jika file ditentukan dalam variabel lingkungan`AWS_SHARED_CREDENTIALS_FILE`, menggunakan kredensional dalam file itu.
## Contoh menghubungkan ke driver ODBC dengan Okta
```
driver={Amazon Timestream ODBC Driver};auth=okta;region=us-west-2;idPHost=(your host at Okta);idPUsername=(your user name);idPPassword=(your password);OktaApplicationID=(your Okta AppId);roleARN=(your role ARN);idPARN=(your Idp ARN);
```
## Contoh menghubungkan ke driver ODBC dengan Azure Active Directory (AAD)
```
driver={Amazon Timestream ODBC Driver};auth=aad;region=us-west-2;idPUsername=(your user name);idPPassword=(your password);aadApplicationID=(your AAD AppId);aadClientSecret=(your AAD client secret);aadTenant=(your AAD tenant);roleARN=(your role ARN);idPARN=(your idP ARN);
```
## Contoh menghubungkan ke driver ODBC dengan titik akhir yang ditentukan dan level log 2 (PERINGATAN)
```
Driver={Amazon Timestream ODBC Driver};Auth=IAM;AccessKeyId=(your access key ID);secretKey=(your secret key);EndpointOverride=ingest.timestream.us-west-2.amazonaws.com;Region=us-east-2;LogLevel=2;
```
# Memecahkan masalah koneksi dengan driver ODBC
**catatan**
Ketika nama pengguna dan kata sandi sudah ditentukan dalam DSN, tidak perlu menentukannya lagi ketika manajer driver ODBC memintanya.
Kode kesalahan `01S02` dengan pesan, `Re-writing (connection string option) (have you specified it several times?` terjadi ketika opsi string koneksi dilewatkan lebih dari sekali dalam string koneksi. Menentukan opsi lebih dari sekali menimbulkan kesalahan. Saat membuat koneksi dengan DSN dan string koneksi, jika opsi koneksi sudah ditentukan dalam DSN, jangan tentukan lagi dalam string koneksi.