kb-cloud-client-typescript 2.4.0-alpha.46 → 2.4.0-alpha.47

package/src/openapi.yaml

@@ -5099,6 +5099,144 @@ paths:
         - cluster
         - shared
       x-codegen-request-body-name: body
+  /api/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mariadb/spaceAnalysis:
+    get:
+      tags:
+        - diagnostics
+      summary: Get MariaDB space analysis
+      description: Get a read-only MariaDB compatible space snapshot and fixed backend-owned storage metrics.
+      operationId: getDiagnosticsMariaDBSpaceAnalysis
+      parameters:
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: databaseName
+          in: query
+          description: Optional database name for table and index details. When omitted, the largest non-system database is selected.
+          required: false
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/mysqlSpaceAnalysis'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+  /api/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mariadb/sqlAnalysis:
+    get:
+      tags:
+        - diagnostics
+      summary: Get MariaDB SQL analysis
+      description: Get a read-only MariaDB SQL fingerprint ranking from Performance Schema statement digests. The response does not expose raw SQL text, time-window aggregation, execution plans, or remediation actions.
+      operationId: getDiagnosticsMariaDBSQLAnalysis
+      parameters:
+        - name: orgName
+          in: path
+          description: Organization name
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          description: Cluster name
+          required: true
+          schema:
+            type: string
+        - name: limit
+          in: query
+          description: Maximum number of SQL fingerprints to return. The backend applies its own upper bound.
+          required: false
+          schema:
+            type: integer
+            format: int64
+        - name: orderBy
+          in: query
+          description: Sort key. Allowed values are totalTime, meanTime, maxTime, and calls. Defaults to totalTime.
+          required: false
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/mysqlSQLAnalysis'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+  /api/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mariadb/performanceTrends:
+    get:
+      tags:
+        - diagnostics
+      summary: Get MariaDB performance trends
+      description: Get read-only MariaDB performance trends from backend-owned metrics and database capability checks. The response does not expose SQL, PromQL, internal endpoints, or credentials.
+      operationId: getDiagnosticsMariaDBPerformanceTrends
+      parameters:
+        - name: orgName
+          in: path
+          description: Organization name
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          description: Cluster name
+          required: true
+          schema:
+            type: string
+        - name: range
+          in: query
+          description: Controlled query range. Allowed values are 1h, 6h, 24h, and 7d. Defaults to 1h.
+          required: false
+          schema:
+            type: string
+        - name: step
+          in: query
+          description: Controlled query granularity. Allowed values are 1m, 5m, 15m, and 1h.
+          required: false
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/performanceTrends'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '500':
+          $ref: '#/components/responses/500'
   /api/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mysql/spaceAnalysis:
     get:
       tags:
@@ -16419,13 +16557,13 @@ paths:
           $ref: '#/components/responses/404'
         '500':
           $ref: '#/components/responses/500'
-  /api/v1/data/damengdb/organizations/{orgName}/clusters/{clusterName}/tablespaces:
+  /api/v1/data/oracle/organizations/{orgName}/clusters/{clusterName}/tablespaces:
     get:
       tags:
-        - dameng
-      summary: List damengdb tablespaces
-      description: List tablespaces for a Dameng cluster.
-      operationId: listTablespaces
+        - oracle
+      summary: List Oracle tablespaces
+      description: List tablespaces for a Oracle cluster.
+      operationId: listOracleTablespaces
       parameters:
         - name: orgName
           in: path
@@ -16444,7 +16582,9 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/DmTablespaceList'
+                type: array
+                items:
+                  $ref: '#/components/schemas/OracleTablespace'
           description: A successful response.
         '400':
           $ref: '#/components/responses/400'
@@ -16458,10 +16598,10 @@ paths:
           $ref: '#/components/responses/500'
     post:
       tags:
-        - dameng
-      summary: Create damengdb tablespace
-      description: Create tablespace for a Dameng cluster.
-      operationId: createTablespace
+        - oracle
+      summary: Create Oracle tablespace
+      description: Create tablespace for a Oracle cluster.
+      operationId: createOracleTablespace
       parameters:
         - name: orgName
           in: path
@@ -16476,16 +16616,17 @@ paths:
             type: string
           description: Cluster name
       requestBody:
+        required: true
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/DmTablespace'
+              $ref: '#/components/schemas/OracleTablespaceCreate'
       responses:
         '200':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/DmTablespace'
+                $ref: '#/components/schemas/OracleTablespace'
           description: A successful response.
         '400':
           $ref: '#/components/responses/400'
@@ -16497,12 +16638,12 @@ paths:
           $ref: '#/components/responses/404'
         '500':
           $ref: '#/components/responses/500'
-  /api/v1/data/damengdb/organizations/{orgName}/clusters/{clusterName}/tablespaces/{tablespaceName}:
+  /api/v1/data/oracle/organizations/{orgName}/clusters/{clusterName}/tablespaces/{tablespaceName}:
     get:
       tags:
-        - dameng
-      summary: Get Dameng tablespace info
-      operationId: getTablespace
+        - oracle
+      summary: Get Oracle tablespace info
+      operationId: getOracleTablespace
       parameters:
         - name: orgName
           in: path
@@ -16527,7 +16668,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/DmTablespace'
+                $ref: '#/components/schemas/OracleTablespace'
           description: A successful response.
         '400':
           $ref: '#/components/responses/400'
@@ -16541,10 +16682,10 @@ paths:
           $ref: '#/components/responses/500'
     delete:
       tags:
-        - dameng
-      summary: Delete damengdb tablespace
-      description: Delete tablespace for a Dameng cluster.
-      operationId: deleteTablespace
+        - oracle
+      summary: Delete Oracle tablespace
+      description: Delete tablespace for a Oracle cluster.
+      operationId: deleteOracleTablespace
       parameters:
         - name: orgName
           in: path
@@ -16564,6 +16705,18 @@ paths:
           schema:
             type: string
           description: Tablespace name
+        - name: includingContents
+          in: query
+          schema:
+            type: boolean
+            default: false
+          description: Explicitly delete all objects in the tablespace. Without this flag Oracle rejects nonempty tablespaces.
+        - name: deleteDatafiles
+          in: query
+          schema:
+            type: boolean
+            default: false
+          description: Also remove physical files. Requires includingContents. Otherwise manually managed files are retained.
       responses:
         '204':
           content: {}
@@ -16580,10 +16733,10 @@ paths:
           $ref: '#/components/responses/500'
     patch:
       tags:
-        - dameng
-      summary: Update damengdb tablespace
-      description: Update tablespace for a Dameng cluster.
-      operationId: updateTablespace
+        - oracle
+      summary: Expand Oracle tablespace
+      description: Expand one existing datafile/tempfile or add one file in the current container.
+      operationId: expandOracleTablespace
       parameters:
         - name: orgName
           in: path
@@ -16604,16 +16757,17 @@ paths:
             type: string
           description: Tablespace name
       requestBody:
+        required: true
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/DmTablespace'
+              $ref: '#/components/schemas/OracleTablespaceExpand'
       responses:
         '200':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/DmTablespace'
+                $ref: '#/components/schemas/OracleTablespace'
           description: A successful response.
         '400':
           $ref: '#/components/responses/400'
@@ -16625,40 +16779,35 @@ paths:
           $ref: '#/components/responses/404'
         '500':
           $ref: '#/components/responses/500'
-  /api/v1/data/{engineName}/organizations/{orgName}/clusters/{clusterName}/console:
+  /api/v1/data/damengdb/organizations/{orgName}/clusters/{clusterName}/tablespaces:
     get:
       tags:
-        - dms
-        - shared
-      summary: get engine available console
-      description: get engine available console
-      operationId: getEngineAvailableConsole
+        - dameng
+      summary: List damengdb tablespaces
+      description: List tablespaces for a Dameng cluster.
+      operationId: listTablespaces
       parameters:
-        - name: engineName
-          in: path
-          description: name of the engine
-          required: true
-          schema:
-            type: string
         - name: orgName
           in: path
-          description: name of the Org
           required: true
           schema:
             type: string
+          description: Organization name
         - name: clusterName
           in: path
-          description: name of the cluster
           required: true
           schema:
             type: string
+          description: Cluster name
       responses:
         '200':
-          description: OK
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/console'
+                $ref: '#/components/schemas/DmTablespaceList'
+          description: A successful response.
+        '400':
+          $ref: '#/components/responses/400'
         '401':
           $ref: '#/components/responses/401'
         '403':
@@ -16667,35 +16816,39 @@ paths:
           $ref: '#/components/responses/404'
         '500':
           $ref: '#/components/responses/500'
-    delete:
+    post:
       tags:
-        - dms
-        - shared
-      summary: disable console
-      description: disable console
-      operationId: disableConsole
+        - dameng
+      summary: Create damengdb tablespace
+      description: Create tablespace for a Dameng cluster.
+      operationId: createTablespace
       parameters:
-        - name: engineName
-          in: path
-          description: name of the engine
-          required: true
-          schema:
-            type: string
         - name: orgName
           in: path
-          description: name of the Org
           required: true
           schema:
             type: string
+          description: Organization name
         - name: clusterName
           in: path
-          description: name of the cluster
           required: true
           schema:
             type: string
+          description: Cluster name
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/DmTablespace'
       responses:
-        '204':
-          description: disable console successfully
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DmTablespace'
+          description: A successful response.
+        '400':
+          $ref: '#/components/responses/400'
         '401':
           $ref: '#/components/responses/401'
         '403':
@@ -16704,37 +16857,244 @@ paths:
           $ref: '#/components/responses/404'
         '500':
           $ref: '#/components/responses/500'
