Query profiler

このドキュメントでは、クエリのコンポーネントとパフォーマンスを分析するためのグラフィカルツールである Query profiler について説明します。

Query profiler は、Amazon Redshift コンソールから表示できる、クエリのモニタリングおよびトラブルシューティング機能です。クエリのパフォーマンスを分析するのに役立ちます。主に、クエリに関する実行順序、実行計画、統計を視覚とグラフィックで表示し、それらを理解して、トラブルシューティングを行いやすくすることを目的としています。Query profiler は、次のタイプのクエリコンポーネントを分析するのに役立ちます。

ストリーム、セグメント、ステップの詳細については、「Amazon Redshift データベースデベロッパーガイド」の「クエリプランと実行ワークフロー」を参照してください。

Query Profiler には、SYS_QUERY_HISTORY、SYS_QUERY_DETAIL、SYS_QUERY_EXPLAIN、SYS_CHILD_QUERY_TEXT ビューから返される情報が表示されます。これらのビューの詳細については、「Amazon Redshift データベースデベロッパーガイド」の「SYS_QUERY_HISTORY」、「SYS_QUERY_DETAIL」、「SYS_QUERY_EXPLAIN」、「SYS_CHILD_QUERY_TEXT」を参照してください。

Query profiler は、データベースで最近実行されたクエリのクエリ情報のみを表示します。データベースに対して実行するのではなく、事前に読み込まれたキャッシュデータを使用して完了するクエリには、事前に情報が利用できなかった場合、クエリプロファイルは作成されません。これは、Amazon Redshift が上記に対してクエリプランを生成しないためです。

Query Profiler を使用するための前提条件

SYS モニタリングビューは、使いやすく、複雑さを軽減するように設計されており、効果的なモニタリングとトラブルシューティングに役立つさまざまなメトリクスを提供します。SYS モニタリングビューでは、クラスターのサイズやアクティビティに関係なく、過去 7 日分のクエリ履歴も確実に表示されます。ユーザーは自分が実行したクエリしか表示できませんが、スーパーユーザーはすべてのユーザーが実行したクエリを表示できます。

IAM ユーザーアカウントまたはロールには、コンソールの [クエリとデータベースのモニタリング] セクションにアクセスするためのアクセス許可が必要です。このセクションでは、ユーザーアカウントまたはロールにアクセス許可を追加する方法について説明します。

次のポリシーを使用して、IAM ユーザーアカウントまたはロールに最小限のアクセス許可を追加します。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "redshift:DescribeClusters",
                "redshift-serverless:ListNamespaces",
                "redshift-serverless:ListWorkgroups",
                "redshift-data:ExecuteStatement",
                "redshift-data:DescribeStatement",
                "redshift-data:GetStatementResult"
            ],
            "Resource": [
                "arn:aws:redshift-serverless:<your-namespace>",
                "arn:aws:redshift-serverless:<your-workgroupname>",
                "arn:aws:redshift:<your-clustername>"
            ]
        }
    ]
}

ロールにクエリモニタリング許可を付与する

sys:monitor アクセス許可を付与されたロールを割り当てられたユーザーは、すべてのクエリを表示できます。sys:operator アクセス許可を付与されたロールを割り当てられたユーザーは、クエリのキャンセル、クエリ履歴の分析、VACUUM オペレーションを実行できます。

ユーザーにクエリモニタリング許可を付与する

sys:monitor アクセス許可を割り当てられたユーザーは、すべてのクエリを表示できます。sys:operator アクセス許可を割り当てられたユーザーは、クエリのキャンセル、クエリ履歴の分析、VACUUM オペレーションを実行できます。

Amazon Redshift コンソールで Query profiler にアクセスしてクエリを分析する

Amazon Redshift Serverless またはプロビジョニングされた Amazon Redshift のいずれかの Query Profiler にアクセスできます。詳細については、次のセクションを参照してください。

Amazon Redshift Serverless の Amazon Redshift コンソールで Query profiler にアクセスする

Amazon Redshift Serverless の Query profiler にアクセスするには、以下を実行します。

クエリプランが利用可能な場合は、子クエリのリストが表示されます。[クエリ] を選択して、Query profiler で表示します。

Amazon Redshift Provisioned の Amazon Redshift コンソールで Query profiler にアクセスする

Amazon Redshift Provisioned の Query profiler にアクセスするには、以下を実行します。

クエリプランが利用可能な場合は、子クエリのリストが表示されます。[クエリ] を選択して、Query profiler で表示します。

Query profiler のユーザーインターフェイス

Query profiler は、次のページを使用してクエリに関する情報を表示します。

[クエリの詳細] ページ

[クエリの詳細] ページには、次のコンポーネントがあります。

[子クエリ] ページ

[子クエリ] ページには、次のコンポーネントがあります。

[子クエリ] ペイン

Query profiler は、選択した子クエリのステップのグラフィカル表現として、[子クエリ] ペインに子クエリを表示します。

[子クエリ] ペインには、実行順序とステップ間の関係が表示されます。例えば、あるステップが他の 2 つのステップからの出力を結合する場合、[子クエリ] ペインには、そのステップが 2 つのノードから入力されるツリーノードとして表示されます。

デフォルトでは、[子クエリ] ペインにはステップを含むストリームは表示されません。Amazon Redshift が子クエリのステップを論理的にパーティション化するために使用するストリームを表示するには、[ストリームの表示] を選択します。[ストリームの表示] を選択すると、[子クエリ] ペインにクエリのストリームに含まれるステップが表示されます。

[子クエリ] ペインには、セグメント情報は表示されません。ステップのセグメントを表示するには、[ステップ] を選択します。[ステップの詳細] ペインには、ステップのセグメントが表示されます。

[子クエリ] ペインのナビゲーション

[子クエリ] ペインで [ステップ] を選択すると、それらに関する詳細情報を表示できます。また、ワークスペースでパンやズームを行い、クエリプランのステップをより視覚化的に確認できます。

次の方法を使用して、[子クエリ] プランでノード、パン、ズームを選択できます。

Query profiler を使用したクエリのトラブルシューティング

クエリのトラブルシューティングを行う場合は、[子クエリ] を選択して、[合計クエリ時間の割合] が最も大きいストリームを判断できます。これは、クエリのどの部分を詳細に分析する必要があるかを判断するための簡単な方法です。

最も時間がかかっている子クエリが判明したら、そのステップを表示して、パフォーマンスを低下させている結合やスキャンを確認します。