[管理] メニューの [データベース] セクションの [クエリ] ページでは、Looker がデータベースに送信した最新の 50 件のクエリに関する情報を表示可能。最新の 50 件のクエリより古いクエリについては、Looker の使用状況セクションをご覧ください。
基本的なクエリ情報
| 列 | 定義 |
|---|---|
| 時間 | アプリケーションのタイムゾーンで表示されるクエリの開始時間。 |
| ステータス | クエリのステータス。次の情報が含まれます。
|
| 接続 | このクエリが実行された Looker 接続。 |
| ユーザー | このクエリを実行したユーザー（特定可能な場合）。Looker が永続的な派生テーブルを作成する場合や、不明なユーザーが公開の Look にアクセスした場合などは、特定のユーザーによって実行されないクエリもあります。 |
| ソース | Explore のページや SQL Runner など、Looker におけるクエリの送信元。可能な場合は、保存済みの Look へのリンク、またはクエリ ID とモデルと Explore の名前も表示されます。一部のクエリには、SQL Runner で実行されるクエリなどの追加情報はありません。Open SQL インターフェースから発行されたクエリの [Source] の値は Sql_interface になります。 |
| ランタイム | クエリの実行にかかった時間。これには、クエリの構築、クエリがキューで使用した時間、データベース間の移行、クエリのデータベース実行が含まれます。クエリが実行中の場合、ランタイムにはそれまでのクエリの実行時間が表示されます。以前に実行されたクエリの場合、ランタイムにはクエリの実行が完了するまでの推定時間も表示されます。推定値は、クエリの最後の実行時間に基づいており、「約 2 秒」のように表示されます。 |
| 詳細ボタン | 詳しくは、このページの詳細ボタンのサブセクションをご覧ください。 |
詳細ボタン
クエリの右側にある [詳細] ボタンをクリックすると、そのクエリに関する追加情報が表示されます。[クエリの詳細] メニューには次のものが含まれます。
- クエリに関する詳細を含む [Info] セクション（次のテーブルを参照）。
- データベースに対して実行された未加工の SQL を示す [SQL] セクション。[コンテキスト コメント] は、[クエリの詳細] 情報には表示されません。コメントがクエリのキャッシュに影響するのを防ぐために、Looker は SQL がデータベースに送信される直前に、コンテキスト コメント を送信 SQL コマンドに追加します。
- Open SQL インターフェースからクエリが発行されたときに表示される [SQL インターフェースのクエリ] セクション。このセクションには、外部 BI ツールから Looker に送信された SQL クエリが表示されます。これは、問題のトラブルシューティングと再現に役立ちます。
- SQL Runner でクエリを開く [SQL Runner で開く] リンク。
[情報] セクションには次の情報が含まれます。
| セクション | 定義 |
|---|---|
| 履歴 ID | クエリの履歴 ID（利用可能な場合）。 |
| ステータス | 基本クエリ情報テーブルで説明されているクエリのステータス。 |
| メッセージ | クエリに PDT が含まれている場合、このフィールドに PDT 生成コメントが表示されます。クエリに PDT が含まれていない場合、このフィールドは表示されません。 |
| 接続 | このクエリが実行された Looker 接続。 |
| ユーザー | このクエリを実行したユーザー（特定可能な場合）。Looker が永続的な派生テーブルを作成する場合や、不明なユーザーが公開の Look にアクセスした場合などは、特定のユーザーによって実行されないクエリもあります。 |
| ソース | Explore のページや SQL Runner など、Looker におけるクエリの送信元。可能であれば、保存済み Look へのリンク、クエリ ID、モデル名、Explore 名、選択したフィールドなど、追加情報が表示されます。 |
| 開始時間 | アプリケーションのタイムゾーンで表示されるクエリの開始時間。 |
| 終了時刻 | アプリケーションのタイムゾーンで表示されるクエリの終了時間。 |
| ランタイム | クエリの実行にかかった時間。 |
クエリの強制終了
クエリの強制終了をサポートする言語の場合、Looker は次の 2 つの方法で実行中のクエリを停止できます。
- クエリが実行されているブラウザタブを閉じると、Looker でクエリが自動的に停止されます。
- Looker 管理者は、[クエリ] 管理ページでクエリの [停止] ボタンをクリックして、実行中のクエリを停止できます。（
see_queries権限を持つユーザーは [クエリ] ページを表示できますが、実行中のクエリを停止できるのは Looker 管理者のみです）。
Looker がクエリを強制終了するには、クエリが実行されているブラウザタブを閉じるか、[クエリ] ページでクエリを停止する必要があります。また、データベース言語がクエリの強制終了をサポートしている必要があります。次の表に、Looker の最新リリースでクエリ強制終了をサポートする言語を示します。
| 方言 | サポート対象 |
|---|---|
| Actian Avalanche | はい |
| Amazon Athena | はい |
| Amazon Aurora MySQL | はい |
| Amazon Redshift | はい |
| Amazon Redshift 2.1+ | はい |
| Amazon Redshift Serverless 2.1+ | はい |
| 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+ with Native Driver | はい |
| Cloudera Impala with Native Driver | はい |
| DataVirtuality | はい |
| Databricks | はい |
| Denodo 7 | はい |
| Denodo 8 & 9 | はい |
| Dremio | はい |
| Dremio 11+ | はい |
| Exasol | はい |
| 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 pre-9.5 | はい |
| PrestoDB | はい |
| PrestoSQL | はい |
| SAP HANA | はい |
| 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 のキューから抜けた場合でも、データベース上ではまだキューに残っている可能性があります。データベース クエリのタイムアウトをカスタマイズする方法については、データベースのドキュメントをご覧ください。