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à. # Utilizzo dell'origine dati Athena ## Policy IAM Grafana necessita delle autorizzazioni concesse tramite IAM per poter leggere le metriche di Athena. Puoi associare queste autorizzazioni ai ruoli IAM e utilizzare il supporto integrato di Grafana per l'assunzione dei ruoli. Tieni presente che dovrai [configurare la politica richiesta per il](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) tuo ruolo prima di aggiungere l'origine dati a Grafana. Avrai bisogno di un ruolo di amministratore o di editor per aggiungere una fonte di dati. La policy di accesso integrata di Amazon Grafana Athena è definita nella sezione. [AWS politica gestita: AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess) ## Interroga i dati di Athena L'origine dati Athena fornisce un editor di query SQL standard. Amazon Managed Grafana include alcune macro per facilitare la scrittura di query su serie temporali più complesse. Macro | Macro | Description | Esempio | Esempio di output | | --- | --- | --- | --- | | \$1\$1\$1dateFilter(column) | \$1\$1\$1dateFiltercrea un filtro condizionale che seleziona i dati (utilizzandocolumn) in base all'intervallo di date del pannello. | \$1\$1\$1date(my\$1date) | my\$1date BETWEEN date '2017-07-18' AND date '2017-07-18' | | \$1\$1\$1parseTime(column,format) | \$1\$1\$1parseTimelancia un varchar come timestamp con il formato dato. | \$1\$1\$1parseTime(eventtime, 'yyyy-MM-dd''T''HH:mm:ss''Z') | parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss''Z') | | \$1\$1\$1timeFilter(column,format) | \$1\$1\$1timeFiltercrea un condizionale che filtra i dati (utilizzandocolumn) in base all'intervallo di tempo del pannello. Il secondo argomento viene utilizzato per analizzare facoltativamente la colonna da un varchar a un timestamp con un formato specifico. | \$1\$1\$1timeFilter(time, 'yyyy-MM-dd HH:mm:ss') | TIMESTAMP time BETWEEN TIMESTAMP '2017-07-18T11:15:52Z' AND TIMESTAMP '2017-07-18T11:15:52Z' | | \$1\$1\$1timeFrom() | \$1\$1\$1timeFromrestituisce l'ora di inizio corrente dell'intervallo del pannello tra virgolette. | \$1\$1\$1timeFrom() | TIMESTAMP '2017-07-18 11:15:52' | | \$1\$1\$1timeTo() | \$1\$1\$1timeTo restituisce l'ora di fine corrente dell'intervallo del pannello tra virgolette. | \$1\$1\$1timeTo() | TIMESTAMP '2017-07-18 11:15:52' | | \$1\$1\$1timeGroup(column, '1m', format) | \$1\$1\$1timeGroup raggruppa i timestamp in modo che ci sia solo 1 punto per ogni periodo del grafico. Il terzo argomento viene utilizzato per analizzare facoltativamente la colonna da un varchar a un timestamp con un formato specifico. | \$1\$1\$1timeGroup(time,'5m','yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z') | FROM\$1UNIXTIME(FLOOR(TO\$1UNIXTIME(parse\$1datetime(time,'yyyy-MM-dd''T''HH:mm:ss.SSSSSS''Z'))/300)\$1300) | | \$1\$1\$1table | \$1\$1\$1tablerestituisce la tabella selezionata nel selettore Tabella. | \$1\$1\$1table | my\$1table | | \$1\$1\$1column | \$1\$1\$1columnrestituisce la colonna selezionata nel selettore Colonna (richiede una tabella). | \$1\$1\$1column | col1 | **Visualizzazione** La maggior parte delle interrogazioni in Athena sarà rappresentata al meglio da una visualizzazione tabellare. Una query visualizza i dati restituiti in una tabella. Se può essere interrogata, può essere visualizzata come tabella. Questo esempio restituisce i risultati per la visualizzazione di una tabella: ``` SELECT {column_1}, {column_2} FROM {table}; ``` **Visualizzazioni di serie temporali/ grafici** Per le serie temporali e le visualizzazioni grafiche, è necessario: + seleziona una colonna con un o un `date` tipo. `datetime` La `date` colonna deve essere in ordine crescente (utilizzando`ORDER BY column ASC`). + seleziona anche una colonna numerica. **Ispezione dell'interrogazione** Amazon Managed Grafana supporta macro che Athena non supporta, il che significa che una query potrebbe non funzionare se copiata e incollata direttamente in Athena. **Per visualizzare l'interrogazione interpolata completa, che funziona direttamente in Athena, fate clic sul pulsante Query Inspector.** **L'interrogazione completa viene visualizzata nella scheda Query.** ## Modelli e variabili Per ulteriori informazioni sull'aggiunta di una variabile di query Athena, vedere. [Aggiungere una variabile di query](variables-types.md#add-a-query-variable) Usa la tua fonte dati Athena come fonte di dati per le query disponibili. Qualsiasi valore richiamato da una tabella Athena può essere usato come variabile. Evita di selezionare troppi valori, poiché ciò può causare problemi di prestazioni. Dopo aver creato una variabile, puoi usarla nelle tue query Athena utilizzando. [Sintassi variabile](templates-and-variables.md#variable-syntax) Per ulteriori informazioni sulle variabili, consulta. [Modelli e variabili](templates-and-variables.md) ## Annotazioni [Annotazioni](dashboard-annotations.md)consentono di sovrapporre informazioni dettagliate sugli eventi sopra i grafici. ****È possibile aggiungere annotazioni selezionando il pannello o aggiungendo query di annotazione utilizzando la vista Annotazioni del menu Dashboard.**** Un esempio di query per aggiungere automaticamente annotazioni: ``` SELECT time as time, environment as tags, humidity as text FROM tableName WHERE $__dateFilter(time) and humidity > 95 ``` La tabella seguente rappresenta le descrizioni delle colonne che possono essere utilizzate per il rendering delle annotazioni: | Nome | Description | | --- | --- | | Time | Il nome del date/time campo. Potrebbe essere una colonna con un tipo di date/time dati SQL nativo o un valore epocale. | | Timeend | Nome opzionale del date/time campo finale. Potrebbe essere una colonna con un tipo di date/time dati SQL nativo o un valore epocale. (Grafana v6.6\$1) | | Text | Campo di descrizione dell'evento. | | Tags | Nome di campo opzionale da utilizzare per i tag degli eventi come stringa separata da virgole. | ## Supporto per dati di interrogazione asincrona Le query Athena in Amazon Managed Grafana vengono gestite in modo asincrono per evitare i timeout. Le query asincrone utilizzano richieste separate per avviare la query, verificarne lo stato di avanzamento e infine recuperare i risultati. In questo modo si evitano i timeout per le query che vengono eseguite per un lungo periodo. ## Riutilizzo dei risultati delle query È possibile riutilizzare i risultati delle query precedenti per migliorare le prestazioni delle query. Per abilitare il riutilizzo delle query, enable si trova nella sezione **Riutilizzo dei risultati delle query** dell'editor di query. Questa operazione deve essere eseguita per ogni query per la quale si desidera riutilizzare le query. **Nota** Questa funzionalità richiede che l'istanza Athena sia nella versione del motore 3. Per ulteriori informazioni, consulta [Modifica delle versioni del motore Athena](https://docs.aws.amazon.com/athena/latest/ug/engine-versions-changing.html) nella Guida per l'utente di *Amazon Athena*.