@alicloud/adb20211201 5.3.0 → 5.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (73) hide show
  1. package/dist/client.d.ts +159 -0
  2. package/dist/client.js +360 -0
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/CancelSqlPatternCompareReportRequest.d.ts +43 -0
  5. package/dist/models/CancelSqlPatternCompareReportRequest.js +62 -0
  6. package/dist/models/CancelSqlPatternCompareReportRequest.js.map +1 -0
  7. package/dist/models/CancelSqlPatternCompareReportResponse.d.ts +19 -0
  8. package/dist/models/CancelSqlPatternCompareReportResponse.js +69 -0
  9. package/dist/models/CancelSqlPatternCompareReportResponse.js.map +1 -0
  10. package/dist/models/CancelSqlPatternCompareReportResponseBody.d.ts +45 -0
  11. package/dist/models/CancelSqlPatternCompareReportResponseBody.js +64 -0
  12. package/dist/models/CancelSqlPatternCompareReportResponseBody.js.map +1 -0
  13. package/dist/models/CreateSqlPatternCompareReportRequest.d.ts +86 -0
  14. package/dist/models/CreateSqlPatternCompareReportRequest.js +70 -0
  15. package/dist/models/CreateSqlPatternCompareReportRequest.js.map +1 -0
  16. package/dist/models/CreateSqlPatternCompareReportResponse.d.ts +19 -0
  17. package/dist/models/CreateSqlPatternCompareReportResponse.js +69 -0
  18. package/dist/models/CreateSqlPatternCompareReportResponse.js.map +1 -0
  19. package/dist/models/CreateSqlPatternCompareReportResponseBody.d.ts +29 -0
  20. package/dist/models/CreateSqlPatternCompareReportResponseBody.js +60 -0
  21. package/dist/models/CreateSqlPatternCompareReportResponseBody.js.map +1 -0
  22. package/dist/models/DescribeSqlPatternCompareReportRequest.d.ts +131 -0
  23. package/dist/models/DescribeSqlPatternCompareReportRequest.js +74 -0
  24. package/dist/models/DescribeSqlPatternCompareReportRequest.js.map +1 -0
  25. package/dist/models/DescribeSqlPatternCompareReportResponse.d.ts +19 -0
  26. package/dist/models/DescribeSqlPatternCompareReportResponse.js +69 -0
  27. package/dist/models/DescribeSqlPatternCompareReportResponse.js.map +1 -0
  28. package/dist/models/DescribeSqlPatternCompareReportResponseBody.d.ts +220 -0
  29. package/dist/models/DescribeSqlPatternCompareReportResponseBody.js +124 -0
  30. package/dist/models/DescribeSqlPatternCompareReportResponseBody.js.map +1 -0
  31. package/dist/models/DescribeSqlPatternCompareReportsRequest.d.ts +101 -0
  32. package/dist/models/DescribeSqlPatternCompareReportsRequest.js +70 -0
  33. package/dist/models/DescribeSqlPatternCompareReportsRequest.js.map +1 -0
  34. package/dist/models/DescribeSqlPatternCompareReportsResponse.d.ts +19 -0
  35. package/dist/models/DescribeSqlPatternCompareReportsResponse.js +69 -0
  36. package/dist/models/DescribeSqlPatternCompareReportsResponse.js.map +1 -0
  37. package/dist/models/DescribeSqlPatternCompareReportsResponseBody.d.ts +186 -0
  38. package/dist/models/DescribeSqlPatternCompareReportsResponseBody.js +114 -0
  39. package/dist/models/DescribeSqlPatternCompareReportsResponseBody.js.map +1 -0
  40. package/dist/models/ItemsMetricValuesValue.d.ts +333 -0
  41. package/dist/models/ItemsMetricValuesValue.js +204 -0
  42. package/dist/models/ItemsMetricValuesValue.js.map +1 -0
  43. package/dist/models/ListKnowledgeFilesRequest.d.ts +70 -0
  44. package/dist/models/ListKnowledgeFilesRequest.js +68 -0
  45. package/dist/models/ListKnowledgeFilesRequest.js.map +1 -0
  46. package/dist/models/ListKnowledgeFilesResponse.d.ts +19 -0
  47. package/dist/models/ListKnowledgeFilesResponse.js +69 -0
  48. package/dist/models/ListKnowledgeFilesResponse.js.map +1 -0
  49. package/dist/models/ListKnowledgeFilesResponseBody.d.ts +189 -0
  50. package/dist/models/ListKnowledgeFilesResponseBody.js +134 -0
  51. package/dist/models/ListKnowledgeFilesResponseBody.js.map +1 -0
  52. package/dist/models/model.d.ts +24 -0
  53. package/dist/models/model.js +72 -23
  54. package/dist/models/model.js.map +1 -1
  55. package/package.json +1 -1
  56. package/src/client.ts +402 -0
  57. package/src/models/CancelSqlPatternCompareReportRequest.ts +60 -0
  58. package/src/models/CancelSqlPatternCompareReportResponse.ts +40 -0
  59. package/src/models/CancelSqlPatternCompareReportResponseBody.ts +64 -0
  60. package/src/models/CreateSqlPatternCompareReportRequest.ts +111 -0
  61. package/src/models/CreateSqlPatternCompareReportResponse.ts +40 -0
  62. package/src/models/CreateSqlPatternCompareReportResponseBody.ts +44 -0
  63. package/src/models/DescribeSqlPatternCompareReportRequest.ts +160 -0
  64. package/src/models/DescribeSqlPatternCompareReportResponse.ts +40 -0
  65. package/src/models/DescribeSqlPatternCompareReportResponseBody.ts +287 -0
  66. package/src/models/DescribeSqlPatternCompareReportsRequest.ts +126 -0
  67. package/src/models/DescribeSqlPatternCompareReportsResponse.ts +40 -0
  68. package/src/models/DescribeSqlPatternCompareReportsResponseBody.ts +246 -0
  69. package/src/models/ItemsMetricValuesValue.ts +456 -0
  70. package/src/models/ListKnowledgeFilesRequest.ts +93 -0
  71. package/src/models/ListKnowledgeFilesResponse.ts +40 -0
  72. package/src/models/ListKnowledgeFilesResponseBody.ts +260 -0
  73. package/src/models/model.ts +24 -0
