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

package/dist/openapi/models/postgresql-sqlfingerprint-explain-response.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 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.
+ */
+import type { DmsExecutionPlanPlanningMode } from './dms-execution-plan-planning-mode';
+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;
+}
+//# sourceMappingURL=postgresql-sqlfingerprint-explain-response.d.ts.map

package/dist/openapi/models/postgresql-sqlfingerprint-explain-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresql-sqlfingerprint-explain-response.d.ts","sourceRoot":"","sources":["../../../src/openapi/models/postgresql-sqlfingerprint-explain-response.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAGvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E;;;;GAIG;AACH,MAAM,WAAW,uCAAuC;IACpD;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,UAAU,EAAE,4BAA4B,CAAC;IACzC;;;;OAIG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,eAAe,EAAE,sBAAsB,CAAC;CAC3C"}

package/dist/openapi/models/postgresql-sqlfingerprint-explain-response.js

@@ -0,0 +1,16 @@
+"use strict";
+/* 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=postgresql-sqlfingerprint-explain-response.js.map

package/dist/openapi/models/postgresql-sqlfingerprint-explain-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresql-sqlfingerprint-explain-response.js","sourceRoot":"","sources":["../../../src/openapi/models/postgresql-sqlfingerprint-explain-response.ts"],"names":[],"mappings":";AAAA,oBAAoB;AACpB,oBAAoB;AACpB;;;;;;;;;;GAUG"}

package/dist/openapi/models/postgresql-sqlfingerprint.d.ts

@@ -75,5 +75,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;
 }
 //# sourceMappingURL=postgresql-sqlfingerprint.d.ts.map

package/dist/openapi/models/postgresql-sqlfingerprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postgresql-sqlfingerprint.d.ts","sourceRoot":"","sources":["../../../src/openapi/models/postgresql-sqlfingerprint.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"postgresql-sqlfingerprint.d.ts","sourceRoot":"","sources":["../../../src/openapi/models/postgresql-sqlfingerprint.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAC;CACvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kb-cloud-client-typescript",
-  "version": "2.4.0-alpha.42",
+  "version": "2.4.0-alpha.44",
   "description": "Auto-generated TypeScript SDK for KubeBlocks Cloud API",
   "private": false,
   "license": "Apache-2.0",

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

@@ -393,6 +393,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
@@ -881,6 +882,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/adminapi/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 = `/admin/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/adminapi/models/dms-execution-plan-planning-mode.ts

@@ -0,0 +1,31 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Admin API
+ * The Admin API is used to manage the ApeCloud platform. 
+ *
+ * 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/adminapi/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/adminapi/models/index.ts

@@ -295,6 +295,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';
@@ -776,6 +777,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/adminapi/models/postgresql-sqlfingerprint-explain-response.ts

@@ -0,0 +1,98 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Admin API
+ * The Admin API is used to manage the ApeCloud platform. 
+ *
+ * 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/adminapi/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;
 }