# テーブルチャート

## 描画タイプ

テーブルチャートでは、以下の描画タイプが選択できます。

| <p>ローテーブル </p><p><picture><source srcset="/files/0q3RCR2xy7GGLxBYJea9" media="(prefers-color-scheme: dark)"><img src="/files/ikNyBqstPVdnhFlbYYjd" alt="Table Raw"></picture></p> | <p>集計テーブル </p><p><picture><source srcset="/files/xrfZtKGyM4QO5etA8nQk" media="(prefers-color-scheme: dark)"><img src="/files/N9otS0YMTZxRUTquAURf" alt="Table Aggregated"></picture></p> |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

## 仕様

### ソースタイプ

テーブルチャートは2種類のソースタイプを持ち、選択したソースタイプによりデータの集計・表示の仕様が異なります。

| ソースタイプ        | 説明           | カラムの役割                                                                              |
| ------------- | ------------ | ----------------------------------------------------------------------------------- |
| ローデータ（ローテーブル） | 取得した行をそのまま表示 | 表示対象のカラムの選択                                                                         |
| 集計データ（集計テーブル） | グループ化して集計    | [グループ化（ディメンション）、値（メトリクス）](/data-exploration/chart/chart-common.md#dimension-metric) |

## Tips

### 画像表示

カラムの値で画像URLを指定して、「詳細設定」>「カラム設定」>「画像URLプレビュー」から「有効化」をオンにすることで、カラムで指定したURLの画像をテーブルチャート内で表示できます。

| <picture><source srcset="/files/QnSNn1a0rcjEMIPKYviJ" media="(prefers-color-scheme: dark)"><img src="/files/FeVA1j0PgrqJtqhICORj" alt="Table Image Preview"></picture> |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

### リンク表示

カラムの値でURLを指定して、「詳細設定」>「カラム設定」>「リンクURLを有効化」をオンにすることで、カラムで指定したURLを新しいタブで開くリンクをテーブルチャート内で表示できます。

| <picture><source srcset="/files/51HRRQ3GIHx14N4Z7iGd" media="(prefers-color-scheme: dark)"><img src="/files/cakbIz16TdaiFmJlFFlc" alt="Table Link URL"></picture> |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |

#### レポートへのパラメータ付きリンクを作成する

SQLクエリで動的にURLを生成することで、テーブルの各行のデータをパラメータとして別のレポートページに渡すことができます。

1. レポートの作成とURLの取得
   * 遷移先のレポートにパラメータを設定し、ブラウザのアドレスバーからURLを取得します。
     * `URLの例：https://app.codatum.com/workspace/{workspace_id}/report/{report_id}/{page_id}`
   * パラメータIDの確認方法： レポート内のパラメータウィジェットのIDをメモしておきます（例：`68f369edf5e6f69036b8872d`）　　
2. SQLでURL列を作成
   * CONCAT関数を使って、各行のデータをパラメータに含むURLを生成しchartに挿入します。
   * 単一パラメータの例（国名）:

     ```sql
     CONCAT(
       'https://app.codatum.com/workspace/{workspace_id}/report/{report_id}/{page_id}?cdm.params.{パラメータID}=',
       country  --- パラメータに渡したい列名
     ) AS link
     ```
3. テーブルチャートでリンクを有効化
   * テーブルチャート設定 → カラム設定 → 該当列 → 「リンクURLを有効化」をオンにします。

補足

* countryの部分は、パラメータに渡したいデータベースの列名に置き換えてください
* パラメータウィジェットの現在値をSQL内で参照することはできません（固定値または列の値のみ）
* ユーザーがセルをクリックすると、新しいタブでレポートが開きます
* パラメータの設定方法詳細は[こちら](/data-exploration/parameter-overview/set-parameters-via-url.md)からご確認ください


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.codatum.jp/data-exploration/chart/table-chart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