-    post:
+  /api/v1/data/damengdb/organizations/{orgName}/clusters/{clusterName}/tablespaces/{tablespaceName}:
+    get:
       tags:
-        - dms
-        - shared
-      summary: enable console
-      description: enable console
-      operationId: enableConsole
+        - dameng
+      summary: Get Dameng tablespace info
+      operationId: getTablespace
       parameters:
-        - name: engineName
+        - name: orgName
           in: path
-          description: name of the engine
           required: true
           schema:
             type: string
-        - name: orgName
+          description: Organization name
+        - name: clusterName
           in: path
-          description: name of the Org
           required: true
           schema:
             type: string
-        - name: clusterName
+          description: Cluster name
+        - name: tablespaceName
           in: path
-          description: name of the cluster
           required: true
           schema:
             type: string
-      requestBody:
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/DMSConsoleEnableOpt'
+          description: Tablespace name
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DmTablespace'
+          description: A successful response.
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+    delete:
+      tags:
+        - dameng
+      summary: Delete damengdb tablespace
+      description: Delete tablespace for a Dameng cluster.
+      operationId: deleteTablespace
+      parameters:
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Organization name
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Cluster name
+        - name: tablespaceName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Tablespace name
+      responses:
+        '204':
+          content: {}
+          description: A successful response.
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+    patch:
+      tags:
+        - dameng
+      summary: Update damengdb tablespace
+      description: Update tablespace for a Dameng cluster.
+      operationId: updateTablespace
+      parameters:
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Organization name
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Cluster name
+        - name: tablespaceName
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Tablespace name
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/DmTablespace'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DmTablespace'
+          description: A successful response.
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+  /api/v1/data/{engineName}/organizations/{orgName}/clusters/{clusterName}/console:
+    get:
+      tags:
+        - dms
+        - shared
+      summary: get engine available console
+      description: get engine available console
+      operationId: getEngineAvailableConsole
+      parameters:
+        - name: engineName
+          in: path
+          description: name of the engine
+          required: true
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          description: name of the Org
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          description: name of the cluster
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/console'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+    delete:
+      tags:
+        - dms
+        - shared
+      summary: disable console
+      description: disable console
+      operationId: disableConsole
+      parameters:
+        - name: engineName
+          in: path
+          description: name of the engine
+          required: true
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          description: name of the Org
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          description: name of the cluster
+          required: true
+          schema:
+            type: string
+      responses:
+        '204':
+          description: disable console successfully
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+    post:
+      tags:
+        - dms
+        - shared
+      summary: enable console
+      description: enable console
+      operationId: enableConsole
+      parameters:
+        - name: engineName
+          in: path
+          description: name of the engine
+          required: true
+          schema:
+            type: string
+        - name: orgName
+          in: path
+          description: name of the Org
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          description: name of the cluster
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/DMSConsoleEnableOpt'
       responses:
         '204':
           description: enable console successfully
@@ -26223,1047 +26583,900 @@ components:
         collectedAt:
           type: string
           description: Backend collection timestamp in UTC.
-    mssqlRequest:
+    mysqlSQLFingerprint:
       type: object
       required:
-        - requestId
-        - startedAt
-        - status
-        - command
+        - queryID
+        - fingerprint
+        - querySummary
+        - calls
+        - totalTimeMs
+        - meanTimeMs
+        - maxTimeMs
+        - rows
+        - rowsSent
+        - rowsAffected
+        - rowsExamined
+        - lockTimeMs
+        - errors
+        - warnings
+        - tmpTables
+        - tmpDiskTables
+        - noIndexUsed
+        - noGoodIndexUsed
         - database
-        - sql
-        - sqlTruncated
-        - elapsedMs
-        - cpuMs
-        - reads
-        - logicalReads
-        - writes
-        - waitType
-        - waitMs
-        - waitResource
-        - blockingSessionId
       properties:
-        requestId:
-          type: integer
-          format: int64
-        startedAt:
-          type: string
-          description: Opaque SQL Server local start time, used to detect session or request reuse. Pass back unchanged; it is not a UTC timestamp.
-        status:
+        queryID:
           type: string
-        command:
-          type: string
-        database:
+          description: MySQL Performance Schema DIGEST value.
+        fingerprint:
           type: string
-        sql:
+          description: Stable SQL fingerprint identifier. M1 uses DIGEST.
+        querySummary:
           type: string
-          description: Current statement extracted with byte offsets. Truncated to 8192 characters.
-        sqlTruncated:
-          type: boolean
-        elapsedMs:
+          description: Normalized DIGEST_TEXT. Raw SQL text is intentionally not returned.
+        calls:
           type: integer
           format: int64
-        cpuMs:
+          description: Number of executions accumulated in the current digest row.
+        totalTimeMs:
+          type: number
+          format: double
+          description: Total statement wait time in milliseconds.
+        meanTimeMs:
+          type: number
+          format: double
+          description: Mean statement wait time in milliseconds.
+        maxTimeMs:
+          type: number
+          format: double
+          description: Maximum statement wait time in milliseconds.
+        rows:
           type: integer
           format: int64
-        reads:
+          description: Sum of rows sent and rows affected.
+        rowsSent:
           type: integer
           format: int64
-        logicalReads:
+          description: Total rows sent to clients.
+        rowsAffected:
           type: integer
           format: int64
-        writes:
+          description: Total rows affected by statements.
+        rowsExamined:
           type: integer
           format: int64
-        waitType:
-          type: string
-        waitMs:
+          description: Total rows examined by statements.
+        lockTimeMs:
+          type: number
+          format: double
+          description: Total statement lock time in milliseconds.
+        errors:
           type: integer
           format: int64
-        waitResource:
-          type: string
-        blockingSessionId:
+          description: Total statement errors.
+        warnings:
           type: integer
           format: int64
-    mssqlSession:
+          description: Total statement warnings.
+        tmpTables:
+          type: integer
+          format: int64
+          description: Total internal temporary tables created.
+        tmpDiskTables:
+          type: integer
+          format: int64
+          description: Total internal on-disk temporary tables created.
+        noIndexUsed:
+          type: integer
+          format: int64
+          description: Executions that used no index.
+        noGoodIndexUsed:
+          type: integer
+          format: int64
+          description: Executions for which no good index was found.
+        database:
+          type: string
+          description: Default schema name associated with the digest row.
+        firstSeen:
+          type: string
+          description: UTC timestamp when the digest was first observed.
+        lastSeen:
+          type: string
+          description: UTC timestamp when the digest was most recently observed.
+    mysqlSQLAnalysis:
       type: object
       required:
-        - sessionId
-        - startedAt
+        - source
         - status
-        - user
-        - host
-        - application
-        - client
-        - database
-        - openTransactions
-        - transactionSeconds
-        - lastSql
-        - lastSqlTruncated
-        - requests
-        - requestsTruncated
+        - collectedAt
+        - limit
+        - orderBy
+        - items
       properties:
-        sessionId:
-          type: integer
-          format: int64
-        startedAt:
+        source:
           type: string
-          description: Opaque SQL Server local start time, used to detect session or request reuse. Pass back unchanged; it is not a UTC timestamp.
+          description: Data source. M1 uses performance_schema.events_statements_summary_by_digest.
         status:
           type: string
-        user:
+          description: Source status. Expected values are available or unavailable.
+        unavailableReason:
           type: string
-        host:
+          description: Reason when status is unavailable, such as performance_schema_disabled, digest_consumer_disabled, permission_denied, or query_failed.
+        message:
           type: string
-        application:
+          description: User-facing recovery guidance when SQL analysis is unavailable.
+        collectedAt:
           type: string
-        client:
+          description: Backend collection timestamp in UTC. It is not a sampling-window end time.
+        firstSeen:
           type: string
-        database:
+          description: Earliest FIRST_SEEN timestamp across currently visible digest rows, when available.
+        lastSeen:
           type: string
-        openTransactions:
+          description: Latest LAST_SEEN timestamp across currently visible digest rows, when available.
+        limit:
           type: integer
           format: int64
-        transactionSeconds:
+          description: Effective row limit after backend normalization.
+        orderBy:
+          type: string
+          description: Effective sort key. Expected values are totalTime, meanTime, maxTime, or calls.
+        totalTimeMsAll:
+          type: number
+          format: double
+          x-nullable: true
+          description: Total execution time in milliseconds across all visible digest rows, not limited to the returned top-N items.
+        callsAll:
           type: integer
           format: int64
-        lastSql:
-          type: string
-          description: Most recent batch on the connection, not necessarily the SQL that acquired its locks. Truncated to 8192 characters.
-        lastSqlTruncated:
-          type: boolean
-        requests:
+          x-nullable: true
+          description: Total execution count across all visible digest rows, not limited to the returned top-N items.
+        digestLost:
+          type: integer
+          format: int64
+          x-nullable: true
+          description: Number of statement digests not recorded because the digest table was full, when exposed by the server.
+        items:
           type: array
+          description: SQL fingerprint ranking rows from Performance Schema. The list may be empty when no statement statistics exist.
           items:
-            $ref: '#/components/schemas/mssqlRequest'
-        requestsTruncated:
-          type: boolean
-    mssqlSessionSnapshot:
+            $ref: '#/components/schemas/mysqlSQLFingerprint'
+    performanceTrendRange:
       type: object
       required:
-        - capturedAt
-        - sessions
-        - truncated
+        - label
+        - start
+        - end
+        - durationSeconds
       properties:
-        capturedAt:
+        label:
           type: string
