

 Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、[ブログ記事](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)を参照してください。

# クエリ履歴データの表示
<a name="performance-metrics-query-history"></a>

Amazon Redshift のクエリ履歴メトリクスを使用して、次の操作を実行できます。
+ クエリのパフォーマンスの問題を分離し、診断します。
+ クエリのランタイムメトリクスとクラスターのパフォーマンスメトリクスを同じタイムラインで比較して、2 つの関連性を確認します。この操作は、パフォーマンスが低いクエリの特定、ボトルネックとなっているクエリの検索、およびワークロードに対してクラスターのサイズ変更が必要かどうかの判断に役立ちます。
+ タイムラインで選択して、特定のクエリの詳細にドリルダウンします。**クエリ ID** およびその他のプロパティがグラフの下の行に表示されている場合、クエリを選択してクエリの詳細を表示できます。詳細として、クエリの SQL ステートメント、実行の詳細、クエリプランなどが表示されます。詳細については、[クエリの詳細の表示と分析](performance-metrics-query-execution-details.md) を参照してください。
+ ロードジョブが正常に完了し、サービスレベルアグリーメント (SLA) を満たしているかどうかを確認します。

**クエリ履歴データを表示するには**

1. AWS マネジメントコンソール にサインインして、[https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/) で Amazon Redshift コンソールを開きます。

1. ナビゲーションメニューで **[クラスター]** を選択し、リストからクラスター名を選択してその詳細を開きます。クラスターの詳細が、**[クラスターのパフォーマンス]** タブ、**[クエリのモニタリング]** タブ、**[データベース]** タブ、**[データ共有]** タブ、**[スケジュール]** タブ、**[メンテナンス]** タブ、**[プロパティ]** タブなどに表示されます。

1. クエリに関するメトリクスの **[クエリのモニタリング]** タブを選択します。

1. [**Query monitoring (クエリのモニタリング)**] セクションで、[**Query history (クエリの履歴)**] タブを選択します。

   ウィンドウのコントロールを使用して、[**Query list (クエリリスト)**] と [**Cluster metrics (クラスターメトリクス)**] を切り替えることができます。

   [**Query list (クエリリスト)**] を選択すると、タブには次のグラフが表示されます。
   + **クエリランタイム** – タイムライン上のクエリのアクティビティ。このグラフを使用して、どのクエリが同じ期間で実行されているかを確認します。クエリを選択すると、クエリ実行の詳細が表示されます。X 軸は、選択した期間を示します。実行、完了、ロードなどによって、グラフ化されたクエリをフィルタリングできます。各バーはクエリを表し、バーの長さはバーの開始から終了までのランタイムを表します。クエリには、SQL データ操作ステートメント (SELECT、INSERT、DELETE など) とロード (COPY など) を含めることができます。デフォルトでは、選択した期間に実行されている最長のクエリの上位 100 件が表示されます。
   + **クエリとロード** – クラスターで実行されたクエリとロードのリスト。このウィンドウには、クエリが現在実行されている場合は、[**Terminate query (クエリを終了)**] オプションが表示されます。

   [**Cluster metrics (クラスターメトリクス)**] を選択すると、タブには次のグラフが表示されます。
   + **クエリランタイム** – タイムライン上のクエリのアクティビティ。このグラフを使用して、どのクエリが同じ期間で実行されているかを確認します。クエリを選択すると、クエリ実行の詳細が表示されます。
   + **CPU 使用率** – リーダーノード別のクラスターの CPU 使用率、およびコンピュートノードの平均数。
   + **使用済みストレージ容量** – ストレージ容量の割合。
   + **アクティブなデータベース接続** – クラスターへのアクティブなデータベース接続の数。

クエリ履歴グラフを操作する場合は、次の点を考慮してください。
+ [**Query runtime (クエリランタイム)**] グラフで特定のクエリを表すバーを選択すると、そのクエリの詳細が表示されます。また、[**Queries and loads (クエリとロード)**] リストでクエリ ID を選択して、その詳細を確認することもできます。
+ スワイプして [**Query runtime (クエリランタイム)**] グラフのセクションを選択し、ズームインして特定の期間を表示できます。
+ [**Query runtime (クエリランタイム)**] グラフで、選択したフィルタですべてのデータを対象にするには、[**Queries and loads (クエリとロード)**] リストに表示されているすべてのページを確認します。
+ [**Queries and loads (クエリとロード)**] リストに表示される列と行数は、**設定歯車アイコン**によって表示される設定ウィンドウを使用して変更できます。
+ [**Queries and loads (クエリとロード)**] リストは、左側のナビゲータの [**クエリ**] アイコン、[**Queries and loads (クエリとロード)**] から移動して表示することもできます。詳細については、[クエリとロードの表示](performance-metrics-queries.md) を参照してください。

## クエリ履歴グラフ
<a name="performance-metrics-query-history-examples"></a>

次の例は、新しい Amazon Redshift コンソールに表示されるグラフを示しています。

**注記**  
Amazon Redshift コンソールグラフには、最新の 100,000 個のクエリのデータのみが含まれます。
+ **Query runtime (クエリランタイム**   
![\[クエリが同じ時間枠内で実行されていることを示すタイムラインでのクエリアクティビティを示したグラフ。\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/mgmt/images/query-history-query-runtime.png)
+ **Queries and loads (クエリとロード**   
![\[クエリとロードのリストを示す表。開始時刻、期間、ステータス、クエリ ID などの属性を列として示しています。\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/mgmt/images/query-history-queries-and-loads.png)
+ **CPU 使用率**   
![\[CPU 使用率を 15 分単位で示す折れ線グラフ。\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/mgmt/images/query-history-cpu-utilization.png)
+ **Storage capacity used (使用済みのストレージキャパシティー**   
![\[使用されているストレージ容量の割合を15 分単位で示す折れ線グラフ。\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/mgmt/images/query-history-storage-capacity-used.png)
+ **Active database connections (アクティブなデータベース接続**   
![\[アクティブなデータベース接続の数を 15 分単位で示す折れ線グラフ。\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/mgmt/images/query-history-active-database-connections.png)