@alicloud/dataworks-public20240518 9.0.0 → 9.1.1

package/dist/client.d.ts

@@ -453,6 +453,45 @@ export default class Client extends OpenApi {
      * @returns CreateComputeResourceResponse
      */
     createComputeResource(request: $_model.CreateComputeResourceRequest): Promise<$_model.CreateComputeResourceResponse>;
+    /**
+     * 创建元数据采集器
+     *
+     * @remarks
+     * ## 使用场景
+     * 为指定数据源创建元数据采集器，并配置采集范围、资源组、调度方式和扩展配置。
+     * ## 推荐流程
+     * 1. 调用 `GetCrawlerTypeCapabilities` 查询当前地域支持的采集器类型及其配置能力。
+     * 2. 使用与 `Type` 匹配的数据源创建采集器。
+     * 3. 创建成功后，调用 `RunCrawler` 手动运行，或通过周期调度自动运行。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 创建成功仅表示采集器配置已生成，不会立即执行元数据采集。
+     *
+     * @param tmpReq - CreateCrawlerRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns CreateCrawlerResponse
+     */
+    createCrawlerWithOptions(tmpReq: $_model.CreateCrawlerRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateCrawlerResponse>;
+    /**
+     * 创建元数据采集器
+     *
+     * @remarks
+     * ## 使用场景
+     * 为指定数据源创建元数据采集器，并配置采集范围、资源组、调度方式和扩展配置。
+     * ## 推荐流程
+     * 1. 调用 `GetCrawlerTypeCapabilities` 查询当前地域支持的采集器类型及其配置能力。
+     * 2. 使用与 `Type` 匹配的数据源创建采集器。
+     * 3. 创建成功后，调用 `RunCrawler` 手动运行，或通过周期调度自动运行。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 创建成功仅表示采集器配置已生成，不会立即执行元数据采集。
+     *
+     * @param request - CreateCrawlerRequest
+     * @returns CreateCrawlerResponse
+     */
+    createCrawler(request: $_model.CreateCrawlerRequest): Promise<$_model.CreateCrawlerResponse>;
     /**
      * Creates a custom attribute definition.
      *
@@ -929,10 +968,10 @@ export default class Client extends OpenApi {
      */
     createMetaCollection(request: $_model.CreateMetaCollectionRequest): Promise<$_model.CreateMetaCollectionResponse>;
     /**
-     * Creates a metadata entity definition. The definition can be for a pure custom type or an extended table type.
+     * Creates a metadata entity definition, including custom types and extended table types.
      *
      * @remarks
-     * This operation requires DataWorks Professional Edition or a higher edition.
+     * DataWorks Professional Edition or a more advanced edition is required.
      *
      * @param tmpReq - CreateMetaEntityDefRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -940,10 +979,10 @@ export default class Client extends OpenApi {
      */
     createMetaEntityDefWithOptions(tmpReq: $_model.CreateMetaEntityDefRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateMetaEntityDefResponse>;
     /**
-     * Creates a metadata entity definition. The definition can be for a pure custom type or an extended table type.
+     * Creates a metadata entity definition, including custom types and extended table types.
      *
      * @remarks
-     * This operation requires DataWorks Professional Edition or a higher edition.
+     * DataWorks Professional Edition or a more advanced edition is required.
      *
      * @param request - CreateMetaEntityDefRequest
      * @returns CreateMetaEntityDefResponse
@@ -1241,10 +1280,17 @@ export default class Client extends OpenApi {
      */
     createSecurityStrategy(request: $_model.CreateSecurityStrategyRequest): Promise<$_model.CreateSecurityStrategyResponse>;
     /**
-     * Saves a reusable semantic task definition. If you use a single-file source, apply for and complete the file upload first. After creation, call RunSemanticJob with the returned Name.
+     * Saves a reusable semantic job definition. If you use a single-file source, apply for and complete the attachment upload first. After creation, call RunSemanticJob with the returned Name.
      *
      * @remarks
-     * Creates a semantic task definition.
+     * ## Scenarios
+     * Creates and saves a reusable semantic job definition. This operation only saves the data source, resource group, and reference file configurations without immediately executing the job.
+     * ## Recommended workflow
+     * 1. When `Source.type=singleTableFile`, call `UploadSemanticFile` first, use the returned `Data.UploadUrl` to complete the PUT upload, and then specify `Data.FileId` in `ReferenceFileIds`. Alternatively, you can provide a single accessible URI.
+     * 2. Configure `Source`, `ProjectId`, and `ResourceGroupId`, and then call this operation to save the job.
+     * 3. Use `Data.Name` from the response to call `RunSemanticJob`. After the job is complete, use `DownloadSemanticResults` to retrieve the output.
+     * ## Before you begin
+     * `Name` must be unique within the current tenant. The reference file quantity rules differ between single-file sources and other sources. For details, refer to the descriptions of the `ReferenceFileIds` and `ReferenceFileUris` fields.
      *
      * @param tmpReq - CreateSemanticJobRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1252,10 +1298,17 @@ export default class Client extends OpenApi {
      */
     createSemanticJobWithOptions(tmpReq: $_model.CreateSemanticJobRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateSemanticJobResponse>;
     /**
-     * Saves a reusable semantic task definition. If you use a single-file source, apply for and complete the file upload first. After creation, call RunSemanticJob with the returned Name.
+     * Saves a reusable semantic job definition. If you use a single-file source, apply for and complete the attachment upload first. After creation, call RunSemanticJob with the returned Name.
      *
      * @remarks
-     * Creates a semantic task definition.
+     * ## Scenarios
+     * Creates and saves a reusable semantic job definition. This operation only saves the data source, resource group, and reference file configurations without immediately executing the job.
+     * ## Recommended workflow
+     * 1. When `Source.type=singleTableFile`, call `UploadSemanticFile` first, use the returned `Data.UploadUrl` to complete the PUT upload, and then specify `Data.FileId` in `ReferenceFileIds`. Alternatively, you can provide a single accessible URI.
+     * 2. Configure `Source`, `ProjectId`, and `ResourceGroupId`, and then call this operation to save the job.
+     * 3. Use `Data.Name` from the response to call `RunSemanticJob`. After the job is complete, use `DownloadSemanticResults` to retrieve the output.
+     * ## Before you begin
+     * `Name` must be unique within the current tenant. The reference file quantity rules differ between single-file sources and other sources. For details, refer to the descriptions of the `ReferenceFileIds` and `ReferenceFileUris` fields.
      *
      * @param request - CreateSemanticJobRequest
      * @returns CreateSemanticJobResponse
@@ -1471,6 +1524,43 @@ export default class Client extends OpenApi {
      * @returns DeleteComputeResourceResponse
      */
     deleteComputeResource(request: $_model.DeleteComputeResourceRequest): Promise<$_model.DeleteComputeResourceResponse>;
+    /**
+     * 删除元数据采集器
+     *
+     * @remarks
+     * ## 使用场景
+     * 删除不再使用的元数据采集器。
+     * ## 推荐流程
+     * 1. 调用 `ListCrawlers` 查询采集器 ID。
+     * 2. 确认采集器不再需要后调用本接口。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 删除成功后，该采集器不能继续查询、更新或运行。已采集元数据由系统清理，清理结果可能存在延迟。
+     *
+     * @param request - DeleteCrawlerRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DeleteCrawlerResponse
+     */
+    deleteCrawlerWithOptions(request: $_model.DeleteCrawlerRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DeleteCrawlerResponse>;
+    /**
+     * 删除元数据采集器
+     *
+     * @remarks
+     * ## 使用场景
+     * 删除不再使用的元数据采集器。
+     * ## 推荐流程
+     * 1. 调用 `ListCrawlers` 查询采集器 ID。
+     * 2. 确认采集器不再需要后调用本接口。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 删除成功后，该采集器不能继续查询、更新或运行。已采集元数据由系统清理，清理结果可能存在延迟。
+     *
+     * @param request - DeleteCrawlerRequest
+     * @returns DeleteCrawlerResponse
+     */
+    deleteCrawler(request: $_model.DeleteCrawlerRequest): Promise<$_model.DeleteCrawlerResponse>;
     /**
      * Deletes a custom attribute definition.
      *
@@ -1811,10 +1901,10 @@ export default class Client extends OpenApi {
      */
     deleteFunction(request: $_model.DeleteFunctionRequest): Promise<$_model.DeleteFunctionResponse>;
     /**
-     * Deletes a lineage in Data Map.
+     * Deletes a specified data lineage relationship from DataWorks Data Map.
      *
      * @remarks
-     * 1. DataWorks Professional Edition or a higher edition is required.
+     * 1. You must purchase DataWorks Professional Edition or a higher edition to use this feature.
      *
      * @param request - DeleteLineageRelationshipRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1822,10 +1912,10 @@ export default class Client extends OpenApi {
      */
     deleteLineageRelationshipWithOptions(request: $_model.DeleteLineageRelationshipRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DeleteLineageRelationshipResponse>;
     /**
-     * Deletes a lineage in Data Map.
+     * Deletes a specified data lineage relationship from DataWorks Data Map.
      *
      * @remarks
-     * 1. DataWorks Professional Edition or a higher edition is required.
+     * 1. You must purchase DataWorks Professional Edition or a higher edition to use this feature.
      *
      * @param request - DeleteLineageRelationshipRequest
      * @returns DeleteLineageRelationshipResponse
@@ -2150,10 +2240,17 @@ export default class Client extends OpenApi {
      */
     deleteSecurityStrategy(request: $_model.DeleteSecurityStrategyRequest): Promise<$_model.DeleteSecurityStrategyResponse>;
     /**
-     * Deletes a task definition by the Name of a created task. If the task is running, call KillSemanticJob with the ExecutorJobId of that run and confirm the stop before deletion.
+     * Deletes a semantic job definition by the Name of a created job. If the job is currently running, call KillSemanticJob with the ExecutorJobId of that run and confirm the stop before deletion.
      *
      * @remarks
-     * Operation description for deleting a semantic task.
+     * ## Scenarios
+     * Archives and deletes a saved semantic job definition so that it no longer appears in the list of available jobs.
+     * ## Call flow
+     * 1. Obtain the job name from `CreateSemanticJob.Data.Name` or `ListSemanticJobs.Data.SemanticJobs[].Name`.
+     * 2. To check whether any active runs exist, call `ListSemanticJobRuns` first. If necessary, stop the execution by calling `KillSemanticJob`.
+     * 3. Call this operation to delete the job definition.
+     * ## Result description
+     * A successful response indicates that the deletion request is complete. After deletion, you can no longer use the name to call `RunSemanticJob`.
      *
      * @param request - DeleteSemanticJobRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2161,10 +2258,17 @@ export default class Client extends OpenApi {
      */
     deleteSemanticJobWithOptions(request: $_model.DeleteSemanticJobRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DeleteSemanticJobResponse>;
     /**
-     * Deletes a task definition by the Name of a created task. If the task is running, call KillSemanticJob with the ExecutorJobId of that run and confirm the stop before deletion.
+     * Deletes a semantic job definition by the Name of a created job. If the job is currently running, call KillSemanticJob with the ExecutorJobId of that run and confirm the stop before deletion.
      *
      * @remarks
-     * Operation description for deleting a semantic task.
+     * ## Scenarios
+     * Archives and deletes a saved semantic job definition so that it no longer appears in the list of available jobs.
+     * ## Call flow
+     * 1. Obtain the job name from `CreateSemanticJob.Data.Name` or `ListSemanticJobs.Data.SemanticJobs[].Name`.
+     * 2. To check whether any active runs exist, call `ListSemanticJobRuns` first. If necessary, stop the execution by calling `KillSemanticJob`.
+     * 3. Call this operation to delete the job definition.
+     * ## Result description
+     * A successful response indicates that the deletion request is complete. After deletion, you can no longer use the name to call `RunSemanticJob`.
      *
      * @param request - DeleteSemanticJobRequest
      * @returns DeleteSemanticJobResponse
@@ -2380,10 +2484,17 @@ export default class Client extends OpenApi {
      */
     dissociateProjectFromResourceGroup(request: $_model.DissociateProjectFromResourceGroupRequest): Promise<$_model.DissociateProjectFromResourceGroupResponse>;
     /**
-     * Returns the download URL of artifacts by node name and an optional run ID after execution completes. If JobRunId is not specified, the result of the latest run of the node is returned.
+     * Returns the download URL of artifacts by job name and an optional run ID after a run completes. If JobRunId is not specified, the results of the most recent run of the job are returned.
      *
      * @remarks
-     * Operation description for retrieving the download URL of semantic task results.
+     * ## Scenarios
+     * Retrieves temporary download URLs for result files of a submitted semantic job run, such as semantic model YAML artifacts. This operation returns download URLs and does not directly return file content.
+     * ## Procedure
+     * 1. Use the job name `JobName` to locate the job.
+     * 2. To retrieve artifacts of a specific run, specify the `JobRunId` from the `RunSemanticJob.Data.JobRunId` or `ListSemanticJobRuns` response. If you do not specify this parameter, the artifacts of the most recent run are returned.
+     * 3. Download the corresponding files from `Data.Results[].DownloadUrl`.
+     * ## Before you begin
+     * The download URL is a temporary credential. Use it only briefly on the client side. Do not write it to logs or store it for long-term use.
      *
      * @param request - DownloadSemanticResultsRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -2391,10 +2502,17 @@ export default class Client extends OpenApi {
      */
     downloadSemanticResultsWithOptions(request: $_model.DownloadSemanticResultsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DownloadSemanticResultsResponse>;
     /**
-     * Returns the download URL of artifacts by node name and an optional run ID after execution completes. If JobRunId is not specified, the result of the latest run of the node is returned.
+     * Returns the download URL of artifacts by job name and an optional run ID after a run completes. If JobRunId is not specified, the results of the most recent run of the job are returned.
      *
      * @remarks
-     * Operation description for retrieving the download URL of semantic task results.
+     * ## Scenarios
+     * Retrieves temporary download URLs for result files of a submitted semantic job run, such as semantic model YAML artifacts. This operation returns download URLs and does not directly return file content.
+     * ## Procedure
+     * 1. Use the job name `JobName` to locate the job.
+     * 2. To retrieve artifacts of a specific run, specify the `JobRunId` from the `RunSemanticJob.Data.JobRunId` or `ListSemanticJobRuns` response. If you do not specify this parameter, the artifacts of the most recent run are returned.
+     * 3. Download the corresponding files from `Data.Results[].DownloadUrl`.
+     * ## Before you begin
+     * The download URL is a temporary credential. Use it only briefly on the client side. Do not write it to logs or store it for long-term use.
      *
      * @param request - DownloadSemanticResultsRequest
      * @returns DownloadSemanticResultsResponse
@@ -2746,6 +2864,82 @@ export default class Client extends OpenApi {
      * @returns GetComputeResourceResponse
      */
     getComputeResource(request: $_model.GetComputeResourceRequest): Promise<$_model.GetComputeResourceResponse>;
+    /**
+     * 获取元数据采集器详情
+     *
+     * @remarks
+     * ## 使用场景
+     * 查询指定元数据采集器的配置、可用状态和最近一次运行信息。
+     * ## 推荐流程
+     * 1. 调用 `ListCrawlers` 查询采集器 ID。
+     * 2. 调用本接口获取采集器详情。
+     * 3. 如需查询完整运行历史，调用 `ListCrawlerRuns`。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 采集器尚未运行时，最近运行状态和任务实例 ID 可能为空。
+     *
+     * @param request - GetCrawlerRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetCrawlerResponse
+     */
+    getCrawlerWithOptions(request: $_model.GetCrawlerRequest, runtime: $dara.RuntimeOptions): Promise<$_model.GetCrawlerResponse>;
+    /**
+     * 获取元数据采集器详情
+     *
+     * @remarks
+     * ## 使用场景
+     * 查询指定元数据采集器的配置、可用状态和最近一次运行信息。
+     * ## 推荐流程
+     * 1. 调用 `ListCrawlers` 查询采集器 ID。
+     * 2. 调用本接口获取采集器详情。
+     * 3. 如需查询完整运行历史，调用 `ListCrawlerRuns`。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 采集器尚未运行时，最近运行状态和任务实例 ID 可能为空。
+     *
+     * @param request - GetCrawlerRequest
+     * @returns GetCrawlerResponse
+     */
+    getCrawler(request: $_model.GetCrawlerRequest): Promise<$_model.GetCrawlerResponse>;
+    /**
+     * 查询当前地域支持创建的元数据采集器类型及能力
+     *
+     * @remarks
+     * ## 使用场景
+     * 查询当前地域支持创建的采集器类型，以及各类型支持的数据源、采集范围、资源组、调度、AI 元数据描述和扩展配置能力。
+     * ## 推荐流程
+     * 1. 在创建或更新采集器前调用本接口。
+     * 2. 根据返回的能力信息构造 `CreateCrawler` 或 `UpdateCrawler` 请求。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 不同地域和采集器类型的能力可能不同，请以本接口的实际返回结果为准。
+     *
+     * @param request - GetCrawlerTypeCapabilitiesRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetCrawlerTypeCapabilitiesResponse
+     */
+    getCrawlerTypeCapabilitiesWithOptions(request: $_model.GetCrawlerTypeCapabilitiesRequest, runtime: $dara.RuntimeOptions): Promise<$_model.GetCrawlerTypeCapabilitiesResponse>;
+    /**
+     * 查询当前地域支持创建的元数据采集器类型及能力
+     *
+     * @remarks
+     * ## 使用场景
+     * 查询当前地域支持创建的采集器类型，以及各类型支持的数据源、采集范围、资源组、调度、AI 元数据描述和扩展配置能力。
+     * ## 推荐流程
+     * 1. 在创建或更新采集器前调用本接口。
+     * 2. 根据返回的能力信息构造 `CreateCrawler` 或 `UpdateCrawler` 请求。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 不同地域和采集器类型的能力可能不同，请以本接口的实际返回结果为准。
+     *
+     * @param request - GetCrawlerTypeCapabilitiesRequest
+     * @returns GetCrawlerTypeCapabilitiesResponse
+     */
+    getCrawlerTypeCapabilities(request: $_model.GetCrawlerTypeCapabilitiesRequest): Promise<$_model.GetCrawlerTypeCapabilitiesResponse>;
     /**
      * Queries the result of asynchronously creating a workflow instance.
      *
@@ -3680,7 +3874,14 @@ export default class Client extends OpenApi {
      * Queries the executor status and runtime configuration by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns.
      *
      * @remarks
-     * Operation description for querying semantic job run details.
+     * ## Scenarios
+     * Queries the detailed status and runtime information of a semantic job run on the executor side. This is used to poll execution progress or troubleshoot run failures.
+     * ## Procedure
+     * 1. Call `RunSemanticJob` or `ListSemanticJobRuns` to obtain the `ExecutorJobId`.
+     * 2. Use the `ProjectId` returned by the job definition as the `ProjectId` for this operation.
+     * 3. Determine the current status based on the executor details in `Data`. If the job is still running, continue polling this operation.
+     * ## Related operations
+     * To retrieve logs, call `GetSemanticJobLog`. To stop a run, call `KillSemanticJob`.
      *
      * @param request - GetSemanticJobDetailRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -3691,7 +3892,14 @@ export default class Client extends OpenApi {
      * Queries the executor status and runtime configuration by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns.
      *
      * @remarks
-     * Operation description for querying semantic job run details.
+     * ## Scenarios
+     * Queries the detailed status and runtime information of a semantic job run on the executor side. This is used to poll execution progress or troubleshoot run failures.
+     * ## Procedure
+     * 1. Call `RunSemanticJob` or `ListSemanticJobRuns` to obtain the `ExecutorJobId`.
+     * 2. Use the `ProjectId` returned by the job definition as the `ProjectId` for this operation.
+     * 3. Determine the current status based on the executor details in `Data`. If the job is still running, continue polling this operation.
+     * ## Related operations
+     * To retrieve logs, call `GetSemanticJobLog`. To stop a run, call `KillSemanticJob`.
      *
      * @param request - GetSemanticJobDetailRequest
      * @returns GetSemanticJobDetailResponse
@@ -3701,7 +3909,14 @@ export default class Client extends OpenApi {
      * Queries execution logs by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns. The current POP contract exposes only the task and workspace identifiers and returns default log segments.
      *
      * @remarks
-     * Operation description for querying semantic job run logs.
+     * ## Scenarios
+     * Reads the execution logs of a semantic job run to observe the execution process and identify failure causes.
+     * ## Procedure
+     * 1. Specify the run by using `RunSemanticJob.Data.ExecutorJobId` or `ListSemanticJobRuns[].ExecutorJobId`.
+     * 2. Call this operation with the `ProjectId` of the corresponding task.
+     * 3. Analyze the log segments in `Data` together with the run status returned by `GetSemanticJobDetail`.
+     * ## Before you begin
+     * Logs are used for diagnostics and do not represent the final result files. Obtain result artifacts by calling `DownloadSemanticResults`.
      *
      * @param request - GetSemanticJobLogRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -3712,7 +3927,14 @@ export default class Client extends OpenApi {
      * Queries execution logs by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns. The current POP contract exposes only the task and workspace identifiers and returns default log segments.
      *
      * @remarks
-     * Operation description for querying semantic job run logs.
+     * ## Scenarios
+     * Reads the execution logs of a semantic job run to observe the execution process and identify failure causes.
+     * ## Procedure
+     * 1. Specify the run by using `RunSemanticJob.Data.ExecutorJobId` or `ListSemanticJobRuns[].ExecutorJobId`.
+     * 2. Call this operation with the `ProjectId` of the corresponding task.
+     * 3. Analyze the log segments in `Data` together with the run status returned by `GetSemanticJobDetail`.
+     * ## Before you begin
+     * Logs are used for diagnostics and do not represent the final result files. Obtain result artifacts by calling `DownloadSemanticResults`.
      *
      * @param request - GetSemanticJobLogRequest
      * @returns GetSemanticJobLogResponse
@@ -3746,7 +3968,7 @@ export default class Client extends OpenApi {
      */
     getSkill(request: $_model.GetSkillRequest): Promise<$_model.GetSkillResponse>;
     /**
-     * Retrieves the details of a specified data table in DataWorks Data Map. You can specify whether to return business metadata.
+     * Retrieves the details of a specified table in Data Map. You can choose whether to return business metadata.
      *
      * @remarks
      * 1. You must purchase DataWorks Basic Edition or a higher edition to use this feature.
@@ -3757,7 +3979,7 @@ export default class Client extends OpenApi {
      */
     getTableWithOptions(request: $_model.GetTableRequest, runtime: $dara.RuntimeOptions): Promise<$_model.GetTableResponse>;
     /**
-     * Retrieves the details of a specified data table in DataWorks Data Map. You can specify whether to return business metadata.
+     * Retrieves the details of a specified table in Data Map. You can choose whether to return business metadata.
      *
      * @remarks
      * 1. You must purchase DataWorks Basic Edition or a higher edition to use this feature.
@@ -3951,10 +4173,17 @@ export default class Client extends OpenApi {
      */
     importWorkflowDefinition(request: $_model.ImportWorkflowDefinitionRequest): Promise<$_model.ImportWorkflowDefinitionResponse>;
     /**
-     * Stops a specified run by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns. A successful call only indicates that the stop request has been accepted. Query the final status by calling GetSemanticJobDetail.
+     * Stops a specified run by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns. A successful call indicates only that the stop request has been accepted. Query the final status by calling GetSemanticJobDetail.
      *
      * @remarks
-     * Operation description for stopping a semantic job run.
+     * ## Scenarios
+     * Sends a stop request to the executor for a specified semantic job run. This is applicable to scenarios where a job runs for an extended period, requires manual termination, or needs resource reclamation.
+     * ## Procedure
+     * 1. Obtain the `ExecutorJobId` from `RunSemanticJob` or `ListSemanticJobRuns`, and use the `ProjectId` of the job.
+     * 2. Optionally specify `RetryTimes` as needed.
+     * 3. After the call, poll the final status by using `GetSemanticJobDetail`. If necessary, call `GetSemanticJobLog` for diagnostics.
+     * ## Before you begin
+     * A successful response indicates only that the stop request has been processed. It does not mean the job has reached a desired state.
      *
      * @param request - KillSemanticJobRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -3962,10 +4191,17 @@ export default class Client extends OpenApi {
      */
     killSemanticJobWithOptions(request: $_model.KillSemanticJobRequest, runtime: $dara.RuntimeOptions): Promise<$_model.KillSemanticJobResponse>;
     /**
-     * Stops a specified run by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns. A successful call only indicates that the stop request has been accepted. Query the final status by calling GetSemanticJobDetail.
+     * Stops a specified run by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns. A successful call indicates only that the stop request has been accepted. Query the final status by calling GetSemanticJobDetail.
      *
      * @remarks
-     * Operation description for stopping a semantic job run.
+     * ## Scenarios
+     * Sends a stop request to the executor for a specified semantic job run. This is applicable to scenarios where a job runs for an extended period, requires manual termination, or needs resource reclamation.
+     * ## Procedure
+     * 1. Obtain the `ExecutorJobId` from `RunSemanticJob` or `ListSemanticJobRuns`, and use the `ProjectId` of the job.
+     * 2. Optionally specify `RetryTimes` as needed.
+     * 3. After the call, poll the final status by using `GetSemanticJobDetail`. If necessary, call `GetSemanticJobLog` for diagnostics.
+     * ## Before you begin
+     * A successful response indicates only that the stop request has been processed. It does not mean the job has reached a desired state.
      *
      * @param request - KillSemanticJobRequest
      * @returns KillSemanticJobResponse
@@ -4129,7 +4365,7 @@ export default class Client extends OpenApi {
      */
     listCertificates(request: $_model.ListCertificatesRequest): Promise<$_model.ListCertificatesResponse>;
     /**
-     * Queries the column list of a specified data table in DataWorks Data Map.
+     * Queries the column list of a specified table in DataWorks Data Map.
      *
      * @remarks
      * 1. You must purchase DataWorks Basic Edition or a higher edition to use this feature.
@@ -4140,7 +4376,7 @@ export default class Client extends OpenApi {
      */
     listColumnsWithOptions(request: $_model.ListColumnsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListColumnsResponse>;
     /**
-     * Queries the column list of a specified data table in DataWorks Data Map.
+     * Queries the column list of a specified table in DataWorks Data Map.
      *
      * @remarks
      * 1. You must purchase DataWorks Basic Edition or a higher edition to use this feature.
@@ -4195,6 +4431,45 @@ export default class Client extends OpenApi {
      * @returns ListComputeResourcesResponse
      */
     listComputeResources(request: $_model.ListComputeResourcesRequest): Promise<$_model.ListComputeResourcesResponse>;
+    /**
+     * 查询元数据采集器运行记录
+     *
+     * @remarks
+     * ## 使用场景
+     * 分页查询指定元数据采集器最近 30 天内的运行记录，并可按运行开始时间和状态筛选。
+     * ## 推荐流程
+     * 1. 使用 `ListCrawlers` 查询采集器 ID。
+     * 2. 调用本接口查询运行记录和任务实例 ID。
+     * 3. 对运行、停止等异步操作，以本接口返回的最终状态为准。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 未指定时间范围时，默认查询当前时间向前 30 天。
+     *
+     * @param request - ListCrawlerRunsRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ListCrawlerRunsResponse
+     */
+    listCrawlerRunsWithOptions(request: $_model.ListCrawlerRunsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListCrawlerRunsResponse>;
+    /**
+     * 查询元数据采集器运行记录
+     *
+     * @remarks
+     * ## 使用场景
+     * 分页查询指定元数据采集器最近 30 天内的运行记录，并可按运行开始时间和状态筛选。
+     * ## 推荐流程
+     * 1. 使用 `ListCrawlers` 查询采集器 ID。
+     * 2. 调用本接口查询运行记录和任务实例 ID。
+     * 3. 对运行、停止等异步操作，以本接口返回的最终状态为准。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 未指定时间范围时，默认查询当前时间向前 30 天。
+     *
+     * @param request - ListCrawlerRunsRequest
+     * @returns ListCrawlerRunsResponse
+     */
+    listCrawlerRuns(request: $_model.ListCrawlerRunsRequest): Promise<$_model.ListCrawlerRunsResponse>;
     /**
      * Queries a list of metadata crawler types supported in Data Map. The subtypes of the types and the hierarchical relationship between the subtypes are also returned.
      *
@@ -4213,6 +4488,43 @@ export default class Client extends OpenApi {
      * @returns ListCrawlerTypesResponse
      */
     listCrawlerTypes(): Promise<$_model.ListCrawlerTypesResponse>;
+    /**
+     * 查询元数据采集器列表
+     *
+     * @remarks
+     * ## 使用场景
+     * 分页查询有权访问的元数据采集器，并可按工作空间、数据源、采集器类型、环境、负责人和名称筛选。
+     * ## 推荐流程
+     * 1. 按需组合筛选条件查询采集器列表。
+     * 2. 使用返回的采集器 ID 调用详情、更新、运行、停止、运行记录或删除接口。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 多个筛选条件同时提供时组合生效，名称支持模糊匹配。
+     *
+     * @param tmpReq - ListCrawlersRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ListCrawlersResponse
+     */
+    listCrawlersWithOptions(tmpReq: $_model.ListCrawlersRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListCrawlersResponse>;
+    /**
+     * 查询元数据采集器列表
+     *
+     * @remarks
+     * ## 使用场景
+     * 分页查询有权访问的元数据采集器，并可按工作空间、数据源、采集器类型、环境、负责人和名称筛选。
+     * ## 推荐流程
+     * 1. 按需组合筛选条件查询采集器列表。
+     * 2. 使用返回的采集器 ID 调用详情、更新、运行、停止、运行记录或删除接口。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 多个筛选条件同时提供时组合生效，名称支持模糊匹配。
+     *
+     * @param request - ListCrawlersRequest
+     * @returns ListCrawlersResponse
+     */
+    listCrawlers(request: $_model.ListCrawlersRequest): Promise<$_model.ListCrawlersResponse>;
     /**
      * Retrieves a paginated list of custom agents.
      *
@@ -4241,7 +4553,7 @@ export default class Client extends OpenApi {
      */
     listCustomAgents(request: $_model.ListCustomAgentsRequest): Promise<$_model.ListCustomAgentsResponse>;
     /**
-     * Retrieves a list of custom attribute definitions.
+     * Queries the list of custom attribute definitions.
      *
      * @param request - ListCustomAttributesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -4249,7 +4561,7 @@ export default class Client extends OpenApi {
      */
     listCustomAttributesWithOptions(request: $_model.ListCustomAttributesRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListCustomAttributesResponse>;
     /**
-     * Retrieves a list of custom attribute definitions.
+     * Queries the list of custom attribute definitions.
      *
      * @param request - ListCustomAttributesRequest
      * @returns ListCustomAttributesResponse
@@ -4925,10 +5237,10 @@ export default class Client extends OpenApi {
      */
     listImages(request: $_model.ListImagesRequest): Promise<$_model.ListImagesResponse>;
     /**
-     * Queries the data map for data lineage relationships between specified entities, such as tables, columns, and OSS objects.
+     * Queries the list of data lineage relationships between two specified entities (tables, fields, OSS files, etc.) in DataWorks Data Map.
      *
      * @remarks
-     * 1. This operation is available in DataWorks Standard Edition and later versions.
+     * 1. You must purchase DataWorks Standard Edition or a higher edition to use this feature.
      *
      * @param request - ListLineageRelationshipsRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -4936,10 +5248,10 @@ export default class Client extends OpenApi {
      */
     listLineageRelationshipsWithOptions(request: $_model.ListLineageRelationshipsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListLineageRelationshipsResponse>;
     /**
-     * Queries the data map for data lineage relationships between specified entities, such as tables, columns, and OSS objects.
+     * Queries the list of data lineage relationships between two specified entities (tables, fields, OSS files, etc.) in DataWorks Data Map.
      *
      * @remarks
-     * 1. This operation is available in DataWorks Standard Edition and later versions.
+     * 1. You must purchase DataWorks Standard Edition or a higher edition to use this feature.
      *
      * @param request - ListLineageRelationshipsRequest
      * @returns ListLineageRelationshipsResponse
@@ -5000,10 +5312,10 @@ export default class Client extends OpenApi {
      */
     listMcpServers(request: $_model.ListMcpServersRequest): Promise<$_model.ListMcpServersResponse>;
     /**
-     * Queries a list of collections in Data Map. Collections include categories and data albums.
+     * Queries the list of Data Map collections. Supports querying both Data Map categories and data albums.
      *
      * @remarks
-     * 1. DataWorks Professional Edition or a higher edition is required.
+     * 1. You must purchase DataWorks Professional Edition or a higher edition to use this feature.
      *
      * @param request - ListMetaCollectionsRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -5011,17 +5323,17 @@ export default class Client extends OpenApi {
      */
     listMetaCollectionsWithOptions(request: $_model.ListMetaCollectionsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListMetaCollectionsResponse>;
     /**
-     * Queries a list of collections in Data Map. Collections include categories and data albums.
+     * Queries the list of Data Map collections. Supports querying both Data Map categories and data albums.
      *
      * @remarks
-     * 1. DataWorks Professional Edition or a higher edition is required.
+     * 1. You must purchase DataWorks Professional Edition or a higher edition to use this feature.
      *
      * @param request - ListMetaCollectionsRequest
      * @returns ListMetaCollectionsResponse
      */
     listMetaCollections(request: $_model.ListMetaCollectionsRequest): Promise<$_model.ListMetaCollectionsResponse>;
     /**
-     * Lists metadata entities. Support is currently limited to custom types.
+     * Queries a list of metadata entities. Currently, only custom entity types are supported.
      *
      * @param tmpReq - ListMetaEntitiesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -5029,14 +5341,14 @@ export default class Client extends OpenApi {
      */
     listMetaEntitiesWithOptions(tmpReq: $_model.ListMetaEntitiesRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListMetaEntitiesResponse>;
     /**
-     * Lists metadata entities. Support is currently limited to custom types.
+     * Queries a list of metadata entities. Currently, only custom entity types are supported.
      *
      * @param request - ListMetaEntitiesRequest
      * @returns ListMetaEntitiesResponse
      */
     listMetaEntities(request: $_model.ListMetaEntitiesRequest): Promise<$_model.ListMetaEntitiesResponse>;
     /**
-     * Retrieves a list of custom entity definitions, including custom entity types and extended table types.
+     * Queries the list of custom entity definitions, including custom entity types and extension table types.
      *
      * @param request - ListMetaEntityDefsRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -5044,7 +5356,7 @@ export default class Client extends OpenApi {
      */
     listMetaEntityDefsWithOptions(request: $_model.ListMetaEntityDefsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListMetaEntityDefsResponse>;
     /**
-     * Retrieves a list of custom entity definitions, including custom entity types and extended table types.
+     * Queries the list of custom entity definitions, including custom entity types and extension table types.
      *
      * @param request - ListMetaEntityDefsRequest
      * @returns ListMetaEntityDefsResponse
@@ -5208,11 +5520,12 @@ export default class Client extends OpenApi {
      */
     listParameters(request: $_model.ListParametersRequest): Promise<$_model.ListParametersResponse>;
     /**
-     * Queries a list of partitions in a table in Data Map. Only tables of the MaxCompute and E-MapReduce (EMR)-type Hive Metastore Service (HMS) metadata crawlers are supported.
+     * Queries the partition list of a specified table in DataWorks Data Map. Currently supports MaxCompute and HMS (EMR cluster) types.
      *
      * @remarks
-     * 1. DataWorks Basic Edition or a higher edition is required.
-     * 2. Only maxcompute and hms (EMR cluster) table types are supported.
+     * 1. You must purchase DataWorks Basic Edition or a higher edition to use this feature.
+     * 2. Only MaxCompute and HMS (EMR cluster) table types are supported.
+     * 3. Before calling this API, call ListCrawlers to obtain the MetaEntityId of the metadata crawler, then call ListDatabases to obtain the database ID. For MaxCompute projects with Schema enabled, call ListSchemas to obtain the schema ID. Then call ListTables to obtain the TableId, and pass the returned table ID to this API.
      *
      * @param request - ListPartitionsRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -5220,11 +5533,12 @@ export default class Client extends OpenApi {
      */
     listPartitionsWithOptions(request: $_model.ListPartitionsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListPartitionsResponse>;
     /**
-     * Queries a list of partitions in a table in Data Map. Only tables of the MaxCompute and E-MapReduce (EMR)-type Hive Metastore Service (HMS) metadata crawlers are supported.
+     * Queries the partition list of a specified table in DataWorks Data Map. Currently supports MaxCompute and HMS (EMR cluster) types.
      *
      * @remarks
-     * 1. DataWorks Basic Edition or a higher edition is required.
-     * 2. Only maxcompute and hms (EMR cluster) table types are supported.
+     * 1. You must purchase DataWorks Basic Edition or a higher edition to use this feature.
+     * 2. Only MaxCompute and HMS (EMR cluster) table types are supported.
+     * 3. Before calling this API, call ListCrawlers to obtain the MetaEntityId of the metadata crawler, then call ListDatabases to obtain the database ID. For MaxCompute projects with Schema enabled, call ListSchemas to obtain the schema ID. Then call ListTables to obtain the TableId, and pass the returned table ID to this API.
      *
      * @param request - ListPartitionsRequest
      * @returns ListPartitionsResponse
@@ -5571,10 +5885,17 @@ export default class Client extends OpenApi {
      */
     listSecurityStrategies(request: $_model.ListSecurityStrategiesRequest): Promise<$_model.ListSecurityStrategiesResponse>;
     /**
-     * Queries the run records of a created node by its Name with paging. The JobRunId in each record is active for retrieving the results of a specific run, and the ExecutorJobId is active for getting details, logs, or stopping the run.
+     * Queries the run records of a created node by Name with paging. The JobRunId in each record is active for retrieving the results of a specific run, and the ExecutorJobId is active for querying details, retrieving logs, or stopping the run.
      *
      * @remarks
-     * Queries the run records of a semantic job.
+     * ## Scenarios
+     * View the historical run records of a semantic job with pagination to obtain the run ID, executor job ID, status, and time information for each submission.
+     * ## Procedure
+     * 1. Use the job name from `CreateSemanticJob.Data.Name` or `ListSemanticJobs` as the `JobName`.
+     * 2. Use `PageNumber` and `PageSize` to read records page by page.
+     * 3. Use the `JobRunId` from a record to call `DownloadSemanticResults`, and use the `ExecutorJobId` to call the detail, log, or stop operations.
+     * ## Before you begin
+     * Pagination starts from page 1 by default. Each page contains a maximum of 200 records.
      *
      * @param request - ListSemanticJobRunsRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -5582,20 +5903,34 @@ export default class Client extends OpenApi {
      */
     listSemanticJobRunsWithOptions(request: $_model.ListSemanticJobRunsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListSemanticJobRunsResponse>;
     /**
-     * Queries the run records of a created node by its Name with paging. The JobRunId in each record is active for retrieving the results of a specific run, and the ExecutorJobId is active for getting details, logs, or stopping the run.
+     * Queries the run records of a created node by Name with paging. The JobRunId in each record is active for retrieving the results of a specific run, and the ExecutorJobId is active for querying details, retrieving logs, or stopping the run.
      *
      * @remarks
-     * Queries the run records of a semantic job.
+     * ## Scenarios
+     * View the historical run records of a semantic job with pagination to obtain the run ID, executor job ID, status, and time information for each submission.
+     * ## Procedure
+     * 1. Use the job name from `CreateSemanticJob.Data.Name` or `ListSemanticJobs` as the `JobName`.
+     * 2. Use `PageNumber` and `PageSize` to read records page by page.
+     * 3. Use the `JobRunId` from a record to call `DownloadSemanticResults`, and use the `ExecutorJobId` to call the detail, log, or stop operations.
+     * ## Before you begin
+     * Pagination starts from page 1 by default. Each page contains a maximum of 200 records.
      *
      * @param request - ListSemanticJobRunsRequest
      * @returns ListSemanticJobRunsResponse
      */
     listSemanticJobRuns(request: $_model.ListSemanticJobRunsRequest): Promise<$_model.ListSemanticJobRunsResponse>;
     /**
-     * Queries semantics node definitions of the current tenant by paging. The Name, ProjectId, and Source fields in the list items can be used for running/deleting nodes, querying run details, and verifying input scope, respectively.
+     * Queries the semantic node definitions of the current tenant with paging. The Name, ProjectId, and Source fields in the list items can be used for running/deleting nodes, querying run details, and verifying input scope, respectively.
      *
      * @remarks
-     * Queries the list of semantic task definitions.
+     * ## Scenarios
+     * Queries the saved semantic node definitions of the current tenant with paging. Use this operation to display the node list, select a node to run, or obtain the workspace to which a node belongs.
+     * ## Invoke flow
+     * 1. Use `PageNumber` and `PageSize` to read `Data.SemanticJobs` with paging.
+     * 2. Use the `Name` field of a list item to invoke `RunSemanticJob`, `DeleteSemanticJob`, or `ListSemanticJobRuns`.
+     * 3. Use the `ProjectId` field of a list item together with `ExecutorJobId` to invoke the details, log, and stop operations.
+     * ## Notes
+     * This operation returns node definitions, not real-time run statuses. To query run statuses, invoke `ListSemanticJobRuns`.
      *
      * @param request - ListSemanticJobsRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -5603,10 +5938,17 @@ export default class Client extends OpenApi {
      */
     listSemanticJobsWithOptions(request: $_model.ListSemanticJobsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListSemanticJobsResponse>;
     /**
-     * Queries semantics node definitions of the current tenant by paging. The Name, ProjectId, and Source fields in the list items can be used for running/deleting nodes, querying run details, and verifying input scope, respectively.
+     * Queries the semantic node definitions of the current tenant with paging. The Name, ProjectId, and Source fields in the list items can be used for running/deleting nodes, querying run details, and verifying input scope, respectively.
      *
      * @remarks
-     * Queries the list of semantic task definitions.
+     * ## Scenarios
+     * Queries the saved semantic node definitions of the current tenant with paging. Use this operation to display the node list, select a node to run, or obtain the workspace to which a node belongs.
+     * ## Invoke flow
+     * 1. Use `PageNumber` and `PageSize` to read `Data.SemanticJobs` with paging.
+     * 2. Use the `Name` field of a list item to invoke `RunSemanticJob`, `DeleteSemanticJob`, or `ListSemanticJobRuns`.
+     * 3. Use the `ProjectId` field of a list item together with `ExecutorJobId` to invoke the details, log, and stop operations.
+     * ## Notes
+     * This operation returns node definitions, not real-time run statuses. To query run statuses, invoke `ListSemanticJobRuns`.
      *
      * @param request - ListSemanticJobsRequest
      * @returns ListSemanticJobsResponse
@@ -5647,7 +5989,7 @@ export default class Client extends OpenApi {
      * Queries the list of data tables in DataWorks Data Map. For types that do not support the schema level, you can query data tables under a specified database. For types that support the schema level, you can query data tables under a specified database, MaxCompute project, or schema. The response contains only basic table information and does not include technical metadata or business metadata.
      *
      * @remarks
-     * 1. DataWorks Basic Edition or a higher edition is required.
+     * 1. You must purchase DataWorks Basic Edition or a higher edition to use this feature.
      *
      * @param tmpReq - ListTablesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -5658,7 +6000,7 @@ export default class Client extends OpenApi {
      * Queries the list of data tables in DataWorks Data Map. For types that do not support the schema level, you can query data tables under a specified database. For types that support the schema level, you can query data tables under a specified database, MaxCompute project, or schema. The response contains only basic table information and does not include technical metadata or business metadata.
      *
      * @remarks
-     * 1. DataWorks Basic Edition or a higher edition is required.
+     * 1. You must purchase DataWorks Basic Edition or a higher edition to use this feature.
      *
      * @param request - ListTablesRequest
      * @returns ListTablesResponse
@@ -6227,10 +6569,62 @@ export default class Client extends OpenApi {
      */
     rollbackParameter(request: $_model.RollbackParameterRequest): Promise<$_model.RollbackParameterResponse>;
     /**
-     * Submits a semantic job for execution by its Name and returns the run identifier and executor identifier. A successful call indicates that the job has been submitted, not that the semantic model results have been generated.
+     * 运行元数据采集器
      *
      * @remarks
-     * *Before using this operation, make sure that you fully understand the [billing method and pricing](https://www.alibabacloud.com/help/en/dataworks/dataworks-data-agent-agent-billing) of model calls used by semantic building.**
+     * ## 使用场景
+     * 提交指定元数据采集器的运行请求。
+     * ## 推荐流程
+     * 1. 调用 `ListCrawlers` 查询可运行的采集器 ID。
+     * 2. 调用本接口提交运行请求。
+     * 3. 调用 `ListCrawlerRuns` 查询最终运行状态。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 费用说明
+     * 运行采集任务会使用计算资源，可能产生费用，具体以实际使用的资源组和 DataWorks 计费规则为准。
+     * 当采集器已开启 AI 元数据描述能力（`EnableAiComment=true`）时，采集元数据并生成 AI 说明会消耗 Token。Token 赠送额度及超出额度后的计费规则，请参见 [Data Agent 费用](https://help.aliyun.com/zh/dataworks/dataworks-data-agent-agent-billing)。
+     * ## 注意事项
+     * 接口成功仅表示运行请求已受理，不表示采集任务已经完成。
+     *
+     * @param request - RunCrawlerRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns RunCrawlerResponse
+     */
+    runCrawlerWithOptions(request: $_model.RunCrawlerRequest, runtime: $dara.RuntimeOptions): Promise<$_model.RunCrawlerResponse>;
+    /**
+     * 运行元数据采集器
+     *
+     * @remarks
+     * ## 使用场景
+     * 提交指定元数据采集器的运行请求。
+     * ## 推荐流程
+     * 1. 调用 `ListCrawlers` 查询可运行的采集器 ID。
+     * 2. 调用本接口提交运行请求。
+     * 3. 调用 `ListCrawlerRuns` 查询最终运行状态。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 费用说明
+     * 运行采集任务会使用计算资源，可能产生费用，具体以实际使用的资源组和 DataWorks 计费规则为准。
+     * 当采集器已开启 AI 元数据描述能力（`EnableAiComment=true`）时，采集元数据并生成 AI 说明会消耗 Token。Token 赠送额度及超出额度后的计费规则，请参见 [Data Agent 费用](https://help.aliyun.com/zh/dataworks/dataworks-data-agent-agent-billing)。
+     * ## 注意事项
+     * 接口成功仅表示运行请求已受理，不表示采集任务已经完成。
+     *
+     * @param request - RunCrawlerRequest
+     * @returns RunCrawlerResponse
+     */
+    runCrawler(request: $_model.RunCrawlerRequest): Promise<$_model.RunCrawlerResponse>;
+    /**
+     * Submits a saved semantic job for execution by name and returns the run identifier and executor job identifier. A successful call indicates that the job has been submitted, not that the semantic model results have been generated.
+     *
+     * @remarks
+     * ## Description
+     * Loads a saved semantic job definition by `Name` and submits a new analysis run to the executor. This operation does not accept runtime `Source`, resource group, or reference file overrides. The execution always uses the configuration saved by `CreateSemanticJob`.
+     * ## Pre-execution validation
+     * The service validates the existence and access permissions of the job, and re-validates whether the associated files still exist. For files associated through `ReferenceFileIds`, the service resolves them to temporary addresses readable by the current run before submission. Deleting a file after upload or specifying an invalid file ID causes the submission to fail.
+     * ## Response and What to do next
+     * `Data.JobRunId` is the identity of the current semantics node run and is used by `DownloadSemanticResults` to download the exact output of this run. `Data.ExecutorJobId` is the identity of the executor node and is used by `GetSemanticJobDetail`, `GetSemanticJobLog`, and `KillSemanticJob`. A successful response indicates that the executor has accepted the submission, not that the model analysis or result files are complete.
+     * ## Billing
+     * **Before using this operation, make sure that you fully understand the billing method and pricing of the [model calls](https://www.alibabacloud.com/help/en/dataworks/dataworks-data-agent-agent-billing) used by semantic construction.**
      *
      * @param request - RunSemanticJobRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -6238,10 +6632,17 @@ export default class Client extends OpenApi {
      */
     runSemanticJobWithOptions(request: $_model.RunSemanticJobRequest, runtime: $dara.RuntimeOptions): Promise<$_model.RunSemanticJobResponse>;
     /**
-     * Submits a semantic job for execution by its Name and returns the run identifier and executor identifier. A successful call indicates that the job has been submitted, not that the semantic model results have been generated.
+     * Submits a saved semantic job for execution by name and returns the run identifier and executor job identifier. A successful call indicates that the job has been submitted, not that the semantic model results have been generated.
      *
      * @remarks
-     * *Before using this operation, make sure that you fully understand the [billing method and pricing](https://www.alibabacloud.com/help/en/dataworks/dataworks-data-agent-agent-billing) of model calls used by semantic building.**
+     * ## Description
+     * Loads a saved semantic job definition by `Name` and submits a new analysis run to the executor. This operation does not accept runtime `Source`, resource group, or reference file overrides. The execution always uses the configuration saved by `CreateSemanticJob`.
+     * ## Pre-execution validation
+     * The service validates the existence and access permissions of the job, and re-validates whether the associated files still exist. For files associated through `ReferenceFileIds`, the service resolves them to temporary addresses readable by the current run before submission. Deleting a file after upload or specifying an invalid file ID causes the submission to fail.
+     * ## Response and What to do next
+     * `Data.JobRunId` is the identity of the current semantics node run and is used by `DownloadSemanticResults` to download the exact output of this run. `Data.ExecutorJobId` is the identity of the executor node and is used by `GetSemanticJobDetail`, `GetSemanticJobLog`, and `KillSemanticJob`. A successful response indicates that the executor has accepted the submission, not that the model analysis or result files are complete.
+     * ## Billing
+     * **Before using this operation, make sure that you fully understand the billing method and pricing of the [model calls](https://www.alibabacloud.com/help/en/dataworks/dataworks-data-agent-agent-billing) used by semantic construction.**
      *
      * @param request - RunSemanticJobRequest
      * @returns RunSemanticJobResponse
@@ -6310,6 +6711,45 @@ export default class Client extends OpenApi {
      * @returns StartWorkflowInstancesResponse
      */
     startWorkflowInstances(request: $_model.StartWorkflowInstancesRequest): Promise<$_model.StartWorkflowInstancesResponse>;
+    /**
+     * 停止元数据采集器运行
+     *
+     * @remarks
+     * ## 使用场景
+     * 停止指定元数据采集器当前正在执行的运行任务。
+     * ## 推荐流程
+     * 1. 调用 `ListCrawlerRuns` 确认采集器存在正在执行的运行任务。
+     * 2. 调用本接口提交停止请求。
+     * 3. 再次调用 `ListCrawlerRuns` 确认最终运行状态。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 没有正在执行的运行任务时调用会失败。接口成功仅表示停止请求已受理。
+     *
+     * @param request - StopCrawlerRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns StopCrawlerResponse
+     */
+    stopCrawlerWithOptions(request: $_model.StopCrawlerRequest, runtime: $dara.RuntimeOptions): Promise<$_model.StopCrawlerResponse>;
+    /**
+     * 停止元数据采集器运行
+     *
+     * @remarks
+     * ## 使用场景
+     * 停止指定元数据采集器当前正在执行的运行任务。
+     * ## 推荐流程
+     * 1. 调用 `ListCrawlerRuns` 确认采集器存在正在执行的运行任务。
+     * 2. 调用本接口提交停止请求。
+     * 3. 再次调用 `ListCrawlerRuns` 确认最终运行状态。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 没有正在执行的运行任务时调用会失败。接口成功仅表示停止请求已受理。
+     *
+     * @param request - StopCrawlerRequest
+     * @returns StopCrawlerResponse
+     */
+    stopCrawler(request: $_model.StopCrawlerRequest): Promise<$_model.StopCrawlerResponse>;
     /**
      * Stops a synchronization task.
      *
@@ -6623,6 +7063,45 @@ export default class Client extends OpenApi {
      * @returns UpdateComputeResourceResponse
      */
     updateComputeResource(request: $_model.UpdateComputeResourceRequest): Promise<$_model.UpdateComputeResourceResponse>;
+    /**
+     * 更新元数据采集器
+     *
+     * @remarks
+     * ## 使用场景
+     * 部分更新指定元数据采集器的资源组、采集范围、调度、AI 元数据描述或扩展配置。
+     * ## 推荐流程
+     * 1. 调用 `GetCrawler` 查询当前配置。
+     * 2. 调用 `GetCrawlerTypeCapabilities` 确认该采集器类型支持的配置能力。
+     * 3. 仅传入需要更新的字段调用本接口。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 至少需要提供一个可更新字段；未提供的字段保持不变。
+     *
+     * @param tmpReq - UpdateCrawlerRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns UpdateCrawlerResponse
+     */
+    updateCrawlerWithOptions(tmpReq: $_model.UpdateCrawlerRequest, runtime: $dara.RuntimeOptions): Promise<$_model.UpdateCrawlerResponse>;
+    /**
+     * 更新元数据采集器
+     *
+     * @remarks
+     * ## 使用场景
+     * 部分更新指定元数据采集器的资源组、采集范围、调度、AI 元数据描述或扩展配置。
+     * ## 推荐流程
+     * 1. 调用 `GetCrawler` 查询当前配置。
+     * 2. 调用 `GetCrawlerTypeCapabilities` 确认该采集器类型支持的配置能力。
+     * 3. 仅传入需要更新的字段调用本接口。
+     * ## 版本要求
+     * 需要购买DataWorks基础版及以上版本才能使用。
+     * ## 注意事项
+     * 至少需要提供一个可更新字段；未提供的字段保持不变。
+     *
+     * @param request - UpdateCrawlerRequest
+     * @returns UpdateCrawlerResponse
+     */
+    updateCrawler(request: $_model.UpdateCrawlerRequest): Promise<$_model.UpdateCrawlerResponse>;
     /**
      * Updates a custom attribute.
      *
@@ -7008,10 +7487,10 @@ export default class Client extends OpenApi {
      */
     updateMetaEntity(request: $_model.UpdateMetaEntityRequest): Promise<$_model.UpdateMetaEntityResponse>;
     /**
-     * Updates a meta entity definition. This operation supports both custom and extended table entity types.
+     * Updates a metadata entity definition, including custom entity types and extension table types.
      *
      * @remarks
-     * This operation requires DataWorks Professional Edition or a later version.
+     * DataWorks Professional Edition or a more advanced edition is required.
      *
      * @param tmpReq - UpdateMetaEntityDefRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -7019,10 +7498,10 @@ export default class Client extends OpenApi {
      */
     updateMetaEntityDefWithOptions(tmpReq: $_model.UpdateMetaEntityDefRequest, runtime: $dara.RuntimeOptions): Promise<$_model.UpdateMetaEntityDefResponse>;
     /**
-     * Updates a meta entity definition. This operation supports both custom and extended table entity types.
+     * Updates a metadata entity definition, including custom entity types and extension table types.
      *
      * @remarks
-     * This operation requires DataWorks Professional Edition or a later version.
+     * DataWorks Professional Edition or a more advanced edition is required.
      *
      * @param request - UpdateMetaEntityDefRequest
      * @returns UpdateMetaEntityDefResponse
@@ -7242,10 +7721,10 @@ export default class Client extends OpenApi {
      */
     updateSkill(request: $_model.UpdateSkillRequest): Promise<$_model.UpdateSkillResponse>;
     /**
-     * Updates the business metadata for a data table in the data map. You can update only the table\\"s Readme and custom attributes.
+     * Updates the business metadata of a table in Data Map. Currently, only the table usage description and custom attributes can be updated.
      *
      * @remarks
-     * 1. You must purchase DataWorks Basic Edition or a later version to use this operation.
+     * 1. You must have DataWorks Basic Edition or a higher edition to use this feature.
      *
      * @param tmpReq - UpdateTableBusinessMetadataRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -7253,10 +7732,10 @@ export default class Client extends OpenApi {
      */
     updateTableBusinessMetadataWithOptions(tmpReq: $_model.UpdateTableBusinessMetadataRequest, runtime: $dara.RuntimeOptions): Promise<$_model.UpdateTableBusinessMetadataResponse>;
     /**
-     * Updates the business metadata for a data table in the data map. You can update only the table\\"s Readme and custom attributes.
+     * Updates the business metadata of a table in Data Map. Currently, only the table usage description and custom attributes can be updated.
      *
      * @remarks
-     * 1. You must purchase DataWorks Basic Edition or a later version to use this operation.
+     * 1. You must have DataWorks Basic Edition or a higher edition to use this feature.
      *
      * @param request - UpdateTableBusinessMetadataRequest
      * @returns UpdateTableBusinessMetadataResponse
@@ -7358,10 +7837,17 @@ export default class Client extends OpenApi {
      */
     updateWorkflowDefinition(request: $_model.UpdateWorkflowDefinitionRequest): Promise<$_model.UpdateWorkflowDefinitionResponse>;
     /**
-     * Requests a temporary OSS PUT upload URL. Complete the PUT upload before the URL expires, and then pass the returned FileId to the ReferenceFileIds parameter of CreateSemanticJob.
+     * Requests a temporary OSS PUT upload URL. Complete the PUT upload before the URL expires, then pass the returned FileId to the ReferenceFileIds parameter of CreateSemanticJob.
      *
      * @remarks
-     * Requests an upload URL for semantic job attachments.
+     * ## Scenarios
+     * Requests an upload slot for a reference file to prepare a file for the `singleTableFile` source of `CreateSemanticJob`.
+     * ## Procedure
+     * 1. Pass the file name, MIME type, and actual size to this operation to obtain `Data.UploadUrl` and `Data.FileId`.
+     * 2. Perform an HTTP PUT upload with the same `Content-Type` before the `UploadUrl` expires.
+     * 3. After the upload is complete, use `FileId` as the only element of `CreateSemanticJob.ReferenceFileIds`.
+     * ## Security considerations
+     * `UploadUrl` is a short-lived pre-signed PUT URL. The holder can write to the corresponding object. Do not log, share, or persist this URL.
      *
      * @param request - UploadSemanticFileRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -7369,10 +7855,17 @@ export default class Client extends OpenApi {
      */
     uploadSemanticFileWithOptions(request: $_model.UploadSemanticFileRequest, runtime: $dara.RuntimeOptions): Promise<$_model.UploadSemanticFileResponse>;
     /**
-     * Requests a temporary OSS PUT upload URL. Complete the PUT upload before the URL expires, and then pass the returned FileId to the ReferenceFileIds parameter of CreateSemanticJob.
+     * Requests a temporary OSS PUT upload URL. Complete the PUT upload before the URL expires, then pass the returned FileId to the ReferenceFileIds parameter of CreateSemanticJob.
      *
      * @remarks
-     * Requests an upload URL for semantic job attachments.
+     * ## Scenarios
+     * Requests an upload slot for a reference file to prepare a file for the `singleTableFile` source of `CreateSemanticJob`.
+     * ## Procedure
+     * 1. Pass the file name, MIME type, and actual size to this operation to obtain `Data.UploadUrl` and `Data.FileId`.
+     * 2. Perform an HTTP PUT upload with the same `Content-Type` before the `UploadUrl` expires.
+     * 3. After the upload is complete, use `FileId` as the only element of `CreateSemanticJob.ReferenceFileIds`.
+     * ## Security considerations
+     * `UploadUrl` is a short-lived pre-signed PUT URL. The holder can write to the corresponding object. Do not log, share, or persist this URL.
      *
      * @param request - UploadSemanticFileRequest
      * @returns UploadSemanticFileResponse