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.
AWS IoT TwinMaker Athena-Konnektor für tabellarische Daten
Mit dem Athena-Konnektor für tabellarische Daten können Sie auf Ihre Athena-Datenspeicher zugreifen und sie verwenden. AWS IoT TwinMaker Sie können Ihre Athena-Daten verwenden, um digitale Zwillinge ohne einen intensiven Datenmigrationsaufwand zu erstellen. Sie können entweder den vorgefertigten Connector verwenden oder einen benutzerdefinierten Athena-Connector erstellen, um auf Daten aus Ihren Athena-Datenquellen zuzugreifen.
AWS IoT TwinMaker Voraussetzungen für den Athena-Datenkonnektor
Bevor Sie den Athena Tabular Data Connector verwenden, müssen Sie die folgenden Voraussetzungen erfüllen:
Erstellen Sie verwaltete Athena-Tabellen und die zugehörigen Amazon S3-Ressourcen. Informationen zur Verwendung von Athena finden Sie in der Athena-Dokumentation.
Erstellen Sie einen Arbeitsbereich AWS IoT TwinMaker . Sie können einen Arbeitsbereich in der AWS IoT TwinMaker Konsole erstellen
. Aktualisiere deine Workspace-IAM-Rolle mit Athena-Berechtigungen. Weitere Informationen finden Sie unter Ändern Sie Ihre Workspace-IAM-Rolle, um den Athena-Datenkonnektor zu verwenden.
Machen Sie sich mit dem AWS IoT TwinMaker Entitätskomponentensystem vertraut und erfahren Sie, wie Sie Entitäten erstellen. Weitere Informationen finden Sie unter Erstelle deine erste Entität.
Machen Sie sich mit den AWS IoT TwinMaker Datenkonnektoren vertraut. Weitere Informationen finden Sie unter AWS IoT TwinMaker Datenkonnektoren.
Verwenden Sie den Athena-Datenkonnektor
Um den Athena-Datenkonnektor zu verwenden, müssen Sie eine Komponente erstellen, wobei Sie den Athena-Konnektor als Komponententyp verwenden. Anschließend fügen Sie die Komponente zur Verwendung in einer Entität in Ihrer Szene hinzu. AWS IoT TwinMaker
- Erstellen Sie einen Komponententyp mit dem Athena-Datenkonnektor
-
Gehen Sie wie folgt vor, um einen AWS IoT TwinMaker Komponententyp mit dem Athena-Konnektor für tabellarische Daten zu erstellen:
Navigieren Sie zur AWS IoT TwinMaker -Konsole
. Öffnen Sie einen vorhandenen Arbeitsbereich oder erstellen Sie einen neuen.
Wählen Sie im Navigationsmenü auf der linken Seite Komponententypen und dann Komponententyp erstellen aus, um die Seite zur Erstellung von Komponententypen zu öffnen.
Füllen Sie auf der Seite „Komponententyp erstellen“ das ID-Feld mit einer ID aus, die Ihrem Anwendungsfall entspricht.
Wählen Sie den Basistyp. Wählen Sie aus der Dropdownliste den Athena-Konnektor für tabellarische Daten aus, der als com.amazon.athena.connector gekennzeichnet ist.
Konfigurieren Sie die Datenquelle des Komponententyps, indem Sie Athena-Ressourcen für die folgenden Felder auswählen:
Wählen Sie eine Athena-Datenquelle.
Wählen Sie eine Athena-Datenbank.
Wählen Sie einen Tabellennamen.
Wählen Sie eine Athena-Arbeitsgruppe.
Nachdem Sie die Athena-Ressourcen ausgewählt haben, die Sie als Datenquelle verwenden möchten, wählen Sie aus, welche Spalten aus der Tabelle Sie einbeziehen möchten.
Wählen Sie einen Spaltennamen für die externe ID aus. Wählen Sie eine Spalte aus dem vorherigen Schritt aus, die als externe ID-Spalte dienen soll. Die externe ID ist die ID, die verwendet wird, um ein Athena-Asset darzustellen und es einer AWS IoT TwinMaker Entität zuzuordnen.
(Optional) Fügen Sie diesen Ressourcen AWS Tags hinzu, damit Sie sie gruppieren und organisieren können.
Wählen Sie Komponententyp erstellen, um die Erstellung des Komponententyps abzuschließen.
- Erstellen Sie eine Komponente mit dem Athena-Datenkonnektortyp und hängen Sie sie an eine Entität an
-
Gehen Sie wie folgt vor, um eine AWS IoT TwinMaker Komponente mit dem Athena-Konnektor für tabellarische Daten zu erstellen und sie an eine Entität anzuhängen:
Anmerkung
Sie müssen über einen vorhandenen Komponententyp verfügen, der den Athena-Konnektor für tabellarische Daten als Datenquelle verwendet, um dieses Verfahren abschließen zu können. Lesen Sie das vorherige Verfahren Erstellen Sie einen Komponententyp mit dem Athena-Datenkonnektor, bevor Sie mit dieser exemplarischen Vorgehensweise beginnen.
Navigieren Sie zur AWS IoT TwinMaker -Konsole
. Öffnen Sie einen vorhandenen Arbeitsbereich oder erstellen Sie einen neuen.
Wählen Sie im Navigationsmenü auf der linken Seite Entitäten und wählen Sie die Entität aus, der Sie die Komponente hinzufügen oder eine neue Entität erstellen möchten.
Wählen Sie als Nächstes Komponente hinzufügen aus. , füllen Sie das Feld Komponentenname mit einem Namen aus, der Ihrem Anwendungsfall entspricht.
Wählen Sie im Dropdownmenü Komponententyp die Komponententyp-ID aus, die Sie im vorherigen Verfahren erstellt haben.
Geben Sie die Komponenteninformationen und einen Komponentennamen ein und wählen Sie das zuvor ComponentType erstellte Kind aus. Dies ist der, den ComponentType Sie mit dem Athena-Datenkonnektor erstellt haben.
Geben Sie im Abschnitt Eigenschaften die Athene ComponentExternalId für die Komponente ein.
Wählen Sie Komponente hinzufügen, um die Erstellung der Komponente abzuschließen.
Sie haben jetzt erfolgreich eine Komponente mit dem Athena-Datenkonnektor als Komponententyp erstellt und sie an eine Entität angehängt.
Verwenden der JSON-Referenz für den Athena-Datenkonnektor für tabellarische Daten
Das folgende Beispiel ist die vollständige JSON-Referenz für den Athena-Konnektor für tabellarische Daten. Verwenden Sie dies als Ressource, um benutzerdefinierte Datenkonnektoren und Komponententypen zu erstellen.
{ "componentTypeId": "com.amazon.athena.connector", "description": "Athena connector for syncing tabular data", "workspaceId":"AmazonOwnedTypesWorkspace", "propertyGroups": { "tabularPropertyGroup": { "groupType": "TABULAR", "propertyNames": [] } }, "propertyDefinitions": { "athenaDataSource": { "dataType": { "type": "STRING" }, "isRequiredInEntity": true }, "athenaDatabase": { "dataType": { "type": "STRING" }, "isRequiredInEntity": true }, "athenaTable": { "dataType": { "type": "STRING" }, "isRequiredInEntity": true }, "athenaWorkgroup": { "dataType": { "type": "STRING" }, "isRequiredInEntity": true }, "athenaExternalIdColumnName": { "dataType": { "type": "STRING" }, "isRequiredInEntity": true, "isExternalId": false }, "athenaComponentExternalId": { "dataType": { "type": "STRING" }, "isStoredExternally": false, "isRequiredInEntity": true, "isExternalId": true } }, "functions": { "tabularDataReaderByEntity": { "implementedBy": { "isNative": true } } } }
Verwenden Sie den Athena-Datenkonnektor
Sie können Ihre Entitäten, die Athena-Tabellen verwenden, in Grafana anzeigen. Weitere Informationen finden Sie unter AWS IoT TwinMaker Grafana-Dashboard-Integration.
Informationen zum Erstellen und Verwenden von Athena-Tabellen zum Speichern von Daten finden Sie in der Athena-Dokumentation.
Fehlerbehebung beim Athena-Datenkonnektor
Dieses Thema behandelt häufig auftretende Probleme, die bei der Konfiguration des Athena-Datenkonnektors auftreten können.
- Standort der Athena-Arbeitsgruppe:
-
Bei der Erstellung von ComponentType für den Athena-Konnektor muss für eine Athena-Arbeitsgruppe der Ausgabeort eingerichtet werden. Weitere Informationen finden Sie unter So funktionieren Arbeitsgruppen.
- Fehlende IAM-Rollenberechtigungen:
-
Der Rolle AWS IoT TwinMaker; workspace fehlt möglicherweise die Athena-API-Zugriffsberechtigung, wenn Sie einen ComponentType erstellen, einer Entität eine Ca-Komponente hinzufügen oder die API ausführen. GetPropertyValue Informationen zum Aktualisieren von IAM-Berechtigungen finden Sie unter Erstellen und Verwalten einer Servicerolle für. AWS IoT TwinMaker
Visualisieren Sie die tabellarischen Athena-Daten in Grafana
Ein Grafana-Plugin ist ebenfalls verfügbar, um Ihre tabellarischen Daten auf Grafana zu visualisieren, einem Dashboard-Panel mit zusätzlichen Funktionen wie Sortieren und Filtern anhand ausgewählter Eigenschaften, ohne API-Aufrufe oder Interaktionen mit Athena zu AWS IoT TwinMaker tätigen. In diesem Thema erfahren Sie, wie Sie Grafana für die Visualisierung tabellarischer Athena-Daten konfigurieren.
Voraussetzungen
Bevor Sie ein Grafana-Panel für die Visualisierung tabellarischer Athena-Daten konfigurieren, überprüfen Sie die folgenden Voraussetzungen:
Sie haben eine Grafana-Umgebung eingerichtet. Weitere Informationen finden Sie unter AWS IoT TwinMaker Grafana-Integration.
Sie können eine Grafana-Datenquelle konfigurieren. Weitere Informationen finden Sie unter Grafana. AWS IoT TwinMaker
Sie sind mit dem Erstellen eines neuen Dashboards und dem Hinzufügen eines neuen Panels vertraut.
Visualisieren Sie die tabellarischen Athena-Daten in Grafana
Dieses Verfahren zeigt Ihnen, wie Sie ein Grafana-Panel einrichten, um die tabellarischen Athena-Daten zu visualisieren.
Öffnen Sie Ihr Grafana-Dashboard AWS IoT TwinMaker .
Wählen Sie in den Panel-Einstellungen das Bedienfeld Tabelle aus.
Wählen Sie Ihre Datenquelle in der Abfragekonfiguration aus.
Wählen Sie die Abfrage „Eigenschaftswert abrufen“ aus.
Wählen Sie eine Entity aus.
Wählen Sie eine Komponente aus, deren ComponentType den Athena-Basiskomponententyp erweitert.
Wählen Sie die Eigenschaftsgruppe Ihrer Athena-Tabelle aus.
Wählen Sie eine beliebige Anzahl von Eigenschaften aus der Eigenschaftsgruppe aus.
Konfigurieren Sie die tabellarischen Bedingungen mithilfe einer Liste von Filtern und Eigenschaftsreihenfolgen. Mit den folgenden Optionen:
Filter: Definieren Sie einen Ausdruck für einen Eigenschaftswert, um Ihre Daten zu filtern.
OrderBy: Geben Sie an, ob Daten für eine Eigenschaft in aufsteigender oder absteigender Reihenfolge zurückgegeben werden sollen.
