Skip to content

aws.sagemaker.list_training_jobs_for_hyper_parameter_tuning_job

Example SQL Queries

SELECT * FROM
aws.sagemaker.list_training_jobs_for_hyper_parameter_tuning_job
WHERE
"hyper_parameter_tuning_job_name" = 'VALUE';

Description

Gets a list of TrainingJobSummary objects that describe the training jobs that a hyperparameter tuning job launched.

Table Definition

Column NameColumn Data Type
hyper_parameter_tuning_job_name Required Input Column

The name of the tuning job whose training jobs you want to list.

VARCHAR
sort_by Input Column

The field to sort results by. The default is Name.

If the value of this field is FinalObjectiveMetricValue, any training jobs that did not return an objective metric are not listed.

VARCHAR
sort_order Input Column

The sort order for results. The default is Ascending.

VARCHAR
status_equals Input Column

A filter that returns only training jobs with the specified status.

VARCHAR
_aws_profile Input Column

The AWS profile defines the AWS identity used. It can be defined via credentials or by assuming a IAM role.

STRUCT(
"type" VARCHAR,
"name" VARCHAR,
"account_id" VARCHAR,
"via_profile_name" VARCHAR,
"assumed_role_arn" VARCHAR,
"organization" STRUCT(
"account_name" VARCHAR,
"id" VARCHAR,
"tags" STRUCT(
"key" VARCHAR,
"value" VARCHAR
)[],
"master_account" STRUCT(
"id" VARCHAR,
"email" VARCHAR
),
"parents" STRUCT(
"type" VARCHAR,
"id" VARCHAR,
"name" VARCHAR,
"tags" STRUCT(
"key" VARCHAR,
"value" VARCHAR
)[]
)[]
)
)
Show child fields
_aws_profile.account_id

The AWS account id

_aws_profile.assumed_role_arn

The ARN of the assumed role

_aws_profile.name

The unique name of the profile.

_aws_profile.organization

Information about this profile's membership in the AWS organization.

Show child fields
_aws_profile.organization.account_name

The name of account speciifed by the organization

_aws_profile.organization.id

The organization id

_aws_profile.organization.master_account
Show child fields
_aws_profile.organization.master_account.email

The organization master account email address

_aws_profile.organization.master_account.id

The organization master account id

_aws_profile.organization.parents[]
Show child fields
_aws_profile.organization.parents[].id

The id of the parent

_aws_profile.organization.parents[].name

The name of the parent

_aws_profile.organization.parents[].tags[]
Show child fields
_aws_profile.organization.parents[].tags[].key
_aws_profile.organization.parents[].tags[].value
_aws_profile.organization.parents[].type

The type of parent can be an organization unit or a root

_aws_profile.organization.tags[]
Show child fields
_aws_profile.organization.tags[].key
_aws_profile.organization.tags[].value
_aws_profile.type

The type of profile, either 'credentials' or 'assumed_role'

_aws_profile.via_profile_name

This IAM role for this profile is assumed by first utilizing another profile with this name to obtain credentials.

creation_time

The date and time that the training job was created.

TIMESTAMP_S
failure_reason

The reason that the training job failed.

VARCHAR
final_hyper_parameter_tuning_job_objective_metric

The FinalHyperParameterTuningJobObjectiveMetric object that specifies the value of the objective metric of the tuning job that launched this training job.

STRUCT(
"type" VARCHAR,
"metric_name" VARCHAR,
"value" DOUBLE
)
Show child fields
final_hyper_parameter_tuning_job_objective_metric.metric_name

The name of the objective metric. For SageMaker built-in algorithms, metrics are defined per algorithm. See the metrics for XGBoost as an example. You can also use a custom algorithm for training and define your own metrics. For more information, see Define metrics and environment variables.

final_hyper_parameter_tuning_job_objective_metric.type

Select if you want to minimize or maximize the objective metric during hyperparameter tuning.

final_hyper_parameter_tuning_job_objective_metric.value

The value of the objective metric.

objective_status

The status of the objective metric for the training job:

  • Succeeded: The final objective metric for the training job was evaluated by the hyperparameter tuning job and used in the hyperparameter tuning process.

  • Pending: The training job is in progress and evaluation of its final objective metric is pending.

  • Failed: The final objective metric for the training job was not evaluated, and was not used in the hyperparameter tuning process. This typically occurs when the training job failed or did not emit an objective metric.

VARCHAR
training_end_time

Specifies the time when the training job ends on training instances. You are billed for the time interval between the value of TrainingStartTime and this time. For successful jobs and stopped jobs, this is the time after model artifacts are uploaded. For failed jobs, this is the time when SageMaker detects a job failure.

TIMESTAMP_S
training_job_arn

The Amazon Resource Name (ARN) of the training job.

VARCHAR
training_job_definition_name

The training job definition name.

VARCHAR
training_job_name

The name of the training job.

VARCHAR
training_job_status

The status of the training job.

VARCHAR
training_start_time

The date and time that the training job started.

TIMESTAMP_S
tuned_hyper_parameters

A list of the hyperparameters for which you specified ranges to search.

MAP(VARCHAR, VARCHAR)
tuning_job_name

The HyperParameter tuning job that launched the training job.

VARCHAR