change Explain PostgreSQL to Explain Tensor

Author: MGorkov

docs/en_US/developer_tools.rst

@@ -18,4 +18,4 @@ PL/SQL code.
    erd_tool
    psql_tool
    ai_tools
-   expl_pgsql
+   expl_tensor

docs/en_US/expl_pgsql.rst docs/en_US/expl_tensor.rstdocs/en_US/expl_pgsql.rst renamed to docs/en_US/expl_tensor.rst

@@ -1,10 +1,10 @@
-.. _expl_pgsql:
+.. _expl_tensor:
 
 ***************************
-`Explain PostgreSQL`:index:
+`Explain Tensor`:index:
 ***************************
 
-**Explain PostgreSQL** is a powerful module integrated into pgAdmin 4 that enables advanced analysis of query execution plans and beautification of SQL code. This tool helps developers and DBAs understand how PostgreSQL executes queries, identify performance bottlenecks, and optimize database workloads effectively.
+**Explain Tensor** is a powerful module integrated into pgAdmin 4 that enables advanced analysis of query execution plans and beautification of SQL code. This tool helps developers and DBAs understand how PostgreSQL executes queries, identify performance bottlenecks, and optimize database workloads effectively.
 
 Key Features:
 
@@ -14,32 +14,34 @@ Key Features:
 
 **Requirements:**
 
-Before using the Explain PostgreSQL module, ensure the following:
+Before using the Explain Tensor module, ensure the following:
 
  1. You are connected to a PostgreSQL server with sufficient privileges to execute commands.
 
- 2. Configure Explain PostgreSQL in :ref:`Preferences → Explain PostgreSQL <the-explain-postgresql-node>`.
+ 2. Ensure Explain Tensor are enabled in the server configuration (set ``EXPLAIN_TENSOR_ENABLED`` to ``True`` in ``config.py``).
+
+ 3. Configure Explain Tensor in :ref:`Preferences → Explain Tensor <the-explain-tensor-node>`.
 
 **Note:**
 
- * Using Explain PostgreSQL requires an active internet connection.
+ * Using Explain Tensor requires an active internet connection.
 
- * When analyzing query plans via Explain PostgreSQL, the plan and query are sent to a third-party service
+ * When analyzing query plans via Explain Tensor, the plan and query are sent to a third-party service
    (by default: https://explain.tensor.ru).
 
 
-Configuring Explain PostgreSQL
+Configuring Explain Tensor
 ******************************
 
-To configure Explain PostgreSQL, navigate to *File → Preferences → Explain PostgreSQL*.
+To configure Explain Tensor, navigate to *File → Preferences → Explain Tensor*.
 
-.. image:: images/preferences_expl_pgsql.png
-    :alt: Explain PostgreSQL preferences
+.. image:: images/preferences_expl_tensor.png
+    :alt: Explain Tensor preferences
     :align: center
 
 1. Set the **Explain Plan** switch to *True*.
 
-2. Enter the *Explain PostgreSQL API* URL (default: https://explain.tensor.ru).
+2. Enter the *Explain Tensor API* URL (default: https://explain.tensor.ru).
 
 3. Set the **Format SQL** switch to *True* if you want to use the SQL formatting capability.
 
@@ -48,7 +50,7 @@ To configure Explain PostgreSQL, navigate to *File → Preferences → Explain P
 After configuring, click *Save* to apply the changes.
 
 
-Using Explain PostgreSQL
+Using Explain Tensor
 *************************
 
 To analyze a query plan:
@@ -61,17 +63,17 @@ To analyze a query plan:
 
 4. Click the **Explain Analyze** button in the toolbar (or press ``Shift+F7``) to generate the execution plan.
 
-   Upon successful generation, the *Explain PostgreSQL* panel will appear.
+   Upon successful generation, the *Explain Tensor* panel will appear.
 
- .. image:: images/expl_pgsql_analyze.png
-    :alt: Example of Explain PostgreSQL output
+ .. image:: images/expl_tensor_analyze.png
+    :alt: Example of Explain Tensor output
     :align: center
 
 
 Understanding Execution Plans
 *****************************
 
-Each node in the execution plan represents a step in query processing. The Explain PostgreSQL module displays:
+Each node in the execution plan represents a step in query processing. The Explain Tensor module displays:
 
  * **Plan Tree** – A simplified view of the execution algorithm. Numeric indicators are displayed separately and highlighted with colors indicating load intensity.
 
@@ -81,50 +83,50 @@ Each node in the execution plan represents a step in query processing. The Expla
     * Yellow – Medium cost
     * Red – High cost (potential bottleneck)
 
- .. image:: images/expl_pgsql_plantree.png
-    :alt: Example of Explain PostgreSQL plan tree
+ .. image:: images/expl_tensor_plantree.png
+    :alt: Example of Explain Tensor plan tree
     :align: center
 
  * **Diagram** – Shows real dependencies between nodes and resource flows.
 
- .. image:: images/expl_pgsql_diagram.png
-    :alt: Example of Explain PostgreSQL diagram
+ .. image:: images/expl_tensor_diagram.png
+    :alt: Example of Explain Tensor diagram
     :align: center
 
  * **Schema** – Visualizes database tables and their relationships.
 
- .. image:: images/expl_pgsql_schema.png
-    :alt: Example of Explain PostgreSQL schema
+ .. image:: images/expl_tensor_schema.png
+    :alt: Example of Explain Tensor schema
     :align: center
 
  * **Statistics** – Summary statistics allow you to analyze large plans in aggregated form, sorted by any metric such as execution time, disk reads, cache usage, or filtered rows.
 
- .. image:: images/expl_pgsql_stats.png
-    :alt: Example of Explain PostgreSQL statistics
+ .. image:: images/expl_tensor_stats.png
+    :alt: Example of Explain Tensor statistics
     :align: center
 
  * **Pie Chart** – Helps quickly identify dominant nodes and their approximate share of resource consumption.
 
- .. image:: images/expl_pgsql_piechart.png
-    :alt: Example of Explain PostgreSQL pie chart
+ .. image:: images/expl_tensor_piechart.png
+    :alt: Example of Explain Tensor pie chart
     :align: center
 
  * **Tiled Visualization** – Allows compact evaluation of node connections in large plans and highlights problematic sections.
 
- .. image:: images/expl_pgsql_tilemap.png
-    :alt: Example of Explain PostgreSQL tiled visualization
+ .. image:: images/expl_tensor_tilemap.png
+    :alt: Example of Explain Tensor tiled visualization
     :align: center
 
  * **Smart Recommendations** – Automatically generated based on structural and resource metrics, these provide precise guidance on resolving performance issues.
 
- .. image:: images/expl_pgsql_recs.png
-    :alt: Example of Explain PostgreSQL recommendations
+ .. image:: images/expl_tensor_recs.png
+    :alt: Example of Explain Tensor recommendations
     :align: center
 
  * **Personal Archive** – Contains all the plans you've analyzed, giving you instant access regardless of whether they were published publicly.
 
- .. image:: images/expl_pgsql_personal.png
-    :alt: Example of Explain PostgreSQL personal archive
+ .. image:: images/expl_tensor_personal.png
+    :alt: Example of Explain Tensor personal archive
     :align: center