# 棒グラフ

棒グラフは、セグメント別に分解されたデータを視覚化するのに役立ちます。

<figure><img src="/files/xM4NpgRkmXY9MlgU5SW9" alt="Bar chart example"><figcaption></figcaption></figure>

NQLクエリには、セグメンテーションラベルと集約が必要です。

## データの形状 <a href="#barchart-datashape" id="barchart-datashape"></a>

`<segmentation 1>, (<segmentation 2>, <segmentation 3>,...) <kpi 1>, (<kpi 2>, <kpi 3>, ...)`

棒グラフのNQLクエリ構造は以下のケースに依存します：

* [デフォルトのブレークダウン無効時の棒グラフ用NQL](#nql-for-bar-charts-without-a-breakdown-dropdown)
* [デフォルトのブレークダウン有効時の棒グラフ用NQL](#nql-for-bar-charts-with-a-breakdown-dropdown)

## デフォルトのブレークダウンが無効化された棒グラフのNQL構造 <a href="#barcharts-without-breakdowns" id="barcharts-without-breakdowns"></a>

[棒グラフ特有の視覚化フィールドを構成する](#linechart-linechartspecificsettings)場合、**デフォルトの内訳を有効にする**を選択しないと、以下のNQL構造に従う必要があります。

```
...
<kpi1>, <kpi2>, ...を要約する by <segmentation1>, <segmentation2>, ...
```

この場合、クエリ内で常に `by <segmentation1>,...` を指定してください。

{% hint style="info" %}
[ライブダッシュボードNQL例](/platform/ja/user-guide/live-dashboards/live-dashboards-nql-examples.md#livedashboardsnqlexamples-barchart) のドキュメントでクエリの例を確認してください。
{% endhint %}

## デフォルトのブレークダウンが有効化された棒グラフ用NQL構造 <a href="#barcharts-with-breakdowns" id="barcharts-with-breakdowns"></a>

特定の棒グラフにおける[可視化フィールドを構成する](#linechart-linechartspecificsettings)際、**デフォルトのブレークダウンを有効化** する場合は、以下のNQL構造に従う必要があります。

<pre><code><strong>...
</strong><strong>summarize , , ... 
</strong></code></pre>

この場合、クエリから `by <segmentation1>,...` を省略できます。システムはブレークダウンドロップダウンのオプションをデフォルトで使用します。 下の画像の **プレビュー** セクションを参照してください。

{% hint style="info" %}
[ライブダッシュボードNQL例](/platform/ja/user-guide/live-dashboards/live-dashboards-nql-examples.md#livedashboardsnqlexamples-barchart) のドキュメントでクエリの例を確認してください。
{% endhint %}

<figure><img src="/files/GDIryws8TMkQJuTQJbE2" alt=""><figcaption></figcaption></figure>

## 棒グラフの列名—デフォルトのブレークダウンに関わらず <a href="#barchart-columnnames" id="barchart-columnnames"></a>

NQLクエリの変数名は列のラベルとして使用されます。

<figure><img src="/files/zD1l06sfwvBgkG2S9ZAk" alt="Column names"><figcaption></figcaption></figure>

変数名は次のヒューリスティックでフォーマットされます。

* アンダースコアはスペースに置き換えられます。
* 変数の最初の文字が大文字に変更されます。

{% hint style="info" %}
ライブダッシュボードの棒グラフウィジェットでは、チャートの列ヘッダーをクリックすることで結果をソートできます。
{% endhint %}

<figure><img src="/files/PeTwihcJtWpj4KiZDUES" alt="Sorting bar chart results by column data."><figcaption></figcaption></figure>

***

## 棒グラフに特有のビジュアルフィールドの設定 <a href="#linechart-linechartspecificsettings" id="linechart-linechartspecificsettings"></a>

{% hint style="info" %}
[ライブダッシュボードの管理](/platform/ja/user-guide/live-dashboards/managing-live-dashboards.md#filling-in-widget-visualization-fields)のドキュメントを参照し、このウィジェットに特有ではない構成フィールドを埋める方法を学んでください。
{% endhint %}

[ウィジェットの追加](/platform/ja/user-guide/live-dashboards/managing-live-dashboards.md#adding-widgets)/[ウィジェットの編集](/platform/ja/user-guide/live-dashboards/managing-live-dashboards.md#managing-widgets)ポップアップで**棒グラフ**オプションを**チャートタイプ**ドロップダウンから選択後:

1. ウィジェットに\*\*タイトル（任意）\*\*をつけてください。
2. メトリックの解釈、計算方法、またはメトリックの詳細を説明するために\*\*ウィジェットの説明（任意）\*\*を入力してください。
   * ダッシュボード内の棒グラフウィジェットの横にある情報アイコンにホバーするとウィジェットの説明が表示されます。
3. 選択した**グローバルタイムピッカー**（期間）やダッシュボードに適用された**グローバルフィルター**に従って棒グラフの結果が更新されるかどうか判断します。
   * ライブダッシュボードの棒グラフウィジェットでは、アクションメニューで**すべての結果を表示**または**フィルタされたデータを表示**を選択できます。
4. コンテナに表示される**最大行数**を定義します。
   * チャートの結果が定義された制限を超えた場合、dashboardには**もっと読み込む**ボタンが表示されます。

***

関連トピック

* [KPI](/platform/ja/user-guide/live-dashboards/widget-types/kpi.md)
* [折れ線グラフ](/platform/ja/user-guide/live-dashboards/widget-types/line-chart.md)
* [単一メトリックのゲージチャート](/platform/ja/user-guide/live-dashboards/widget-types/single-metric-gauge-chart.md)
* [複数メトリックのゲージチャート](/platform/ja/user-guide/live-dashboards/widget-types/multi-metric-gauge-chart.md)
* [テーブル](/platform/ja/user-guide/live-dashboards/widget-types/table.md)
* [見出し](/platform/ja/user-guide/live-dashboards/widget-types/heading.md)
* [フィルタウィジェット](/platform/ja/user-guide/live-dashboards/widget-types/filter-widget.md)
* [タイムフレームピッカー](/platform/ja/user-guide/live-dashboards/widget-types/timeframe-picker.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.nexthink.com/platform/ja/user-guide/live-dashboards/widget-types/bar-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.