-        sessions:
-          type: array
-          items:
-            $ref: '#/components/schemas/mssqlSession'
-        truncated:
-          type: boolean
-    mssqlWait:
-      type: object
-      required:
-        - sessionId
-        - requestId
-        - blockingSessionId
-        - waitType
-        - waitMs
-        - resource
-        - source
-      properties:
-        sessionId:
-          type: integer
-          format: int64
-        requestId:
-          type: integer
-          format: int64
-          description: Request ID, or -1 when a waiting task cannot be associated with a live request.
-        blockingSessionId:
-          type: integer
-          format: int64
-          description: SQL Server blocking owner. Negative values are special owners, not session IDs.
-        waitType:
+          description: Controlled query range label. Values are 1h, 6h, 24h, or 7d.
+        start:
           type: string
-        waitMs:
+        end:
+          type: string
+        durationSeconds:
           type: integer
           format: int64
-        resource:
-          type: string
-        source:
-          type: string
-    mssqlLock:
+    performanceTrendSummary:
       type: object
       required:
-        - sessionId
-        - requestId
-        - database
-        - resourceType
-        - resource
-        - entityId
-        - mode
-        - status
-        - ownerType
+        - metric
+        - displayName
+        - category
+        - unit
+        - min
+        - max
+        - avg
+        - latest
       properties:
-        sessionId:
-          type: integer
-          format: int64
-        requestId:
-          type: integer
-          format: int64
-        database:
+        metric:
           type: string
-        resourceType:
+        displayName:
+          $ref: '#/components/schemas/localizedDescription'
+        category:
           type: string
-        resource:
+          description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
+        dimension:
           type: string
-        entityId:
+          description: Optional series dimension. Values include cluster, instance, pvc, and database.
+        labels:
+          type: object
+          additionalProperties:
+            type: string
+          description: Optional dimension labels, for example instance, pvc, role, or datname.
+        unit:
           type: string
-        mode:
+        warnThreshold:
+          type: number
+          format: double
+          description: Optional warning threshold in the same unit as this metric.
+        critThreshold:
+          type: number
+          format: double
+          description: Optional critical threshold in the same unit as this metric.
+        thresholdDirection:
           type: string
-        status:
-          type: string
-        ownerType:
+          description: Optional threshold direction. Values are above, below, or boolean.
+        min:
+          type: number
+          format: double
+        max:
+          type: number
+          format: double
+        avg:
+          type: number
+          format: double
+        latest:
+          type: number
+          format: double
+        changeDirection:
           type: string
-    mssqlLockSnapshot:
+          description: Change direction when at least two samples exist. Values are increasing, decreasing, or stable.
+    performanceTrendPoint:
       type: object
       required:
-        - capturedAt
-        - sessions
-        - waits
-        - locks
-        - truncated
+        - timestamp
+        - value
       properties:
-        capturedAt:
+        timestamp:
           type: string
-        sessions:
-          type: array
-          items:
-            $ref: '#/components/schemas/mssqlSession'
-        waits:
-          type: array
-          items:
-            $ref: '#/components/schemas/mssqlWait'
-        locks:
-          type: array
-          items:
-            $ref: '#/components/schemas/mssqlLock'
-        truncated:
-          type: boolean
-      description: Bounded live DMV observations. Edges are SQL Server reported blocking identifiers. Collection is not atomic; graph cycles are not historical deadlock evidence.
-    mssqlCachedPlan:
+        value:
+          type: number
+          format: double
+    performanceTrendSeries:
       type: object
       required:
-        - capturedAt
-        - xml
-        - available
+        - metric
+        - displayName
+        - category
+        - unit
+        - points
       properties:
-        capturedAt:
-          type: string
-        xml:
+        metric:
           type: string
-        available:
-          type: boolean
-      description: Cached compiled plan for the selected live request. No captured SQL is executed. This is not an actual runtime plan.
-    postgresqlSession:
-      type: object
-      required:
-        - pid
-        - user
-        - database
-        - applicationName
-        - clientAddr
-        - clientPort
-        - state
-        - waitEventType
-        - waitEvent
-        - durationSeconds
-        - xactDurationSeconds
-        - queryDigest
-        - querySummary
-        - backendType
-      properties:
-        pid:
-          type: integer
-          format: int64
-        user:
+        displayName:
+          $ref: '#/components/schemas/localizedDescription'
+        category:
           type: string
-        database:
+          description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
+        dimension:
           type: string
-        applicationName:
+          description: Optional series dimension. Values include cluster, instance, pvc, and database.
+        labels:
+          type: object
+          additionalProperties:
+            type: string
+          description: Optional dimension labels, for example instance, pvc, role, or datname.
+        unit:
           type: string
-        clientAddr:
+        warnThreshold:
+          type: number
+          format: double
+          description: Optional warning threshold in the same unit as this metric.
+        critThreshold:
+          type: number
+          format: double
+          description: Optional critical threshold in the same unit as this metric.
+        thresholdDirection:
           type: string
-          description: Client address.
-        clientPort:
+          description: Optional threshold direction. Values are above, below, or boolean.
+        points:
+          type: array
+          items:
+            $ref: '#/components/schemas/performanceTrendPoint'
+    performanceTrendSource:
+      type: object
+      required:
+        - name
+        - kind
+        - status
+        - collectedAt
+      properties:
+        name:
           type: string
-          description: Client port.
-        state:
+        kind:
           type: string
-        waitEventType:
+        status:
           type: string
-        waitEvent:
+          description: Coarse source status. Values are success, partial, failed, skipped, or noData.
+        collectedAt:
           type: string
-        backendStart:
+        message:
           type: string
-          description: Backend start timestamp if available.
-        queryStart:
+    performanceTrends:
+      type: object
+      required:
+        - range
+        - granularity
+        - summary
+        - series
+        - sources
+        - warnings
+        - collectedAt
+      properties:
+        range:
+          $ref: '#/components/schemas/performanceTrendRange'
+        granularity:
           type: string
-          description: Query start timestamp if available.
-        xactStart:
+          description: Controlled backend query step.
+        summary:
+          type: array
+          description: Per-series numeric summary. changeDirection is present only when at least two points exist.
+          items:
+            $ref: '#/components/schemas/performanceTrendSummary'
+        series:
+          type: array
+          description: Successfully collected and displayable metric series only. Unsupported, empty, or failed metrics are not represented as per-metric entries.
+          items:
+            $ref: '#/components/schemas/performanceTrendSeries'
+        sources:
+          type: array
+          description: Coarse collection source status. Messages are sanitized and do not expose PromQL, endpoints, credentials, or raw internal errors.
+          items:
+            $ref: '#/components/schemas/performanceTrendSource'
+        warnings:
+          type: array
+          items:
+            type: string
+        collectedAt:
           type: string
-          description: Transaction start timestamp if available.
-        durationSeconds:
-          type: integer
-          format: int64
-        xactDurationSeconds:
+          description: Backend collection timestamp in UTC.
+    mssqlRequest:
+      type: object
+      required:
+        - requestId
+        - startedAt
+        - status
+        - command
+        - database
+        - sql
+        - sqlTruncated
+        - elapsedMs
+        - cpuMs
+        - reads
+        - logicalReads
+        - writes
+        - waitType
+        - waitMs
+        - waitResource
+        - blockingSessionId
+      properties:
+        requestId:
           type: integer
           format: int64
-        queryDigest:
+        startedAt:
           type: string
-        querySummary:
+          description: Opaque SQL Server local start time, used to detect session or request reuse. Pass back unchanged; it is not a UTC timestamp.
+        status:
           type: string
-        backendType:
+        command:
           type: string
-    postgresqlSessionList:
-      type: array
-      items:
-        $ref: '#/components/schemas/postgresqlSession'
-    postgresqlSpaceSummary:
-      type: object
-      required:
-        - tableCount
-        - indexCount
-        - toastRelationCount
-        - tableListTruncated
-        - indexListTruncated
-      properties:
-        databaseName:
+        database:
           type: string
-        databaseSizeBytes:
+        sql:
+          type: string
+          description: Current statement extracted with byte offsets. Truncated to 8192 characters.
+        sqlTruncated:
+          type: boolean
+        elapsedMs:
           type: integer
           format: int64
-        tableCount:
+        cpuMs:
           type: integer
           format: int64
-        indexCount:
+        reads:
           type: integer
           format: int64
-        toastRelationCount:
+        logicalReads:
           type: integer
           format: int64
-        largestTableBytes:
+        writes:
           type: integer
           format: int64
-        largestIndexBytes:
+        waitType:
+          type: string
+        waitMs:
           type: integer
           format: int64
-        tableListTruncated:
-          type: boolean
-        indexListTruncated:
-          type: boolean
-    postgresqlStorageInstanceUsage:
-      type: object
-      properties:
-        instanceName:
-          type: string
-          description: Kubernetes pod name for this PostgreSQL replica storage sample.
-        pvcName:
+        waitResource:
           type: string
-          description: PersistentVolumeClaim name when it can be read from metrics labels.
-        role:
-          type: string
-          description: Raw PostgreSQL replica role value read from metrics labels, kept aligned with instance detail display.
-        componentName:
-          type: string
-          description: Optional KubeBlocks component name when it can be read from metrics labels.
-        totalBytes:
-          type: integer
-          format: int64
-          description: Physical PVC capacity in bytes for this replica storage sample.
-        usedBytes:
+        blockingSessionId:
           type: integer
           format: int64
-          description: Physical PVC used bytes for this replica storage sample.
-        availableBytes:
+    mssqlSession:
+      type: object
+      required:
+        - sessionId
+        - startedAt
+        - status
+        - user
+        - host
+        - application
+        - client
+        - database
+        - openTransactions
+        - transactionSeconds
+        - lastSql
+        - lastSqlTruncated
+        - requests
+        - requestsTruncated
+      properties:
+        sessionId:
           type: integer
           format: int64