package/dist/client.d.ts CHANGED
@@ -219,6 +219,39 @@ export default class Client extends OpenApi {
219
219
  * @returns CancelSparkWarehouseBatchSQLResponse
220
220
  */
221
221
  cancelSparkWarehouseBatchSQL(request: $_model.CancelSparkWarehouseBatchSQLRequest): Promise<$_model.CancelSparkWarehouseBatchSQLResponse>;
222
+ /**
223
+ * Cancels an SQL Pattern comparison report.
224
+ *
225
+ * @remarks
226
+ * Cancels a specified SQL Pattern comparison report. Reports in the following statuses can be canceled:
227
+ * - `PENDING`: Waiting to be generated.
228
+ * - `RUNNING`: Being generated.
229
+ * > - Only reports with `CancelAvailable` set to `true` can be canceled.
230
+ * > - Reports that are completed, failed, or expired cannot be canceled.
231
+ * > - When you cancel an already canceled report again, `Canceled` still returns `true`, and `CancelTime` retains the time of the first cancellation.
232
+ * > - Reports are isolated by instance and Alibaba Cloud account.
233
+ *
234
+ * @param request - CancelSqlPatternCompareReportRequest
235
+ * @param runtime - runtime options for this request RuntimeOptions
236
+ * @returns CancelSqlPatternCompareReportResponse
237
+ */
238
+ cancelSqlPatternCompareReportWithOptions(request: $_model.CancelSqlPatternCompareReportRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CancelSqlPatternCompareReportResponse>;
239
+ /**
240
+ * Cancels an SQL Pattern comparison report.
241
+ *
242
+ * @remarks
243
+ * Cancels a specified SQL Pattern comparison report. Reports in the following statuses can be canceled:
244
+ * - `PENDING`: Waiting to be generated.
245
+ * - `RUNNING`: Being generated.
246
+ * > - Only reports with `CancelAvailable` set to `true` can be canceled.
247
+ * > - Reports that are completed, failed, or expired cannot be canceled.
248
+ * > - When you cancel an already canceled report again, `Canceled` still returns `true`, and `CancelTime` retains the time of the first cancellation.
249
+ * > - Reports are isolated by instance and Alibaba Cloud account.
250
+ *
251
+ * @param request - CancelSqlPatternCompareReportRequest
252
+ * @returns CancelSqlPatternCompareReportResponse
253
+ */
254
+ cancelSqlPatternCompareReport(request: $_model.CancelSqlPatternCompareReportRequest): Promise<$_model.CancelSqlPatternCompareReportResponse>;
222
255
  /**
223
256
  * Queries whether a database account of an AnalyticDB for MySQL cluster is associated with a Resource Access Management (RAM) user.
224
257
  *
@@ -695,6 +728,35 @@ export default class Client extends OpenApi {
695
728
  * @returns CreateSparkTemplateResponse
696
729
  */
697
730
  createSparkTemplate(request: $_model.CreateSparkTemplateRequest): Promise<$_model.CreateSparkTemplateResponse>;
731
+ /**
732
+ * Creates a SQL pattern comparison report.
733
+ *
734
+ * @remarks
735
+ * Compares two time windows and asynchronously generates a SQL pattern comparison report.
736
+ * > - The start time of each window must be earlier than the end time, and the duration must not exceed 24 hours. Select windows of the same duration and similar business cycles.
737
+ * > - The returned `ReportId` only indicates that the request has been accepted. Call `DescribeSqlPatternCompareReports` to query the report status, and query the details when `DetailEnabled` is `true`.
738
+ * > - Only one report can be generated for an instance at a time.
739
+ * > - Reports are valid for 7 days and are isolated by instance and Alibaba Cloud account.
740
+ *
741
+ * @param request - CreateSqlPatternCompareReportRequest
742
+ * @param runtime - runtime options for this request RuntimeOptions
743
+ * @returns CreateSqlPatternCompareReportResponse
744
+ */
745
+ createSqlPatternCompareReportWithOptions(request: $_model.CreateSqlPatternCompareReportRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateSqlPatternCompareReportResponse>;
746
+ /**
747
+ * Creates a SQL pattern comparison report.
748
+ *
749
+ * @remarks
750
+ * Compares two time windows and asynchronously generates a SQL pattern comparison report.
751
+ * > - The start time of each window must be earlier than the end time, and the duration must not exceed 24 hours. Select windows of the same duration and similar business cycles.
752
+ * > - The returned `ReportId` only indicates that the request has been accepted. Call `DescribeSqlPatternCompareReports` to query the report status, and query the details when `DetailEnabled` is `true`.
753
+ * > - Only one report can be generated for an instance at a time.
754
+ * > - Reports are valid for 7 days and are isolated by instance and Alibaba Cloud account.
755
+ *
756
+ * @param request - CreateSqlPatternCompareReportRequest
757
+ * @returns CreateSqlPatternCompareReportResponse
758
+ */
759
+ createSqlPatternCompareReport(request: $_model.CreateSqlPatternCompareReportRequest): Promise<$_model.CreateSqlPatternCompareReportResponse>;
698
760
  /**
699
761
  * Deletes a database account from a cluster.
700
762
  *
@@ -2691,6 +2753,88 @@ export default class Client extends OpenApi {
2691
2753
  * @returns DescribeSqlPatternResponse
2692
2754
  */
2693
2755
  describeSqlPattern(request: $_model.DescribeSqlPatternRequest): Promise<$_model.DescribeSqlPatternResponse>;
2756
+ /**
2757
+ * Queries the details of an SQL Pattern comparison report.
2758
+ *
2759
+ * @remarks
2760
+ * Performs a paged query of SQL Pattern comparison report details based on `MetricType` by using paging. Report type descriptions:
2761
+ * - NEW: Returns Patterns that are new in time window 2. `MetricValues` returns `Time2`.
2762
+ * - CHANGED: Returns Patterns that exist in both time windows and have increased average values for the current metric. `MetricValues` returns `Avg`, `Sum`, and `Max`.
2763
+ * Metric calculation methods:
2764
+ * - `Sum`: The sum of metric values across valid query minute buckets.
2765
+ * - `Avg`: The average of metric values across valid query minute buckets.
2766
+ * - `Max`: The peak metric value within a single minute bucket.
2767
+ * Metric units:
2768
+ * - `QUERY_COUNT`: count.
2769
+ * - `CPU_COST`: seconds.
2770
+ * - `SHUFFLE_SIZE`, `PEAK_MEMORY`, `SCAN_SIZE`: GB.
2771
+ * > - Only reports with `DetailEnabled` set to `true` can be queried for details. Reports that are incomplete, canceled, or expired cannot be queried.
2772
+ * > - Fields ending with `Percent` are already expressed as percentages. When the time window 1 metric value is 0, `ChangeRatePercent` may not be returned and should not be treated as 0%.
2773
+ * > - Reports are isolated by instance and Alibaba Cloud account.
2774
+ *
2775
+ * @param request - DescribeSqlPatternCompareReportRequest
2776
+ * @param runtime - runtime options for this request RuntimeOptions
2777
+ * @returns DescribeSqlPatternCompareReportResponse
2778
+ */
2779
+ describeSqlPatternCompareReportWithOptions(request: $_model.DescribeSqlPatternCompareReportRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeSqlPatternCompareReportResponse>;
2780
+ /**
2781
+ * Queries the details of an SQL Pattern comparison report.
2782
+ *
2783
+ * @remarks
2784
+ * Performs a paged query of SQL Pattern comparison report details based on `MetricType` by using paging. Report type descriptions:
2785
+ * - NEW: Returns Patterns that are new in time window 2. `MetricValues` returns `Time2`.
2786
+ * - CHANGED: Returns Patterns that exist in both time windows and have increased average values for the current metric. `MetricValues` returns `Avg`, `Sum`, and `Max`.
2787
+ * Metric calculation methods:
2788
+ * - `Sum`: The sum of metric values across valid query minute buckets.
2789
+ * - `Avg`: The average of metric values across valid query minute buckets.
2790
+ * - `Max`: The peak metric value within a single minute bucket.
2791
+ * Metric units:
2792
+ * - `QUERY_COUNT`: count.
2793
+ * - `CPU_COST`: seconds.
2794
+ * - `SHUFFLE_SIZE`, `PEAK_MEMORY`, `SCAN_SIZE`: GB.
2795
+ * > - Only reports with `DetailEnabled` set to `true` can be queried for details. Reports that are incomplete, canceled, or expired cannot be queried.
2796
+ * > - Fields ending with `Percent` are already expressed as percentages. When the time window 1 metric value is 0, `ChangeRatePercent` may not be returned and should not be treated as 0%.
2797
+ * > - Reports are isolated by instance and Alibaba Cloud account.
2798
+ *
2799
+ * @param request - DescribeSqlPatternCompareReportRequest
2800
+ * @returns DescribeSqlPatternCompareReportResponse
2801
+ */
2802
+ describeSqlPatternCompareReport(request: $_model.DescribeSqlPatternCompareReportRequest): Promise<$_model.DescribeSqlPatternCompareReportResponse>;
2803
+ /**
2804
+ * Queries the list of SQL Pattern comparison reports.
2805
+ *
2806
+ * @remarks
2807
+ * Queries the SQL Pattern comparison reports created by the current Alibaba Cloud account for a specified instance. RAM users can query reports that belong to their parent Alibaba Cloud account.
2808
+ * The following pagination methods are supported:
2809
+ * - Page number-based pagination (recommended): Use `PageNumber` and `PageSize`.
2810
+ * - Token-based pagination: Use `MaxResults` and `NextToken`.
2811
+ * > - The two pagination methods cannot be used together. When you use page number-based pagination, the `MaxResults` parameter that is automatically included by the platform does not take effect.
2812
+ * > - The list returns only unexpired reports in the `PENDING`, `RUNNING`, or `SUCCESS` state.
2813
+ * > - Use `DetailEnabled` to determine whether report details can be queried. Use `CancelAvailable` to determine whether a report can be canceled.
2814
+ * > - Reports are valid for 7 days and are isolated by instance and Alibaba Cloud account.
2815
+ *
2816
+ * @param request - DescribeSqlPatternCompareReportsRequest
2817
+ * @param runtime - runtime options for this request RuntimeOptions
2818
+ * @returns DescribeSqlPatternCompareReportsResponse
2819
+ */
2820
+ describeSqlPatternCompareReportsWithOptions(request: $_model.DescribeSqlPatternCompareReportsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeSqlPatternCompareReportsResponse>;
2821
+ /**
2822
+ * Queries the list of SQL Pattern comparison reports.
2823
+ *
2824
+ * @remarks
2825
+ * Queries the SQL Pattern comparison reports created by the current Alibaba Cloud account for a specified instance. RAM users can query reports that belong to their parent Alibaba Cloud account.
2826
+ * The following pagination methods are supported:
2827
+ * - Page number-based pagination (recommended): Use `PageNumber` and `PageSize`.
2828
+ * - Token-based pagination: Use `MaxResults` and `NextToken`.
2829
+ * > - The two pagination methods cannot be used together. When you use page number-based pagination, the `MaxResults` parameter that is automatically included by the platform does not take effect.
2830
+ * > - The list returns only unexpired reports in the `PENDING`, `RUNNING`, or `SUCCESS` state.
2831
+ * > - Use `DetailEnabled` to determine whether report details can be queried. Use `CancelAvailable` to determine whether a report can be canceled.
2832
+ * > - Reports are valid for 7 days and are isolated by instance and Alibaba Cloud account.
2833
+ *
2834
+ * @param request - DescribeSqlPatternCompareReportsRequest
2835
+ * @returns DescribeSqlPatternCompareReportsResponse
2836
+ */
2837
+ describeSqlPatternCompareReports(request: $_model.DescribeSqlPatternCompareReportsRequest): Promise<$_model.DescribeSqlPatternCompareReportsResponse>;
2694
2838
  /**
2695
2839
  * Queries the storage resource usage of an AnalyticDB for MySQL cluster.
2696
2840
  *
@@ -3840,6 +3984,21 @@ export default class Client extends OpenApi {
3840
3984
  * @returns ListApsWebhookResponse
3841
3985
  */
3842
3986
  listApsWebhook(request: $_model.ListApsWebhookRequest): Promise<$_model.ListApsWebhookResponse>;
3987
+ /**
3988
+ * Queries knowledge base files.
3989
+ *
3990
+ * @param request - ListKnowledgeFilesRequest
3991
+ * @param runtime - runtime options for this request RuntimeOptions
3992
+ * @returns ListKnowledgeFilesResponse
3993
+ */
3994
+ listKnowledgeFilesWithOptions(request: $_model.ListKnowledgeFilesRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListKnowledgeFilesResponse>;
3995
+ /**
3996
+ * Queries knowledge base files.
3997
+ *
3998
+ * @param request - ListKnowledgeFilesRequest
3999
+ * @returns ListKnowledgeFilesResponse
4000
+ */
4001
+ listKnowledgeFiles(request: $_model.ListKnowledgeFilesRequest): Promise<$_model.ListKnowledgeFilesResponse>;
3843
4002
  /**
3844
4003
  * Queries the tags of a knowledge base document.
3845
4004
  *
package/dist/client.js CHANGED
@@ -683,6 +683,69 @@ class Client extends openapi_core_1.default {
683
683
  let runtime = new $dara.RuntimeOptions({});
684
684
  return await this.cancelSparkWarehouseBatchSQLWithOptions(request, runtime);
685
685
  }
686
+ /**
687
+ * Cancels an SQL Pattern comparison report.
688
+ *
689
+ * @remarks
690
+ * Cancels a specified SQL Pattern comparison report. Reports in the following statuses can be canceled:
691
+ * - `PENDING`: Waiting to be generated.
692
+ * - `RUNNING`: Being generated.
693
+ * > - Only reports with `CancelAvailable` set to `true` can be canceled.
694
+ * > - Reports that are completed, failed, or expired cannot be canceled.
695
+ * > - When you cancel an already canceled report again, `Canceled` still returns `true`, and `CancelTime` retains the time of the first cancellation.
696
+ * > - Reports are isolated by instance and Alibaba Cloud account.
697
+ *
698
+ * @param request - CancelSqlPatternCompareReportRequest
699
+ * @param runtime - runtime options for this request RuntimeOptions
700
+ * @returns CancelSqlPatternCompareReportResponse
701
+ */
702
+ async cancelSqlPatternCompareReportWithOptions(request, runtime) {
703
+ request.validate();
704
+ let query = {};
705
+ if (!$dara.isNull(request.DBClusterId)) {
706
+ query["DBClusterId"] = request.DBClusterId;
707
+ }
708
+ if (!$dara.isNull(request.regionId)) {
709
+ query["RegionId"] = request.regionId;
710
+ }
711
+ if (!$dara.isNull(request.reportId)) {
712
+ query["ReportId"] = request.reportId;
713
+ }
714
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
715
+ query: openapi_core_2.OpenApiUtil.query(query),
716
+ });
717
+ let params = new openapi_core_2.$OpenApiUtil.Params({
718
+ action: "CancelSqlPatternCompareReport",
719
+ version: "2021-12-01",
720
+ protocol: "HTTPS",
721
+ pathname: "/",
722
+ method: "POST",
723
+ authType: "AK",
724
+ style: "RPC",
725
+ reqBodyType: "formData",
726
+ bodyType: "json",
727
+ });
728
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.CancelSqlPatternCompareReportResponse({}));
729
+ }
730
+ /**
731
+ * Cancels an SQL Pattern comparison report.
732
+ *
733
+ * @remarks
734
+ * Cancels a specified SQL Pattern comparison report. Reports in the following statuses can be canceled:
735
+ * - `PENDING`: Waiting to be generated.
736
+ * - `RUNNING`: Being generated.
737
+ * > - Only reports with `CancelAvailable` set to `true` can be canceled.
738
+ * > - Reports that are completed, failed, or expired cannot be canceled.
739
+ * > - When you cancel an already canceled report again, `Canceled` still returns `true`, and `CancelTime` retains the time of the first cancellation.
740
+ * > - Reports are isolated by instance and Alibaba Cloud account.
741
+ *
742
+ * @param request - CancelSqlPatternCompareReportRequest
743
+ * @returns CancelSqlPatternCompareReportResponse
744
+ */
745
+ async cancelSqlPatternCompareReport(request) {
746
+ let runtime = new $dara.RuntimeOptions({});
747
+ return await this.cancelSqlPatternCompareReportWithOptions(request, runtime);
748
+ }
686
749
  /**
687
750
  * Queries whether a database account of an AnalyticDB for MySQL cluster is associated with a Resource Access Management (RAM) user.
688
751
  *
@@ -2511,6 +2574,77 @@ class Client extends openapi_core_1.default {
2511
2574
  let runtime = new $dara.RuntimeOptions({});
2512
2575
  return await this.createSparkTemplateWithOptions(request, runtime);
2513
2576
  }
2577
+ /**
2578
+ * Creates a SQL pattern comparison report.
2579
+ *
2580
+ * @remarks
2581
+ * Compares two time windows and asynchronously generates a SQL pattern comparison report.
2582
+ * > - The start time of each window must be earlier than the end time, and the duration must not exceed 24 hours. Select windows of the same duration and similar business cycles.
2583
+ * > - The returned `ReportId` only indicates that the request has been accepted. Call `DescribeSqlPatternCompareReports` to query the report status, and query the details when `DetailEnabled` is `true`.
2584
+ * > - Only one report can be generated for an instance at a time.
2585
+ * > - Reports are valid for 7 days and are isolated by instance and Alibaba Cloud account.
2586
+ *
2587
+ * @param request - CreateSqlPatternCompareReportRequest
2588
+ * @param runtime - runtime options for this request RuntimeOptions
2589
+ * @returns CreateSqlPatternCompareReportResponse
2590
+ */
2591
+ async createSqlPatternCompareReportWithOptions(request, runtime) {
2592
+ request.validate();
2593
+ let query = {};
2594
+ if (!$dara.isNull(request.compareEndTime)) {
2595
+ query["CompareEndTime"] = request.compareEndTime;
2596
+ }
2597
+ if (!$dara.isNull(request.compareStartTime)) {
2598
+ query["CompareStartTime"] = request.compareStartTime;
2599
+ }
2600
+ if (!$dara.isNull(request.DBClusterId)) {
2601
+ query["DBClusterId"] = request.DBClusterId;
2602
+ }
2603
+ if (!$dara.isNull(request.endTime)) {
2604
+ query["EndTime"] = request.endTime;
2605
+ }
2606
+ if (!$dara.isNull(request.patternType)) {
2607
+ query["PatternType"] = request.patternType;
2608
+ }
2609
+ if (!$dara.isNull(request.regionId)) {
2610
+ query["RegionId"] = request.regionId;
2611
+ }
2612
+ if (!$dara.isNull(request.startTime)) {
2613
+ query["StartTime"] = request.startTime;
2614
+ }
2615
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
2616
+ query: openapi_core_2.OpenApiUtil.query(query),
2617
+ });
2618
+ let params = new openapi_core_2.$OpenApiUtil.Params({
2619
+ action: "CreateSqlPatternCompareReport",
2620
+ version: "2021-12-01",
2621
+ protocol: "HTTPS",
2622
+ pathname: "/",
2623
+ method: "POST",
2624
+ authType: "AK",
2625
+ style: "RPC",
2626
+ reqBodyType: "formData",
2627
+ bodyType: "json",
2628
+ });
2629
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateSqlPatternCompareReportResponse({}));
2630
+ }
2631
+ /**
2632
+ * Creates a SQL pattern comparison report.
2633
+ *
2634
+ * @remarks
2635
+ * Compares two time windows and asynchronously generates a SQL pattern comparison report.
2636
+ * > - The start time of each window must be earlier than the end time, and the duration must not exceed 24 hours. Select windows of the same duration and similar business cycles.
2637
+ * > - The returned `ReportId` only indicates that the request has been accepted. Call `DescribeSqlPatternCompareReports` to query the report status, and query the details when `DetailEnabled` is `true`.
2638
+ * > - Only one report can be generated for an instance at a time.
2639
+ * > - Reports are valid for 7 days and are isolated by instance and Alibaba Cloud account.
2640
+ *
2641
+ * @param request - CreateSqlPatternCompareReportRequest
2642
+ * @returns CreateSqlPatternCompareReportResponse
2643
+ */
2644
+ async createSqlPatternCompareReport(request) {
2645
+ let runtime = new $dara.RuntimeOptions({});
2646
+ return await this.createSqlPatternCompareReportWithOptions(request, runtime);
2647
+ }
2514
2648
  /**
2515
2649
  * Deletes a database account from a cluster.
2516
2650
  *
@@ -8453,6 +8587,178 @@ class Client extends openapi_core_1.default {
8453
8587
  let runtime = new $dara.RuntimeOptions({});
8454
8588
  return await this.describeSqlPatternWithOptions(request, runtime);
8455
8589
  }
8590
+ /**
8591
+ * Queries the details of an SQL Pattern comparison report.
8592
+ *
8593
+ * @remarks
8594
+ * Performs a paged query of SQL Pattern comparison report details based on `MetricType` by using paging. Report type descriptions:
8595
+ * - NEW: Returns Patterns that are new in time window 2. `MetricValues` returns `Time2`.
8596
+ * - CHANGED: Returns Patterns that exist in both time windows and have increased average values for the current metric. `MetricValues` returns `Avg`, `Sum`, and `Max`.
8597
+ * Metric calculation methods:
8598
+ * - `Sum`: The sum of metric values across valid query minute buckets.
8599
+ * - `Avg`: The average of metric values across valid query minute buckets.
8600
+ * - `Max`: The peak metric value within a single minute bucket.
8601
+ * Metric units:
8602
+ * - `QUERY_COUNT`: count.
8603
+ * - `CPU_COST`: seconds.
8604
+ * - `SHUFFLE_SIZE`, `PEAK_MEMORY`, `SCAN_SIZE`: GB.
8605
+ * > - Only reports with `DetailEnabled` set to `true` can be queried for details. Reports that are incomplete, canceled, or expired cannot be queried.
8606
+ * > - Fields ending with `Percent` are already expressed as percentages. When the time window 1 metric value is 0, `ChangeRatePercent` may not be returned and should not be treated as 0%.
8607
+ * > - Reports are isolated by instance and Alibaba Cloud account.
8608
+ *
8609
+ * @param request - DescribeSqlPatternCompareReportRequest
8610
+ * @param runtime - runtime options for this request RuntimeOptions
8611
+ * @returns DescribeSqlPatternCompareReportResponse
8612
+ */
8613
+ async describeSqlPatternCompareReportWithOptions(request, runtime) {
8614
+ request.validate();
8615
+ let query = {};
8616
+ if (!$dara.isNull(request.changeRate)) {
8617
+ query["ChangeRate"] = request.changeRate;
8618
+ }
8619
+ if (!$dara.isNull(request.DBClusterId)) {
8620
+ query["DBClusterId"] = request.DBClusterId;
8621
+ }
8622
+ if (!$dara.isNull(request.includePattern)) {
8623
+ query["IncludePattern"] = request.includePattern;
8624
+ }
8625
+ if (!$dara.isNull(request.metricType)) {
8626
+ query["MetricType"] = request.metricType;
8627
+ }
8628
+ if (!$dara.isNull(request.order)) {
8629
+ query["Order"] = request.order;
8630
+ }
8631
+ if (!$dara.isNull(request.pageNumber)) {
8632
+ query["PageNumber"] = request.pageNumber;
8633
+ }
8634
+ if (!$dara.isNull(request.pageSize)) {
8635
+ query["PageSize"] = request.pageSize;
8636
+ }
8637
+ if (!$dara.isNull(request.regionId)) {
8638
+ query["RegionId"] = request.regionId;
8639
+ }
8640
+ if (!$dara.isNull(request.reportId)) {
8641
+ query["ReportId"] = request.reportId;
8642
+ }
8643
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
8644
+ query: openapi_core_2.OpenApiUtil.query(query),
8645
+ });
8646
+ let params = new openapi_core_2.$OpenApiUtil.Params({
8647
+ action: "DescribeSqlPatternCompareReport",
8648
+ version: "2021-12-01",
8649
+ protocol: "HTTPS",
8650
+ pathname: "/",
8651
+ method: "POST",
8652
+ authType: "AK",
8653
+ style: "RPC",
8654
+ reqBodyType: "formData",
8655
+ bodyType: "json",
8656
+ });
8657
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeSqlPatternCompareReportResponse({}));
8658
+ }
8659
+ /**
8660
+ * Queries the details of an SQL Pattern comparison report.
8661
+ *
8662
+ * @remarks
8663
+ * Performs a paged query of SQL Pattern comparison report details based on `MetricType` by using paging. Report type descriptions:
8664
+ * - NEW: Returns Patterns that are new in time window 2. `MetricValues` returns `Time2`.
8665
+ * - CHANGED: Returns Patterns that exist in both time windows and have increased average values for the current metric. `MetricValues` returns `Avg`, `Sum`, and `Max`.
8666
+ * Metric calculation methods:
8667
+ * - `Sum`: The sum of metric values across valid query minute buckets.
8668
+ * - `Avg`: The average of metric values across valid query minute buckets.
8669
+ * - `Max`: The peak metric value within a single minute bucket.
8670
+ * Metric units:
8671
+ * - `QUERY_COUNT`: count.
8672
+ * - `CPU_COST`: seconds.
8673
+ * - `SHUFFLE_SIZE`, `PEAK_MEMORY`, `SCAN_SIZE`: GB.
8674
+ * > - Only reports with `DetailEnabled` set to `true` can be queried for details. Reports that are incomplete, canceled, or expired cannot be queried.
8675
+ * > - Fields ending with `Percent` are already expressed as percentages. When the time window 1 metric value is 0, `ChangeRatePercent` may not be returned and should not be treated as 0%.
8676
+ * > - Reports are isolated by instance and Alibaba Cloud account.
8677
+ *
8678
+ * @param request - DescribeSqlPatternCompareReportRequest
8679
+ * @returns DescribeSqlPatternCompareReportResponse
8680
+ */
8681
+ async describeSqlPatternCompareReport(request) {
8682
+ let runtime = new $dara.RuntimeOptions({});
8683
+ return await this.describeSqlPatternCompareReportWithOptions(request, runtime);
8684
+ }
8685
+ /**
8686
+ * Queries the list of SQL Pattern comparison reports.
8687
+ *
8688
+ * @remarks
8689
+ * Queries the SQL Pattern comparison reports created by the current Alibaba Cloud account for a specified instance. RAM users can query reports that belong to their parent Alibaba Cloud account.
8690
+ * The following pagination methods are supported:
8691
+ * - Page number-based pagination (recommended): Use `PageNumber` and `PageSize`.
8692
+ * - Token-based pagination: Use `MaxResults` and `NextToken`.
8693
+ * > - The two pagination methods cannot be used together. When you use page number-based pagination, the `MaxResults` parameter that is automatically included by the platform does not take effect.
8694
+ * > - The list returns only unexpired reports in the `PENDING`, `RUNNING`, or `SUCCESS` state.
8695
+ * > - Use `DetailEnabled` to determine whether report details can be queried. Use `CancelAvailable` to determine whether a report can be canceled.
8696
+ * > - Reports are valid for 7 days and are isolated by instance and Alibaba Cloud account.
8697
+ *
8698
+ * @param request - DescribeSqlPatternCompareReportsRequest
8699
+ * @param runtime - runtime options for this request RuntimeOptions
8700
+ * @returns DescribeSqlPatternCompareReportsResponse
8701
+ */
8702
+ async describeSqlPatternCompareReportsWithOptions(request, runtime) {
8703
+ request.validate();
8704
+ let query = {};
8705
+ if (!$dara.isNull(request.DBClusterId)) {
8706
+ query["DBClusterId"] = request.DBClusterId;
8707
+ }
8708
+ if (!$dara.isNull(request.maxResults)) {
8709
+ query["MaxResults"] = request.maxResults;
8710
+ }
8711
+ if (!$dara.isNull(request.nextToken)) {
8712
+ query["NextToken"] = request.nextToken;
8713
+ }
8714
+ if (!$dara.isNull(request.order)) {
8715
+ query["Order"] = request.order;
8716
+ }
8717
+ if (!$dara.isNull(request.pageNumber)) {
8718
+ query["PageNumber"] = request.pageNumber;
8719
+ }
8720
+ if (!$dara.isNull(request.pageSize)) {
8721
+ query["PageSize"] = request.pageSize;
8722
+ }
8723
+ if (!$dara.isNull(request.regionId)) {
8724
+ query["RegionId"] = request.regionId;
8725
+ }
8726
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
8727
+ query: openapi_core_2.OpenApiUtil.query(query),
8728
+ });
8729
+ let params = new openapi_core_2.$OpenApiUtil.Params({
8730
+ action: "DescribeSqlPatternCompareReports",
8731
+ version: "2021-12-01",
8732
+ protocol: "HTTPS",
8733
+ pathname: "/",
8734
+ method: "POST",
8735
+ authType: "AK",
8736
+ style: "RPC",
8737
+ reqBodyType: "formData",
8738
+ bodyType: "json",
8739
+ });
8740
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeSqlPatternCompareReportsResponse({}));
8741
+ }
8742
+ /**
8743
+ * Queries the list of SQL Pattern comparison reports.
8744
+ *
8745
+ * @remarks
8746
+ * Queries the SQL Pattern comparison reports created by the current Alibaba Cloud account for a specified instance. RAM users can query reports that belong to their parent Alibaba Cloud account.
8747
+ * The following pagination methods are supported:
8748
+ * - Page number-based pagination (recommended): Use `PageNumber` and `PageSize`.
8749
+ * - Token-based pagination: Use `MaxResults` and `NextToken`.
8750
+ * > - The two pagination methods cannot be used together. When you use page number-based pagination, the `MaxResults` parameter that is automatically included by the platform does not take effect.
8751
+ * > - The list returns only unexpired reports in the `PENDING`, `RUNNING`, or `SUCCESS` state.
8752
+ * > - Use `DetailEnabled` to determine whether report details can be queried. Use `CancelAvailable` to determine whether a report can be canceled.
8753
+ * > - Reports are valid for 7 days and are isolated by instance and Alibaba Cloud account.
8754
+ *
8755
+ * @param request - DescribeSqlPatternCompareReportsRequest
8756
+ * @returns DescribeSqlPatternCompareReportsResponse
8757
+ */
8758
+ async describeSqlPatternCompareReports(request) {
8759
+ let runtime = new $dara.RuntimeOptions({});
8760
+ return await this.describeSqlPatternCompareReportsWithOptions(request, runtime);
8761
+ }
8456
8762
  /**
8457
8763
  * Queries the storage resource usage of an AnalyticDB for MySQL cluster.
8458
8764
  *
@@ -11421,6 +11727,60 @@ class Client extends openapi_core_1.default {
11421
11727
  let runtime = new $dara.RuntimeOptions({});
11422
11728
  return await this.listApsWebhookWithOptions(request, runtime);
11423
11729
  }
11730
+ /**
11731
+ * Queries knowledge base files.
11732
+ *
11733
+ * @param request - ListKnowledgeFilesRequest
11734
+ * @param runtime - runtime options for this request RuntimeOptions
11735
+ * @returns ListKnowledgeFilesResponse
11736
+ */
11737
+ async listKnowledgeFilesWithOptions(request, runtime) {
11738
+ request.validate();
11739
+ let query = {};
11740
+ if (!$dara.isNull(request.DBClusterId)) {
11741
+ query["DBClusterId"] = request.DBClusterId;
11742
+ }
11743
+ if (!$dara.isNull(request.fileIds)) {
11744
+ query["FileIds"] = request.fileIds;
11745
+ }
11746
+ if (!$dara.isNull(request.page)) {
11747
+ query["Page"] = request.page;
11748
+ }
11749
+ if (!$dara.isNull(request.pageSize)) {
11750
+ query["PageSize"] = request.pageSize;
11751
+ }
11752
+ if (!$dara.isNull(request.status)) {
11753
+ query["Status"] = request.status;
11754
+ }
11755
+ if (!$dara.isNull(request.user)) {
11756
+ query["User"] = request.user;
11757
+ }
11758
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
11759
+ query: openapi_core_2.OpenApiUtil.query(query),
11760
+ });
11761
+ let params = new openapi_core_2.$OpenApiUtil.Params({
11762
+ action: "ListKnowledgeFiles",
11763
+ version: "2021-12-01",
11764
+ protocol: "HTTPS",
11765
+ pathname: "/",
11766
+ method: "POST",
11767
+ authType: "AK",
11768
+ style: "RPC",
11769
+ reqBodyType: "formData",
11770
+ bodyType: "json",
11771
+ });
11772
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListKnowledgeFilesResponse({}));
11773
+ }
11774
+ /**
11775
+ * Queries knowledge base files.
11776
+ *
11777
+ * @param request - ListKnowledgeFilesRequest
11778
+ * @returns ListKnowledgeFilesResponse
11779
+ */
11780
+ async listKnowledgeFiles(request) {
11781
+ let runtime = new $dara.RuntimeOptions({});
11782
+ return await this.listKnowledgeFilesWithOptions(request, runtime);
11783
+ }
11424
11784
  /**
11425
11785
  * Queries the tags of a knowledge base document.
11426
11786
  *