翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# クエリ
<a name="panel-queries"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

 Grafana ワークスペースのパネルは、*クエリ*を使用してデータソースと通信し、視覚化用データを取得します。クエリは、データソースで使用すクエリ言語で記述された質問です。クエリが適切に形成されると、データソースが応答します。パネルのデータソースオプションでは、クエリがデータソースに送信される頻度と、収集されるデータポイント数を調整できます。

 Grafana ワークスペースは、パネルごとに最大 26 個のクエリをサポートします。

## クエリエディタ
<a name="query-editors"></a>

 クエリエディタはクエリの記述に役立つフォームです。データソースによっては、クエリエディタが自動完了機能、メトリクス名、または変数の提案が用意されている場合があります。

 クエリ言語の違いにより、各データソースのクエリエディタの外観が異なる場合があります。

## クエリ構文
<a name="query-syntax"></a>

 データソースがデータを求めるためのクエリ言語と構文が異なります。これらはその 2 つのクエリ例です。

 **[PostgreSQL]** 

```
SELECT hostname FROM host WHERE region IN($region)
```

 **PromQL** 

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

 データソースのクエリの書き込みについては、そのデータソースのドキュメントを参照してください。データソースは [データソースに接続する](AMG-data-sources.md) に一覧されています。

## クエリタブ UI
<a name="query-tab-ui"></a>

 **[クエリ]** タブは以下の要素で設定されています。
+  データソースセレクター 
+  クエリオプション 
+  クエリインスペクターボタン 
+  クエリエディタリスト 

### データソースセレクター
<a name="data-source-selector"></a>

 データソースセレクターはドロップダウンリストです。追加済みのデータソースを選択するには、これを選択します。パネルを作成すると、Amazon Managed Grafana によりデフォルトのデータソースが自動的に選択されます。データソースの詳細については、「[データソースに接続する](AMG-data-sources.md)」を参照してください。

 Grafana ワークスペースで設定されたデータソースに加え、3 つの特別なデータソースを使用できます。
+ **TestDataDB** – ランダムな歩行データを生成する組み込みデータソースです。Grafana データソースは視覚化のテストや実験の実行に役立ちます。
+  **混合** – 同じパネル内の複数のデータソースをクエリするためのデータソースです。このデータソースを選択すると、追加する新しいクエリすべてにデータソースを選択できます。
  +  最初のクエリでは、**[混合]** を選択する前に選択済みのデータソースを使用します。
  +  既存のクエリを変更して混合データソースを使用することはできません。
+ **ダッシュボード** – 同じダッシュボード内の別のパネルの一連の結果を使用するためのデータソースです。

### クエリオプション
<a name="query-options"></a>

 選択したデータソースの設定を表示するには、データソースセレクターの横にある **[クエリオプション]** を選択します。ここで行った変更はこのパネルで行われたクエリにのみ影響します。

 Amazon Managed Grafana はダークグレーテキストで表示されるデフォルトを設定します。変更はホワイトテキストで表示されます。フィールドをデフォルト設定に戻すには、フィールドからホワイトテキストを削除します。

 次のパネルデータソースのクエリオプションを使用できます。
+  **[最大データポイント数]** – データソースがサポートしている場合、返される各シリーズのデータポイントの最大数を設定します。クエリが最大データポイント設定よりも多くのデータポイントを返す場合、データソースはそれらを統合します (平均、最大、または他の関数で集計することで、返されるポイントの数を減らします)。

   ポイント数を制限する主な 2 つの理由は、パフォーマンスおよびラインの平滑化です。デフォルト値はグラフの幅 (またはピクセル数) で、これにより、大きすぎてグラフパネルが表示できないデータポイントがなくなります。

   ストリーミングデータでは、ローリングバッファに最大データポイント値が使用されます。(ストリーミングはデータの継続的なフローであり、バッファリングはストリームをチャンクに分割する方法です)。