-          description: Available bytes derived from totalBytes - usedBytes when both values are available.
-        usageRatio:
-          type: number
-          format: double
-          nullable: true
-          description: usedBytes / totalBytes for this replica storage sample when both values are available.
-        updatedAt:
+        startedAt:
           type: string
-          description: Metrics collection timestamp in UTC.
-        source:
+          description: Opaque SQL Server local start time, used to detect session or request reuse. Pass back unchanged; it is not a UTC timestamp.
+        status:
           type: string
-    postgresqlStorageOverview:
-      type: object
-      required:
-        - source
-        - instances
-      properties:
-        source:
+        user:
           type: string
-        instances:
-          type: array
-          description: Physical PostgreSQL replica storage usage split by pod/PVC/role.
-          items:
-            $ref: '#/components/schemas/postgresqlStorageInstanceUsage'
-    postgresqlDatabaseSpace:
-      type: object
-      properties:
-        name:
+        host:
           type: string
-        sizeBytes:
-          type: integer
-          format: int64
-    postgresqlTableSpace:
-      type: object
-      properties:
-        database:
+        application:
           type: string
-        schema:
+        client:
           type: string
-        name:
+        database:
           type: string
-        relationOid:
-          type: integer
-          format: int64
-        totalBytes:
-          type: integer
-          format: int64
-        tableBytes:
-          type: integer
-          format: int64
-        indexBytes:
-          type: integer
-          format: int64
-        toastBytes:
-          type: integer
-          format: int64
-        toastRelationOid:
-          type: integer
-          format: int64
-        liveTuples:
-          type: integer
-          format: int64
-        deadTuples:
-          type: integer
-          format: int64
-        seqScan:
+        openTransactions:
           type: integer
           format: int64
-        indexScan:
+        transactionSeconds:
           type: integer
           format: int64
-        lastVacuum:
-          type: string
-        lastAutoVacuum:
-          type: string
-        lastAnalyze:
-          type: string
-        lastAutoAnalyze:
+        lastSql:
           type: string
-    postgresqlIndexSpace:
+          description: Most recent batch on the connection, not necessarily the SQL that acquired its locks. Truncated to 8192 characters.
+        lastSqlTruncated:
+          type: boolean
+        requests:
+          type: array
+          items:
+            $ref: '#/components/schemas/mssqlRequest'
+        requestsTruncated:
+          type: boolean
+    mssqlSessionSnapshot:
       type: object
+      required:
+        - capturedAt
+        - sessions
+        - truncated
       properties:
-        database:
-          type: string
-        schema:
-          type: string
-        table:
-          type: string
-        name:
+        capturedAt:
           type: string
-        tableRelationOid:
+        sessions:
+          type: array
+          items:
+            $ref: '#/components/schemas/mssqlSession'
+        truncated:
+          type: boolean
+    mssqlWait:
+      type: object
+      required:
+        - sessionId
+        - requestId
+        - blockingSessionId
+        - waitType
+        - waitMs
+        - resource
+        - source
+      properties:
+        sessionId:
           type: integer
           format: int64
-        relationOid:
+        requestId:
           type: integer
           format: int64
-        sizeBytes:
+          description: Request ID, or -1 when a waiting task cannot be associated with a live request.
+        blockingSessionId:
           type: integer
           format: int64
-        isPrimary:
-          type: boolean
-        isUnique:
-          type: boolean
-        scanCount:
+          description: SQL Server blocking owner. Negative values are special owners, not session IDs.
+        waitType:
+          type: string
+        waitMs:
           type: integer
           format: int64
-        tuplesRead:
+        resource:
+          type: string
+        source:
+          type: string
+    mssqlLock:
+      type: object
+      required:
+        - sessionId
+        - requestId
+        - database
+        - resourceType
+        - resource
+        - entityId
+        - mode
+        - status
+        - ownerType
+      properties:
+        sessionId:
           type: integer
           format: int64
-        tuplesFetch:
+        requestId:
           type: integer
           format: int64
-    postgresqlToastRelationSpace:
-      type: object
-      properties:
         database:
           type: string
-        schema:
+        resourceType:
           type: string
-        table:
+        resource:
           type: string
-        tableRelationOid:
-          type: integer
-          format: int64
-        toastRelationOid:
-          type: integer
-          format: int64
-        toastBytes:
-          type: integer
-          format: int64
-    postgresqlSpaceSource:
-      type: object
-      required:
-        - name
-        - kind
-        - status
-        - collectedAt
-      properties:
-        name:
+        entityId:
           type: string
-        kind:
+        mode:
           type: string
         status:
           type: string
-        collectedAt:
-          type: string
-        message:
+        ownerType:
           type: string
-    postgresqlSpaceAnalysis:
+    mssqlLockSnapshot:
       type: object
       required:
-        - summary
-        - storageOverview
-        - databases
-        - selectedDatabase
-        - tables
-        - indexes
-        - toastRelations
-        - sources
-        - collectedAt
+        - capturedAt
+        - sessions
+        - waits
+        - locks
+        - truncated
       properties:
-        summary:
-          $ref: '#/components/schemas/postgresqlSpaceSummary'
-        storageOverview:
-          $ref: '#/components/schemas/postgresqlStorageOverview'
-        databases:
-          type: array
-          description: Sizes of all connectable non-template databases in the PostgreSQL instance.
-          items:
-            $ref: '#/components/schemas/postgresqlDatabaseSpace'
-        selectedDatabase:
+        capturedAt:
           type: string
-          description: Database used for tables, indexes, and toastRelations in this response.
-        tables:
+        sessions:
           type: array
-          description: Top tables from selectedDatabase.
           items:
-            $ref: '#/components/schemas/postgresqlTableSpace'
-        indexes:
+            $ref: '#/components/schemas/mssqlSession'
+        waits:
           type: array
-          description: Top indexes from selectedDatabase.
           items:
-            $ref: '#/components/schemas/postgresqlIndexSpace'
-        toastRelations:
-          type: array
-          description: Toast relations derived from selectedDatabase table space data.
-          items:
-            $ref: '#/components/schemas/postgresqlToastRelationSpace'
-        sources:
+            $ref: '#/components/schemas/mssqlWait'
+        locks:
           type: array
           items:
-            $ref: '#/components/schemas/postgresqlSpaceSource'
-        collectedAt:
+            $ref: '#/components/schemas/mssqlLock'
+        truncated:
+          type: boolean
+      description: Bounded live DMV observations. Edges are SQL Server reported blocking identifiers. Collection is not atomic; graph cycles are not historical deadlock evidence.
+    mssqlCachedPlan:
+      type: object
+      required:
+        - capturedAt
+        - xml
+        - available
+      properties:
+        capturedAt:
           type: string
-          description: Backend collection timestamp in UTC.
-    postgresqlSQLFingerprint:
+        xml:
+          type: string
+        available:
+          type: boolean
+      description: Cached compiled plan for the selected live request. No captured SQL is executed. This is not an actual runtime plan.
+    postgresqlSession:
       type: object
       required:
-        - queryID
-        - fingerprint
-        - querySummary
-        - calls
-        - totalTimeMs
-        - meanTimeMs
-        - maxTimeMs
-        - rows
-        - database
+        - pid
         - user
-        - topLevel
+        - database
+        - applicationName
+        - clientAddr
+        - clientPort
+        - state
+        - waitEventType
+        - waitEvent
+        - durationSeconds
+        - xactDurationSeconds
+        - queryDigest
+        - querySummary
+        - backendType
       properties:
-        queryID:
+        pid:
+          type: integer
+          format: int64
+        user:
           type: string
-          description: PostgreSQL pg_stat_statements queryid represented as a string.
-        fingerprint:
+        database:
           type: string
-          description: Stable SQL fingerprint identifier for UI grouping. M1 uses queryID.
-        querySummary:
+        applicationName:
           type: string
-          description: Redacted SQL summary. Full raw SQL is intentionally not returned.
-        calls:
+        clientAddr:
+          type: string
+          description: Client address.
+        clientPort:
+          type: string
+          description: Client port.
+        state:
+          type: string
+        waitEventType:
+          type: string
+        waitEvent:
+          type: string
+        backendStart:
+          type: string
+          description: Backend start timestamp if available.
+        queryStart:
+          type: string
+          description: Query start timestamp if available.
+        xactStart:
+          type: string
+          description: Transaction start timestamp if available.
+        durationSeconds:
           type: integer
           format: int64
-          description: Number of executions accumulated by pg_stat_statements since statsReset.
-        totalTimeMs:
-          type: number
-          format: double
-          description: Total execution time in milliseconds accumulated by pg_stat_statements since statsReset.
-        meanTimeMs:
-          type: number
-          format: double
-          description: Mean execution time in milliseconds.
-        maxTimeMs:
-          type: number
-          format: double
-          description: Max execution time in milliseconds.
-        rows:
+        xactDurationSeconds:
           type: integer
           format: int64
-          description: Rows returned or affected by the fingerprint, as reported by pg_stat_statements.
-        database:
+        queryDigest:
           type: string
-          description: Database name resolved from pg_stat_statements.dbid when visible.
-        user:
+        querySummary:
           type: string
-          description: Database user name resolved from pg_stat_statements.userid when visible.
-        topLevel:
-          type: boolean
-          description: Whether pg_stat_statements recorded the statement as top-level. Legacy PostgreSQL versions without the toplevel column report true.
-    postgresqlSQLAnalysis:
+        backendType:
+          type: string
+    postgresqlSessionList:
+      type: array
+      items:
+        $ref: '#/components/schemas/postgresqlSession'
+    postgresqlSpaceSummary:
       type: object
       required:
