Interface ICfnMLTransformProps
Properties for defining a CfnMLTransform
.
Namespace: Amazon.CDK.AWS.Glue
Assembly: Amazon.CDK.Lib.dll
Syntax (csharp)
public interface ICfnMLTransformProps
Syntax (vb)
Public Interface ICfnMLTransformProps
Remarks
See: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-glue-mltransform.html
ExampleMetadata: fixture=_generated
Examples
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.Glue;
var tags;
var cfnMLTransformProps = new CfnMLTransformProps {
InputRecordTables = new InputRecordTablesProperty {
GlueTables = new [] { new GlueTablesProperty {
DatabaseName = "databaseName",
TableName = "tableName",
// the properties below are optional
CatalogId = "catalogId",
ConnectionName = "connectionName"
} }
},
Role = "role",
TransformParameters = new TransformParametersProperty {
TransformType = "transformType",
// the properties below are optional
FindMatchesParameters = new FindMatchesParametersProperty {
PrimaryKeyColumnName = "primaryKeyColumnName",
// the properties below are optional
AccuracyCostTradeoff = 123,
EnforceProvidedLabels = false,
PrecisionRecallTradeoff = 123
}
},
// the properties below are optional
Description = "description",
GlueVersion = "glueVersion",
MaxCapacity = 123,
MaxRetries = 123,
Name = "name",
NumberOfWorkers = 123,
Tags = tags,
Timeout = 123,
TransformEncryption = new TransformEncryptionProperty {
MlUserDataEncryption = new MLUserDataEncryptionProperty {
MlUserDataEncryptionMode = "mlUserDataEncryptionMode",
// the properties below are optional
KmsKeyId = "kmsKeyId"
},
TaskRunSecurityConfigurationName = "taskRunSecurityConfigurationName"
},
WorkerType = "workerType"
};
Synopsis
Properties
Description | A user-defined, long-form description text for the machine learning transform. |
GlueVersion | This value determines which version of AWS Glue this machine learning transform is compatible with. |
InputRecordTables | A list of AWS Glue table definitions used by the transform. |
MaxCapacity | The number of AWS Glue data processing units (DPUs) that are allocated to task runs for this transform. |
MaxRetries | The maximum number of times to retry after an |
Name | A user-defined name for the machine learning transform. Names are required to be unique. |
NumberOfWorkers | The number of workers of a defined |
Role | The name or Amazon Resource Name (ARN) of the IAM role with the required permissions. |
Tags | The tags to use with this machine learning transform. |
Timeout | The timeout in minutes of the machine learning transform. |
TransformEncryption | The encryption-at-rest settings of the transform that apply to accessing user data. |
TransformParameters | The algorithm-specific parameters that are associated with the machine learning transform. |
WorkerType | The type of predefined worker that is allocated when a task of this transform runs. |
Properties
Description
A user-defined, long-form description text for the machine learning transform.
virtual string Description { get; }
Property Value
System.String
Remarks
GlueVersion
This value determines which version of AWS Glue this machine learning transform is compatible with.
virtual string GlueVersion { get; }
Property Value
System.String
Remarks
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 AWS Glue Versions in the developer guide.
InputRecordTables
A list of AWS Glue table definitions used by the transform.
object InputRecordTables { get; }
Property Value
System.Object
Remarks
MaxCapacity
The number of AWS Glue data processing units (DPUs) that are allocated to task runs for this transform.
virtual Nullable<double> MaxCapacity { get; }
Property Value
System.Nullable<System.Double>
Remarks
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 AWS Glue pricing page .
MaxCapacity
is a mutually exclusive option with NumberOfWorkers
and WorkerType
.
When the WorkerType
field is set to a value other than Standard
, the MaxCapacity
field is set automatically and becomes read-only.
MaxRetries
The maximum number of times to retry after an MLTaskRun
of the machine learning transform fails.
virtual Nullable<double> MaxRetries { get; }
Property Value
System.Nullable<System.Double>
Remarks
Name
A user-defined name for the machine learning transform. Names are required to be unique. Name
is optional:.
virtual string Name { get; }
Property Value
System.String
Remarks
NumberOfWorkers
The number of workers of a defined workerType
that are allocated when a task of the transform runs.
virtual Nullable<double> NumberOfWorkers { get; }
Property Value
System.Nullable<System.Double>
Remarks
If WorkerType
is set, then NumberOfWorkers
is required (and vice versa).
Role
The name or Amazon Resource Name (ARN) of the IAM role with the required permissions.
string Role { get; }
Property Value
System.String
Remarks
The required permissions include both AWS Glue service role permissions to AWS Glue resources, and Amazon S3 permissions required by the transform.
Tags
The tags to use with this machine learning transform.
virtual object Tags { get; }
Property Value
System.Object
Remarks
You may use tags to limit access to the machine learning transform. For more information about tags in AWS Glue , see AWS Tags in AWS Glue in the developer guide.
Timeout
The timeout in minutes of the machine learning transform.
virtual Nullable<double> Timeout { get; }
Property Value
System.Nullable<System.Double>
Remarks
TransformEncryption
The encryption-at-rest settings of the transform that apply to accessing user data.
virtual object TransformEncryption { get; }
Property Value
System.Object
Remarks
Machine learning transforms can access user data encrypted in Amazon S3 using KMS.
Additionally, imported labels and trained transforms can now be encrypted using a customer provided KMS key.
TransformParameters
The algorithm-specific parameters that are associated with the machine learning transform.
object TransformParameters { get; }
Property Value
System.Object
Remarks
WorkerType
The type of predefined worker that is allocated when a task of this transform runs.
virtual string WorkerType { get; }
Property Value
System.String
Remarks
Accepts a value of Standard, G.1X, or G.2X.
MaxCapacity
is a mutually exclusive option with NumberOfWorkers
and WorkerType
.