推奨事項を確認する
ページを開くと、推奨事項が優先度順に表示されます。アナライザーは、クエリのリスクとテーブルの使用頻度を考慮するため、最も対応する価値の高い項目が先に表示されます。 テーブル、ベース、スペースIDで検索すると、すべての推奨事項を対象に絞り込めます。その他のテキストでは、現在画面に表示されている項目を絞り込みます。ステータスとリスクのフィルターを使用すると、一覧をさらに絞り込めます。 各項目には、所属するスペース、ベース、テーブルの名前が表示されます。行を展開すると、推奨事項の根拠、システムの判断、SQL診断を確認できます。
詳細分析をクリックすると、そのテーブルが入力済みの状態で分析ワークスペースが開きます。
アナライザーがテーブル全体に対する高頻度の部分文字列検索を検出すると、フィールドごとのインデックスではなく、テーブル全体に対する生成テキストGINの推奨事項が1件作成されます。この行には詳細分析の代わりに検索パスを作成が表示され、インデックスを追加は表示されません。検索アクセスパスは分析ワークスペースから適用し、最初にEXPLAINサンプル検索を行う必要があるためです。テーブルにパスが設定されると、推奨事項は自動的に終了します。
その横には、さらに2つのタブがあります。
設定上の問題によって処理が滞っている場合、一覧の上にバナーが表示されます。たとえば、ランタイムフラグがオフの状態で検索アクセスパスが設定されている場合、一部のテーブルでアクセスパスが古いか再構築待ちになり、検索が通知なく低速な
ILIKEスキャンへフォールバックしている場合、最も古いキュー内のタスクが長時間待機し、処理するワーカーがないと考えられる場合です。下の推奨事項に対応する前に、バナーで報告されている問題を修正してください。
判断バッジを確認する
各推奨事項には、システムによる最新の判断が表示されます。デフォルトでは、Teableは判断を記録して推奨事項とタスクのレコードを作成するだけで、データベースを自動的に変更しません。自動実行は
V2_TABLE_QUERY_OPS_AUTO_ACCEPT=autoで明示的に有効にする必要があります。有効にした場合も、実行計画で明確なコスト改善が示された小規模なテーブルにのみ適用されます。それ以外はすべて管理者の対応を待ちます。提案されたインデックスを追加する
推奨事項で提案されたインデックスに同意する場合は、その行のインデックスを追加をクリックします。確定すると推奨事項が承認され、基盤となるPostgreSQLテーブルでCREATE INDEX CONCURRENTLYが実行されます。計画の検証がスキップされた場合でも、Teableは推奨フィールドからインデックスを構築します。ダイアログには根拠が再度表示されるため、最後にもう一度確認できます。
推定行数が50,000件以上のテーブルでは、ボタンを使用できるようになる前に、メンテナンス時間帯が確保されていることを確定するよう求められます。大規模テーブルでの並行構築には時間がかかり、実行中は負荷が増加します。
その後、Teableはインデックスを作成しましたまたは推奨事項を承認し、キューへ追加しましたと報告します。後者の場合は、タスクでタスクを追跡します。推奨事項に実行可能な物理列がない場合、インデックスを追加は無効なままとなり、その理由が表示されます。代わりに分析ワークスペースを使用して、さらに調査してください。
詳細分析を実行する
たとえば、まだ推奨事項がない低速テーブルがユーザーから報告された場合は、分析ワークスペースを開いて、スコープをオンデマンドで分析します。
テーブル、ベース、スペースのいずれかを選択し、対応するIDを入力して、分析の種類を選びます。低速なテーブルがわかっている場合は、テーブルから始めてください。
クエリレポートを生成または検索レポートを生成をクリックします。レポートには、検出されたリスクと推奨される次の操作がまとめられます。検索レポートの場合、EXPLAINサンプル検索は任意です。サンプルを追加すると、提案された部分文字列検索アクセスパスについて、結果の互換性、クエリ計画、繰り返しクエリの実行時間を確認できます。Teableはサンプル値を保存しません。
クエリレポートによってデータベースが変更されることはありません。部分文字列検索の推奨事項を適用するには、EXPLAINサンプル検索と管理者による確認が必要です。