调用GetSparkSQLEngineState查询SparkSQL引擎状态_云原生数据仓库AnalyticDB(AnalyticDB)-阿里云帮助中心

查询Spark SQL引擎的状态。

接口说明

地域的公网接入地址：adb.<region-id>.aliyuncs.com。示例：adb.cn-hangzhou.aliyuncs.com。
地域的 VPC 接入地址：adb-vpc.<region-id>.aliyuncs.com。示例：adb-vpc.cn-hangzhou.aliyuncs.com。

说明如果华北 1（青岛）、华南 1（深圳）、华南 3（广州）、中国香港发起请求时，遇到 409 错误，请联系技术支持。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
DBClusterId	string	是	企业版、基础版或湖仓版集群 ID。	amv-bp11q28kvl688****
ResourceGroupName	string	是	Job 型资源组名称。	test_instance

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	Id of the request	xxxx-xxx-xx
Data	object	Spark SQL 引擎状态详情。
AppId	string	应用 ID。	s202207151211hz0c****
MinExecutor	string	Spark Executor 最小启动量。	1
MaxExecutor	string	Spark Executor 最大启动量。	3
Jars	string	第三方 JAR 包。	oss://test-bucket/test.jar
SlotNum	string	Spark 应用槽位值。	2
Config	string	Spark 应用配置。	{"key1": "value1", "key2": "value2"}
State	string	应用执行状态，取值说明： SUBMITTED：已提交。 STARTING：开始启动。 RUNNING：执行中。 FAILING：任务失败，清理环境中。 FAILED：失败。 KILLING：中止任务，清理环境中。 KILLED：中止任务。 SUCCEEDING：任务执行结束，清理环境中。 COMPLETED：已完成。 FATAL：意外失败。 UNKNOWN：未知错误。	COMPLETED
SubmittedTimeInMillis	string	Spark SQL 应用的提交时间，Unix 时间戳，单位毫秒（ms）。	1651213645000

示例

正常返回示例

JSON格式

{
  "RequestId": "xxxx-xxx-xx",
  "Data": {
    "AppId": "s202207151211hz0c****",
    "MinExecutor": "1",
    "MaxExecutor": "3",
    "Jars": "oss://test-bucket/test.jar",
    "SlotNum": "2",
    "Config": "{\"key1\": \"value1\", \"key2\": \"value2\"}",
    "State": "COMPLETED",
    "SubmittedTimeInMillis": "1651213645000"
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	Spark.InvalidParameter	Invalid parameter value: %s	输入参数不正确。
400	Spark.InvalidState	The object of the operation is in an invalid state: %s	操作对象处于非合法状态。
400	Spark.AnalyzeTask.AppStateNotAccepted	Only Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.	只允许分析处于终止状态的 Spark app。指定 app 不满足条件。
400	Spark.AnalyzeTask.FailedToKill	Failed to terminate the Spark log analysis task %s, because the task status has changed. Obtain the latest status and try again.	杀死Spark日志分析任务的请求执行失败，因为对应任务状态已经发生了变化。请获取分析任务最新状态后执行。
400	Spark.AnalyzeTask.InvalidStateWhenAnalyzingApp	Only logs of Spark applications in the terminated state can be analyzed. The specified application %s does not meet the requirement.	仅允许针对处于终止状态的Spark作业执行日志分析程序。当前作业不满足条件。
400	Spark.App.InvalidResourceSpec	The requested resource type is not supported:\n %s	-
400	Spark.App.ParameterConflict	Conflicting parameters submitted:\n %s	-
400	Spark.Config.invalidConnectors	The spark.adb.connectors configuration is invalid: %s	spark.adb.connectors配置不正确。
400	Spark.Config.RoleArnVerifyFailed	RoleARN parameter verification failed. Error msg: %s when verify RoleArn %s	RoleARN参数校验失败。
400	Spark.Log.InvalidState	Failed to obtain the logs of the Spark job %s in the %s state.	无法获取指定Spark作业的日志。
400	Spark.SQL.NotFoundExecutableSQLError	No executable statements are submitted. Please check the input SQL.	Spark作业的SQL信息中不包含可执行语句。
400	Spark.SQL.ParserError	Failed to parse the SQL %s. Error message: %s.	Spark作业信息中的SQL无法解析。
404	Spark.App.ContentNotFound	The requested content %s of the Spark application is not found.	找不到指定Spark作业的提交内容。
404	Spark.AnalyzeTask.NotFound	The requested analysis task %s is not found.	请求查看的日志分析任务 %s 不存在。
404	Spark.ObjectNotFound	The object is not found. More information: %s	操作对象不存在。关联信息：%s。
404	Spark.TemplateFile.FileNotFound	The template file %s is not found.	未能找到输入的模板文件。
404	Spark.TemplateFile.TemplateNotFound	The template %s is not found.	模板文件未找到。
500	Spark.ServerError	The Spark control component system encountered an error, please create a ticket to solve the problem or concat the supported engineer on duty. Error message: %s	Spark管控组件系统遇到错误，请提交工单，或联系值班工程师。

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2023-06-28	OpenAPI 错误码发生变更	查看变更详情