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. # Mengakses Timestream untuk LiveAnalytics Anda dapat mengakses Timestream untuk LiveAnalytics menggunakan konsol, CLI atau API. Untuk informasi tentang mengakses Timestream LiveAnalytics, tinjau hal-hal berikut: **Topics** + [Mendaftar untuk Akun AWS](#sign-up-for-aws) + [Buat pengguna dengan akses administratif](#create-an-admin) + [Menyediakan Timestream untuk akses LiveAnalytics](#getting-started.prereqs.iam-user) + [Memberikan akses programatis](#programmatic-access) + [Menggunakan konsol](console_timestream.md) + [Mengakses Amazon Timestream LiveAnalytics untuk menggunakan AWS CLI](Tools.CLI.md) + [Menggunakan API](Using.API.md) + [Menggunakan AWS SDKs](getting-started-sdks.md) ## Mendaftar untuk Akun AWS Jika Anda tidak memiliki Akun AWS, selesaikan langkah-langkah berikut untuk membuatnya. **Untuk mendaftar untuk Akun AWS** 1. Buka [https://portal.aws.amazon.com/billing/pendaftaran.](https://portal.aws.amazon.com/billing/signup) 1. Ikuti petunjuk online. Bagian dari prosedur pendaftaran melibatkan menerima panggilan telepon atau pesan teks dan memasukkan kode verifikasi pada keypad telepon. Saat Anda mendaftar untuk sebuah Akun AWS, sebuah *Pengguna root akun AWS*dibuat. Pengguna root memiliki akses ke semua Layanan AWS dan sumber daya di akun. Sebagai praktik keamanan terbaik, tetapkan akses administratif ke pengguna, dan gunakan hanya pengguna root untuk melakukan [tugas yang memerlukan akses pengguna root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks). AWS mengirimi Anda email konfirmasi setelah proses pendaftaran selesai. Kapan saja, Anda dapat melihat aktivitas akun Anda saat ini dan mengelola akun Anda dengan masuk [https://aws.amazon.com.rproxy.goskope.comke/](https://aws.amazon.com/) dan memilih **Akun Saya**. ## Buat pengguna dengan akses administratif Setelah Anda mendaftar Akun AWS, amankan Pengguna root akun AWS, aktifkan AWS IAM Identity Center, dan buat pengguna administratif sehingga Anda tidak menggunakan pengguna root untuk tugas sehari-hari. **Amankan Anda Pengguna root akun AWS** 1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/)sebagai pemilik akun dengan memilih **pengguna Root** dan memasukkan alamat Akun AWS email Anda. Di laman berikutnya, masukkan kata sandi. Untuk bantuan masuk dengan menggunakan pengguna root, lihat [Masuk sebagai pengguna root](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) di *AWS Sign-In Panduan Pengguna*. 1. Mengaktifkan autentikasi multi-faktor (MFA) untuk pengguna root Anda. Untuk petunjuk, lihat [Mengaktifkan perangkat MFA virtual untuk pengguna Akun AWS root (konsol) Anda](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) di Panduan Pengguna *IAM*. **Buat pengguna dengan akses administratif** 1. Aktifkan Pusat Identitas IAM. Untuk mendapatkan petunjuk, silakan lihat [Mengaktifkan AWS IAM Identity Center](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-set-up-for-idc.html) di *Panduan Pengguna AWS IAM Identity Center *. 1. Di Pusat Identitas IAM, berikan akses administratif ke pengguna. Untuk tutorial tentang menggunakan Direktori Pusat Identitas IAM sebagai sumber identitas Anda, lihat [Mengkonfigurasi akses pengguna dengan default Direktori Pusat Identitas IAM](https://docs.aws.amazon.com//singlesignon/latest/userguide/quick-start-default-idc.html) di *Panduan AWS IAM Identity Center Pengguna*. **Masuk sebagai pengguna dengan akses administratif** + Untuk masuk dengan pengguna Pusat Identitas IAM, gunakan URL masuk yang dikirim ke alamat email saat Anda membuat pengguna Pusat Identitas IAM. Untuk bantuan masuk menggunakan pengguna Pusat Identitas IAM, lihat [Masuk ke portal AWS akses](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html) di *Panduan AWS Sign-In Pengguna*. **Tetapkan akses ke pengguna tambahan** 1. Di Pusat Identitas IAM, buat set izin yang mengikuti praktik terbaik menerapkan izin hak istimewa paling sedikit. Untuk petunjuknya, lihat [Membuat set izin](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-started-create-a-permission-set.html) di *Panduan AWS IAM Identity Center Pengguna*. 1. Tetapkan pengguna ke grup, lalu tetapkan akses masuk tunggal ke grup. Untuk petunjuk, lihat [Menambahkan grup](https://docs.aws.amazon.com//singlesignon/latest/userguide/addgroups.html) di *Panduan AWS IAM Identity Center Pengguna*. ## Menyediakan Timestream untuk akses LiveAnalytics Izin yang diperlukan untuk mengakses Timestream untuk LiveAnalytics sudah diberikan kepada administrator. Untuk pengguna lain, Anda harus memberi mereka Timestream untuk LiveAnalytics akses menggunakan kebijakan berikut: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "timestream:*", "kms:DescribeKey", "kms:CreateGrant", "kms:Decrypt", "dbqms:CreateFavoriteQuery", "dbqms:DescribeFavoriteQueries", "dbqms:UpdateFavoriteQuery", "dbqms:DeleteFavoriteQueries", "dbqms:GetQueryString", "dbqms:CreateQueryHistory", "dbqms:UpdateQueryHistory", "dbqms:DeleteQueryHistory", "dbqms:DescribeQueryHistory", "s3:ListAllMyBuckets" ], "Resource": "*" } ] } ``` ------ **catatan** Untuk selengkapnya`dbqms`, lihat [Tindakan, sumber daya, dan kunci kondisi untuk Layanan Metadata Kueri Database](https://docs.aws.amazon.com/service-authorization/latest/reference/list_databasequerymetadataservice.html). Untuk selengkapnya, `kms` lihat [Kunci tindakan, sumber daya, dan kondisi untuk Layanan Manajemen AWS Kunci](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awskeymanagementservice.html). ## Memberikan akses programatis Pengguna membutuhkan akses terprogram jika mereka ingin berinteraksi dengan AWS luar. Konsol Manajemen AWS Cara untuk memberikan akses terprogram tergantung pada jenis pengguna yang mengakses AWS. Untuk memberi pengguna akses programatis, pilih salah satu opsi berikut. **** | Pengguna mana yang membutuhkan akses programatis? | Untuk | Oleh | | --- | --- | --- | | IAM | (Disarankan) Gunakan kredenal konsol sebagai kredensil sementara untuk menandatangani permintaan terprogram ke,, atau. AWS CLI AWS SDKs AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/timestream/latest/developerguide/accessing.html) | | Identitas tenaga kerja (Pengguna yang dikelola di Pusat Identitas IAM) | Gunakan kredensi sementara untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/timestream/latest/developerguide/accessing.html) | | IAM | Gunakan kredensi sementara untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk dalam [Menggunakan kredensil sementara dengan AWS sumber daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) di Panduan Pengguna IAM. | | IAM | (Tidak direkomendasikan)Gunakan kredensi jangka panjang untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/timestream/latest/developerguide/accessing.html) | # Menggunakan konsol Anda dapat menggunakan AWS Management Console untuk Timestream Live Analytics untuk membuat, mengedit, menghapus, mendeskripsikan, dan mencantumkan database dan tabel. Anda juga dapat menggunakan konsol untuk menjalankan kueri. **Topics** + [Tutorial](#console_timestream.db-w-sample-data) + [Buat database](#console_timestream.db.using-console) + [Membuat tabel](#console_timestream.table.using-console) + [Jalankankueri](#console_timestream.queries.using-console) + [Buat kueri terjadwal](#console_timestream.scheduledquery.using-console) + [Hapus kueri terjadwal](#console_timestream.scheduledquerydeletedisable.using-console) + [Menghapus tabel](#console_timestream.delete-table.using-console) + [Hapus database](#console_timestream.delete-db.using-console) + [Mengedit tabel](#console_timestream.edit-table.using-console) + [Mengedit database](#console_timestream.edit-db.using-console) ## Tutorial Tutorial ini menunjukkan cara membuat database yang diisi dengan kumpulan data sampel dan menjalankan query sampel. Contoh dataset yang digunakan dalam tutorial ini sering terlihat di IoT dan skenario. DevOps Dataset IoT berisi data deret waktu seperti kecepatan, lokasi, dan beban truk, untuk merampingkan manajemen armada dan mengidentifikasi peluang pengoptimalan. DevOps Dataset berisi metrik instans EC2 seperti CPU, jaringan, dan pemanfaatan memori untuk meningkatkan kinerja dan ketersediaan aplikasi. Berikut adalah [video tutorial](https://www.youtube.com/watch?v=YBWCGDd4ChQ) untuk petunjuk yang dijelaskan di bagian ini Ikuti langkah-langkah ini untuk membuat database yang diisi dengan kumpulan data sampel dan menjalankan kueri sampel menggunakan AWS Konsol. 1. Buka [AWS Konsol](https://console.aws.amazon.com/timestream). 1. **Di panel navigasi, pilih Databases** 1. Klik **Buat database**. 1. Pada halaman buat database, masukkan yang berikut ini: + **Pilih konfigurasi** —Pilih **database Sampel**. + **Nama** —Masukkan nama database pilihan Anda. + **Pilih kumpulan data sampel —Pilih** **IoT** dan. **DevOps** + Klik **Buat database untuk membuat database** yang berisi dua tabel—IoT dan DevOps diisi dengan data sampel. 1. Di panel navigasi, pilih Editor **kueri** 1. Pilih **Contoh kueri** dari menu atas. 1. Klik salah satu contoh kueri. Ini akan membawa Anda kembali ke editor kueri dengan editor diisi dengan kueri sampel. 1. Klik **Jalankan** untuk menjalankan kueri dan melihat hasil kueri. ## Buat database Ikuti langkah-langkah ini untuk membuat database menggunakan AWS Konsol. 1. Buka [AWS Konsol](https://console.aws.amazon.com/timestream). 1. **Di panel navigasi, pilih Databases** 1. Klik **Buat database**. 1. Pada halaman buat database, masukkan yang berikut ini. + **Pilih konfigurasi** —Pilih **Database standar**. + **Nama** —Masukkan nama database pilihan Anda. + **Enkripsi** —Pilih kunci KMS atau gunakan opsi default, di mana Timestream Live Analytics akan membuat kunci KMS di akun Anda jika belum ada. 1. Klik **Buat database** untuk membuat database. ## Membuat tabel Ikuti langkah-langkah ini untuk membuat tabel menggunakan AWS Konsol. 1. Buka [AWS Konsol](https://console.aws.amazon.com/timestream). 1. **Di panel navigasi, pilih Tabel** 1. Klik **Buat tabel**. 1. Pada halaman buat tabel, masukkan yang berikut ini. + **Nama database** —Pilih nama database yang dibuat di[Buat database](#console_timestream.db.using-console). + **Nama tabel** —Masukkan nama tabel pilihan Anda. + **Penyimpanan penyimpanan memori** —Tentukan berapa lama Anda ingin menyimpan data di penyimpanan memori. Penyimpanan memori memproses data yang masuk, termasuk data yang datang terlambat (data dengan stempel waktu lebih awal dari waktu saat ini) dan dioptimalkan untuk kueri cepat. point-in-time + **Retensi penyimpanan magnetik** —Tentukan berapa lama Anda ingin menyimpan data di penyimpanan magnetik. Penyimpanan magnetik dimaksudkan untuk penyimpanan jangka panjang dan dioptimalkan untuk kueri analitik cepat. 1. Klik **Buat tabel**. ## Jalankankueri Ikuti langkah-langkah ini untuk menjalankan kueri menggunakan AWS Konsol. 1. Buka [AWS Konsol](https://console.aws.amazon.com/timestream). 1. Di panel navigasi, pilih Editor **kueri** 1. Di panel kiri, pilih database yang dibuat di[Buat database](#console_timestream.db.using-console). 1. Di panel kiri, pilih database yang dibuat di[Membuat tabel](#console_timestream.table.using-console). 1. Di editor kueri, Anda dapat menjalankan kueri. Untuk melihat 10 baris terbaru dalam tabel, jalankan: ``` SELECT * FROM . ORDER BY time DESC LIMIT 10 ``` 1. (Opsional) **Aktifkan Aktifkan Wawasan** untuk mendapatkan wawasan tentang efisiensi kueri Anda. ## Buat kueri terjadwal Ikuti langkah-langkah ini untuk membuat kueri terjadwal menggunakan AWS Konsol. 1. Buka [AWS Konsol](https://console.aws.amazon.com/timestream). 1. Di panel navigasi, pilih **Kueri terjadwal**. 1. Klik **Buat kueri terjadwal**. 1. Di bagian **Nama Kueri** dan **Tabel Tujuan**, masukkan yang berikut ini. + **Nama** —Masukkan nama kueri. + **Nama database** —Pilih nama database yang dibuat di[Buat database](#console_timestream.db.using-console). + **Nama tabel** —Pilih nama tabel yang dibuat di[Membuat tabel](#console_timestream.table.using-console). 1. Di bagian **Pernyataan Kueri**, masukkan pernyataan kueri yang valid. Kemudian klik **Validasi kueri**. 1. Dari **model tabel Tujuan**, tentukan model untuk atribut yang tidak ditentukan. Anda dapat menggunakan **Visual Builder** atau JSON. 1. Di bagian **Jalankan jadwal**, pilih **Tingkat tetap** atau ekspresi **Chron. Untuk ekspresi** chron, lihat Ekspresi [Jadwal untuk Kueri Terjadwal untuk detail selengkapnya tentang ekspresi jadwal](https://docs.aws.amazon.com/timestream/latest/developerguide/scheduledqueries-schedule.html). 1. Di bagian **topik SNS**, masukkan topik SNS yang akan digunakan untuk notifikasi. 1. Di bagian **Laporan log kesalahan** masukkan lokasi S3 yang akan digunakan untuk melaporkan kesalahan. Pilih **jenis kunci Enkripsi**. 1. Di bagian **Pengaturan keamanan** dari tombol **AWS KMS, pilih jenis kunci** AWS KMS. Masukkan **peran IAM** yang LiveAnalytics akan digunakan Timestream untuk menjalankan kueri terjadwal. Lihat [contoh kebijakan IAM untuk kueri terjadwal](https://docs.aws.amazon.com/timestream/latest/developerguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-sheduledqueries) untuk detail tentang izin yang diperlukan dan hubungan kepercayaan untuk peran tersebut. 1. Klik **Buat kueri terjadwal**. ## Hapus kueri terjadwal Ikuti langkah-langkah berikut untuk menghapus atau menonaktifkan kueri terjadwal menggunakan AWS Konsol. 1. Buka [AWS Konsol](https://console.aws.amazon.com/timestream). 1. Di panel navigasi, pilih Kueri **terjadwal** 1. Pilih kueri terjadwal yang dibuat di[Buat kueri terjadwal](#console_timestream.scheduledquery.using-console). 1. Pilih **Tindakan**. 1. Pilih **Nonaktifkan** atau **Hapus**. 1. Jika Anda memilih Hapus, konfirmasikan tindakan dan pilih **Hapus**. ## Menghapus tabel Ikuti langkah-langkah berikut untuk menghapus database menggunakan AWS Konsol. 1. Buka [AWS Konsol](https://console.aws.amazon.com/timestream). 1. **Di panel navigasi, pilih Tabel** 1. Pilih tabel yang Anda buat[Membuat tabel](#console_timestream.table.using-console). 1. Klik **Hapus**. 1. Ketik *hapus* di kotak konfirmasi. ## Hapus database Ikuti langkah-langkah berikut untuk menghapus database menggunakan AWS Konsol: 1. Buka [AWS Konsol](https://console.aws.amazon.com/timestream). 1. **Di panel navigasi, pilih Databases** 1. Pilih database yang Anda buat di **Buat database**. 1. Klik **Hapus**. 1. Ketik *hapus* di kotak konfirmasi. ## Mengedit tabel Ikuti langkah-langkah ini untuk mengedit tabel menggunakan AWS Konsol. 1. Buka [AWS Konsol](https://console.aws.amazon.com/timestream). 1. **Di panel navigasi, pilih Tabel** 1. Pilih tabel yang Anda buat[Membuat tabel](#console_timestream.table.using-console). 1. Klik **Edit** 1. Edit detail tabel dan simpan. + **Penyimpanan penyimpanan memori** —Tentukan berapa lama Anda ingin menyimpan data di penyimpanan memori. Penyimpanan memori memproses data yang masuk, termasuk data yang datang terlambat (data dengan stempel waktu lebih awal dari waktu saat ini) dan dioptimalkan untuk kueri cepat. point-in-time + **Retensi penyimpanan magnetik** —Tentukan berapa lama Anda ingin menyimpan data di penyimpanan magnetik. Penyimpanan magnetik dimaksudkan untuk penyimpanan jangka panjang dan dioptimalkan untuk kueri analitik cepat. ## Mengedit database Ikuti langkah-langkah ini untuk mengedit database menggunakan AWS Konsol. 1. Buka [AWS Konsol](https://console.aws.amazon.com/timestream). 1. **Di panel navigasi, pilih Databases** 1. Pilih database yang Anda buat di **Buat database**. 1. Klik **Edit** 1. Edit detail database dan simpan. # Mengakses Amazon Timestream LiveAnalytics untuk menggunakan AWS CLI Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk mengontrol beberapa AWS layanan dari baris perintah dan mengotomatiskannya melalui skrip. Anda dapat menggunakan AWS CLI untuk operasi ad hoc. Anda juga dapat menggunakannya untuk menyematkan Amazon Timestream LiveAnalytics untuk operasi dalam skrip utilitas. Sebelum Anda dapat menggunakan Timestream for LiveAnalytics, Anda harus mengatur akses terprogram. AWS CLI Untuk informasi selengkapnya, lihat [Memberikan akses programatis](accessing.md#programmatic-access). Untuk daftar lengkap semua perintah yang tersedia untuk Timestream for LiveAnalytics Query API di AWS CLI, lihat [Referensi AWS CLI Perintah](https://docs.aws.amazon.com/cli/latest/reference/timestream-query/index.html). Untuk daftar lengkap semua perintah yang tersedia untuk Timestream for LiveAnalytics Write API di AWS CLI, lihat [Referensi AWS CLI Perintah](https://docs.aws.amazon.com/cli/latest/reference/timestream-write/index.html). **Topics** + [Mengunduh dan mengonfigurasi AWS CLI](#Tools.CLI.DownloadingAndRunning) + [Menggunakan Timestream AWS CLI with untuk LiveAnalytics](#Tools.CLI.UsingWithQLDB) ## Mengunduh dan mengonfigurasi AWS CLI AWS CLI Berjalan di Windows, macOS, atau Linux. Untuk mengunduh, menginstal, dan mengonfigurasinya, ikuti langkah-langkah berikut: 1. Unduh AWS CLI di [http://aws.amazon.com/cli](https://aws.amazon.com/cli). 1. *Ikuti petunjuk untuk [Menginstal AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) dan [Mengkonfigurasi AWS CLI di](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) Panduan Pengguna.AWS Command Line Interface * ## Menggunakan Timestream AWS CLI with untuk LiveAnalytics Format baris perintah terdiri dari Amazon Timestream untuk nama LiveAnalytics operasi, diikuti oleh parameter untuk operasi itu. AWS CLI Mendukung sintaks singkatan untuk nilai parameter, selain JSON. Gunakan `help` untuk mencantumkan semua perintah yang tersedia di Timestream untuk LiveAnalytics. Contoh: ``` aws timestream-write help ``` ``` aws timestream-query help ``` Anda juga dapat menggunakan `help` untuk mendeskripsikan perintah tertentu dan mempelajari lebih lanjut tentang penggunaannya: ``` aws timestream-write create-database help ``` Misalnya, untuk membuat database: ``` aws timestream-write create-database --database-name myFirstDatabase ``` Untuk membuat tabel dengan penyimpanan magnetik menulis diaktifkan: ``` aws timestream-write create-table \ --database-name metricsdb \ --table-name metrics \ --magnetic-store-write-properties "{\"EnableMagneticStoreWrites\": true}" ``` Untuk menulis data menggunakan catatan ukuran tunggal: ``` aws timestream-write write-records \ --database-name metricsdb \ --table-name metrics \ --common-attributes "{\"Dimensions\":[{\"Name\":\"asset_id\", \"Value\":\"100\"}], \"Time\":\"1631051324000\",\"TimeUnit\":\"MILLISECONDS\"}" \ --records "[{\"MeasureName\":\"temperature\", \"MeasureValueType\":\"DOUBLE\",\"MeasureValue\":\"30\"},{\"MeasureName\":\"windspeed\", \"MeasureValueType\":\"DOUBLE\",\"MeasureValue\":\"7\"},{\"MeasureName\":\"humidity\", \"MeasureValueType\":\"DOUBLE\",\"MeasureValue\":\"15\"},{\"MeasureName\":\"brightness\", \"MeasureValueType\":\"DOUBLE\",\"MeasureValue\":\"17\"}]" ``` Untuk menulis data menggunakan catatan multi-ukuran: ``` # wide model helper method to create Multi-measure records function ingest_multi_measure_records { epoch=`date +%s` epoch+=$i # multi-measure records aws timestream-write write-records \ --database-name $src_db_wide \ --table-name $src_tbl_wide \ --common-attributes "{\"Dimensions\":[{\"Name\":\"device_id\", \ \"Value\":\"12345678\"},\ {\"Name\":\"device_type\", \"Value\":\"iPhone\"}, \ {\"Name\":\"os_version\", \"Value\":\"14.8\"}, \ {\"Name\":\"region\", \"Value\":\"us-east-1\"} ], \ \"Time\":\"$epoch\",\"TimeUnit\":\"MILLISECONDS\"}" \ --records "[{\"MeasureName\":\"video_metrics\", \"MeasureValueType\":\"MULTI\", \ \"MeasureValues\": \ [{\"Name\":\"video_startup_time\",\"Value\":\"0\",\"Type\":\"BIGINT\"}, \ {\"Name\":\"rebuffering_ratio\",\"Value\":\"0.5\",\"Type\":\"DOUBLE\"}, \ {\"Name\":\"video_playback_failures\",\"Value\":\"0\",\"Type\":\"BIGINT\"}, \ {\"Name\":\"average_frame_rate\",\"Value\":\"0.5\",\"Type\":\"DOUBLE\"}]}]" \ --endpoint-url $ingest_endpoint \ --region $region } # create 5 records for i in {100..105}; do ingest_multi_measure_records $i; done ``` Untuk menanyakan tabel: ``` aws timestream-query query \ --query-string "SELECT time, device_id, device_type, os_version, region, video_startup_time, rebuffering_ratio, video_playback_failures, \ average_frame_rate \ FROM metricsdb.metrics \ where time >= ago (15m)" ``` Untuk membuat kueri terjadwal: ``` aws timestream-query create-scheduled-query \ --name scheduled_query_name \ --query-string "select bin(time, 1m) as time, \ avg(measure_value::double) as avg_cpu, min(measure_value::double) as min_cpu, region \ from $src_db.$src_tbl where measure_name = 'cpu' \ and time BETWEEN @scheduled_runtime - (interval '5' minute) AND @scheduled_runtime \ group by region, bin(time, 1m)" \ --schedule-configuration "{\"ScheduleExpression\":\"$cron_exp\"}" \ --notification-configuration "{\"SnsConfiguration\":{\"TopicArn\":\"$sns_topic_arn\"}}" \ --scheduled-query-execution-role-arn "arn:aws:iam::452360119086:role/TimestreamSQExecutionRole" \ --target-configuration "{\"TimestreamConfiguration\":{\ \"DatabaseName\": \"$dest_db\",\ \"TableName\": \"$dest_tbl\",\ \"TimeColumn\":\"time\",\ \"DimensionMappings\":[{\ \"Name\": \"region\", \"DimensionValueType\": \"VARCHAR\" }],\ \"MultiMeasureMappings\":{\ \"TargetMultiMeasureName\": \"mma_name\", \"MultiMeasureAttributeMappings\":[{\ \"SourceColumn\": \"avg_cpu\", \"MeasureValueType\": \"DOUBLE\", \"TargetMultiMeasureAttributeName\": \"target_avg_cpu\" },\ { \ \"SourceColumn\": \"min_cpu\", \"MeasureValueType\": \"DOUBLE\", \"TargetMultiMeasureAttributeName\": \"target_min_cpu\" }] \ }\ }}" \ --error-report-configuration "{\"S3Configuration\": {\ \"BucketName\": \"$s3_err_bucket\",\ \"ObjectKeyPrefix\": \"scherrors\",\ \"EncryptionOption\": \"SSE_S3\"\ }\ }" ``` # Menggunakan API Selain itu [SDKs](getting-started-sdks.md), Amazon Timestream for LiveAnalytics menyediakan akses REST API langsung melalui pola penemuan *titik akhir*. Pola penemuan titik akhir dijelaskan di bawah ini, bersama dengan kasus penggunaannya. ## Pola penemuan titik akhir Karena Timestream Live Analytics SDKs dirancang untuk bekerja secara transparan dengan arsitektur layanan, termasuk pengelolaan dan pemetaan titik akhir layanan, disarankan agar Anda menggunakannya untuk sebagian besar aplikasi. SDKs Namun, ada beberapa contoh di mana penggunaan pola penemuan titik akhir Timestream untuk LiveAnalytics REST API diperlukan: + Anda menggunakan [titik akhir VPC (AWS PrivateLink)](VPCEndpoints.md) dengan Timestream untuk LiveAnalytics + Aplikasi Anda menggunakan bahasa pemrograman yang belum memiliki dukungan SDK + Anda memerlukan kontrol yang lebih baik atas implementasi sisi klien Bagian ini mencakup informasi tentang cara kerja pola penemuan titik akhir, cara menerapkan pola penemuan titik akhir, dan catatan penggunaan. Pilih topik di bawah ini untuk mempelajari lebih lanjut. **Topics** + [Pola penemuan titik akhir](#Using-API.endpoint-discovery) + [Cara kerja pola penemuan titik akhir](Using-API.endpoint-discovery.how-it-works.md) + [Menerapkan pola penemuan titik akhir](Using-API.endpoint-discovery.describe-endpoints.implementation.md) # Cara kerja pola penemuan titik akhir Timestream dibangun menggunakan [arsitektur seluler](architecture.md#cells) untuk memastikan properti penskalaan dan isolasi lalu lintas yang lebih baik. Karena setiap akun pelanggan dipetakan ke sel tertentu di suatu wilayah, aplikasi Anda harus menggunakan titik akhir khusus sel yang benar tempat akun Anda telah dipetakan. Saat menggunakan SDKs, pemetaan ini ditangani secara transparan untuk Anda dan Anda tidak perlu mengelola titik akhir khusus sel. Namun, saat mengakses REST API secara langsung, Anda harus mengelola dan memetakan titik akhir yang benar sendiri. Proses ini, *pola penemuan titik akhir*, dijelaskan di bawah ini: 1. Pola penemuan titik akhir dimulai dengan panggilan untuk `DescribeEndpoints` tindakan (dijelaskan di [https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html)bagian). 1. Titik akhir harus di-cache dan digunakan kembali untuk jumlah waktu yang ditentukan oleh nilai yang dikembalikan time-to-live (TTL) (the). [https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html#timestream-Type-Endpoint-CachePeriodInMinutes.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html#timestream-Type-Endpoint-CachePeriodInMinutes.html) Panggilan ke Timestream Live Analytics API kemudian dapat dilakukan selama TTL. 1. Setelah TTL kedaluwarsa, panggilan baru DescribeEndpoints harus dilakukan untuk menyegarkan titik akhir (dengan kata lain, mulai lagi pada Langkah 1). **catatan** Sintaks, parameter, dan informasi penggunaan lainnya untuk `DescribeEndpoints` tindakan dijelaskan dalam [Referensi API](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html). Perhatikan bahwa `DescribeEndpoints` tindakan tersedia melalui keduanya SDKs, dan identik untuk masing-masing. Untuk implementasi pola penemuan titik akhir, lihat[Menerapkan pola penemuan titik akhir](Using-API.endpoint-discovery.describe-endpoints.implementation.md). # Menerapkan pola penemuan titik akhir Untuk menerapkan pola penemuan titik akhir, pilih API (Tulis atau Kueri), buat **DescribeEndpoints**permintaan, dan gunakan titik akhir yang dikembalikan selama durasi nilai TTL yang dikembalikan. Prosedur implementasi dijelaskan di bawah ini. **catatan** Pastikan Anda terbiasa dengan [catatan penggunaan](#Using-API.endpoint-discovery.describe-endpoints.usage-notes). ## Prosedur implementasi 1. Dapatkan titik akhir untuk API yang ingin Anda lakukan panggilan ([Tulis](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) atau [Kueri](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)). menggunakan [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html)permintaan. 1. Buat permintaan yang sesuai dengan API [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html)yang diinginkan ([Tulis](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) atau [Kueri](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)) menggunakan salah satu dari dua titik akhir yang dijelaskan di bawah ini. Tidak ada parameter input untuk permintaan tersebut. Pastikan Anda membaca catatan di bawah ini. *Tulis SDK:* ``` ingest.timestream..amazonaws.com ``` *Kueri SDK:* ``` query.timestream..amazonaws.com ``` Contoh panggilan CLI untuk wilayah `us-east-1` berikut. ``` REGION_ENDPOINT="https://query.timestream.us-east-1.amazonaws.com" REGION=us-east-1 aws timestream-write describe-endpoints \ --endpoint-url $REGION_ENDPOINT \ --region $REGION ``` **catatan** Header HTTP “Host” juga *harus* berisi titik akhir API. Permintaan akan gagal jika header tidak diisi. Ini adalah persyaratan standar untuk semua permintaan HTTP/1.1. Jika Anda menggunakan pustaka HTTP yang mendukung 1.1 atau yang lebih baru, pustaka HTTP akan secara otomatis mengisi header untuk Anda. **catatan** Gantikan ** dengan pengenal wilayah untuk wilayah tempat permintaan dibuat, mis. `us-east-1` 1. Parse respon untuk mengekstrak endpoint (s), dan cache nilai TTL (s). Responsnya adalah array dari satu atau lebih [`Endpoint`objek](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html). Setiap `Endpoint` objek berisi alamat titik akhir (`Address`) dan TTL untuk titik akhir itu (). `CachePeriodInMinutes` 1. Cache titik akhir hingga TTL yang ditentukan. 1. Ketika TTL kedaluwarsa, ambil titik akhir baru dengan memulai dari awal pada langkah 1 Implementasi. ## Catatan penggunaan untuk pola penemuan titik akhir + **DescribeEndpoints**Tindakan ini adalah satu-satunya tindakan yang dikenali oleh titik akhir regional Timestream Live Analytics. + Respons berisi daftar titik akhir untuk membuat panggilan Timestream Live Analytics API terhadap. + Pada respons yang berhasil, setidaknya harus ada satu titik akhir dalam daftar. Jika ada lebih dari satu titik akhir dalam daftar, salah satu dari mereka sama-sama dapat digunakan untuk panggilan API, dan pemanggil dapat memilih titik akhir yang akan digunakan secara acak. + Selain alamat DNS titik akhir, setiap titik akhir dalam daftar akan menentukan waktu untuk hidup (TTL) yang diizinkan untuk menggunakan titik akhir yang ditentukan dalam menit. + Titik akhir harus di-cache dan digunakan kembali untuk jumlah waktu yang ditentukan oleh nilai TTL yang dikembalikan (dalam menit). Setelah TTL kedaluwarsa, panggilan baru **DescribeEndpoints**harus dilakukan untuk menyegarkan titik akhir yang akan digunakan, karena titik akhir tidak akan berfungsi lagi setelah TTL kedaluwarsa. # Menggunakan AWS SDKs Anda dapat mengakses Amazon Timestream menggunakan file. AWS SDKs Timestream mendukung dua SDKs per bahasa; yaitu, Write SDK dan Query SDK. Tulis SDK digunakan untuk melakukan operasi CRUD dan untuk memasukkan data deret waktu Anda ke Timestream. Query SDK digunakan untuk menanyakan data deret waktu yang ada yang disimpan di Timestream. Setelah Anda menyelesaikan prasyarat yang diperlukan untuk SDK pilihan Anda, Anda dapat memulai dengan. [Sampel Kode](code-samples.md) **Topics** + [Java](getting-started.java.md) + [Jawa v2](getting-started.java-v2.md) + [Go](getting-started.go.md) + [Python](getting-started.python.md) + [Node.js](getting-started.node-js.md) + [.NET](getting-started.dot-net.md) # Java Untuk memulai dengan [Java 1.0 SDK](https://aws.amazon.com/sdk-for-java/) dan Amazon Timestream, lengkapi prasyarat, yang dijelaskan di bawah ini. Setelah Anda menyelesaikan prasyarat yang diperlukan untuk Java SDK, Anda dapat memulai dengan. [Sampel Kode](code-samples.md) ## Prasyarat Sebelum Anda memulai dengan Java, Anda harus melakukan hal berikut: 1. Ikuti instruksi AWS pengaturan di[Mengakses Timestream untuk LiveAnalytics](accessing.md). 1. Siapkan lingkungan pengembangan Java dengan mengunduh dan menginstal yang berikut ini: + Java SE Development Kit 8 (seperti [Amazon Corretto](https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.html) 8). + [Java IDE (seperti [Eclipse](http://www.eclipse.org) atau IntelliJ).](https://www.jetbrains.com/idea/) Untuk informasi selengkapnya, lihat [Memulai dengan AWS SDK untuk Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html) 1. Konfigurasikan AWS kredensil dan Wilayah Anda untuk pengembangan: + Siapkan AWS kredensil keamanan Anda untuk digunakan dengan file. AWS SDK untuk Java + Tetapkan AWS Wilayah Anda untuk menentukan Timestream default untuk titik LiveAnalytics akhir. ## Menggunakan Apache Maven Anda dapat menggunakan [Apache Maven](https://maven.apache.org/) untuk mengkonfigurasi dan membangun proyek. AWS SDK untuk Java **catatan** Untuk menggunakan Apache Maven, pastikan Java SDK dan runtime Anda 1,8 atau lebih tinggi. Anda dapat mengonfigurasi AWS SDK sebagai dependensi Maven seperti yang dijelaskan dalam [Menggunakan SDK](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-project-maven.html) dengan Apache Maven. Anda dapat menjalankan kompilasi dan menjalankan kode sumber Anda dengan perintah berikut: ``` mvn clean compile mvn exec:java -Dexec.mainClass= ``` **catatan** ``adalah jalur ke kelas utama kode sumber Java Anda. ## Mengatur AWS kredensil Anda Ini [AWS SDK untuk Java](https://aws.amazon.com/sdk-for-java)mengharuskan Anda memberikan AWS kredensil ke aplikasi Anda saat runtime. *Contoh kode dalam panduan ini mengasumsikan bahwa Anda menggunakan file AWS kredensial, seperti yang dijelaskan dalam [Menyiapkan AWS Kredensial dan Wilayah untuk Pengembangan](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup-credentials.html) dalam Panduan Pengembang.AWS SDK untuk Java * Berikut ini adalah contoh file AWS kredensial bernama`~/.aws/credentials`, di mana karakter tilde (`~`) mewakili direktori home Anda. ``` [default] aws_access_key_id = AWS access key ID goes here aws_secret_access_key = Secret key goes here ``` # Jawa v2 Untuk memulai dengan [Java 2.0 SDK](https://aws.amazon.com/sdk-for-java/) dan Amazon Timestream, lengkapi prasyarat, yang dijelaskan di bawah ini. Setelah Anda menyelesaikan prasyarat yang diperlukan untuk Java 2.0 SDK, Anda dapat memulai dengan. [Sampel Kode](code-samples.md) ## Prasyarat Sebelum Anda memulai dengan Java, Anda harus melakukan hal berikut: 1. Ikuti instruksi AWS pengaturan di[Mengakses Timestream untuk LiveAnalytics](accessing.md). 1. Anda dapat mengonfigurasi AWS SDK sebagai dependensi Maven seperti yang dijelaskan dalam [Menggunakan SDK](https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/welcome.html) dengan Apache Maven. 1. Siapkan lingkungan pengembangan Java dengan mengunduh dan menginstal yang berikut ini: + Java SE Development Kit 8 (seperti [Amazon Corretto](https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.html) 8). + [Java IDE (seperti [Eclipse](http://www.eclipse.org) atau IntelliJ).](https://www.jetbrains.com/idea/) Untuk informasi selengkapnya, lihat [Memulai dengan AWS SDK untuk Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html) ## Menggunakan Apache Maven Anda dapat menggunakan [Apache Maven](https://maven.apache.org/) untuk mengkonfigurasi dan membangun proyek. AWS SDK untuk Java **catatan** Untuk menggunakan Apache Maven, pastikan Java SDK dan runtime Anda 1,8 atau lebih tinggi. Anda dapat mengonfigurasi AWS SDK sebagai dependensi Maven seperti yang dijelaskan dalam [Menggunakan SDK](https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/welcome.html) dengan Apache Maven. Perubahan yang diperlukan pada file pom.xml dijelaskan [di sini](https://docs.aws.amazon.com/sdk-for-java/v2/migration-guide/whats-different.html#adding-v2). Anda dapat menjalankan kompilasi dan menjalankan kode sumber Anda dengan perintah berikut: ``` mvn clean compile mvn exec:java -Dexec.mainClass= ``` **catatan** ``adalah jalur ke kelas utama kode sumber Java Anda. # Go Untuk memulai dengan [Go SDK](https://aws.amazon.com/sdk-for-go/) dan Amazon Timestream, lengkapi prasyarat, yang dijelaskan di bawah ini. Setelah Anda menyelesaikan prasyarat yang diperlukan untuk Go SDK, Anda dapat memulai dengan. [Sampel Kode](code-samples.md) ## Prasyarat 1. [Unduh GO SDK 1.14](https://golang.org/doc/install). 1. [Konfigurasikan GO SDK](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html). 1. [Bangun klien Anda](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html). # Python Untuk memulai dengan [Python SDK](https://aws.amazon.com/sdk-for-python/) dan Amazon Timestream, lengkapi prasyarat, yang dijelaskan di bawah ini. Setelah Anda menyelesaikan prasyarat yang diperlukan untuk Python SDK, Anda dapat memulai dengan. [Sampel Kode](code-samples.md) ## Prasyarat [Untuk menggunakan Python, instal dan konfigurasikan Boto3, ikuti instruksi di sini.](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html) # Node.js Untuk memulai dengan [Node.js SDK](https://aws.amazon.com/sdk-for-node-js/) dan Amazon Timestream, lengkapi prasyarat, yang dijelaskan di bawah ini. Setelah Anda menyelesaikan prasyarat yang diperlukan untuk Node.js SDK, Anda dapat memulai dengan. [Sampel Kode](code-samples.md) ## Prasyarat Sebelum Anda memulai dengan Node.js, Anda harus melakukan hal berikut: 1. [Instal Node.js](https://nodejs.org/en/). 1. [Instal AWS SDK untuk JavaScript](https://aws.amazon.com/sdk-for-node-js/). # .NET Untuk memulai dengan [.NET SDK](https://aws.amazon.com/sdk-for-net/) dan Amazon Timestream, lengkapi prasyarat, yang dijelaskan di bawah ini. Setelah Anda menyelesaikan prasyarat yang diperlukan untuk .NET SDK, Anda dapat memulai dengan. [Sampel Kode](code-samples.md) ## Prasyarat Sebelum Anda memulai dengan.NET, instal NuGet paket yang diperlukan dan pastikan AWSSDK versi.Core adalah 3.3.107 atau yang lebih baru dengan menjalankan perintah berikut: ``` dotnet add package AWSSDK.Core dotnet add package AWSSDK.TimestreamWrite dotnet add package AWSSDK.TimestreamQuery ```