> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# テーブルクエリ運用

> 低速なテーブルに対するクエリリスクの推奨事項を確認し、データベースの改善を確定します。

<Tip>セルフホストのBusinessプラン以上で利用できます</Tip>

パス: システム管理 → テーブルクエリ運用

大規模なテーブルでビュー、フィルター、リレーション、検索が遅くなった場合は、**テーブルクエリ運用**を使用します。バックグラウンドアナライザーがクエリのワークロードを監視し、観測結果を推奨事項に変換します。このページには推奨事項が一覧表示されるため、インスタンス管理者は根拠を確認し、特定のテーブルを詳しく分析して、データベースの変更を確定できます。

一覧の上にあるカウンターには、観測期間、リクエスト、低速クエリ、タイムアウト、未対応および承認済みの推奨事項、実行中および失敗したタスク、検索アクセスパスが利用可能または低下状態にある件数など、現在の状況がまとめて表示されます。

## 推奨事項を確認する

ページを開くと、**推奨事項**が優先度順に表示されます。アナライザーは、クエリのリスクとテーブルの使用頻度を考慮するため、最も対応する価値の高い項目が先に表示されます。

テーブル、ベース、スペースIDで検索すると、すべての推奨事項を対象に絞り込めます。その他のテキストでは、現在画面に表示されている項目を絞り込みます。ステータスとリスクのフィルターを使用すると、一覧をさらに絞り込めます。

各項目には、所属するスペース、ベース、テーブルの名前が表示されます。行を展開すると、推奨事項の根拠、システムの判断、SQL診断を確認できます。

| セクション        | 示される内容                                                                                                       |
| ------------ | ------------------------------------------------------------------------------------------------------------ |
| **トリガー**     | 推奨事項の発生元: 観測されたクエリトラフィック、保存済みビューの設定、またはリレーションフィールドの設定。保存済みビューがトリガーの場合、低速クエリはまだ観測されておらず、設定自体によってリスクが検出されています。 |
| **アクセスパス**   | このテーブルへのアクセスに、シーケンシャルスキャンとインデックススキャンがそれぞれ使用された頻度。                                                            |
| **理由**       | 大規模なテーブル、フィルターまたは並べ替えフィールドに有効なインデックスがない、高コストな並べ替え、観測されたタイムアウトなど、わかりやすく示した原因。                                 |
| **クエリ形状**    | 絞り込みと並べ替えに使用される具体的なフィールド、および各フィールドで使用する一致の種類。                                                                |
| **提案インデックス** | 推奨事項によってインデックスが作成されるフィールドと、その理由。                                                                             |

**詳細分析**をクリックすると、そのテーブルが入力済みの状態で分析ワークスペースが開きます。

アナライザーがテーブル全体に対する高頻度の部分文字列検索を検出すると、フィールドごとのインデックスではなく、テーブル全体に対する**生成テキストGIN**の推奨事項が1件作成されます。この行には**詳細分析**の代わりに**検索パスを作成**が表示され、**インデックスを追加**は表示されません。検索アクセスパスは分析ワークスペースから適用し、最初に**EXPLAINサンプル検索**を行う必要があるためです。テーブルにパスが設定されると、推奨事項は自動的に終了します。

その横には、さらに2つのタブがあります。

| タブ          | 表示内容                                            |
| ----------- | ----------------------------------------------- |
| **高負荷テーブル** | リクエスト数、低速クエリ数、タイムアウト数、最長クエリ時間を含む、最も使用頻度の高いテーブル。 |
| **タスク**     | Teableが作成した修復タスクと、そのステータス、試行回数、ワーカー、最後のエラー。     |

設定上の問題によって処理が滞っている場合、一覧の上にバナーが表示されます。たとえば、ランタイムフラグがオフの状態で検索アクセスパスが設定されている場合、一部のテーブルでアクセスパスが古いか再構築待ちになり、検索が通知なく低速な`ILIKE`スキャンへフォールバックしている場合、最も古いキュー内のタスクが長時間待機し、処理するワーカーがないと考えられる場合です。下の推奨事項に対応する前に、バナーで報告されている問題を修正してください。