-        - source
-        - status
-        - collectedAt
-        - limit
-        - orderBy
-        - items
+        - tableCount
+        - indexCount
+        - toastRelationCount
+        - tableListTruncated
+        - indexListTruncated
       properties:
-        source:
+        databaseName:
           type: string
-          description: Data source. M1 uses pg_stat_statements only.
-        status:
+        databaseSizeBytes:
+          type: integer
+          format: int64
+        tableCount:
+          type: integer
+          format: int64
+        indexCount:
+          type: integer
+          format: int64
+        toastRelationCount:
+          type: integer
+          format: int64
+        largestTableBytes:
+          type: integer
+          format: int64
+        largestIndexBytes:
+          type: integer
+          format: int64
+        tableListTruncated:
+          type: boolean
+        indexListTruncated:
+          type: boolean
+    postgresqlStorageInstanceUsage:
+      type: object
+      properties:
+        instanceName:
           type: string
-          description: Source status. Expected values are available or unavailable.
-        unavailableReason:
+          description: Kubernetes pod name for this PostgreSQL replica storage sample.
+        pvcName:
           type: string
-          description: Reason when status is unavailable, such as extension_disabled, permission_denied, or query_failed.
-        statsReset:
+          description: PersistentVolumeClaim name when it can be read from metrics labels.
+        role:
           type: string
-          description: UTC timestamp reported by pg_stat_statements_info.stats_reset when available. Empty means the source did not expose this timestamp.
-        collectedAt:
+          description: Raw PostgreSQL replica role value read from metrics labels, kept aligned with instance detail display.
+        componentName:
           type: string
-          description: Backend collection timestamp in UTC. It is not a sampling-window end time.
-        limit:
+          description: Optional KubeBlocks component name when it can be read from metrics labels.
+        totalBytes:
           type: integer
           format: int64
-          description: Effective row limit after backend normalization.
-        orderBy:
-          type: string
-          description: Effective sort key. Expected values are totalTime, meanTime, maxTime, or calls.
-        totalTimeMsAll:
-          type: number
-          format: double
-          x-nullable: true
-          description: Total execution time in milliseconds across all visible pg_stat_statements rows, not limited to the returned top-N items. Present only when the source is available.
-        callsAll:
+          description: Physical PVC capacity in bytes for this replica storage sample.
+        usedBytes:
           type: integer
           format: int64
-          x-nullable: true
-          description: Total execution count across all visible pg_stat_statements rows, not limited to the returned top-N items. Present only when the source is available.
-        items:
+          description: Physical PVC used bytes for this replica storage sample.
+        availableBytes:
+          type: integer
+          format: int64
+          description: Available bytes derived from totalBytes - usedBytes when both values are available.
+        usageRatio:
+          type: number
+          format: double
+          nullable: true
+          description: usedBytes / totalBytes for this replica storage sample when both values are available.
+        updatedAt:
+          type: string
+          description: Metrics collection timestamp in UTC.
+        source:
+          type: string
+    postgresqlStorageOverview:
+      type: object
+      required:
+        - source
+        - instances
+      properties:
+        source:
+          type: string
+        instances:
           type: array
-          description: SQL fingerprint ranking rows from pg_stat_statements. The list may be empty when no statement statistics exist.
+          description: Physical PostgreSQL replica storage usage split by pod/PVC/role.
           items:
-            $ref: '#/components/schemas/postgresqlSQLFingerprint'
-    DmsExecutionPlanPlanningMode:
-      type: string
-      enum:
-        - standard
-        - generic
-    DmsExecutionPlanMode:
-      type: string
-      enum:
-        - estimate
-        - analyze
-        - actual
-        - autotrace
-    DmsExecutionPlanRawFormat:
-      type: string
-      enum:
-        - json
-        - xml
-        - text
-        - table
-    DmsExecutionPlanNodeCategory:
-      type: string
-      enum:
-        - result
-        - sort
-        - join
-        - table_scan
-        - index_scan
-        - lookup
-        - materialize
-        - aggregate
-        - exchange
-        - modify
-        - other
-    DmsExecutionPlanNodeCost:
+            $ref: '#/components/schemas/postgresqlStorageInstanceUsage'
+    postgresqlDatabaseSpace:
       type: object
       properties:
-        startup:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        total:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        self:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        percent:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-    DmsExecutionPlanNodeRows:
-      type: object
-      properties:
-        estimated:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        actual:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        actualPerLoop:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        removedByFilter:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        mismatchRatio:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-    DmsExecutionPlanNodeTiming:
-      type: object
-      properties:
-        startupMs:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        totalMs:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        selfMs:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        loops:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-    DmsExecutionPlanNodeConditions:
+        name:
+          type: string
+        sizeBytes:
+          type: integer
+          format: int64
+    postgresqlTableSpace:
       type: object
       properties:
-        filter:
-          type: string
-          nullable: true
-          x-omitempty: true
-        indexCond:
-          type: string
-          nullable: true
-          x-omitempty: true
-        joinCond:
+        database:
           type: string
-          nullable: true
-          x-omitempty: true
-        hashCond:
+        schema:
           type: string
-          nullable: true
-          x-omitempty: true
-        sortKey:
-          type: array
-          items:
-            type: string
-    DmsExecutionPlanNode:
-      type: object
-      properties:
-        id:
+        name:
           type: string
-        parentIds:
-          type: array
-          items:
-            type: string
-        childIds:
-          type: array
-          items:
-            type: string
-        order:
+        relationOid:
           type: integer
           format: int64
-          nullable: true
-          x-omitempty: true
-        category:
-          $ref: '#/components/schemas/DmsExecutionPlanNodeCategory'
-        nodeType:
-          type: string
-        label:
-          type: string
-        relationName:
+        totalBytes:
+          type: integer
+          format: int64
+        tableBytes:
+          type: integer
+          format: int64
+        indexBytes:
+          type: integer
+          format: int64
+        toastBytes:
+          type: integer
+          format: int64
+        toastRelationOid:
+          type: integer
+          format: int64
+        liveTuples:
+          type: integer
+          format: int64
+        deadTuples:
+          type: integer
+          format: int64
+        seqScan:
+          type: integer
+          format: int64
+        indexScan:
+          type: integer
+          format: int64
+        lastVacuum:
           type: string
-          nullable: true
-          x-omitempty: true
-        schemaName:
+        lastAutoVacuum:
           type: string
-          nullable: true
-          x-omitempty: true
-        alias:
+        lastAnalyze:
           type: string
-          nullable: true
-          x-omitempty: true
-        indexName:
+        lastAutoAnalyze:
           type: string
-          nullable: true
-          x-omitempty: true
-        cost:
-          $ref: '#/components/schemas/DmsExecutionPlanNodeCost'
-          nullable: true
-          x-omitempty: true
-        rows:
-          $ref: '#/components/schemas/DmsExecutionPlanNodeRows'
-          nullable: true
-          x-omitempty: true
-        timing:
-          $ref: '#/components/schemas/DmsExecutionPlanNodeTiming'
-          nullable: true
-          x-omitempty: true
-        conditions:
-          $ref: '#/components/schemas/DmsExecutionPlanNodeConditions'
-          nullable: true
-          x-omitempty: true
-        details:
-          type: object
-          additionalProperties: true
-          x-omitempty: true
-    DmsExecutionPlanEdgeRows:
-      type: object
-      properties:
-        estimated:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        actual:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-    DmsExecutionPlanEdge:
+    postgresqlIndexSpace:
       type: object
       properties:
-        id:
+        database:
           type: string
-        source:
+        schema:
           type: string
-        target:
+        table:
           type: string
-        rows:
-          $ref: '#/components/schemas/DmsExecutionPlanEdgeRows'
-          nullable: true
-          x-omitempty: true
-        widthWeight:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        label:
+        name:
           type: string
-          nullable: true
-          x-omitempty: true
-    DmsExecutionPlanSummary:
-      type: object
-      properties:
-        totalCost:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        totalActualTimeMs:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        planRows:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        actualRows:
-          type: number
-          format: double
-          nullable: true
-          x-omitempty: true
-        nodeCount:
+        tableRelationOid:
           type: integer
           format: int64
-        maxCostNodeId:
+        relationOid:
+          type: integer
+          format: int64
+        sizeBytes:
+          type: integer
+          format: int64
+        isPrimary:
+          type: boolean
+        isUnique:
+          type: boolean
+        scanCount:
+          type: integer
+          format: int64
+        tuplesRead:
+          type: integer
+          format: int64
+        tuplesFetch:
+          type: integer
+          format: int64
+    postgresqlToastRelationSpace:
+      type: object
+      properties:
+        database:
           type: string
-          nullable: true
-          x-omitempty: true
-        maxRowsNodeId:
+        schema:
           type: string
-          nullable: true
-          x-omitempty: true
-        maxTimeNodeId:
+        table:
           type: string
-          nullable: true
-          x-omitempty: true
-    DmsExecutionPlanWarningSeverity:
-      type: string
-      enum:
-        - info
-        - warning
-        - critical
-    DmsExecutionPlanWarning:
+        tableRelationOid:
+          type: integer
+          format: int64
+        toastRelationOid:
+          type: integer
+          format: int64
+        toastBytes:
+          type: integer
+          format: int64
+    postgresqlSpaceSource:
       type: object
+      required:
+        - name
+        - kind
+        - status
+        - collectedAt
       properties:
-        code:
+        name:
           type: string
-        severity:
-          $ref: '#/components/schemas/DmsExecutionPlanWarningSeverity'
-        nodeId:
+        kind:
+          type: string
+        status:
+          type: string
+        collectedAt:
           type: string
