MLTransform (AWS Java SDK :: Services

java.lang.Object
- software.amazon.awssdk.services.glue.model.MLTransform

All Implemented Interfaces:: Serializable, SdkPojo, ToCopyableBuilder<MLTransform.Builder,MLTransform>

@Generated(value="software.amazon.awssdk:codegen")
public final class MLTransform
extends Object
implements SdkPojo, Serializable, ToCopyableBuilder<MLTransform.Builder,MLTransform>

A structure for a machine learning transform.

See Also:: Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface MLTransform.Builder

Nested Classes
Modifier and Type	Class and Description
`static interface`	`MLTransform.Builder`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static MLTransform.Builder`	`builder()`
`Instant`	`createdOn()` A timestamp.
`String`	`description()` A user-defined, long-form description text for the machine learning transform.
`boolean`	`equals(Object obj)`
`boolean`	`equalsBySdkFields(Object obj)`
`EvaluationMetrics`	`evaluationMetrics()` An `EvaluationMetrics` object.
`<T> Optional<T>`	`getValueForField(String fieldName, Class<T> clazz)`
`String`	`glueVersion()` This value determines which version of Glue this machine learning transform is compatible with.
`int`	`hashCode()`
`boolean`	`hasInputRecordTables()` For responses, this returns true if the service returned a value for the InputRecordTables property.
`boolean`	`hasSchema()` For responses, this returns true if the service returned a value for the Schema property.
`List<GlueTable>`	`inputRecordTables()` A list of Glue table definitions used by the transform.
`Integer`	`labelCount()` A count identifier for the labeling files generated by Glue for this transform.
`Instant`	`lastModifiedOn()` A timestamp.
`Double`	`maxCapacity()` The number of Glue data processing units (DPUs) that are allocated to task runs for this transform.
`Integer`	`maxRetries()` The maximum number of times to retry after an `MLTaskRun` of the machine learning transform fails.
`String`	`name()` A user-defined name for the machine learning transform.
`Integer`	`numberOfWorkers()` The number of workers of a defined `workerType` that are allocated when a task of the transform runs.
`TransformParameters`	`parameters()` A `TransformParameters` object.
`String`	`role()` The name or Amazon Resource Name (ARN) of the IAM role with the required permissions.
`List<SchemaColumn>`	`schema()` A map of key-value pairs representing the columns and data types that this transform can run against.
`List<SdkField<?>>`	`sdkFields()`
`static Class<? extends MLTransform.Builder>`	`serializableBuilderClass()`
`TransformStatusType`	`status()` The current status of the machine learning transform.
`String`	`statusAsString()` The current status of the machine learning transform.
`Integer`	`timeout()` The timeout in minutes of the machine learning transform.
`MLTransform.Builder`	`toBuilder()`
`String`	`toString()` Returns a string representation of this object.
`TransformEncryption`	`transformEncryption()` The encryption-at-rest settings of the transform that apply to accessing user data.
`String`	`transformId()` The unique transform ID that is generated for the machine learning transform.
`WorkerType`	`workerType()` The type of predefined worker that is allocated when a task of this transform runs.
`String`	`workerTypeAsString()` The type of predefined worker that is allocated when a task of this transform runs.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy

- Method Detail
  - transformId
```
public final String transformId()
```
    The unique transform ID that is generated for the machine learning transform. The ID is guaranteed to be unique and does not change.
    
    Returns:
    
    The unique transform ID that is generated for the machine learning transform. The ID is guaranteed to be unique and does not change.
  - name
```
public final String name()
```
    A user-defined name for the machine learning transform. Names are not guaranteed unique and can be changed at any time.
    
    Returns:
    
    A user-defined name for the machine learning transform. Names are not guaranteed unique and can be changed at any time.
  - description
```
public final String description()
```
    A user-defined, long-form description text for the machine learning transform. Descriptions are not guaranteed to be unique and can be changed at any time.
    
    Returns:
    
    A user-defined, long-form description text for the machine learning transform. Descriptions are not guaranteed to be unique and can be changed at any time.
  - status
```
public final TransformStatusType status()
```
    The current status of the machine learning transform.
    
    If the service returns an enum value that is not available in the current SDK version, status will return TransformStatusType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from statusAsString().
    
    Returns:
    
    The current status of the machine learning transform.
    
    See Also:
    
    TransformStatusType
  - statusAsString
```
public final String statusAsString()
```
    The current status of the machine learning transform.
    
    If the service returns an enum value that is not available in the current SDK version, status will return TransformStatusType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from statusAsString().
    
    Returns:
    
    The current status of the machine learning transform.
    
    See Also:
    
    TransformStatusType
  - createdOn
```
public final Instant createdOn()
```
    A timestamp. The time and date that this machine learning transform was created.
    
    Returns:
    
    A timestamp. The time and date that this machine learning transform was created.
  - lastModifiedOn
```
public final Instant lastModifiedOn()
```
    A timestamp. The last point in time when this machine learning transform was modified.
    
    Returns:
    
    A timestamp. The last point in time when this machine learning transform was modified.
  - hasInputRecordTables
```
public final boolean hasInputRecordTables()
```
    For responses, this returns true if the service returned a value for the InputRecordTables property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
  - inputRecordTables
```
public final List<GlueTable> inputRecordTables()
```
    A list of Glue table definitions used by the transform.
    
    Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
    
    This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasInputRecordTables() method.
    
    Returns:
    
    A list of Glue table definitions used by the transform.
  - parameters
```
public final TransformParameters parameters()
```
    A TransformParameters object. You can use parameters to tune (customize) the behavior of the machine learning transform by specifying what data it learns from and your preference on various tradeoffs (such as precious vs. recall, or accuracy vs. cost).
    
    Returns:
    
    A TransformParameters object. You can use parameters to tune (customize) the behavior of the machine learning transform by specifying what data it learns from and your preference on various tradeoffs (such as precious vs. recall, or accuracy vs. cost).
  - evaluationMetrics
```
public final EvaluationMetrics evaluationMetrics()
```
    An EvaluationMetrics object. Evaluation metrics provide an estimate of the quality of your machine learning transform.
    
    Returns:
    
    An EvaluationMetrics object. Evaluation metrics provide an estimate of the quality of your machine learning transform.
  - labelCount
```
public final Integer labelCount()
```
    A count identifier for the labeling files generated by Glue for this transform. As you create a better transform, you can iteratively download, label, and upload the labeling file.
    
    Returns:
    
    A count identifier for the labeling files generated by Glue for this transform. As you create a better transform, you can iteratively download, label, and upload the labeling file.
  - hasSchema
```
public final boolean hasSchema()
```
    For responses, this returns true if the service returned a value for the Schema property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
  - schema
```
public final List<SchemaColumn> schema()
```
    A map of key-value pairs representing the columns and data types that this transform can run against. Has an upper bound of 100 columns.
    
    Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
    
    This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasSchema() method.
    
    Returns:
    
    A map of key-value pairs representing the columns and data types that this transform can run against. Has an upper bound of 100 columns.
  - role
```
public final String role()
```
    The name or Amazon Resource Name (ARN) of the IAM role with the required permissions. The required permissions include both Glue service role permissions to Glue resources, and Amazon S3 permissions required by the transform.
    - This role needs Glue service role permissions to allow access to resources in Glue. See Attach a Policy to IAM Users That Access Glue.
    - This role needs permission to your Amazon Simple Storage Service (Amazon S3) sources, targets, temporary directory, scripts, and any libraries used by the task run for this transform.
    Returns:
    The name or Amazon Resource Name (ARN) of the IAM role with the required permissions. The required permissions include both Glue service role permissions to Glue resources, and Amazon S3 permissions required by the transform.
    
    This role needs Glue service role permissions to allow access to resources in Glue. See Attach a Policy to IAM Users That Access Glue.
    
    This role needs permission to your Amazon Simple Storage Service (Amazon S3) sources, targets, temporary directory, scripts, and any libraries used by the task run for this transform.
  - glueVersion
```
public final String glueVersion()
```
    This value determines which version of Glue this machine learning transform is compatible with. Glue 1.0 is recommended for most customers. If the value is not set, the Glue compatibility defaults to Glue 0.9. For more information, see Glue Versions in the developer guide.
    
    Returns:
    
    This value determines which version of Glue this machine learning transform is compatible with. Glue 1.0 is recommended for most customers. If the value is not set, the Glue compatibility defaults to Glue 0.9. For more information, see Glue Versions in the developer guide.
  - maxCapacity
```
public final Double maxCapacity()
```
    The number of Glue data processing units (DPUs) that are allocated to task runs for this transform. You can allocate from 2 to 100 DPUs; the default is 10. A DPU is a relative measure of processing power that consists of 4 vCPUs of compute capacity and 16 GB of memory. For more information, see the Glue pricing page.
    
    MaxCapacity is a mutually exclusive option with NumberOfWorkers and WorkerType.
    - If either NumberOfWorkers or WorkerType is set, then MaxCapacity cannot be set.
    - If MaxCapacity is set then neither NumberOfWorkers or WorkerType can be set.
    - If WorkerType is set, then NumberOfWorkers is required (and vice versa).
    - MaxCapacity and NumberOfWorkers must both be at least 1.
    When the WorkerType field is set to a value other than Standard, the MaxCapacity field is set automatically and becomes read-only.
    Returns:
    The number of Glue data processing units (DPUs) that are allocated to task runs for this transform. You can allocate from 2 to 100 DPUs; the default is 10. A DPU is a relative measure of processing power that consists of 4 vCPUs of compute capacity and 16 GB of memory. For more information, see the Glue pricing page.
    
    MaxCapacity is a mutually exclusive option with NumberOfWorkers and WorkerType.
    
    If either NumberOfWorkers or WorkerType is set, then MaxCapacity cannot be set.
    
    If MaxCapacity is set then neither NumberOfWorkers or WorkerType can be set.
    
    If WorkerType is set, then NumberOfWorkers is required (and vice versa).
    
    MaxCapacity and NumberOfWorkers must both be at least 1.
    
    When the WorkerType field is set to a value other than Standard, the MaxCapacity field is set automatically and becomes read-only.
  - workerType
```
public final WorkerType workerType()
```
    The type of predefined worker that is allocated when a task of this transform runs. Accepts a value of Standard, G.1X, or G.2X.
    - For the Standard worker type, each worker provides 4 vCPU, 16 GB of memory and a 50GB disk, and 2 executors per worker.
    - For the G.1X worker type, each worker provides 4 vCPU, 16 GB of memory and a 64GB disk, and 1 executor per worker.
    - For the G.2X worker type, each worker provides 8 vCPU, 32 GB of memory and a 128GB disk, and 1 executor per worker.
    MaxCapacity is a mutually exclusive option with NumberOfWorkers and WorkerType.
    - If either NumberOfWorkers or WorkerType is set, then MaxCapacity cannot be set.
    - If MaxCapacity is set then neither NumberOfWorkers or WorkerType can be set.
    - If WorkerType is set, then NumberOfWorkers is required (and vice versa).
    - MaxCapacity and NumberOfWorkers must both be at least 1.
    If the service returns an enum value that is not available in the current SDK version, workerType will return WorkerType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from workerTypeAsString().
    Returns:
    The type of predefined worker that is allocated when a task of this transform runs. Accepts a value of Standard, G.1X, or G.2X.
    
    For the Standard worker type, each worker provides 4 vCPU, 16 GB of memory and a 50GB disk, and 2 executors per worker.
    
    For the G.1X worker type, each worker provides 4 vCPU, 16 GB of memory and a 64GB disk, and 1 executor per worker.
    
    For the G.2X worker type, each worker provides 8 vCPU, 32 GB of memory and a 128GB disk, and 1 executor per worker.
    
    MaxCapacity is a mutually exclusive option with NumberOfWorkers and WorkerType.
    
    If either NumberOfWorkers or WorkerType is set, then MaxCapacity cannot be set.
    
    If MaxCapacity is set then neither NumberOfWorkers or WorkerType can be set.
    
    If WorkerType is set, then NumberOfWorkers is required (and vice versa).
    
    MaxCapacity and NumberOfWorkers must both be at least 1.
    See Also:
    
    WorkerType
  - workerTypeAsString
```
public final String workerTypeAsString()
```
    The type of predefined worker that is allocated when a task of this transform runs. Accepts a value of Standard, G.1X, or G.2X.
    - For the Standard worker type, each worker provides 4 vCPU, 16 GB of memory and a 50GB disk, and 2 executors per worker.
    - For the G.1X worker type, each worker provides 4 vCPU, 16 GB of memory and a 64GB disk, and 1 executor per worker.
    - For the G.2X worker type, each worker provides 8 vCPU, 32 GB of memory and a 128GB disk, and 1 executor per worker.
    MaxCapacity is a mutually exclusive option with NumberOfWorkers and WorkerType.
    - If either NumberOfWorkers or WorkerType is set, then MaxCapacity cannot be set.
    - If MaxCapacity is set then neither NumberOfWorkers or WorkerType can be set.
    - If WorkerType is set, then NumberOfWorkers is required (and vice versa).
    - MaxCapacity and NumberOfWorkers must both be at least 1.
    If the service returns an enum value that is not available in the current SDK version, workerType will return WorkerType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from workerTypeAsString().
    Returns:
    The type of predefined worker that is allocated when a task of this transform runs. Accepts a value of Standard, G.1X, or G.2X.
    
    For the Standard worker type, each worker provides 4 vCPU, 16 GB of memory and a 50GB disk, and 2 executors per worker.
    
    For the G.1X worker type, each worker provides 4 vCPU, 16 GB of memory and a 64GB disk, and 1 executor per worker.
    
    For the G.2X worker type, each worker provides 8 vCPU, 32 GB of memory and a 128GB disk, and 1 executor per worker.
    
    MaxCapacity is a mutually exclusive option with NumberOfWorkers and WorkerType.
    
    If either NumberOfWorkers or WorkerType is set, then MaxCapacity cannot be set.
    
    If MaxCapacity is set then neither NumberOfWorkers or WorkerType can be set.
    
    If WorkerType is set, then NumberOfWorkers is required (and vice versa).
    
    MaxCapacity and NumberOfWorkers must both be at least 1.
    See Also:
    
    WorkerType
  - numberOfWorkers
```
public final Integer numberOfWorkers()
```
    The number of workers of a defined workerType that are allocated when a task of the transform runs.
    
    If WorkerType is set, then NumberOfWorkers is required (and vice versa).
    
    Returns:
    
    The number of workers of a defined workerType that are allocated when a task of the transform runs.
    
    If WorkerType is set, then NumberOfWorkers is required (and vice versa).
  - timeout
```
public final Integer timeout()
```
    The timeout in minutes of the machine learning transform.
    
    Returns:
    
    The timeout in minutes of the machine learning transform.
  - maxRetries
```
public final Integer maxRetries()
```
    The maximum number of times to retry after an MLTaskRun of the machine learning transform fails.
    
    Returns:
    
    The maximum number of times to retry after an MLTaskRun of the machine learning transform fails.
  - transformEncryption
```
public final TransformEncryption transformEncryption()
```
    The encryption-at-rest settings of the transform that apply to accessing user data. Machine learning transforms can access user data encrypted in Amazon S3 using KMS.
    
    Returns:
    
    The encryption-at-rest settings of the transform that apply to accessing user data. Machine learning transforms can access user data encrypted in Amazon S3 using KMS.
  - toBuilder
```
public MLTransform.Builder toBuilder()
```
    Specified by:
    
    toBuilder in interface ToCopyableBuilder<MLTransform.Builder,MLTransform>
  - builder
```
public static MLTransform.Builder builder()
```
  - serializableBuilderClass
```
public static Class<? extends MLTransform.Builder> serializableBuilderClass()
```
  - hashCode
```
public final int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public final boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - equalsBySdkFields
```
public final boolean equalsBySdkFields(Object obj)
```
    Specified by:
    
    equalsBySdkFields in interface SdkPojo
  - toString
```
public final String toString()
```
    Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
    
    Overrides:
    
    toString in class Object
  - getValueForField
```
public final <T> Optional<T> getValueForField(String fieldName,
                                              Class<T> clazz)
```
  - sdkFields
```
public final List<SdkField<?>> sdkFields()
```
    Specified by:
    
    sdkFields in interface SdkPojo

Class MLTransform

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder

Method Detail

transformId

name

description

status

statusAsString

createdOn

lastModifiedOn

hasInputRecordTables

inputRecordTables

parameters

evaluationMetrics

labelCount

hasSchema

schema

role

glueVersion

maxCapacity

workerType

workerTypeAsString

numberOfWorkers

timeout

maxRetries

transformEncryption

toBuilder

builder

serializableBuilderClass

hashCode

equals

equalsBySdkFields

toString

getValueForField

sdkFields