+  **最小間隔** – 自動計算された間隔の最小制限を設定します。これは通常、最小スクレイプ間隔です。データポイントを 15 秒ごとに保存する場合、それよりも間隔を短くする必要はありません。もう 1 つのユースケースは、スクレイプ間隔よりも高い最小値に設定して、粗く適切に機能するクエリを取得することです。
+  **間隔** – データポイントを時間別に集計またはグループ化するときに使用できる時間範囲です。

   Amazon Managed Grafana は、テンプレートクエリで変数として使用できる適切な間隔を、自動的に計算します。変数は秒: `$__interval`、ミリ秒: `$__interval_ms` のいずれかです。通常、`sum` や `average` などの集計関数で使用されます。例えば、これは間隔変数 `rate(http_requests_total[$__interval])` を使用する Prometheus クエリです。

   この自動間隔は、グラフの幅に基づいて計算されます。ユーザーがズームアウトすると間隔が大きくなり、より粗視化された集計になります。ユーザーがズームインすると間隔が短くなり、より高精細な集計になります。

   詳細については、「[グローバル変数](variables-types.md#global-variables)」を参照してください。
+  **[相対時間]** – 個々のパネルの相対時間範囲をオーバーライドし、これによりパネルは、ダッシュボードの右上隅にあるダッシュボードタイムピッカーで選択されている時間とは異なります。これにより同じダッシュボードに異なる期間または日数のメトリクスを表示できます。
+  **[タイムシフト]** – 個々のパネルの時間範囲を上書きする別の方法です。この関数は相対時間範囲でのみ機能し、その時間範囲を調整できます。

   例えば、パネルの時間範囲をダッシュボードのタイムピッカーより 2 時間早くシフトできます。詳細については、「[時間範囲コントロール](dashboard-time-range-controls.md)」を参照してください。
+  **[キャッシュタイムアウト]** – (このフィールドはデータソースで使用可能な場合にのみ表示されます)。時系列ストアにクエリキャッシュがある場合、デフォルトのキャッシュタイムアウトが上書きされます。数値 (秒単位) として指定します。

### クエリインスペクターボタン
<a name="query-inspector-button"></a>

 ** クエリインスペクター]** を選択すると、パネルインスペクターの **[クエリ]** タブを開くことができます。**[クエリ]** タブには、パネルとレスポンスによって送信されたクエリリクエストが表示されます。

 **[更新]** を選択すると、このパネルからサーバーに送信されたリクエストの全文が表示されます。

**注記**  
 クエリインスペクターが結果を返すようにするには、少なくとも 1 つのクエリを追加する必要があります。

 パネルインスペクターの詳細については、「[パネルの検査](inspect-a-panel.md)」を参照してください。

### クエリエディタリスト
<a name="query-editor-list"></a>

 UI では、クエリは折りたたみ可能なクエリ行に整理されます。各クエリ行にはクエリエディタが含まれ、文字 (A、B、C など) で識別されます。

## パネル間のクエリ結果の共有
<a name="share-query-results-between-panels"></a>

 Amazon Managed Grafana では、1 つのパネルのクエリ結果をダッシュボード内の他の任意のパネルで使用できます。パネル間でクエリ結果を共有すると、データソースに対して実行されるクエリの数が減少し、ダッシュボードのパフォーマンスが向上します。

 ダッシュボードのデータソースを使用すると、結果を共有するクエリを含むダッシュボード内のパネルを選択できます。パネルごとに個別のクエリを送信する代わりに、Amazon Managed Grafana は 1 つのクエリを送信し、他のパネルはクエリ結果を使用して視覚化を構築します。

 この戦略により、同じデータを視覚化するパネルが複数ある場合などに、実行されるクエリ数を大幅に減らすことができます。

**データソースクエリを別のパネルと共有する方法**

1.  ダッシュボードを作成します。詳細については、「[ダッシュボードの作成](getting-started-grafanaui.md#create-a-dashboard)」を参照してください。

1.  パネルを追加します。詳細については、「[パネルの追加](add-a-panel-to-a-dashboard.md)」を参照してください。

1.  タイトルを「**Source panel**」に変更します。このパネルを他のパネルのソースとして使用します。共有するクエリ (1 つ以上) を定義します。現在利用可能なデータソースがない場合は、**[Grafana]** データソースを使用できます。このデータソースはテストに使用できるランダムな時系列を返します。

1.  2 番目のパネルを追加してから、クエリエディタで **[ダッシュボード]** データソースを選択します。

1.  **[パネルリストから結果を使用する]** で、最初に作成したパネルを選択します。

 ソースパネルで定義されたすべてのクエリが新しいパネルで使用できるようになりました。ソースパネルで行われたクエリは、複数のパネルと共有できます。

 クエリを定義済みのパネルに移動するには、そのクエリを選択します。