kb-cloud-client-typescript 2.4.0-alpha.42 → 2.4.0-alpha.44

package/src/adminapi.yaml

@@ -22321,6 +22321,83 @@ paths:
           $ref: '#/components/responses/404'
         '500':
           $ref: '#/components/responses/500'
+  /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/postgresql/sqlAnalysis/queries/{queryID}/explain:
+    post:
+      tags:
+        - diagnostics
+      summary: Explain PostgreSQL SQL fingerprint
+      description: Explicitly trigger a safe PostgreSQL EXPLAIN for one SQL fingerprint. The request does not accept raw SQL. DMS resolves the exact server-side parameterized SELECT statement identity independently of the ranking window, produces an estimated standard or generic plan without parameter sample values, rejects multiple statements, and never runs EXPLAIN ANALYZE or the original SQL. The plan uses current catalog statistics and the DMS connection context; it does not reconstruct the original role, search_path, session settings, parameter values, or historical actual plan.
+      operationId: explainDiagnosticsPostgresqlSQLFingerprint
+      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: queryID
+          in: path
+          description: PostgreSQL pg_stat_statements queryid represented as a string.
+          required: true
+          schema:
+            type: string
+        - name: database
+          in: query
+          description: Database name from the ranking row. The key is required to disambiguate the queryID. An unresolved empty name returns 422 no_explainable_sql_statement.
+          required: true
+          allowEmptyValue: true
+          schema:
+            type: string
+        - name: user
+          in: query
+          description: Database user from the ranking row. The key is required to disambiguate the queryID. An unresolved empty name returns 422 no_explainable_sql_statement.
+          required: true
+          allowEmptyValue: true
+          schema:
+            type: string
+        - name: topLevel
+          in: query
+          description: Top-level identity from the ranking row. Required to disambiguate the queryID on PostgreSQL versions that expose pg_stat_statements.toplevel.
+          required: true
+          schema:
+            type: boolean
+        - name: fingerprint
+          in: query
+          description: Optional fingerprint consistency guard. Currently aligned with PostgreSQL pg_stat_statements queryid.
+          required: false
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/postgresqlSQLFingerprintExplainResponse'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '422':
+          description: Unprocessable Entity
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+        '500':
+          $ref: '#/components/responses/500'
+        '503':
+          $ref: '#/components/responses/503'
   /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mysql/sqlAnalysis:
     get:
       tags:
@@ -29657,6 +29734,11 @@ components:
         - analyze
         - actual
         - autotrace
+    DmsExecutionPlanPlanningMode:
+      type: string
+      enum:
+        - standard
+        - generic
     DmsExecutionPlanRawFormat:
       type: string
       enum:
@@ -29940,6 +30022,16 @@ components:
           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
@@ -43013,6 +43105,7 @@ components:
         - rows
         - database
         - user
+        - topLevel
       properties:
         queryID:
           type: string
@@ -43049,6 +43142,9 @@ components:
         user:
           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:
       type: object
       required:
@@ -43096,6 +43192,55 @@ components:
           description: SQL fingerprint ranking rows from pg_stat_statements. The list may be empty when no statement statistics exist.
           items:
             $ref: '#/components/schemas/postgresqlSQLFingerprint'
+    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:
+          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:
       type: object
       required:

package/src/openapi/.openapi-generator/FILES

@@ -389,6 +389,7 @@ models/dms-execution-plan-node-cost.ts
 models/dms-execution-plan-node-rows.ts
 models/dms-execution-plan-node-timing.ts
 models/dms-execution-plan-node.ts
+models/dms-execution-plan-planning-mode.ts
 models/dms-execution-plan-raw-format.ts
 models/dms-execution-plan-result.ts
 models/dms-execution-plan-summary.ts
@@ -798,6 +799,7 @@ models/postgresql-space-analysis.ts
 models/postgresql-space-source.ts
 models/postgresql-space-summary.ts
 models/postgresql-sqlanalysis.ts
+models/postgresql-sqlfingerprint-explain-response.ts
 models/postgresql-sqlfingerprint.ts
 models/postgresql-storage-instance-usage.ts
 models/postgresql-storage-overview.ts

package/src/openapi/apis/diagnostics-api.ts