### 判断バッジを確認する

各推奨事項には、システムによる最新の判断が表示されます。

| バッジ                    | 意味                                                   |
| ---------------------- | ---------------------------------------------------- |
| **手動確認が必要**            | この推奨事項を適用できるのは管理者だけです。                               |
| **シャドウ · 自動実行対象**      | 推奨事項は承認基準を満たしていますが、自動実行が有効でないため、変更は行われていません。         |
| **自動実行中** / **自動実行済み** | 自動実行によって推奨事項が承認、適用されました。                             |
| **事後検証に失敗 · バックオフ中**   | 自動変更が検証に合格しませんでした。Teableは、そのテーブルを再試行するまでの待機時間を延ばします。 |
| **クールダウン中**            | 同じスコープが最近変更されたため、システムが処理を見合わせています。                   |
| **保留** / **自動実行は未適用**  | 計画の根拠またはテーブルサイズが、自動実行の基準を満たしていません。                   |

<Info>デフォルトでは、Teableは判断を記録して推奨事項とタスクのレコードを作成するだけで、データベースを自動的に変更しません。自動実行は`V2_TABLE_QUERY_OPS_AUTO_ACCEPT=auto`で明示的に有効にする必要があります。有効にした場合も、実行計画で明確なコスト改善が示された小規模なテーブルにのみ適用されます。それ以外はすべて管理者の対応を待ちます。</Info>

### 提案されたインデックスを追加する

推奨事項で提案されたインデックスに同意する場合は、その行の**インデックスを追加**をクリックします。確定すると推奨事項が承認され、基盤となるPostgreSQLテーブルで`CREATE INDEX CONCURRENTLY`が実行されます。計画の検証がスキップされた場合でも、Teableは推奨フィールドからインデックスを構築します。ダイアログには根拠が再度表示されるため、最後にもう一度確認できます。

推定行数が50,000件以上のテーブルでは、ボタンを使用できるようになる前に、メンテナンス時間帯が確保されていることを確定するよう求められます。大規模テーブルでの並行構築には時間がかかり、実行中は負荷が増加します。

その後、Teableは**インデックスを作成しました**または**推奨事項を承認し、キューへ追加しました**と報告します。後者の場合は、**タスク**でタスクを追跡します。推奨事項に実行可能な物理列がない場合、**インデックスを追加**は無効なままとなり、その理由が表示されます。代わりに分析ワークスペースを使用して、さらに調査してください。

## 詳細分析を実行する

たとえば、まだ推奨事項がない低速テーブルがユーザーから報告された場合は、**分析ワークスペース**を開いて、スコープをオンデマンドで分析します。

| 分析の種類          | 用途                                             |
| -------------- | ---------------------------------------------- |
| **クエリとインデックス** | クエリリスクとインデックス改善の可能性を見つけます。                     |
| **部分文字列検索**    | 一致動作を変更せずに、部分文字列検索アクセスパスによって包含検索を高速化できるか確認します。 |

**テーブル**、**ベース**、**スペース**のいずれかを選択し、対応するIDを入力して、分析の種類を選びます。低速なテーブルがわかっている場合は、**テーブル**から始めてください。

**クエリレポートを生成**または**検索レポートを生成**をクリックします。レポートには、検出されたリスクと推奨される次の操作がまとめられます。検索レポートの場合、**EXPLAINサンプル検索**は任意です。サンプルを追加すると、提案された部分文字列検索アクセスパスについて、結果の互換性、クエリ計画、繰り返しクエリの実行時間を確認できます。Teableはサンプル値を保存しません。

<Info>クエリレポートによってデータベースが変更されることはありません。部分文字列検索の推奨事項を適用するには、**EXPLAINサンプル検索**と管理者による確認が必要です。</Info>

大規模なテーブルでは、影響を確認し、確定した変更を適切なメンテナンス時間帯に実施してください。