Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Verwenden der Athena-Datenquelle ## IAM-Richtlinien Grafana benötigt über IAM erteilte Berechtigungen, um Athena-Metriken lesen zu können. Sie können diese Berechtigungen an IAM-Rollen anhängen und die integrierte Unterstützung von Grafana für die Übernahme von Rollen nutzen. Beachten Sie, dass Sie [die erforderliche Richtlinie für Ihre Rolle konfigurieren](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) müssen, bevor Sie die Datenquelle zu Grafana hinzufügen können. Sie benötigen eine Administrator- oder Editorrolle, um eine Datenquelle hinzuzufügen. Die integrierte Amazon Grafana Athena-Zugriffsrichtlinie ist im [AWS verwaltete Richtlinie: AmazonGrafanaAthenaAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonGrafanaAthenaAccess) Abschnitt definiert. ## Athena-Daten abfragen Die Athena-Datenquelle bietet einen Standard-SQL-Abfrageeditor. Amazon Managed Grafana enthält einige Makros, die beim Schreiben komplexerer Zeitreihenabfragen helfen. Makros | Makro | Description | Beispiel | Beispiel für eine Ausgabe | | --- | --- | --- | --- | | \$1\$1\$1dateFilter(column) | \$1\$1\$1dateFiltererstellt einen bedingten Filter, der die Daten (mithilfecolumn) anhand des Datumsbereichs des Panels auswählt. | \$1\$1\$1date(my\$1date) | my\$1date BETWEEN date '2017-07-18' AND date '2017-07-18' | | \$1\$1\$1parseTime(column,format) | \$1\$1\$1parseTimewandelt ein Varchar als Zeitstempel mit dem angegebenen Format um. | \$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\$1timeFiltererstellt eine Bedingung, die die Daten (mithilfecolumn) auf der Grundlage des Zeitbereichs des Panels filtert. Das zweite Argument wird verwendet, um die Spalte optional von einem Varchar bis zu einem Zeitstempel mit einem bestimmten Format zu analysieren. | \$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\$1timeFromgibt die aktuelle Startzeit des Bereichs des Panels mit Anführungszeichen aus. | \$1\$1\$1timeFrom() | TIMESTAMP '2017-07-18 11:15:52' | | \$1\$1\$1timeTo() | \$1\$1\$1timeTo gibt die aktuelle Endzeit des Bereichs des Panels mit Anführungszeichen aus. | \$1\$1\$1timeTo() | TIMESTAMP '2017-07-18 11:15:52' | | \$1\$1\$1timeGroup(column, '1m', format) | \$1\$1\$1timeGroup gruppiert Zeitstempel so, dass es für jede Periode im Diagramm nur einen Punkt gibt. Das dritte Argument wird verwendet, um die Spalte optional von einem Varchar bis zu einem Zeitstempel mit einem bestimmten Format zu analysieren. | \$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\$1tablegibt die in der Tabellenauswahl ausgewählte Tabelle zurück. | \$1\$1\$1table | my\$1table | | \$1\$1\$1column | \$1\$1\$1columngibt die in der Spaltenauswahl ausgewählte Spalte zurück (es ist eine Tabelle erforderlich). | \$1\$1\$1column | col1 | **Visualisierung** Die meisten Abfragen in Athena lassen sich am besten durch eine Tabellenvisualisierung darstellen. Eine Abfrage zeigt Rückgabedaten in einer Tabelle an. Wenn sie abgefragt werden kann, kann sie als Tabelle angezeigt werden. Dieses Beispiel gibt Ergebnisse für eine Tabellenvisualisierung zurück: ``` SELECT {column_1}, {column_2} FROM {table}; ``` **Visualisierungen von Zeitreihen/Diagrammen** Für Zeitreihen- und Grafikvisualisierungen müssen Sie: + Wählen Sie eine Spalte mit einem `date` oder einem Typ aus. `datetime` Die `date` Spalte muss in aufsteigender Reihenfolge sein (mit`ORDER BY column ASC`). + wählen Sie auch eine numerische Spalte aus. **Die Abfrage wird überprüft** Amazon Managed Grafana unterstützt Makros, die Athena nicht unterstützt, was bedeutet, dass eine Abfrage möglicherweise nicht funktioniert, wenn sie direkt in Athena kopiert und eingefügt wird. Um die vollständige interpolierte Abfrage anzuzeigen, die direkt in Athena funktioniert, klicken Sie auf die Schaltfläche **Query** Inspector. **Die vollständige Abfrage wird auf der Registerkarte Abfrage angezeigt.** ## Vorlagen und Variablen Weitere Hinweise zum Hinzufügen einer Athena-Abfragevariablen finden Sie unter[Hinzufügen einer Abfragevariablen](variables-types.md#add-a-query-variable). Verwenden Sie Ihre Athena-Datenquelle als Datenquelle für die verfügbaren Abfragen. Jeder Wert, der aus einer Athena-Tabelle abgefragt wird, kann als Variable verwendet werden. Vermeiden Sie es, zu viele Werte auszuwählen, da dies zu Leistungsproblemen führen kann. Nachdem Sie eine Variable erstellt haben, können Sie sie in Ihren Athena-Abfragen verwenden, indem Sie [Syntax der Variablen](templates-and-variables.md#variable-syntax) Weitere Hinweise zu Variablen finden Sie unter[Vorlagen und Variablen](templates-and-variables.md). ## Anmerkungen [Anmerkungen](dashboard-annotations.md)ermöglichen es Ihnen, umfangreiche Ereignisinformationen über Grafiken zu legen. Sie können Anmerkungen hinzufügen, indem Sie den Bereich auswählen oder mithilfe der Ansicht **Anmerkungen im **Dashboard-Menü** Anmerkungen** Abfragen hinzufügen. Eine Beispielabfrage zum automatischen Hinzufügen von Anmerkungen: ``` SELECT time as time, environment as tags, humidity as text FROM tableName WHERE $__dateFilter(time) and humidity > 95 ``` Die folgende Tabelle enthält die Beschreibungen der Spalten, die zum Rendern von Anmerkungen verwendet werden können: | Name | Description | | --- | --- | | Time | Der Name des date/time Felds. Könnte eine Spalte mit einem systemeigenen date/time SQL-Datentyp oder Epochenwert sein. | | Timeend | Optionaler Name des date/time Endfeldes. Könnte eine Spalte mit einem systemeigenen date/time SQL-Datentyp oder Epochenwert sein. (Grafana v6.6\$1) | | Text | Feld für die Beschreibung des Ereignisses. | | Tags | Optionaler Feldname, der für Event-Tags als kommagetrennte Zeichenfolge verwendet werden soll. | ## Unterstützung für asynchrone Abfragedaten Athena-Abfragen in Amazon Managed Grafana werden asynchron verarbeitet, um Timeouts zu vermeiden. Asynchrone Abfragen verwenden separate Anfragen, um die Abfrage zu starten, dann ihren Fortschritt zu überprüfen und schließlich die Ergebnisse abzurufen. Dadurch werden Timeouts bei Abfragen vermieden, die über einen längeren Zeitraum ausgeführt werden. ## Wiederverwendung von Abfrageergebnissen Sie können die Ergebnisse früherer Abfragen wiederverwenden, um die Abfrageleistung zu verbessern. Um die Wiederverwendung von Abfragen zu aktivieren, finden Sie die Option Aktivieren im Abschnitt **Wiederverwendung von Abfrageergebnissen** des Abfrage-Editors. Dies muss für jede Abfrage erfolgen, die Sie wiederverwenden möchten. **Anmerkung** Für diese Funktion muss Ihre Athena-Instanz die Engine-Version 3 installiert haben. Weitere Informationen finden Sie unter [Ändern der Athena-Engine-Versionen](https://docs.aws.amazon.com/athena/latest/ug/engine-versions-changing.html) im *Amazon Athena Athena-Benutzerhandbuch*.