@@ -68,6 +68,8 @@ import type { PostgresqlLockAnalysis } from '../models';
 // @ts-ignore
 import type { PostgresqlSQLAnalysis } from '../models';
 // @ts-ignore
+import type { PostgresqlSQLFingerprintExplainResponse } from '../models';
+// @ts-ignore
 import type { PostgresqlSession } from '../models';
 // @ts-ignore
 import type { PostgresqlSpaceAnalysis } from '../models';
@@ -139,6 +141,81 @@ export const DiagnosticsApiAxiosParamCreator = function (configuration?: Configu
 
 
     
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Explicitly trigger a safe PostgreSQL EXPLAIN for one SQL fingerprint. The request does not accept raw SQL. DMS resolves the exact server-side parameterized SELECT statement identity independently of the ranking window, produces an estimated standard or generic plan without parameter sample values, rejects multiple statements, and never runs EXPLAIN ANALYZE or the original SQL. The plan uses current catalog statistics and the DMS connection context; it does not reconstruct the original role, search_path, session settings, parameter values, or historical actual plan.
+         * @summary Explain PostgreSQL SQL fingerprint
+         * @param {string} orgName Organization name
+         * @param {string} clusterName Cluster name
+         * @param {string} queryID PostgreSQL pg_stat_statements queryid represented as a string.
+         * @param {string} database Database name from the ranking row. The key is required to disambiguate the queryID. An unresolved empty name returns 422 no_explainable_sql_statement.
+         * @param {string} user Database user from the ranking row. The key is required to disambiguate the queryID. An unresolved empty name returns 422 no_explainable_sql_statement.
+         * @param {boolean} topLevel Top-level identity from the ranking row. Required to disambiguate the queryID on PostgreSQL versions that expose pg_stat_statements.toplevel.
+         * @param {string} [fingerprint] Optional fingerprint consistency guard. Currently aligned with PostgreSQL pg_stat_statements queryid.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        explainDiagnosticsPostgresqlSQLFingerprint: async (orgName: string, clusterName: string, queryID: string, database: string, user: string, topLevel: boolean, fingerprint?: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'orgName' is not null or undefined
+            assertParamExists('explainDiagnosticsPostgresqlSQLFingerprint', 'orgName', orgName)
+            // verify required parameter 'clusterName' is not null or undefined
+            assertParamExists('explainDiagnosticsPostgresqlSQLFingerprint', 'clusterName', clusterName)
+            // verify required parameter 'queryID' is not null or undefined
+            assertParamExists('explainDiagnosticsPostgresqlSQLFingerprint', 'queryID', queryID)
+            // verify required parameter 'database' is not null or undefined
+            assertParamExists('explainDiagnosticsPostgresqlSQLFingerprint', 'database', database)
+            // verify required parameter 'user' is not null or undefined
+            assertParamExists('explainDiagnosticsPostgresqlSQLFingerprint', 'user', user)
+            // verify required parameter 'topLevel' is not null or undefined
+            assertParamExists('explainDiagnosticsPostgresqlSQLFingerprint', 'topLevel', topLevel)
+            const localVarPath = `/api/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/postgresql/sqlAnalysis/queries/{queryID}/explain`
+                .replace(`{${"orgName"}}`, encodeURIComponent(String(orgName)))
+                .replace(`{${"clusterName"}}`, encodeURIComponent(String(clusterName)))
+                .replace(`{${"queryID"}}`, encodeURIComponent(String(queryID)));
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication BearerToken required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            // authentication DigestAuth required
+            await setApiKeyToObject(localVarHeaderParameter, "Authorization", configuration)
+
+            if (database !== undefined) {
+                localVarQueryParameter['database'] = database;
+            }
+
+            if (user !== undefined) {
+                localVarQueryParameter['user'] = user;
+            }
+
+            if (topLevel !== undefined) {
+                localVarQueryParameter['topLevel'] = topLevel;
+            }
+
+            if (fingerprint !== undefined) {
+                localVarQueryParameter['fingerprint'] = fingerprint;
+            }
+
+
+    
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
@@ -1305,6 +1382,25 @@ export const DiagnosticsApiFp = function(configuration?: Configuration) {
             const localVarOperationServerBasePath = operationServerMap['DiagnosticsApi.explainDiagnosticsElasticsearchAllocation']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
+        /**
+         * Explicitly trigger a safe PostgreSQL EXPLAIN for one SQL fingerprint. The request does not accept raw SQL. DMS resolves the exact server-side parameterized SELECT statement identity independently of the ranking window, produces an estimated standard or generic plan without parameter sample values, rejects multiple statements, and never runs EXPLAIN ANALYZE or the original SQL. The plan uses current catalog statistics and the DMS connection context; it does not reconstruct the original role, search_path, session settings, parameter values, or historical actual plan.
+         * @summary Explain PostgreSQL SQL fingerprint
+         * @param {string} orgName Organization name
+         * @param {string} clusterName Cluster name
+         * @param {string} queryID PostgreSQL pg_stat_statements queryid represented as a string.
+         * @param {string} database Database name from the ranking row. The key is required to disambiguate the queryID. An unresolved empty name returns 422 no_explainable_sql_statement.
+         * @param {string} user Database user from the ranking row. The key is required to disambiguate the queryID. An unresolved empty name returns 422 no_explainable_sql_statement.
+         * @param {boolean} topLevel Top-level identity from the ranking row. Required to disambiguate the queryID on PostgreSQL versions that expose pg_stat_statements.toplevel.
+         * @param {string} [fingerprint] Optional fingerprint consistency guard. Currently aligned with PostgreSQL pg_stat_statements queryid.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async explainDiagnosticsPostgresqlSQLFingerprint(orgName: string, clusterName: string, queryID: string, database: string, user: string, topLevel: boolean, fingerprint?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PostgresqlSQLFingerprintExplainResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.explainDiagnosticsPostgresqlSQLFingerprint(orgName, clusterName, queryID, database, user, topLevel, fingerprint, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['DiagnosticsApi.explainDiagnosticsPostgresqlSQLFingerprint']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
         /**
          * Get a read-only Dameng SQL analysis snapshot from V$SYSTEM_LONG_EXEC_SQLS (long-running SQL) and V$SYSTEM_LARGE_MEM_SQLS (high-memory SQL). The response does not expose execution plans or remediation actions.
          * @summary Get Dameng SQL analysis
@@ -1657,6 +1753,16 @@ export const DiagnosticsApiFactory = function (configuration?: Configuration, ba
         explainDiagnosticsElasticsearchAllocation(requestParameters: DiagnosticsApiExplainDiagnosticsElasticsearchAllocationRequest, options?: RawAxiosRequestConfig): AxiosPromise<ElasticsearchAllocationExplanation> {
             return localVarFp.explainDiagnosticsElasticsearchAllocation(requestParameters.orgName, requestParameters.clusterName, requestParameters.index, requestParameters.shard, requestParameters.primary, requestParameters.currentNode, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Explicitly trigger a safe PostgreSQL EXPLAIN for one SQL fingerprint. The request does not accept raw SQL. DMS resolves the exact server-side parameterized SELECT statement identity independently of the ranking window, produces an estimated standard or generic plan without parameter sample values, rejects multiple statements, and never runs EXPLAIN ANALYZE or the original SQL. The plan uses current catalog statistics and the DMS connection context; it does not reconstruct the original role, search_path, session settings, parameter values, or historical actual plan.
+         * @summary Explain PostgreSQL SQL fingerprint
+         * @param {DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprintRequest} requestParameters Request parameters.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        explainDiagnosticsPostgresqlSQLFingerprint(requestParameters: DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprintRequest, options?: RawAxiosRequestConfig): AxiosPromise<PostgresqlSQLFingerprintExplainResponse> {
+            return localVarFp.explainDiagnosticsPostgresqlSQLFingerprint(requestParameters.orgName, requestParameters.clusterName, requestParameters.queryID, requestParameters.database, requestParameters.user, requestParameters.topLevel, requestParameters.fingerprint, options).then((request) => request(axios, basePath));
+        },
         /**
          * Get a read-only Dameng SQL analysis snapshot from V$SYSTEM_LONG_EXEC_SQLS (long-running SQL) and V$SYSTEM_LARGE_MEM_SQLS (high-memory SQL). The response does not expose execution plans or remediation actions.
          * @summary Get Dameng SQL analysis
@@ -1886,6 +1992,16 @@ export interface DiagnosticsApiInterface {
      */
     explainDiagnosticsElasticsearchAllocation(requestParameters: DiagnosticsApiExplainDiagnosticsElasticsearchAllocationRequest, options?: RawAxiosRequestConfig): AxiosPromise<ElasticsearchAllocationExplanation>;
 
+    /**
+     * Explicitly trigger a safe PostgreSQL EXPLAIN for one SQL fingerprint. The request does not accept raw SQL. DMS resolves the exact server-side parameterized SELECT statement identity independently of the ranking window, produces an estimated standard or generic plan without parameter sample values, rejects multiple statements, and never runs EXPLAIN ANALYZE or the original SQL. The plan uses current catalog statistics and the DMS connection context; it does not reconstruct the original role, search_path, session settings, parameter values, or historical actual plan.
+     * @summary Explain PostgreSQL SQL fingerprint
+     * @param {DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprintRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DiagnosticsApiInterface
+     */
+    explainDiagnosticsPostgresqlSQLFingerprint(requestParameters: DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprintRequest, options?: RawAxiosRequestConfig): AxiosPromise<PostgresqlSQLFingerprintExplainResponse>;
+
     /**
      * Get a read-only Dameng SQL analysis snapshot from V$SYSTEM_LONG_EXEC_SQLS (long-running SQL) and V$SYSTEM_LARGE_MEM_SQLS (high-memory SQL). The response does not expose execution plans or remediation actions.
      * @summary Get Dameng SQL analysis
@@ -2147,6 +2263,62 @@ export interface DiagnosticsApiExplainDiagnosticsElasticsearchAllocationRequest
     readonly currentNode?: string
 }
 
+/**
+ * Request parameters for explainDiagnosticsPostgresqlSQLFingerprint operation in DiagnosticsApi.
+ * @export
+ * @interface DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprintRequest
+ */
+export interface DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprintRequest {
+    /**
+     * Organization name
+     * @type {string}
+     * @memberof DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprint
+     */
+    readonly orgName: string
+
+    /**
+     * Cluster name
+     * @type {string}
+     * @memberof DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprint
+     */
+    readonly clusterName: string
+
+    /**
+     * PostgreSQL pg_stat_statements queryid represented as a string.
+     * @type {string}
+     * @memberof DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprint
+     */
+    readonly queryID: string
+
+    /**
+     * Database name from the ranking row. The key is required to disambiguate the queryID. An unresolved empty name returns 422 no_explainable_sql_statement.
+     * @type {string}
+     * @memberof DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprint
+     */
+    readonly database: string
+
+    /**
+     * Database user from the ranking row. The key is required to disambiguate the queryID. An unresolved empty name returns 422 no_explainable_sql_statement.
+     * @type {string}
+     * @memberof DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprint
+     */
+    readonly user: string
+
+    /**
+     * Top-level identity from the ranking row. Required to disambiguate the queryID on PostgreSQL versions that expose pg_stat_statements.toplevel.
+     * @type {boolean}
+     * @memberof DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprint
+     */
+    readonly topLevel: boolean
+
+    /**
+     * Optional fingerprint consistency guard. Currently aligned with PostgreSQL pg_stat_statements queryid.
+     * @type {string}
+     * @memberof DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprint
+     */
+    readonly fingerprint?: string
+}
+
 /**
  * Request parameters for getDiagnosticsDamengSQLAnalysis operation in DiagnosticsApi.
  * @export
@@ -2873,6 +3045,18 @@ export class DiagnosticsApi extends BaseAPI implements DiagnosticsApiInterface {
         return DiagnosticsApiFp(this.configuration).explainDiagnosticsElasticsearchAllocation(requestParameters.orgName, requestParameters.clusterName, requestParameters.index, requestParameters.shard, requestParameters.primary, requestParameters.currentNode, options).then((request) => request(this.axios, this.basePath));
     }
 
+    /**
+     * Explicitly trigger a safe PostgreSQL EXPLAIN for one SQL fingerprint. The request does not accept raw SQL. DMS resolves the exact server-side parameterized SELECT statement identity independently of the ranking window, produces an estimated standard or generic plan without parameter sample values, rejects multiple statements, and never runs EXPLAIN ANALYZE or the original SQL. The plan uses current catalog statistics and the DMS connection context; it does not reconstruct the original role, search_path, session settings, parameter values, or historical actual plan.
+     * @summary Explain PostgreSQL SQL fingerprint
+     * @param {DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprintRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DiagnosticsApi
+     */
+    public explainDiagnosticsPostgresqlSQLFingerprint(requestParameters: DiagnosticsApiExplainDiagnosticsPostgresqlSQLFingerprintRequest, options?: RawAxiosRequestConfig) {
+        return DiagnosticsApiFp(this.configuration).explainDiagnosticsPostgresqlSQLFingerprint(requestParameters.orgName, requestParameters.clusterName, requestParameters.queryID, requestParameters.database, requestParameters.user, requestParameters.topLevel, requestParameters.fingerprint, options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * Get a read-only Dameng SQL analysis snapshot from V$SYSTEM_LONG_EXEC_SQLS (long-running SQL) and V$SYSTEM_LARGE_MEM_SQLS (high-memory SQL). The response does not expose execution plans or remediation actions.
      * @summary Get Dameng SQL analysis

package/src/openapi/models/dms-execution-plan-planning-mode.ts

@@ -0,0 +1,31 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * KubeBlocks Cloud API
+ * KubeBlocks Cloud API is a RESTful API for managing KubeBlocks Cloud resources.  The API is organized around REST.  Our API has predictable resource-oriented URLs, accepts `JSON-encoded` request bodies, returns `JSON-encoded` responses, and uses standard HTTP response codes, authentication, and verbs.  We use standard HTTP authentication and provide API keys to identify who you are. Your API keys carry many privileges, so be sure to keep them secret! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth. 
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@apecloud.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+/**
+ * 
+ * @export
+ * @enum {string}
+ */
+
+export const DmsExecutionPlanPlanningMode = {
+    standard: 'standard',
+    generic: 'generic'
+} as const;
+
+export type DmsExecutionPlanPlanningMode = typeof DmsExecutionPlanPlanningMode[keyof typeof DmsExecutionPlanPlanningMode];
+
+
+

package/src/openapi/models/dms-execution-plan-result.ts

@@ -24,6 +24,9 @@ import type { DmsExecutionPlanMode } from './dms-execution-plan-mode';
 import type { DmsExecutionPlanNode } from './dms-execution-plan-node';
 // May contain unused imports in some cases
 // @ts-ignore
+import type { DmsExecutionPlanPlanningMode } from './dms-execution-plan-planning-mode';
+// May contain unused imports in some cases
+// @ts-ignore
 import type { DmsExecutionPlanRawFormat } from './dms-execution-plan-raw-format';
 // May contain unused imports in some cases
 // @ts-ignore
@@ -65,6 +68,24 @@ export interface DmsExecutionPlanResult {
      * @memberof DmsExecutionPlanResult
      */
     'mode'?: DmsExecutionPlanMode;
+    /**
+     * 
+     * @type {DmsExecutionPlanPlanningMode}
+     * @memberof DmsExecutionPlanResult
+     */
+    'planMode'?: DmsExecutionPlanPlanningMode;
+    /**
+     * 
+     * @type {boolean}
+     * @memberof DmsExecutionPlanResult
+     */
+    'parameterized'?: boolean;
+    /**
+     * 
+     * @type {number}
+     * @memberof DmsExecutionPlanResult
+     */
+    'parameterCount'?: number | null;
     /**
      * 
      * @type {boolean}

package/src/openapi/models/index.ts

@@ -303,6 +303,7 @@ export * from './dms-execution-plan-node-conditions';
 export * from './dms-execution-plan-node-cost';
 export * from './dms-execution-plan-node-rows';
 export * from './dms-execution-plan-node-timing';
+export * from './dms-execution-plan-planning-mode';
 export * from './dms-execution-plan-raw-format';
 export * from './dms-execution-plan-result';
 export * from './dms-execution-plan-summary';
@@ -705,6 +706,7 @@ export * from './postgresql-lock-analysis';
 export * from './postgresql-lock-row';
 export * from './postgresql-sqlanalysis';
 export * from './postgresql-sqlfingerprint';
+export * from './postgresql-sqlfingerprint-explain-response';
 export * from './postgresql-session';
 export * from './postgresql-space-analysis';
 export * from './postgresql-space-source';

package/src/openapi/models/postgresql-sqlfingerprint-explain-response.ts

@@ -0,0 +1,98 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * KubeBlocks Cloud API
+ * KubeBlocks Cloud API is a RESTful API for managing KubeBlocks Cloud resources.  The API is organized around REST.  Our API has predictable resource-oriented URLs, accepts `JSON-encoded` request bodies, returns `JSON-encoded` responses, and uses standard HTTP response codes, authentication, and verbs.  We use standard HTTP authentication and provide API keys to identify who you are. Your API keys carry many privileges, so be sure to keep them secret! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth. 
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: support@apecloud.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+// May contain unused imports in some cases
+// @ts-ignore
+import type { DmsExecutionPlanPlanningMode } from './dms-execution-plan-planning-mode';
+// May contain unused imports in some cases
+// @ts-ignore
+import type { DmsExecutionPlanResult } from './dms-execution-plan-result';
+
+/**
+ * 
+ * @export
+ * @interface PostgresqlSQLFingerprintExplainResponse
+ */
+export interface PostgresqlSQLFingerprintExplainResponse {
+    /**
+     * PostgreSQL pg_stat_statements queryid represented as a string.
+     * @type {string}
+     * @memberof PostgresqlSQLFingerprintExplainResponse
+     */
+    'queryID': string;
+    /**
+     * Stable SQL fingerprint identifier for UI grouping. Currently aligned with PostgreSQL pg_stat_statements queryid.
+     * @type {string}
+     * @memberof PostgresqlSQLFingerprintExplainResponse
+     */
+    'fingerprint': string;
+    /**
+     * Database name from the requested SQL fingerprint identity.
+     * @type {string}
+     * @memberof PostgresqlSQLFingerprintExplainResponse
+     */
+    'database': string;
+    /**
+     * Database user from the requested SQL fingerprint identity.
+     * @type {string}
+     * @memberof PostgresqlSQLFingerprintExplainResponse
+     */
+    'user': string;
+    /**
+     * Top-level flag from the requested SQL fingerprint identity.
+     * @type {boolean}
+     * @memberof PostgresqlSQLFingerprintExplainResponse
+     */
+    'topLevel': boolean;
+    /**
+     * Server-side source used to resolve the parameterized SQL statement. Raw SQL is not returned.
+     * @type {string}
+     * @memberof PostgresqlSQLFingerprintExplainResponse
+     */
+    'statementSource'?: string;
+    /**
+     * Timestamp when the parameterized SQL statement was resolved.
+     * @type {string}
+     * @memberof PostgresqlSQLFingerprintExplainResponse
+     */
+    'statementResolvedAt'?: string;
+    /**
+     * 
+     * @type {DmsExecutionPlanPlanningMode}
+     * @memberof PostgresqlSQLFingerprintExplainResponse
+     */
+    'planMode': DmsExecutionPlanPlanningMode;
+    /**
+     * 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.
+     * @type {boolean}
+     * @memberof PostgresqlSQLFingerprintExplainResponse
+     */
+    'parameterized': boolean;
+    /**
+     * Number of parameters when DMS can determine it. It may be omitted for PostgreSQL generic-plan paths that do not expose the count.
+     * @type {number}
+     * @memberof PostgresqlSQLFingerprintExplainResponse
+     */
+    'parameterCount'?: number | null;
+    /**
+     * 
+     * @type {DmsExecutionPlanResult}
+     * @memberof PostgresqlSQLFingerprintExplainResponse
+     */
+    'explainResult': DmsExecutionPlanResult;
+}
+
+
+

package/src/openapi/models/postgresql-sqlfingerprint.ts

@@ -80,5 +80,11 @@ export interface PostgresqlSQLFingerprint {
      * @memberof PostgresqlSQLFingerprint
      */
     'user': string;
+    /**
+     * Whether pg_stat_statements recorded the statement as top-level. Legacy PostgreSQL versions without the toplevel column report true.
+     * @type {boolean}
+     * @memberof PostgresqlSQLFingerprint
+     */
+    'topLevel': boolean;
 }