[管理] メニューの [データベース] セクションの [クエリ] ページでは、Looker がデータベースに送信した最新の 50 件のクエリに関する情報を表示可能。それより古いクエリについては、Looker の使用状況セクションをご覧ください。
基本的なクエリ情報
列 | 定義 |
---|---|
時間 | アプリケーションのタイムゾーンで表示されるクエリの開始時間。 |
ステータス | クエリのステータス。次の情報が含まれます。
|
接続 | このクエリが実行された Looker 接続。 |
ユーザー | このクエリを実行したユーザー(特定可能な場合)。Looker が永続的な派生テーブルを作成する場合や、不明なユーザーが公開の Look にアクセスした場合などは、特定のユーザーによって実行されないクエリもあります。 |
ソース | Explore のページや SQL Runner など、Looker におけるクエリの送信元。可能な場合は、保存済みの Look へのリンク、またはクエリ ID とモデルと Explore の名前も表示されます。一部のクエリには、SQL Runner で実行されるクエリなどの追加情報はありません。 |
ランタイム | クエリの実行にかかった時間。これには、クエリの構築、クエリがキューで使用した時間、データベース間の移行、クエリのデータベース実行が含まれます。クエリが現在実行中の場合、ランタイムにはそれまでのクエリの実行時間が表示されます。以前に実行されたクエリについては、ランタイムは、クエリの実行を完了するまでの推定時間も表示します。推定値は、クエリの最後の実行時間に基づいており、「約 2 秒」のように表示されます。 |
詳細ボタン | 詳しくは、このページの詳細ボタンのサブセクションをご覧ください。 |
詳細ボタン
クエリの右側にある [詳細] ボタンをクリックすると、そのクエリに関する追加情報が表示されます。[クエリの詳細] ポップアップには次のものが含まれます。
- クエリに関する詳細を含む [Info] セクション(次のテーブルを参照)。
- データベースに対して実行された未加工の SQL が表示される [SQL] セクション。コンテキスト コメントは、[クエリの詳細] 情報には表示されません。コメントがクエリのキャッシュに影響するのを防ぐために、Looker は SQL がデータベースに送信される直前に、コンテキスト コメント を送信 SQL コマンドに追加します。
- [SQL Runner] でクエリを開く [SQL Runner で開く] リンク。
[Info] セクションには、次の情報が含まれています。
セクション | 定義 |
---|---|
履歴 ID | クエリの履歴 ID(利用可能な場合)。 |
ステータス | 基本クエリ情報テーブルで説明されているクエリのステータス。 |
メッセージ | クエリに PDT が含まれている場合は、このフィールドに PDT 生成コメントが表示されます。クエリに PDT が含まれていない場合、このフィールドは表示されません。 |
接続 | このクエリが実行された Looker 接続。 |
ユーザー | このクエリを実行したユーザー(特定可能な場合)。Looker が永続的な派生テーブルを作成する場合や、不明なユーザーが公開の Look にアクセスした場合などは、特定のユーザーによって実行されないクエリもあります。 |
ソース | Explore のページや SQL Runner など、Looker におけるクエリの送信元。可能であれば、保存済み Look へのリンク、クエリ ID、モデル名、Explore 名、選択したフィールドなど、追加情報が表示されます。 |
開始時刻 | アプリケーションのタイムゾーンで表示されるクエリの開始時間。 |
終了時刻 | アプリケーションのタイムゾーンで表示されるクエリの終了時間。 |
ランタイム | クエリの実行にかかった時間。 |
クエリの強制終了
クエリが実行されているブラウザタブを閉じると、Looker で実行中のクエリは自動的に停止されます。Looker 管理者は、[クエリ] ページから実行中のクエリを停止することもできます。(see_queries
権限を持つユーザーは [クエリ] ページを表示できますが、実行中のクエリを停止できるのは Looker 管理者のみです)。実行中のクエリには、クエリの右側に [停止] ボタンが表示されます。[停止] をクリックしてクエリを停止します。
Looker がクエリを強制終了するには、データベース言語がクエリの強制終了をサポートしている必要があります。次のリストは、Looker の最新リリースでクエリ強制終了をサポートする方言を示しています。
方言 | サポート対象 |
---|---|
Actian Avalanche | はい |
Amazon Athena | はい |
Amazon Aurora MySQL | はい |
Amazon Redshift | はい |
Apache Druid | いいえ |
Apache Druid 0.13+ | いいえ |
Apache Druid 0.18+ | いいえ |
Apache Hive 2.3+ | はい |
Apache Hive 3.1.2+ | はい |
Apache Spark 3 以降 | はい |
ClickHouse | はい |
Cloudera Impala 3.1+ | はい |
ネイティブ ドライバを使用した Cloudera Impala 3.1+ | はい |
ネイティブ ドライバを使用した Cloudera Impala | はい |
DataVirtuality | はい |
Databricks | はい |
Denodo 7 | はい |
Denodo 8 | はい |
Dremio | はい |
Dremio 11+ | はい |
Exasol | はい |
Firebolt | はい |
Google BigQuery Legacy SQL | はい |
Google BigQuery Standard SQL | はい |
Google Cloud PostgreSQL | はい |
Google Cloud SQL | はい |
Google Spanner | はい |
Greenplum | はい |
HyperSQL | いいえ |
IBM Netezza | はい |
MariaDB | はい |
Microsoft Azure PostgreSQL | はい |
Microsoft Azure SQL Database | はい |
Microsoft Azure Synapse Analytics | はい |
Microsoft SQL Server 2008+ | はい |
Microsoft SQL Server 2012+ | はい |
Microsoft SQL Server 2016 | はい |
Microsoft SQL Server 2017+ | はい |
MongoBI | はい |
MySQL | はい |
MySQL 8.0.12+ | はい |
Oracle | はい |
Oracle ADWC | はい |
PostgreSQL 9.5+ | はい |
PostgreSQL 9.5 より前 | はい |
PrestoDB | はい |
PrestoSQL | はい |
SAP HANA 2+ | はい |
SingleStore | はい |
SingleStore 7+ | はい |
Snowflake | はい |
Teradata | はい |
Trino | はい |
Vector | はい |
Vertica | はい |
クエリのタイムアウトとキュー
Looker は、長時間キューで待機しているクエリを強制終了します。このオペレーションは、タイムアウトと呼ばれます。クエリには、以下のようなタイムアウトが適用される場合があります。
接続プールのタイムアウト: 同時実行クエリでデータベースの過負荷を防ぐため、Looker は Looker クエリキューに過剰な同時実行クエリを保持し、キューに長時間残っているクエリを強制終了します。デフォルトでは、接続あたり最大 75 件の同時クエリを使用できます。接続上限を超えた追加のクエリは、0 秒後にタイムアウトします。これらのデフォルトを変更するには、接続の接続設定ページで、最大接続数と接続プールのタイムアウト設定を構成します。
ユーザーごとのクエリ制限とタイムアウト: 1 人のユーザーが Looker クエリキューをいっぱいにしてしまうことがないように、各ユーザーには許可される同時クエリの最大数と、対応するキューのタイムアウトが設定されています。デフォルトでは、各ユーザーは最大 15 個の同時クエリを実行できます。この上限によりキューに登録されたクエリのタイムアウトは 600 秒です。これらの設定は、通常の認証プロセスを使用して Looker にログインするユーザーと、API ユーザー認証情報を使用してログインするユーザーの両方に適用されます。Looker インスタンスがセルフホスト型の場合は、
--per-user-query-limit
と--per-user-query-timeout
の起動オプションを構成することで、これらのデフォルトを変更できます。Scheduler Query Limit and Timeout: Looker スケジューラ プロセスの過負荷を防ぐため、Looker インスタンスでは最大 10 個の同時実行スケジュール クエリを実行でき、スケジューラ キュー内のクエリのタイムアウトは 1,200 秒です。Looker インスタンスがセルフホスト型の場合は、
--scheduler-query-limit
と--scheduler-query-timeout
の起動オプションを構成することで、これらのデフォルトを変更できます。Renderer query limit and timeout: Looker レンダラ プロセスが過負荷状態になるのを防ぐため、Looker インスタンスで最大 2 つの画像ベースのダウンロード(PDF や PNG 形式など)を同時にレンダリングできます。 Looker インスタンスがセルフホスト型の場合は、
--concurrent-render-jobs
起動オプションを構成することでこのデフォルトを変更できます。
プロキシのタイムアウト: 多くの場合、セルフホスト型のインスタンスは、デフォルトで 60 秒のタイムアウトを持つプロキシを使用しています。このタイムアウトは 60 分に増やすことをおすすめします。詳細については、Looker プロキシのコミュニティ投稿のプロキシ サーバーまたはロードバランサの背後で Looker を実行するをご覧ください。
データベースのタイムアウト: ほとんどのデータベースには、Looker のキューやタイムアウトとは別のキューとタイムアウトのルールがあります。たとえば、クエリが Looker のキューから抜けた場合でも、データベース上ではまだキューに残っている可能性があります。データベース クエリのタイムアウトをカスタマイズする方法については、データベースのドキュメントをご覧ください。