DescribeJobRun - Amazon Glue DataBrew
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

DescribeJobRun

表示 DataBrew 作业的一次运行。

请求语法

GET /jobs/name/jobRun/runId HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

name

此次运行期间正在处理的作业的名称。

长度限制:长度下限为 1。最大长度为 240。

必需:是

runId

作业运行的唯一标识符。

长度约束:最小长度为 1。最大长度为 255。

必需:是

请求体

该请求没有请求正文。

响应语法

HTTP/1.1 200 Content-type: application/json { "Attempt": number, "CompletedOn": number, "DatabaseOutputs": [ { "DatabaseOptions": { "TableName": "string", "TempDirectory": { "Bucket": "string", "BucketOwner": "string", "Key": "string" } }, "DatabaseOutputMode": "string", "GlueConnectionName": "string" } ], "DataCatalogOutputs": [ { "CatalogId": "string", "DatabaseName": "string", "DatabaseOptions": { "TableName": "string", "TempDirectory": { "Bucket": "string", "BucketOwner": "string", "Key": "string" } }, "Overwrite": boolean, "S3Options": { "Location": { "Bucket": "string", "BucketOwner": "string", "Key": "string" } }, "TableName": "string" } ], "DatasetName": "string", "ErrorMessage": "string", "ExecutionTime": number, "JobName": "string", "JobSample": { "Mode": "string", "Size": number }, "LogGroupName": "string", "LogSubscription": "string", "Outputs": [ { "CompressionFormat": "string", "Format": "string", "FormatOptions": { "Csv": { "Delimiter": "string" } }, "Location": { "Bucket": "string", "BucketOwner": "string", "Key": "string" }, "MaxOutputFiles": number, "Overwrite": boolean, "PartitionColumns": [ "string" ] } ], "ProfileConfiguration": { "ColumnStatisticsConfigurations": [ { "Selectors": [ { "Name": "string", "Regex": "string" } ], "Statistics": { "IncludedStatistics": [ "string" ], "Overrides": [ { "Parameters": { "string" : "string" }, "Statistic": "string" } ] } } ], "DatasetStatisticsConfiguration": { "IncludedStatistics": [ "string" ], "Overrides": [ { "Parameters": { "string" : "string" }, "Statistic": "string" } ] }, "EntityDetectorConfiguration": { "AllowedStatistics": [ { "Statistics": [ "string" ] } ], "EntityTypes": [ "string" ] }, "ProfileColumns": [ { "Name": "string", "Regex": "string" } ] }, "RecipeReference": { "Name": "string", "RecipeVersion": "string" }, "RunId": "string", "StartedBy": "string", "StartedOn": number, "State": "string", "ValidationConfigurations": [ { "RulesetArn": "string", "ValidationMode": "string" } ] }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

JobName

此次运行期间正在处理的作业的名称。

类型:字符串

长度限制:长度下限为 1。最大长度为 240。

Attempt

尝试运行作业 DataBrew 的次数。

类型:整数

CompletedOn

任务完成处理的日期和时间。

类型:时间戳

DatabaseOutputs

表示 JDBC 数据库输出对象的列表,该对象定义了要写入的 DataBrew 配方作业的输出目标。

类型:DatabaseOutput 对象数组

数组成员:最少 1 个物品。

DataCatalogOutputs

一个或多个工件,表示运行作业的 Amazon Glue Data Catalog 输出。

类型:DataCatalogOutput 对象数组

数组成员:最少 1 个物品。

DatasetName

要处理的作业的数据集的名称。

类型:字符串

长度限制:长度下限为 1。最大长度为 255。

ErrorMessage

一条消息,指示作业运行时遇到错误(如果有)。

类型:字符串

ExecutionTime

作业运行消耗资源的时间(以秒为单位)。

类型:整数

JobSample

仅适用于配置文件作业的示例配置。确定要执行分析作业的行数。如果未提供 JobSample 值,则将使用默认值。模式参数的默认值为 CUSTOM_ROWS,大小参数的默认值为 20000。

类型:JobSample 对象

LogGroupName

Amazon CloudWatch 日志组的名称,作业在运行时写入诊断消息。

类型:字符串

长度限制:长度下限为 1。最大长度为 512。

LogSubscription

Amazon CloudWatch 记录任务运行的当前状态。

类型:字符串

有效值:ENABLE | DISABLE

Outputs

作业运行中的一个或多个输出工件。

类型:Output 对象数组

数组成员:最少 1 个物品。

ProfileConfiguration

配置文件作业的配置。用于选择列、进行评估和覆盖评估的默认参数。当配置为空时,分析作业将使用默认设置运行。

类型:ProfileConfiguration 对象

RecipeReference

表示 DataBrew 配方的名称和版本。

类型:RecipeReference 对象

RunId

作业运行的唯一标识符。

类型:字符串

长度限制:长度下限为 1。最大长度为 255。

StartedBy

开始运行任务的用户的亚马逊资源名称 (ARN)。

类型:字符串

StartedOn

作业运行开始的日期和时间。

类型:时间戳

State

作业运行实体本身的当前状态。

类型:字符串

有效值:STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT

ValidationConfigurations

应用于配置文件作业的验证配置列表。

类型:ValidationConfiguration 对象数组

数组成员:最少 1 个物品。

错误

有关所有操作的常见错误信息,请参阅常见错误

ResourceNotFoundException

找不到一个或多个资源。

HTTP 状态代码:404

ValidationException

此请求的输入参数未通过验证。

HTTP 状态代码:400

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: