# EMQX Tables を Grafana に接続する

[Grafana](https://grafana.com/) は、時系列データの監視と可視化に広く使われているオープンソースプラットフォームです。EMQX Tables を **MySQL** データソースとして Grafana に接続し、ダッシュボードを作成してデータを分析できます。

## ステップ 1: EMQX Tables をデータソースとして追加する

1. Grafana で **Connections > Data sources** に移動し、**Add data source** をクリックします。
2. データソースの種類として **MySQL** を選択します。
3. 接続情報を設定します。  
   > これらの認証情報は、Console の EMQX Tables **Deployment Overview** ページで確認できます。
   
   - **Host**: `{YOUR_EMQX_TABLES_PUBLIC_HOST}`
   - **Port**: `4002`
   - **Database**: `{YOUR_EMQX_TABLES_DB_NAME}`
   - **Username**: `{YOUR_EMQX_TABLES_USERNAME}`
   - **Password**: `{YOUR_EMQX_TABLES_PASSWORD}`
4. **Save & Test** をクリックして接続を検証します。

## ステップ 2: ダッシュボードを作成する

::: tip 注意

**必ず生の SQL エディターを使用してください。**  
Grafana の SQL クエリビルダーは、タイムスタンプ型の違いにより EMQX Tables と互換性がありません。

:::

1. 新規または既存のダッシュボードを開きます。

2. **パネル** を追加し、クエリセクションで **Code** モードに切り替えます。

3. EMQX Tables からデータを取得する SQL クエリを記述します。例：

   ```sql
   SELECT
     timestamp_column AS time,
     temperature AS value,
     location AS metric
   FROM sensor_data
   WHERE $__timeFilter(timestamp_column)
   ```

4. **Apply** をクリックしてパネルを保存し、可視化します。

## リファレンス

Grafana での MySQL データソース設定の詳細は、[公式ドキュメント](https://grafana.com/docs/grafana/latest/datasources/mysql/)をご参照ください。
