翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS IoT TwinMaker Athena 表形式データコネクタ
Athena 表形式データコネクタを使用すると、 AWS IoT TwinMakerにある Athena データストアにアクセスして使用できます。大量のデータ移行作業を行わなくても、Athena データを使用してデジタルツインを構築できます。構築済みのコネクタを使用するか、カスタム Athena コネクタを作成して Athena データソースのデータにアクセスできます。
## AWS IoT TwinMaker Athena データコネクタの前提条件
Athena 表形式データコネクタを使用する前に、次の前提条件を完了してください。
+ マネージド Athena テーブルと関連する Amazon S3 リソースを作成します。Athena の使用については、[Athena のドキュメント](https://docs.aws.amazon.com//athena/latest/ug/what-is.html)を参照してください。
+ AWS IoT TwinMaker ワークスペースを作成します。ワークスペースは、[AWS IoT TwinMaker コンソール](https://console.aws.amazon.com/iottwinmaker/)で作成できます。
+ Athena アクセス許可を使用してワークスペースの IAM ロールを更新します。詳細については、「[Athena データコネクタを使用するようにワークスペース IAM ロールを変更する](twinmaker-gs-service-role.md#athena-tabular-data-connector-ws-IAM)」を参照してください。
+ AWS IoT TwinMakerのエンティティコンポーネントシステムおよびエンティティの作成方法を理解します。詳細については、「[最初のエンティティを作成する](twinmaker-gs-entity.md)」を参照してください。
+ AWS IoT TwinMakerのデータコネクタに精通します。詳細については、「[AWS IoT TwinMaker データコネクタ](data-connector-interface.md)」を参照してください。
## Athena データコネクタを使用する
Athena データコネクタを使用するには、Athena コネクタをコンポーネントタイプとして使用してコンポーネントを作成する必要があります。次に、 AWS IoT TwinMakerで使用するために、コンポーネントをシーン内のエンティティにアタッチします。
**Athena データコネクタを使用してコンポーネントタイプを作成する**
この手順を使用して、Athena 表形式データコネクタで AWS IoT TwinMaker コンポーネントタイプを作成します。
1. [AWS IoT TwinMaker コンソール](https://console.aws.amazon.com/iottwinmaker/)に移動します。
1. 既存のフローを開くか、[新しく作成](twinmaker-gs-workspace.md)します。
1. 左側のナビゲーションメニューから **[コンポーネントタイプ]** を選択し、**[コンポーネントタイプの作成]** を選択してコンポーネントタイプ作成ページを開きます。
1. **[コンポーネントタイプの作成]** ページで、**ID** フィールドにユースケースに一致する ID を入力します。
1. **ベースタイプ**を選択します。ドロップダウンリストから、**com.amazon.athena.connector** というラベルが付いている Athena 表形式データコネクタを選択します。
1. 以下のフィールドで Athena リソースを選択して、コンポーネントタイプの**データソース**を設定します。
+ **Athena データソース**を選択します。
+ **[Athena データベース]** を選択します。
+ **テーブル名**を選択します。
+ **[Athena workGroup]** を選択します。
1. データソースとして使用する Athena リソースを選択したら、含める列をテーブルから選択します。
1. **[外部 ID 列名]** を選択します。前のステップから外部 ID 列として使用する列を選択します。外部 ID は、Athena アセットを表し、 AWS IoT TwinMaker エンティティにマッピングするために使用される ID です。
1. **(オプション)** これらのリソースに AWS タグを追加して、グループ化および整理できるようにします。
1. 「**コンポーネントタイプの作成**」を選択して、コンポーネントタイプの作成を終了します。
**Athena データコネクタタイプのコンポーネントを作成し、エンティティにアタッチします。**
この手順を使用して、Athena 表形式データコネクタを使用して AWS IoT TwinMaker コンポーネントを作成し、エンティティにアタッチします。
この手順を完了するには、Athena 表形式データコネクタをデータソースとして使用する既存のコンポーネントタイプが必要です。このウォークスルーを開始する前に、前の手順「**Athena データコネクタを使用してコンポーネントタイプを作成する**」を参照してください。
1. [AWS IoT TwinMaker コンソール](https://console.aws.amazon.com/iottwinmaker/)に移動します。
1. 既存のフローを開くか、[新しく作成](twinmaker-gs-workspace.md)します。
1. 左側のナビゲーションメニューから**エンティティ**を選択し、コンポーネントを追加するエンティティを選択するか、新しいエンティティを作成します。
1. [ 新しいエンティティを作成します](https://docs.aws.amazon.com//iot-twinmaker/latest/guide/twinmaker-gs-entity.html)。
1. 次に「**コンポーネントを追加**」を選択します。次に、「**コンポーネント名**」フィールドに、ユースケースに合った名前を入力します。
1. 「**コンポーネントタイプ**」ドロップダウンメニューから、前の手順で作成した**コンポーネントタイプ ID** を選択します。
1. **[コンポーネント情報]** と **[コンポーネント名]** を入力し、以前に作成した子コンポーネントタイプを選択します。これは Athena データコネクタで作成したコンポーネントタイプです。
1. **[プロパティ]** セクションに、コンポーネントの **[AthenaComponentExternalID]** を入力します。
1. **コンポーネントを追加**を選択して、コンポーネントの作成を終了します。
これで、Athena データコネクタをコンポーネントタイプとして使用するコンポーネントの作成とエンティティへのアタッチが完了しました。
## Athena 表形式データコネクタ JSON リファレンスの使用
以下の例は、Athena 表形式データコネクタの完全な JSON リファレンスです。これをリソースとして使用して、カスタムデータコネクタとコンポーネントタイプを作成します。
```
{
"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
}
}
}
}
```
## Athena データコネクタを使用する
Grafana では Athena テーブルを使用しているエンティティを表示できます。詳細については、「[AWS IoT TwinMaker Grafana ダッシュボードのインテグレーション](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/grafana-integration.html)」を参照してください。
Athena テーブルを作成して使用してデータを保存する方法については、「[Athena のドキュメント](https://docs.aws.amazon.com//athena/latest/ug/what-is.html)」を参照してください。
### Athena データコネクタのトラブルシューティング
このトピックでは、Athena データコネクタを設定するときに発生する可能性がある一般的な問題について説明します。
Athena ワークグループの場所:
Athena コネクタコンポーネントタイプを作成する場合、Athena ワークグループには出力場所を設定する必要があります。[ワークグループの仕組み](https://docs.aws.amazon.com//athena/latest/ug/user-created-workgroups.html)を参照してください。
IAM ロールの権限がありません:
componentType の作成、エンティティへの Ca コンポーネントの追加、または GetPropertyValue API の実行時に、 AWS IoT TwinMakerワークスペースロールに Athena API アクセス許可がない可能性があります。IAM アクセス許可を更新するには、[「 のサービスロールの作成と管理 AWS IoT TwinMaker](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/twinmaker-gs-service-role.html)」を参照してください。
## Athena の表形式データを Grafana で視覚化する
Grafana プラグインは、API コールや Athena とのやり取りを行わずに、選択したプロパティに基づくソートやフィルタリングなどの追加機能を備えたダッシュボードパネルを AWS IoT TwinMaker Grafana で表形式データを視覚化するためにも使用できます。このトピックでは、Athena の表形式データを視覚化するように Grafana を設定する方法を説明します。
### 前提条件
Athena の表形式データを視覚化するように Grafana パネルを設定する前に、以下の前提条件を確認してください。
+ Grafana 環境をセットアップしていること。詳細については、「[AWS IoT TwinMaker Grafana のインテグレーション](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/grafana-integration.html)」を参照してください。
+ Grafana データソースを設定できること。詳細については、[「Grafana AWS IoT TwinMaker](https://github.com/grafana/grafana-iot-twinmaker-app/blob/main/src/datasource/README.md)」を参照してください。
+ 新しいダッシュボードを作成し、新しいパネルを追加するのに慣れていること。
### Athena の表形式データを Grafana で視覚化する
この手順では、Grafana パネルを使用して Athena の表形式のデータを視覚化する方法を示します。
1. AWS IoT TwinMaker Grafana ダッシュボードを開きます。
1. パネル設定で **[テーブル]** パネルを選択します。
1. クエリ設定でデータソースを選択します。
1. **[プロパティ値の取得]** クエリを選択します。
1. エンティティを選択します。
1. **Athena** ベースコンポーネントタイプを拡張する ComponentType を持つコンポーネントを選択します。
1. Athena テーブルのプロパティグループを選択します。
1. プロパティグループから任意の数のプロパティを選択します。
1. フィルターとプロパティの順序のリストを使用して表形式の条件を設定します。オプションは次のとおりです。
+ **フィルター**: プロパティ値の式を定義してデータをフィルターします。
+ **OrderBy**: プロパティのデータを昇順または降順で返すかどうかを指定します。