-          nullable: true
-          x-omitempty: true
         message:
           type: string
-    DmsExecutionPlanResult:
+    postgresqlSpaceAnalysis:
       type: object
+      required:
+        - summary
+        - storageOverview
+        - databases
+        - selectedDatabase
+        - tables
+        - indexes
+        - toastRelations
+        - sources
+        - collectedAt
       properties:
-        originSQL:
-          type: string
-        explainSQL:
-          type: string
-          nullable: true
-          x-omitempty: true
-        engineType:
-          type: string
-        mode:
-          $ref: '#/components/schemas/DmsExecutionPlanMode'
-        planMode:
-          $ref: '#/components/schemas/DmsExecutionPlanPlanningMode'
-        parameterized:
-          type: boolean
-          x-omitempty: false
-        parameterCount:
-          type: integer
-          format: int64
-          nullable: true
-          x-omitempty: true
-        hasActualStats:
-          type: boolean
-          x-omitempty: false
-        rawFormat:
-          $ref: '#/components/schemas/DmsExecutionPlanRawFormat'
-        rawPlan:
-          type: object
-          description: Engine-native raw plan payload exposed for fallback display. SDKs model it as a free-form JSON object.
-          additionalProperties: true
-          x-omitempty: true
-        rootNodeIds:
-          type: array
-          items:
-            type: string
-        nodes:
+        summary:
+          $ref: '#/components/schemas/postgresqlSpaceSummary'
+        storageOverview:
+          $ref: '#/components/schemas/postgresqlStorageOverview'
+        databases:
           type: array
+          description: Sizes of all connectable non-template databases in the PostgreSQL instance.
           items:
-            $ref: '#/components/schemas/DmsExecutionPlanNode'
-        edges:
+            $ref: '#/components/schemas/postgresqlDatabaseSpace'
+        selectedDatabase:
+          type: string
+          description: Database used for tables, indexes, and toastRelations in this response.
+        tables:
           type: array
+          description: Top tables from selectedDatabase.
           items:
-            $ref: '#/components/schemas/DmsExecutionPlanEdge'
-        summary:
-          $ref: '#/components/schemas/DmsExecutionPlanSummary'
-          nullable: true
-          x-omitempty: true
-        warnings:
+            $ref: '#/components/schemas/postgresqlTableSpace'
+        indexes:
           type: array
-          items:
-            $ref: '#/components/schemas/DmsExecutionPlanWarning'
-        fallbackTable:
-          $ref: '#/components/schemas/DmsQueryResponse'
-          nullable: true
-          x-omitempty: true
-    postgresqlSQLFingerprintExplainResponse:
-      type: object
-      required:
-        - queryID
-        - fingerprint
-        - database
-        - user
-        - topLevel
-        - planMode
-        - parameterized
-        - explainResult
-      properties:
-        queryID:
-          type: string
-          description: PostgreSQL pg_stat_statements queryid represented as a string.
-        fingerprint:
-          type: string
-          description: Stable SQL fingerprint identifier for UI grouping. Currently aligned with PostgreSQL pg_stat_statements queryid.
-        database:
-          type: string
-          description: Database name from the requested SQL fingerprint identity.
-        user:
-          type: string
-          description: Database user from the requested SQL fingerprint identity.
-        topLevel:
-          type: boolean
-          description: Top-level flag from the requested SQL fingerprint identity.
-        statementSource:
-          type: string
-          description: Server-side source used to resolve the parameterized SQL statement. Raw SQL is not returned.
-        statementResolvedAt:
+          description: Top indexes from selectedDatabase.
+          items:
+            $ref: '#/components/schemas/postgresqlIndexSpace'
+        toastRelations:
+          type: array
+          description: Toast relations derived from selectedDatabase table space data.
+          items:
+            $ref: '#/components/schemas/postgresqlToastRelationSpace'
+        sources:
+          type: array
+          items:
+            $ref: '#/components/schemas/postgresqlSpaceSource'
+        collectedAt:
           type: string
-          description: Timestamp when the parameterized SQL statement was resolved.
-        planMode:
-          $ref: '#/components/schemas/DmsExecutionPlanPlanningMode'
-          description: Whether DMS produced a standard estimated plan or a generic parameterized estimated plan.
-        parameterized:
-          type: boolean
-          description: Whether generic parameterized planning was used (planMode is generic). False means standard planning, not that historical parameter values were used. This endpoint never retrieves historical parameter values.
-          x-omitempty: false
-        parameterCount:
-          type: integer
-          format: int64
-          nullable: true
-          x-omitempty: true
-          description: Number of parameters when DMS can determine it. It may be omitted for PostgreSQL generic-plan paths that do not expose the count.
-        explainResult:
-          $ref: '#/components/schemas/DmsExecutionPlanResult'
-          description: Normalized DMS estimated visual plan. The resolved statement and generated EXPLAIN SQL are intentionally removed.
-    mysqlSQLFingerprint:
+          description: Backend collection timestamp in UTC.
+    postgresqlSQLFingerprint:
       type: object
       required:
         - queryID
@@ -27274,97 +27487,49 @@ components:
         - meanTimeMs
         - maxTimeMs
         - rows
-        - rowsSent
-        - rowsAffected
-        - rowsExamined
-        - lockTimeMs
-        - errors
-        - warnings
-        - tmpTables
-        - tmpDiskTables
-        - noIndexUsed
-        - noGoodIndexUsed
         - database
+        - user
+        - topLevel
       properties:
         queryID:
           type: string
-          description: MySQL Performance Schema DIGEST value.
+          description: PostgreSQL pg_stat_statements queryid represented as a string.
         fingerprint:
           type: string
-          description: Stable SQL fingerprint identifier. M1 uses DIGEST.
+          description: Stable SQL fingerprint identifier for UI grouping. M1 uses queryID.
         querySummary:
           type: string
-          description: Normalized DIGEST_TEXT. Raw SQL text is intentionally not returned.
+          description: Redacted SQL summary. Full raw SQL is intentionally not returned.
         calls:
           type: integer
           format: int64
-          description: Number of executions accumulated in the current digest row.
+          description: Number of executions accumulated by pg_stat_statements since statsReset.
         totalTimeMs:
           type: number
           format: double
-          description: Total statement wait time in milliseconds.
+          description: Total execution time in milliseconds accumulated by pg_stat_statements since statsReset.
         meanTimeMs:
           type: number
           format: double
-          description: Mean statement wait time in milliseconds.
+          description: Mean execution time in milliseconds.
         maxTimeMs:
           type: number
           format: double
-          description: Maximum statement wait time in milliseconds.
+          description: Max execution time in milliseconds.
         rows:
           type: integer
           format: int64
-          description: Sum of rows sent and rows affected.
-        rowsSent:
-          type: integer
-          format: int64
-          description: Total rows sent to clients.
-        rowsAffected:
-          type: integer
-          format: int64
-          description: Total rows affected by statements.
-        rowsExamined:
-          type: integer
-          format: int64
-          description: Total rows examined by statements.
-        lockTimeMs:
-          type: number
-          format: double
-          description: Total statement lock time in milliseconds.
-        errors:
-          type: integer
-          format: int64
-          description: Total statement errors.
-        warnings:
-          type: integer
-          format: int64
-          description: Total statement warnings.
-        tmpTables:
-          type: integer
-          format: int64
-          description: Total internal temporary tables created.
-        tmpDiskTables:
-          type: integer
-          format: int64
-          description: Total internal on-disk temporary tables created.
-        noIndexUsed:
-          type: integer
-          format: int64
-          description: Executions that used no index.
-        noGoodIndexUsed:
-          type: integer
-          format: int64
-          description: Executions for which no good index was found.
+          description: Rows returned or affected by the fingerprint, as reported by pg_stat_statements.
         database:
           type: string
-          description: Default schema name associated with the digest row.
-        firstSeen:
-          type: string
-          description: UTC timestamp when the digest was first observed.
-        lastSeen:
+          description: Database name resolved from pg_stat_statements.dbid when visible.
+        user:
           type: string
-          description: UTC timestamp when the digest was most recently observed.
-    mysqlSQLAnalysis:
+          description: Database user name resolved from pg_stat_statements.userid when visible.
+        topLevel:
+          type: boolean
+          description: Whether pg_stat_statements recorded the statement as top-level. Legacy PostgreSQL versions without the toplevel column report true.
+    postgresqlSQLAnalysis:
       type: object
       required:
         - source
@@ -27374,236 +27539,431 @@ components:
         - orderBy
         - items
       properties:
-        source:
-          type: string
-          description: Data source. M1 uses performance_schema.events_statements_summary_by_digest.
-        status:
-          type: string
-          description: Source status. Expected values are available or unavailable.
-        unavailableReason:
-          type: string
-          description: Reason when status is unavailable, such as performance_schema_disabled, digest_consumer_disabled, permission_denied, or query_failed.
-        message:
-          type: string
-          description: User-facing recovery guidance when SQL analysis is unavailable.
-        collectedAt:
+        source:
+          type: string
+          description: Data source. M1 uses pg_stat_statements only.
+        status:
+          type: string
+          description: Source status. Expected values are available or unavailable.
+        unavailableReason:
+          type: string
+          description: Reason when status is unavailable, such as extension_disabled, permission_denied, or query_failed.
+        statsReset:
+          type: string
+          description: UTC timestamp reported by pg_stat_statements_info.stats_reset when available. Empty means the source did not expose this timestamp.
+        collectedAt:
+          type: string
+          description: Backend collection timestamp in UTC. It is not a sampling-window end time.
+        limit:
+          type: integer
+          format: int64
+          description: Effective row limit after backend normalization.
+        orderBy:
+          type: string
+          description: Effective sort key. Expected values are totalTime, meanTime, maxTime, or calls.
+        totalTimeMsAll:
+          type: number
+          format: double
+          x-nullable: true
+          description: Total execution time in milliseconds across all visible pg_stat_statements rows, not limited to the returned top-N items. Present only when the source is available.
+        callsAll:
+          type: integer
+          format: int64
+          x-nullable: true
+          description: Total execution count across all visible pg_stat_statements rows, not limited to the returned top-N items. Present only when the source is available.
+        items:
+          type: array
+          description: SQL fingerprint ranking rows from pg_stat_statements. The list may be empty when no statement statistics exist.
+          items:
+            $ref: '#/components/schemas/postgresqlSQLFingerprint'
+    DmsExecutionPlanPlanningMode:
+      type: string
+      enum:
+        - standard
+        - generic
+    DmsExecutionPlanMode:
+      type: string
+      enum:
+        - estimate
+        - analyze
+        - actual
+        - autotrace
+    DmsExecutionPlanRawFormat:
+      type: string
+      enum:
+        - json
+        - xml
+        - text
+        - table
+    DmsExecutionPlanNodeCategory:
+      type: string
+      enum:
+        - result
+        - sort
+        - join
+        - table_scan
+        - index_scan
+        - lookup
+        - materialize
+        - aggregate
+        - exchange
+        - modify
+        - other
+    DmsExecutionPlanNodeCost:
+      type: object
+      properties:
+        startup:
+          type: number
+          format: double
+          nullable: true
+          x-omitempty: true
+        total:
+          type: number
+          format: double
+          nullable: true
+          x-omitempty: true
+        self:
+          type: number
+          format: double
+          nullable: true
+          x-omitempty: true
+        percent:
+          type: number
+          format: double
+          nullable: true
+          x-omitempty: true
+    DmsExecutionPlanNodeRows:
+      type: object
+      properties:
+        estimated:
+          type: number
+          format: double
+          nullable: true
+          x-omitempty: true
+        actual:
+          type: number
+          format: double
+          nullable: true
+          x-omitempty: true
+        actualPerLoop:
+          type: number
+          format: double
+          nullable: true
+          x-omitempty: true
+        removedByFilter:
+          type: number
+          format: double
+          nullable: true
+          x-omitempty: true
+        mismatchRatio:
+          type: number
+          format: double
+          nullable: true
+          x-omitempty: true
+    DmsExecutionPlanNodeTiming:
+      type: object
+      properties:
+        startupMs:
+          type: number
+          format: double
+          nullable: true
+          x-omitempty: true
+        totalMs:
+          type: number
+          format: double
+          nullable: true
+          x-omitempty: true
+        selfMs:
+          type: number
+          format: double
+          nullable: true
+          x-omitempty: true
+        loops:
+          type: number
+          format: double
+          nullable: true
+          x-omitempty: true
+    DmsExecutionPlanNodeConditions:
+      type: object
+      properties:
+        filter:
           type: string
-          description: Backend collection timestamp in UTC. It is not a sampling-window end time.
-        firstSeen:
+          nullable: true
+          x-omitempty: true
+        indexCond:
           type: string
-          description: Earliest FIRST_SEEN timestamp across currently visible digest rows, when available.
-        lastSeen:
+          nullable: true
+          x-omitempty: true
+        joinCond:
           type: string
-          description: Latest LAST_SEEN timestamp across currently visible digest rows, when available.
-        limit:
-          type: integer
-          format: int64
-          description: Effective row limit after backend normalization.
-        orderBy:
+          nullable: true
+          x-omitempty: true
+        hashCond:
           type: string
-          description: Effective sort key. Expected values are totalTime, meanTime, maxTime, or calls.
-        totalTimeMsAll:
-          type: number
-          format: double
-          x-nullable: true
-          description: Total execution time in milliseconds across all visible digest rows, not limited to the returned top-N items.
-        callsAll:
-          type: integer
-          format: int64
-          x-nullable: true
-          description: Total execution count across all visible digest rows, not limited to the returned top-N items.
-        digestLost:
-          type: integer
-          format: int64
-          x-nullable: true
-          description: Number of statement digests not recorded because the digest table was full, when exposed by the server.
-        items:
+          nullable: true
+          x-omitempty: true
+        sortKey:
           type: array
-          description: SQL fingerprint ranking rows from Performance Schema. The list may be empty when no statement statistics exist.
           items:
-            $ref: '#/components/schemas/mysqlSQLFingerprint'
-    performanceTrendRange:
+            type: string
+    DmsExecutionPlanNode:
       type: object
-      required:
-        - label
-        - start
-        - end
-        - durationSeconds
       properties:
-        label:
-          type: string
-          description: Controlled query range label. Values are 1h, 6h, 24h, or 7d.
-        start:
-          type: string
-        end:
+        id:
           type: string
-        durationSeconds:
+        parentIds:
+          type: array
+          items:
+            type: string
+        childIds:
+          type: array
+          items:
+            type: string
+        order:
           type: integer
           format: int64
-    performanceTrendSummary:
-      type: object
-      required:
-        - metric
-        - displayName
-        - category
-        - unit
-        - min
-        - max
-        - avg
-        - latest
-      properties:
-        metric:
-          type: string
-        displayName:
-          $ref: '#/components/schemas/localizedDescription'
+          nullable: true
+          x-omitempty: true
         category:
+          $ref: '#/components/schemas/DmsExecutionPlanNodeCategory'
+        nodeType:
           type: string
-          description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
-        dimension:
+        label:
           type: string
-          description: Optional series dimension. Values include cluster, instance, pvc, and database.
-        labels:
-          type: object
-          additionalProperties:
-            type: string
-          description: Optional dimension labels, for example instance, pvc, role, or datname.
-        unit:
+        relationName:
           type: string
-        warnThreshold:
+          nullable: true
+          x-omitempty: true
+        schemaName:
+          type: string
+          nullable: true
+          x-omitempty: true
+        alias:
+          type: string
+          nullable: true
+          x-omitempty: true
+        indexName:
+          type: string
+          nullable: true
+          x-omitempty: true
+        cost:
+          $ref: '#/components/schemas/DmsExecutionPlanNodeCost'
+          nullable: true
+          x-omitempty: true
+        rows:
+          $ref: '#/components/schemas/DmsExecutionPlanNodeRows'
+          nullable: true
+          x-omitempty: true
+        timing:
+          $ref: '#/components/schemas/DmsExecutionPlanNodeTiming'
+          nullable: true
+          x-omitempty: true
+        conditions:
+          $ref: '#/components/schemas/DmsExecutionPlanNodeConditions'
+          nullable: true
+          x-omitempty: true
+        details:
+          type: object
+          additionalProperties: true
+          x-omitempty: true
+    DmsExecutionPlanEdgeRows:
+      type: object
+      properties:
+        estimated:
           type: number
           format: double
-          description: Optional warning threshold in the same unit as this metric.
-        critThreshold:
+          nullable: true
+          x-omitempty: true
+        actual:
           type: number
           format: double
-          description: Optional critical threshold in the same unit as this metric.
-        thresholdDirection:
+          nullable: true
+          x-omitempty: true
+    DmsExecutionPlanEdge:
+      type: object
+      properties:
+        id:
           type: string
-          description: Optional threshold direction. Values are above, below, or boolean.
-        min:
+        source:
+          type: string
+        target:
+          type: string
+        rows:
+          $ref: '#/components/schemas/DmsExecutionPlanEdgeRows'
+          nullable: true
+          x-omitempty: true
+        widthWeight:
           type: number
           format: double
-        max:
+          nullable: true
+          x-omitempty: true
+        label:
+          type: string
+          nullable: true
+          x-omitempty: true
+    DmsExecutionPlanSummary:
+      type: object
+      properties:
+        totalCost:
           type: number
           format: double
-        avg:
+          nullable: true
+          x-omitempty: true
+        totalActualTimeMs:
           type: number
           format: double
-        latest:
+          nullable: true
+          x-omitempty: true
+        planRows:
           type: number
           format: double
-        changeDirection:
-          type: string
-          description: Change direction when at least two samples exist. Values are increasing, decreasing, or stable.
-    performanceTrendPoint:
-      type: object
-      required:
-        - timestamp
-        - value
-      properties:
-        timestamp:
-          type: string
-        value:
+          nullable: true
+          x-omitempty: true
+        actualRows:
           type: number
           format: double
-    performanceTrendSeries:
-      type: object
-      required:
-        - metric
-        - displayName
-        - category
-        - unit
-        - points
-      properties:
-        metric:
-          type: string
-        displayName:
-          $ref: '#/components/schemas/localizedDescription'
-        category:
-          type: string
-          description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
-        dimension:
+          nullable: true
+          x-omitempty: true
+        nodeCount:
+          type: integer
+          format: int64
+        maxCostNodeId:
           type: string
-          description: Optional series dimension. Values include cluster, instance, pvc, and database.
-        labels:
-          type: object
-          additionalProperties:
-            type: string
-          description: Optional dimension labels, for example instance, pvc, role, or datname.
-        unit:
+          nullable: true
+          x-omitempty: true
+        maxRowsNodeId:
           type: string
-        warnThreshold:
-          type: number
-          format: double
-          description: Optional warning threshold in the same unit as this metric.
-        critThreshold:
-          type: number
-          format: double
-          description: Optional critical threshold in the same unit as this metric.
-        thresholdDirection:
+          nullable: true
+          x-omitempty: true
+        maxTimeNodeId:
           type: string
