Per funzionalità simili a Amazon Timestream for, prendi in considerazione Amazon Timestream LiveAnalytics per InfluxDB. Offre un'acquisizione semplificata dei dati e tempi di risposta alle query di una sola cifra di millisecondi per analisi in tempo reale. [Scopri](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html) di più qui. Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Accesso a Timestream per LiveAnalytics Puoi accedere a Timestream per LiveAnalytics utilizzare la console, la CLI o l'API. Per informazioni sull'accesso a Timestream per LiveAnalytics, consulta quanto segue: **Topics** + [Registrati per un Account AWS](#sign-up-for-aws) + [Crea un utente con accesso amministrativo](#create-an-admin) + [Fornisci Timestream per l'accesso LiveAnalytics](#getting-started.prereqs.iam-user) + [Concessione dell'accesso programmatico](#programmatic-access) + [Utilizzo della console](console_timestream.md) + [Accesso ad Amazon Timestream LiveAnalytics per l'utilizzo di AWS CLI](Tools.CLI.md) + [Utilizzo dell’API](Using.API.md) + [Usando il AWS SDKs](getting-started-sdks.md) ## Registrati per un Account AWS Se non ne hai uno Account AWS, completa i seguenti passaggi per crearne uno. **Per iscriverti a un Account AWS** 1. Apri la [https://portal.aws.amazon.com/billing/registrazione.](https://portal.aws.amazon.com/billing/signup) 1. Segui le istruzioni online. Nel corso della procedura di registrazione riceverai una telefonata o un messaggio di testo e ti verrà chiesto di inserire un codice di verifica attraverso la tastiera del telefono. Quando ti iscrivi a un Account AWS, *Utente root dell'account AWS*viene creato un. L’utente root dispone dell’accesso a tutte le risorse e tutti i Servizi AWS nell’account. Come best practice di sicurezza, assegna l’accesso amministrativo a un utente e utilizza solo l’utente root per eseguire [attività che richiedono l’accesso di un utente root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks). AWS ti invia un'email di conferma dopo il completamento della procedura di registrazione. In qualsiasi momento, puoi visualizzare l'attività corrente del tuo account e gestirlo accedendo a [https://aws.amazon.com/](https://aws.amazon.com/)e scegliendo **Il mio account**. ## Crea un utente con accesso amministrativo Dopo esserti registrato Account AWS, proteggi Utente root dell'account AWS AWS IAM Identity Center, abilita e crea un utente amministrativo in modo da non utilizzare l'utente root per le attività quotidiane. **Proteggi i tuoi Utente root dell'account AWS** 1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/)come proprietario dell'account scegliendo **Utente root** e inserendo il tuo indirizzo Account AWS email. Nella pagina successiva, inserisci la password. Per informazioni sull’accesso utilizzando un utente root, consulta la pagina [Accedere come utente root](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) nella *Guida per l’utente di Accedi ad AWS *. 1. Abilita l’autenticazione a più fattori (MFA) per l’utente root. Per istruzioni, consulta [Abilitare un dispositivo MFA virtuale per l'utente Account AWS root (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) nella Guida per l'*utente IAM*. **Crea un utente con accesso amministrativo** 1. Abilita il Centro identità IAM. Per istruzioni, consulta [Abilitazione del AWS IAM Identity Center](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-set-up-for-idc.html) nella *Guida per l’utente di AWS IAM Identity Center *. 1. Nel Centro identità IAM, assegna l’accesso amministrativo a un utente. Per un tutorial sull'utilizzo di IAM Identity Center directory come fonte di identità, consulta [Configurare l'accesso utente con l'impostazione predefinita IAM Identity Center directory](https://docs.aws.amazon.com//singlesignon/latest/userguide/quick-start-default-idc.html) nella *Guida per l'AWS IAM Identity Center utente*. **Accesso come utente amministratore** + Per accedere come utente del Centro identità IAM, utilizza l’URL di accesso che è stato inviato al tuo indirizzo e-mail quando hai creato l’utente del Centro identità IAM. Per informazioni sull'accesso utilizzando un utente IAM Identity Center, consulta [AWS Accedere al portale di accesso](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html) nella *Guida per l'Accedi ad AWS utente*. **Assegnazione dell’accesso ad altri utenti** 1. Nel Centro identità IAM, crea un set di autorizzazioni conforme alla best practice per l’applicazione di autorizzazioni con il privilegio minimo. Segui le istruzioni riportate nella pagina [Creazione di un set di autorizzazioni](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-started-create-a-permission-set.html) nella *Guida per l’utente di AWS IAM Identity Center *. 1. Assegna al gruppo prima gli utenti e poi l’accesso con autenticazione unica (Single Sign-On). Per istruzioni, consulta [Aggiungere gruppi](https://docs.aws.amazon.com//singlesignon/latest/userguide/addgroups.html) nella *Guida per l’utente di AWS IAM Identity Center *. ## Fornisci Timestream per l'accesso LiveAnalytics Le autorizzazioni necessarie per accedere a Timestream LiveAnalytics sono già concesse all'amministratore. Agli altri utenti, è necessario concedere loro l' LiveAnalytics accesso a Timestream utilizzando la seguente politica: ------ #### [ 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": "*" } ] } ``` ------ **Nota** Per informazioni su`dbqms`, consulta [Azioni, risorse e chiavi di condizione per il servizio Database Query Metadata](https://docs.aws.amazon.com/service-authorization/latest/reference/list_databasequerymetadataservice.html). Per informazioni su, `kms` consulta [Azioni, risorse e chiavi di condizione per il servizio di gestione delle AWS chiavi](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awskeymanagementservice.html). ## Concessione dell'accesso programmatico Gli utenti necessitano dell'accesso programmatico se desiderano interagire con l' AWS Console di gestione AWS esterno di. Il modo per concedere l'accesso programmatico dipende dal tipo di utente che accede. AWS Per fornire agli utenti l’accesso programmatico, scegli una delle seguenti opzioni. **** | Quale utente necessita dell’accesso programmatico? | Per | Come | | --- | --- | --- | | IAM | (Consigliato) Utilizza le credenziali della console come credenziali temporanee per firmare le richieste programmatiche a,, o. AWS CLI AWS SDKs AWS APIs | Segui le istruzioni per l’interfaccia che desideri utilizzare. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/timestream/latest/developerguide/accessing.html) | | Identità della forza lavoro (Utenti gestiti nel centro identità IAM) | Utilizza credenziali temporanee per firmare le richieste programmatiche a AWS CLI, AWS SDKs, o. AWS APIs | Segui le istruzioni per l’interfaccia che desideri utilizzare. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/timestream/latest/developerguide/accessing.html) | | IAM | Utilizza credenziali temporanee per firmare le richieste programmatiche a AWS CLI, AWS SDKs, o. AWS APIs | Seguendo le istruzioni riportate in [Utilizzo delle credenziali temporanee con le AWS risorse nella Guida per](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) l'utente IAM. | | IAM | (Non consigliato)Utilizza credenziali a lungo termine per firmare richieste programmatiche a AWS CLI,, AWS SDKs o. AWS APIs | Segui le istruzioni per l’interfaccia che desideri utilizzare. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/timestream/latest/developerguide/accessing.html) | # Utilizzo della console Puoi utilizzare la Console di AWS gestione per Timestream Live Analytics per creare, modificare, eliminare, descrivere ed elencare database e tabelle. È inoltre possibile utilizzare la console per eseguire interrogazioni. **Topics** + [Tutorial](#console_timestream.db-w-sample-data) + [Creazione di un database](#console_timestream.db.using-console) + [Creare una tabella](#console_timestream.table.using-console) + [Esecuzione di una query](#console_timestream.queries.using-console) + [Crea una query pianificata](#console_timestream.scheduledquery.using-console) + [Eliminare un'interrogazione pianificata](#console_timestream.scheduledquerydeletedisable.using-console) + [Eliminazione di una tabella](#console_timestream.delete-table.using-console) + [Eliminazione di un database](#console_timestream.delete-db.using-console) + [Modifica una tabella](#console_timestream.edit-table.using-console) + [Modifica un database](#console_timestream.edit-db.using-console) ## Tutorial Questo tutorial mostra come creare un database popolato con set di dati di esempio ed eseguire query di esempio. I set di dati di esempio utilizzati in questo tutorial sono spesso presenti nell'IoT e negli DevOps scenari. Il set di dati IoT contiene dati di serie temporali come la velocità, la posizione e il carico di un camion, per semplificare la gestione della flotta e identificare opportunità di ottimizzazione. Il DevOps set di dati contiene parametri delle istanze EC2 come l'utilizzo di CPU, rete e memoria per migliorare le prestazioni e la disponibilità delle applicazioni. Ecco un [video tutorial](https://www.youtube.com/watch?v=YBWCGDd4ChQ) per le istruzioni descritte in questa sezione Segui questi passaggi per creare un database popolato con i set di dati di esempio ed eseguire query di esempio utilizzando la AWS Console. 1. [Apri la console.AWS](https://console.aws.amazon.com/timestream) 1. Nel riquadro di navigazione, scegli **Database** 1. Fai clic su **Crea database**. 1. Nella pagina di creazione del database, inserisci quanto segue: + **Scegli la configurazione**: seleziona il **database di esempio**. + **Nome**: inserisci un nome di database a tua scelta. + **Scegli set di dati di esempio**: seleziona **IoT** e. **DevOps** + Fai clic su **Crea database** per creare un database contenente due tabelle, IoT e DevOps popolato con dati di esempio. 1. **Nel riquadro di navigazione, scegli Query editor** 1. Seleziona **Query di esempio** dal menu in alto. 1. Fai clic su una delle query di esempio. Si tornerà all'editor di query con l'editor popolato con la query di esempio. 1. Fate clic su **Esegui** per eseguire la query e visualizzare i risultati della query. ## Creazione di un database Segui questi passaggi per creare un database utilizzando la AWS console. 1. Apri la [AWS console](https://console.aws.amazon.com/timestream). 1. Nel riquadro di navigazione, scegli **Database** 1. Fai clic su **Crea database**. 1. Nella pagina di creazione del database, inserisci quanto segue. + **Scegli configurazione**: seleziona **Database standard**. + **Nome**: inserisci un nome di database a tua scelta. + **Crittografia**: scegli una chiave KMS o utilizza l'opzione predefinita, in cui Timestream Live Analytics creerà una chiave KMS nel tuo account se non ne esiste già una. 1. Fai clic su **Crea database per creare un database**. ## Creare una tabella Segui questi passaggi per creare una tabella utilizzando la AWS console. 1. Apri la [AWS console](https://console.aws.amazon.com/timestream). 1. Nel riquadro di navigazione, scegli **Tabelle** 1. Fai clic su **Crea tabella**. 1. Nella pagina di creazione della tabella, inserisci quanto segue. + **Nome database**: selezionare il nome del database creato in[Creazione di un database](#console_timestream.db.using-console). + **Nome tabella**: immetti un nome di tabella a tua scelta. + **Conservazione nell'archivio di memoria**: specifica per quanto tempo desideri conservare i dati nell'archivio di memoria. L'archivio di memoria elabora i dati in entrata, compresi i dati in arrivo in ritardo (dati con un timestamp precedente all'ora corrente) ed è ottimizzato per le query veloci. point-in-time + **Conservazione dell'archivio magnetico**: specifica per quanto tempo desideri conservare i dati nell'archivio magnetico. L'archivio magnetico è pensato per l'archiviazione a lungo termine ed è ottimizzato per query analitiche veloci. 1. Fai clic su **Crea tabella.** ## Esecuzione di una query Segui questi passaggi per eseguire le query utilizzando la AWS console. 1. Apri la [AWS console](https://console.aws.amazon.com/timestream). 1. Nel riquadro di navigazione, scegli **Query editor** 1. Nel riquadro sinistro, seleziona il database creato in[Creazione di un database](#console_timestream.db.using-console). 1. Nel riquadro sinistro, seleziona il database creato in[Creare una tabella](#console_timestream.table.using-console). 1. Nell'editor di query, è possibile eseguire una query. Per visualizzare le ultime 10 righe della tabella, esegui: ``` SELECT * FROM . ORDER BY time DESC LIMIT 10 ``` 1. (Facoltativo) **Attiva Enable Insights** per ottenere informazioni sull'efficienza delle tue query. ## Crea una query pianificata Segui questi passaggi per creare un'interrogazione pianificata utilizzando la AWS console. 1. Apri la [AWS console](https://console.aws.amazon.com/timestream). 1. Nel riquadro di navigazione, scegli **Interrogazioni pianificate**. 1. Fai clic su **Crea interrogazione pianificata**. 1. Nelle sezioni **Nome della query** e **Tabella di destinazione**, inserisci quanto segue. + **Nome**: immettere il nome di una query. + **Nome del database**: selezionare il nome del database creato in. [Creazione di un database](#console_timestream.db.using-console) + **Nome tabella**: seleziona il nome della tabella creata in. [Creare una tabella](#console_timestream.table.using-console) 1. Nella sezione **Query Statement**, immettete un'istruzione di interrogazione valida. Quindi fai clic su **Convalida interrogazione**. 1. Da **Modello di tabella di destinazione**, definite il modello per tutti gli attributi non definiti. È possibile utilizzare **Visual Builder o JSON**. 1. Nella sezione **Esegui pianificazione**, scegli **Frequenza fissa** o **Espressione Chron. Per le espressioni chron**, consulta Schedule Expressions for Scheduled [Queries per maggiori dettagli sulle espressioni di pianificazione](https://docs.aws.amazon.com/timestream/latest/developerguide/scheduledqueries-schedule.html). 1. Nella sezione dell'**argomento SNS, inserisci l'argomento** SNS a cui verrà utilizzato per la notifica. 1. Nella sezione **Report del registro degli errori**, inserisci la posizione S3 che verrà utilizzata per segnalare gli errori. Scegli un valore per **Encryption key type** (Tipo di chiave di crittografia). 1. Nella sezione **Impostazioni di sicurezza** della **chiave AWS KMS**, scegli il tipo di chiave AWS KMS. Inserisci il **ruolo IAM** che Timestream for LiveAnalytics utilizzerà per eseguire la query pianificata. Fai riferimento agli [esempi di policy IAM per le query pianificate](https://docs.aws.amazon.com/timestream/latest/developerguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-sheduledqueries) per i dettagli sulle autorizzazioni richieste e sulla relazione di fiducia per il ruolo. 1. Fai clic su **Crea interrogazione pianificata**. ## Eliminare un'interrogazione pianificata Segui questi passaggi per eliminare o disabilitare un'interrogazione pianificata utilizzando la AWS Console. 1. Apri la [AWS console](https://console.aws.amazon.com/timestream). 1. Nel riquadro di navigazione, scegli Interrogazioni **pianificate** 1. Seleziona l'interrogazione pianificata creata in[Crea una query pianificata](#console_timestream.scheduledquery.using-console). 1. Seleziona **Azioni**. 1. Scegli **Disabilita** o **Elimina**. 1. Se hai selezionato Elimina, conferma l'azione e seleziona **Elimina**. ## Eliminazione di una tabella Segui questi passaggi per eliminare un database utilizzando la AWS console. 1. Apri la [AWS console](https://console.aws.amazon.com/timestream). 1. Nel riquadro di navigazione, scegli **Tabelle** 1. Seleziona la tabella in cui hai creato[Creare una tabella](#console_timestream.table.using-console). 1. Fai clic su **Delete** (Elimina). 1. Digita *delete* nella casella di conferma. ## Eliminazione di un database Segui questi passaggi per eliminare un database utilizzando la AWS console: 1. Apri la [AWS console](https://console.aws.amazon.com/timestream). 1. Nel riquadro di navigazione, scegli **Database** 1. Seleziona il database che hai creato in **Crea un database**. 1. Fai clic su **Delete** (Elimina). 1. Digita *delete* nella casella di conferma. ## Modifica una tabella Segui questi passaggi per modificare una tabella utilizzando la AWS console. 1. Apri la [AWS console](https://console.aws.amazon.com/timestream). 1. Nel riquadro di navigazione, scegli **Tabelle** 1. Seleziona la tabella in cui hai creato[Creare una tabella](#console_timestream.table.using-console). 1. Fate clic su **Modifica** 1. Modifica i dettagli della tabella e salva. + **Conservazione dell'archivio di memoria**: specifica per quanto tempo desideri conservare i dati nell'archivio di memoria. L'archivio di memoria elabora i dati in entrata, compresi i dati in arrivo in ritardo (dati con un timestamp precedente all'ora corrente) ed è ottimizzato per le query veloci. point-in-time + **Conservazione dell'archivio magnetico**: specifica per quanto tempo desideri conservare i dati nell'archivio magnetico. L'archivio magnetico è pensato per l'archiviazione a lungo termine ed è ottimizzato per query analitiche veloci. ## Modifica un database Segui questi passaggi per modificare un database utilizzando la AWS console. 1. Apri la [AWS console](https://console.aws.amazon.com/timestream). 1. Nel riquadro di navigazione, scegli **Database** 1. Seleziona il database che hai creato in **Crea un database**. 1. Fai clic su **Modifica** 1. Modifica i dettagli del database e salva. # Accesso ad Amazon Timestream LiveAnalytics per l'utilizzo di AWS CLI È possibile utilizzare il AWS Command Line Interface (AWS CLI) per controllare più AWS servizi dalla riga di comando e automatizzarli tramite script. È possibile utilizzare il AWS CLI per operazioni ad hoc. Puoi anche usarlo per incorporare Amazon LiveAnalytics Timestream for operations all'interno di script di utilità. Prima di poterlo utilizzare AWS CLI con Timestream per LiveAnalytics, devi configurare l'accesso programmatico. Per ulteriori informazioni, consulta [Concessione dell'accesso programmatico](accessing.md#programmatic-access). [Per un elenco completo di tutti i comandi disponibili per l'API Timestream for LiveAnalytics Query in AWS CLI, consulta il Command Reference.AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/timestream-query/index.html) [Per un elenco completo di tutti i comandi disponibili per l'API Timestream for LiveAnalytics Write in AWS CLI, consulta il Command Reference.AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/timestream-write/index.html) **Topics** + [Scaricamento e configurazione di AWS CLI](#Tools.CLI.DownloadingAndRunning) + [Utilizzo di con Timestream per AWS CLI LiveAnalytics](#Tools.CLI.UsingWithQLDB) ## Scaricamento e configurazione di AWS CLI AWS CLI Funziona su Windows, macOS o Linux. Per scaricarlo, installarlo e configurarlo, procedi nel seguente modo: 1. Scaricala AWS CLI da [http://aws.amazon.com/cli](https://aws.amazon.com/cli). 1. *Segui le istruzioni per l'[installazione della AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) e la [configurazione della AWS CLI nella Guida](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) per l'utente.AWS Command Line Interface * ## Utilizzo di con Timestream per AWS CLI LiveAnalytics Il formato della riga di comando è costituito da un Amazon Timestream LiveAnalytics per il nome dell'operazione, seguito dai parametri per tale operazione. AWS CLI Supporta una sintassi abbreviata per i valori dei parametri, oltre a JSON. Usa `help` per elencare tutti i comandi disponibili in Timestream per. LiveAnalytics Esempio: ``` aws timestream-write help ``` ``` aws timestream-query help ``` Puoi anche usare `help` per descrivere un comando specifico e saperne di più sul suo utilizzo: ``` aws timestream-write create-database help ``` Ad esempio, per creare un database: ``` aws timestream-write create-database --database-name myFirstDatabase ``` Per creare una tabella con le scritture magnetiche abilitate: ``` aws timestream-write create-table \ --database-name metricsdb \ --table-name metrics \ --magnetic-store-write-properties "{\"EnableMagneticStoreWrites\": true}" ``` Per scrivere dati utilizzando record a misura singola: ``` 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\"}]" ``` Per scrivere dati utilizzando record a più misure: ``` # 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 ``` Esecuzione di query su una tabella: ``` 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)" ``` Per creare un'interrogazione pianificata: ``` 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\"\ }\ }" ``` # Utilizzo dell’API Oltre a [SDKs](getting-started-sdks.md), Amazon Timestream LiveAnalytics for fornisce l'accesso diretto all'API REST tramite il pattern di rilevamento *degli* endpoint. Il modello di rilevamento degli endpoint è descritto di seguito, insieme ai relativi casi d'uso. ## Il modello di scoperta degli endpoint Poiché Timestream Live Analytics è SDKs progettato per funzionare in modo trasparente con l'architettura del servizio, inclusa la gestione e la mappatura degli endpoint del servizio, si consiglia di utilizzarlo per la maggior parte delle applicazioni. SDKs Tuttavia, ci sono alcuni casi in cui è necessario utilizzare il modello di rilevamento degli endpoint dell'API Timestream for LiveAnalytics REST: + Stai utilizzando [endpoint VPC (AWS PrivateLink)](VPCEndpoints.md) con Timestream per LiveAnalytics + L'applicazione utilizza un linguaggio di programmazione che non supporta ancora l'SDK + È necessario un controllo migliore sull'implementazione lato client Questa sezione include informazioni su come funziona il pattern di rilevamento degli endpoint, su come implementarlo e note sull'utilizzo. Seleziona uno degli argomenti seguenti per saperne di più. **Topics** + [Il modello di scoperta degli endpoint](#Using-API.endpoint-discovery) + [Come funziona il modello di scoperta degli endpoint](Using-API.endpoint-discovery.how-it-works.md) + [Implementazione del modello di rilevamento degli endpoint](Using-API.endpoint-discovery.describe-endpoints.implementation.md) # Come funziona il modello di scoperta degli endpoint Timestream è costruito utilizzando un'[architettura cellulare](architecture.md#cells) per garantire una migliore scalabilità e proprietà di isolamento del traffico. Poiché ogni account cliente è mappato su una cella specifica in una regione, l'applicazione deve utilizzare gli endpoint corretti specifici della cella a cui è stato mappato l'account. Quando si utilizza SDKs, questa mappatura viene gestita in modo trasparente e non è necessario gestire gli endpoint specifici della cella. Tuttavia, quando accedi direttamente all'API REST, dovrai gestire e mappare personalmente gli endpoint corretti. Questo processo, il *modello di rilevamento degli endpoint*, è descritto di seguito: 1. Il pattern di rilevamento degli endpoint inizia con una chiamata all'`DescribeEndpoints`azione (descritta nella [https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html)sezione). 1. L'endpoint deve essere memorizzato nella cache e riutilizzato per il periodo di tempo specificato dal valore time-to-live (TTL) restituito (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) Le chiamate all'API Timestream Live Analytics possono quindi essere effettuate per la durata del TTL. 1. Dopo la scadenza del TTL, è necessario effettuare una nuova chiamata a per DescribeEndpoints aggiornare l'endpoint (in altre parole, ricominciare dalla Fase 1). **Nota** [La sintassi, i parametri e altre informazioni sull'utilizzo dell'`DescribeEndpoints`azione sono descritte nell'API Reference.](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html) Tieni presente che l'`DescribeEndpoints`azione è disponibile tramite entrambi SDKs ed è identica per ciascuno. Per l'implementazione del modello di rilevamento degli endpoint, vedere[Implementazione del modello di rilevamento degli endpoint](Using-API.endpoint-discovery.describe-endpoints.implementation.md). # Implementazione del modello di rilevamento degli endpoint Per implementare il modello di rilevamento degli endpoint, scegli un'API (Write o Query), crea una **DescribeEndpoints**richiesta e utilizza gli endpoint restituiti per la durata dei valori TTL restituiti. La procedura di implementazione è descritta di seguito. **Nota** Assicurati di avere familiarità con le [note sull'utilizzo](#Using-API.endpoint-discovery.describe-endpoints.usage-notes). ## Procedura di implementazione 1. Acquisisci l'endpoint per l'API verso cui desideri effettuare chiamate ([Write](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) o [Query](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)). utilizzando la richiesta. [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html) 1. Crea una richiesta [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html)corrispondente all'API di interesse ([Write](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) o [Query](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)) utilizzando uno dei due endpoint descritti di seguito. Non ci sono parametri di input per la richiesta. Assicurati di leggere le note riportate di seguito. *Scrivi SDK:* ``` ingest.timestream..amazonaws.com ``` *SDK di interrogazione:* ``` query.timestream..amazonaws.com ``` Segue un esempio di chiamata CLI per la regione. `us-east-1` ``` 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 ``` **Nota** L'intestazione HTTP «Host» *deve* contenere anche l'endpoint dell'API. La richiesta avrà esito negativo se l'intestazione non è compilata. Questo è un requisito standard per tutte le richieste HTTP/1.1. Se utilizzi una libreria HTTP che supporta 1.1 o versioni successive, la libreria HTTP dovrebbe compilare automaticamente l'intestazione per te. **Nota** **Sostituiscila con l'identificatore di regione la regione in cui viene effettuata la richiesta, ad es. `us-east-1` 1. Analizza la risposta per estrarre gli endpoint e memorizza nella cache i valori TTL. [La risposta è una matrice di uno o più oggetti. `Endpoint`](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html) Ogni `Endpoint` oggetto contiene un indirizzo endpoint (`Address`) e il TTL per quell'endpoint (). `CachePeriodInMinutes` 1. Memorizza l'endpoint nella cache fino al TTL specificato. 1. Quando il TTL scade, recupera un nuovo endpoint ricominciando dalla fase 1 dell'implementazione. ## Note d'uso per il pattern di rilevamento degli endpoint + L'**DescribeEndpoints**azione è l'unica azione riconosciuta dagli endpoint regionali di Timestream Live Analytics. + La risposta contiene un elenco di endpoint contro cui effettuare chiamate all'API Timestream Live Analytics. + In caso di risposta corretta, dovrebbe esserci almeno un endpoint nell'elenco. Se nell'elenco è presente più di un endpoint, ognuno di essi è ugualmente utilizzabile per le chiamate API e il chiamante può scegliere l'endpoint da utilizzare a caso. + Oltre all'indirizzo DNS dell'endpoint, ogni endpoint nell'elenco specificherà un time to live (TTL) consentito per l'utilizzo dell'endpoint specificato in minuti. + L'endpoint deve essere memorizzato nella cache e riutilizzato per il periodo di tempo specificato dal valore TTL restituito (in minuti). Dopo la scadenza del TTL, è **DescribeEndpoints**necessario effettuare una nuova chiamata per aggiornare l'endpoint da utilizzare, poiché l'endpoint non funzionerà più dopo la scadenza del TTL. # Usando il AWS SDKs Puoi accedere ad Amazon Timestream utilizzando. AWS SDKs Timestream ne supporta due SDKs per lingua, vale a dire Write SDK e Query SDK. L'SDK di scrittura viene utilizzato per eseguire operazioni CRUD e per inserire i dati delle serie temporali in Timestream. L'SDK Query viene utilizzato per interrogare i dati delle serie temporali esistenti archiviati in Timestream. Dopo aver completato i prerequisiti necessari per il tuo SDK preferito, puoi iniziare con. [Esempi di codice](code-samples.md) **Topics** + [Java](getting-started.java.md) + [Java 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 Per iniziare a usare [Java 1.0 SDK](https://aws.amazon.com/sdk-for-java/) e Amazon Timestream, completa i prerequisiti descritti di seguito. Dopo aver completato i prerequisiti necessari per Java SDK, puoi iniziare con. [Esempi di codice](code-samples.md) ## Prerequisiti Prima di iniziare a usare Java, devi fare quanto segue: 1. Segui le istruzioni AWS di configurazione riportate in[Accesso a Timestream per LiveAnalytics](accessing.md). 1. Configura un ambiente di sviluppo Java scaricando e installando quanto segue: + Kit di sviluppo Java SE 8 (ad esempio [Amazon Corretto 8](https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.html)). + IDE Java (come [Eclipse](http://www.eclipse.org) o [IntelliJ](https://www.jetbrains.com/idea/)). Per ulteriori informazioni, consulta [Guida introduttiva a AWS SDK per Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html) 1. Configura AWS le tue credenziali e la regione per lo sviluppo: + Imposta le tue credenziali AWS di sicurezza da utilizzare con. AWS SDK per Java + Imposta la tua AWS regione per determinare il tuo Timestream predefinito per l'endpoint. LiveAnalytics ## Utilizzo di Apache Maven Puoi usare [Apache Maven](https://maven.apache.org/) per configurare e creare progetti. AWS SDK per Java **Nota** Per utilizzare Apache Maven, assicurati che Java SDK e runtime siano 1.8 o superiori. [Puoi configurare l' AWS SDK come dipendenza di Maven come descritto in Uso dell'SDK con Apache Maven.](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-project-maven.html) Puoi eseguire la compilazione ed eseguire il codice sorgente con il seguente comando: ``` mvn clean compile mvn exec:java -Dexec.mainClass= ``` **Nota** ``è il percorso della classe principale del codice sorgente Java. ## Impostazione delle AWS credenziali È [AWS SDK per Java](https://aws.amazon.com/sdk-for-java)necessario fornire AWS le credenziali all'applicazione in fase di esecuzione. *Gli esempi di codice in questa guida presuppongono che si stia utilizzando un file di AWS credenziali, come descritto nella sezione [Configurazione AWS delle credenziali e della regione per lo sviluppo nella Guida per](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup-credentials.html) gli AWS SDK per Java sviluppatori.* Di seguito è riportato un esempio di file di AWS credenziali denominato`~/.aws/credentials`, in cui il carattere tilde (`~`) rappresenta la directory home. ``` [default] aws_access_key_id = AWS access key ID goes here aws_secret_access_key = Secret key goes here ``` # Java v2 Per iniziare a usare [Java 2.0 SDK](https://aws.amazon.com/sdk-for-java/) e Amazon Timestream, completa i prerequisiti descritti di seguito. Dopo aver completato i prerequisiti necessari per l'SDK Java 2.0, puoi iniziare con. [Esempi di codice](code-samples.md) ## Prerequisiti Prima di iniziare a usare Java, è necessario effettuare le seguenti operazioni: 1. Segui le istruzioni AWS di configurazione riportate in[Accesso a Timestream per LiveAnalytics](accessing.md). 1. È possibile configurare l' AWS SDK come dipendenza di Maven come descritto in [Uso dell'SDK](https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/welcome.html) con Apache Maven. 1. Configura un ambiente di sviluppo Java scaricando e installando quanto segue: + Kit di sviluppo Java SE 8 (ad esempio [Amazon Corretto 8](https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.html)). + IDE Java (come [Eclipse](http://www.eclipse.org) o [IntelliJ](https://www.jetbrains.com/idea/)). Per ulteriori informazioni, consulta [Guida introduttiva a AWS SDK per Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html) ## Utilizzo di Apache Maven Puoi usare [Apache Maven](https://maven.apache.org/) per configurare e creare progetti. AWS SDK per Java **Nota** Per utilizzare Apache Maven, assicurati che Java SDK e runtime siano 1.8 o superiori. [Puoi configurare l' AWS SDK come dipendenza di Maven come descritto in Uso dell'SDK con Apache Maven.](https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/welcome.html) [Le modifiche richieste al file pom.xml sono descritte qui.](https://docs.aws.amazon.com/sdk-for-java/v2/migration-guide/whats-different.html#adding-v2) È possibile eseguire compile ed eseguire il codice sorgente con il seguente comando: ``` mvn clean compile mvn exec:java -Dexec.mainClass= ``` **Nota** ``è il percorso della classe principale del codice sorgente Java. # Go Per iniziare a usare [Go SDK](https://aws.amazon.com/sdk-for-go/) e Amazon Timestream, completa i prerequisiti descritti di seguito. Dopo aver completato i prerequisiti necessari per Go SDK, puoi iniziare con. [Esempi di codice](code-samples.md) ## Prerequisiti 1. [Scarica GO SDK 1.14](https://golang.org/doc/install). 1. [Configura GO SDK](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html). 1. [Costruisci il tuo cliente.](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/configuring-sdk.html) # Python Per iniziare a usare [Python SDK](https://aws.amazon.com/sdk-for-python/) e Amazon Timestream, completa i prerequisiti descritti di seguito. Dopo aver completato i prerequisiti necessari per l'SDK Python, puoi iniziare con. [Esempi di codice](code-samples.md) ## Prerequisiti [Per usare Python, installa e configura Boto3 seguendo le istruzioni qui.](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html) # Node.js Per iniziare a usare l'[SDK Node.js](https://aws.amazon.com/sdk-for-node-js/) e Amazon Timestream, completa i prerequisiti descritti di seguito. Dopo aver completato i prerequisiti necessari per l'SDK Node.js, puoi iniziare con. [Esempi di codice](code-samples.md) ## Prerequisiti Prima di iniziare con Node.js, devi fare quanto segue: 1. [Installa Node.js](https://nodejs.org/en/). 1. [Installa l' AWS SDK per JavaScript](https://aws.amazon.com/sdk-for-node-js/). # .NET Per iniziare a usare [il.NET SDK](https://aws.amazon.com/sdk-for-net/) e Amazon Timestream, completa i prerequisiti descritti di seguito. Una volta completati i prerequisiti necessari per .NET SDK, puoi iniziare con. [Esempi di codice](code-samples.md) ## Prerequisiti Prima di iniziare a usare .NET, installa i NuGet pacchetti richiesti e assicurati che la AWSSDK versione.Core sia la 3.3.107 o successiva eseguendo i seguenti comandi: ``` dotnet add package AWSSDK.Core dotnet add package AWSSDK.TimestreamWrite dotnet add package AWSSDK.TimestreamQuery ```