-          description: Optional threshold direction. Values are above, below, or boolean.
-        points:
-          type: array
-          items:
-            $ref: '#/components/schemas/performanceTrendPoint'
-    performanceTrendSource:
+          nullable: true
+          x-omitempty: true
+    DmsExecutionPlanWarningSeverity:
+      type: string
+      enum:
+        - info
+        - warning
+        - critical
+    DmsExecutionPlanWarning:
       type: object
-      required:
-        - name
-        - kind
-        - status
-        - collectedAt
       properties:
-        name:
-          type: string
-        kind:
-          type: string
-        status:
+        code:
           type: string
-          description: Coarse source status. Values are success, partial, failed, skipped, or noData.
-        collectedAt:
+        severity:
+          $ref: '#/components/schemas/DmsExecutionPlanWarningSeverity'
+        nodeId:
           type: string
+          nullable: true
+          x-omitempty: true
         message:
           type: string
-    performanceTrends:
+    DmsExecutionPlanResult:
       type: object
-      required:
-        - range
-        - granularity
-        - summary
-        - series
-        - sources
-        - warnings
-        - collectedAt
       properties:
-        range:
-          $ref: '#/components/schemas/performanceTrendRange'
-        granularity:
+        originSQL:
           type: string
-          description: Controlled backend query step.
-        summary:
+        explainSQL:
+          type: string
+          nullable: true
+          x-omitempty: true
+        engineType:
+          type: string
+        mode:
+          $ref: '#/components/schemas/DmsExecutionPlanMode'
+        planMode:
+          $ref: '#/components/schemas/DmsExecutionPlanPlanningMode'
+        parameterized:
+          type: boolean
+          x-omitempty: false
+        parameterCount:
+          type: integer
+          format: int64
+          nullable: true
+          x-omitempty: true
+        hasActualStats:
+          type: boolean
+          x-omitempty: false
+        rawFormat:
+          $ref: '#/components/schemas/DmsExecutionPlanRawFormat'
+        rawPlan:
+          type: object
+          description: Engine-native raw plan payload exposed for fallback display. SDKs model it as a free-form JSON object.
+          additionalProperties: true
+          x-omitempty: true
+        rootNodeIds:
           type: array
-          description: Per-series numeric summary. changeDirection is present only when at least two points exist.
           items:
-            $ref: '#/components/schemas/performanceTrendSummary'
-        series:
+            type: string
+        nodes:
           type: array
-          description: Successfully collected and displayable metric series only. Unsupported, empty, or failed metrics are not represented as per-metric entries.
           items:
-            $ref: '#/components/schemas/performanceTrendSeries'
-        sources:
+            $ref: '#/components/schemas/DmsExecutionPlanNode'
+        edges:
           type: array
-          description: Coarse collection source status. Messages are sanitized and do not expose PromQL, endpoints, credentials, or raw internal errors.
           items:
-            $ref: '#/components/schemas/performanceTrendSource'
+            $ref: '#/components/schemas/DmsExecutionPlanEdge'
+        summary:
+          $ref: '#/components/schemas/DmsExecutionPlanSummary'
+          nullable: true
+          x-omitempty: true
         warnings:
           type: array
           items:
-            type: string
-        collectedAt:
+            $ref: '#/components/schemas/DmsExecutionPlanWarning'
+        fallbackTable:
+          $ref: '#/components/schemas/DmsQueryResponse'
+          nullable: true
+          x-omitempty: true
+    postgresqlSQLFingerprintExplainResponse:
+      type: object
+      required:
+        - queryID
+        - fingerprint
+        - database
+        - user
+        - topLevel
+        - planMode
+        - parameterized
+        - explainResult
+      properties:
+        queryID:
           type: string
-          description: Backend collection timestamp in UTC.
+          description: PostgreSQL pg_stat_statements queryid represented as a string.
+        fingerprint:
+          type: string
+          description: Stable SQL fingerprint identifier for UI grouping. Currently aligned with PostgreSQL pg_stat_statements queryid.
+        database:
+          type: string
+          description: Database name from the requested SQL fingerprint identity.
+        user:
+          type: string
+          description: Database user from the requested SQL fingerprint identity.
+        topLevel:
+          type: boolean
+          description: Top-level flag from the requested SQL fingerprint identity.
+        statementSource:
+          type: string
+          description: Server-side source used to resolve the parameterized SQL statement. Raw SQL is not returned.
+        statementResolvedAt:
+          type: string
+          description: Timestamp when the parameterized SQL statement was resolved.
+        planMode:
+          $ref: '#/components/schemas/DmsExecutionPlanPlanningMode'
+          description: Whether DMS produced a standard estimated plan or a generic parameterized estimated plan.
+        parameterized:
+          type: boolean
+          description: Whether generic parameterized planning was used (planMode is generic). False means standard planning, not that historical parameter values were used. This endpoint never retrieves historical parameter values.
+          x-omitempty: false
+        parameterCount:
+          type: integer
+          format: int64
+          nullable: true
+          x-omitempty: true
+          description: Number of parameters when DMS can determine it. It may be omitted for PostgreSQL generic-plan paths that do not expose the count.
+        explainResult:
+          $ref: '#/components/schemas/DmsExecutionPlanResult'
+          description: Normalized DMS estimated visual plan. The resolved statement and generated EXPLAIN SQL are intentionally removed.
     elasticsearchHotThreadsType:
       type: string
       enum:
@@ -37063,6 +37423,163 @@ components:
           description: Roles granted to the account, separated by commas.
         type:
           $ref: '#/components/schemas/CkAccountType'
+    OracleTablespaceFile:
+      type: object
+      required:
+        - id
+        - name
+        - status
+        - allocatedSizeMB
+        - usedSizeMB
+        - autoExtend
+        - nextSizeMB
+        - maxSizeMB
+      properties:
+        id:
+          type: integer
+          format: int64
+        name:
+          type: string
+        status:
+          type: string
+        allocatedSizeMB:
+          type: number
+          format: double
+        usedSizeMB:
+          type: number
+          format: double
+        autoExtend:
+          type: boolean
+        nextSizeMB:
+          type: number
+          format: double
+        maxSizeMB:
+          type: number
+          format: double
+    OracleTablespace:
+      type: object
+      description: Oracle tablespace in the datasource connection's current container. Sizes are in MiB. Supports Oracle 12c and 19c.
+      required:
+        - name
+        - contents
+        - status
+        - bigfile
+        - blockSize
+        - containerName
+        - isDefault
+        - allocatedSizeMB
+        - usedSizeMB
+        - maxSizeMB
+        - files
+      properties:
+        name:
+          type: string
+        contents:
+          type: string
+          description: PERMANENT, TEMPORARY, or UNDO.
+        status:
+          type: string
+        bigfile:
+          type: boolean
+        blockSize:
+          type: integer
+          format: int64
+        containerName:
+          type: string
+        isDefault:
+          type: boolean
+          description: Whether this is a default permanent or temporary tablespace, including default temporary group members.
+        allocatedSizeMB:
+          type: number
+          format: double
+        usedSizeMB:
+          type: number
+          format: double
+          description: Allocated file space minus free extents, or temporary file space currently allocated to temporary segments.
+        maxSizeMB:
+          type: number
+          format: double
+          description: Configured file growth limit; does not imply available disk capacity.
+        files:
+          type: array
+          items:
+            $ref: '#/components/schemas/OracleTablespaceFile'
+    OracleTablespaceContents:
+      type: string
+      enum:
+        - PERMANENT
+        - TEMPORARY
+      description: New tablespaces default to PERMANENT when omitted.
+    OracleTablespaceFileSpec:
+      type: object
+      required:
+        - sizeMB
+      properties:
+        name:
+          type: string
+          description: Absolute database-server file path or ASM destination. Omit to use Oracle Managed Files (DB_CREATE_FILE_DEST must be configured). Existing files are never reused.
+          maxLength: 1024
+        sizeMB:
+          type: integer
+          format: int64
+          minimum: 1
+        autoExtend:
+          type: boolean
+          default: false
+        nextSizeMB:
+          type: integer
+          format: int64
+          minimum: 0
+          description: Required positive increment when autoExtend is true; otherwise omit.
+        maxSizeMB:
+          type: integer
+          format: int64
+          minimum: 0
+          description: Maximum size when autoExtend is true; zero or omitted means UNLIMITED. Otherwise omit.
+    OracleTablespaceCreate:
+      type: object
+      required:
+        - name
+        - files
+      properties:
+        name:
+          type: string
+          pattern: ^[A-Za-z][A-Za-z0-9_$#]{0,29}$
+          description: Converted to uppercase. Limited to 30 ASCII bytes for compatibility with Oracle 12.1.
+        contents:
+          $ref: '#/components/schemas/OracleTablespaceContents'
+        bigfile:
+          type: boolean
+          default: false
+        files:
+          type: array
+          minItems: 1
+          description: Exactly one file for BIGFILE tablespaces.
+          items:
+            $ref: '#/components/schemas/OracleTablespaceFileSpec'
+    OracleTablespaceExpandAction:
+      type: string
+      enum:
+        - resize
+        - addFile
+    OracleTablespaceExpand:
+      type: object
+      description: One DDL operation per request. Use resize with fileId and sizeMB, or addFile with file. Shrinking and adding files to BIGFILE tablespaces are rejected.
+      required:
+        - action
+      properties:
+        action:
+          $ref: '#/components/schemas/OracleTablespaceExpandAction'
+        fileId:
+          type: integer
+          format: int64
+          minimum: 1
+        sizeMB:
+          type: integer
+          format: int64
+          minimum: 1
+        file:
+          $ref: '#/components/schemas/OracleTablespaceFileSpec'
     DmFile:
       type: object
       required: