Skip to content

/AWS1/CL_CRL=>CREATETRAININGDATASET()

About CreateTrainingDataset

Defines the information necessary to create a training dataset. In Clean Rooms ML, the TrainingDataset is metadata that points to a Glue table, which is read only during AudienceModel creation.

Method Signature

IMPORTING

Required arguments:

IV_NAME TYPE /AWS1/CRLNAMESTRING /AWS1/CRLNAMESTRING

The name of the training dataset. This name must be unique in your account and region.

IV_ROLEARN TYPE /AWS1/CRLIAMROLEARN /AWS1/CRLIAMROLEARN

The ARN of the IAM role that Clean Rooms ML can assume to read the data referred to in the dataSource field of each dataset.

Passing a role across AWS accounts is not allowed. If you pass a role that isn't in your account, you get an AccessDeniedException error.

IT_TRAININGDATA TYPE /AWS1/CL_CRLDATASET=>TT_DATASETLIST TT_DATASETLIST

An array of information that lists the Dataset objects, which specifies the dataset type and details on its location and schema. You must provide a role that has read access to these tables.

Optional arguments:

IT_TAGS TYPE /AWS1/CL_CRLTAGMAP_W=>TT_TAGMAP TT_TAGMAP

The optional metadata that you apply to the resource to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define.

The following basic restrictions apply to tags:

  • Maximum number of tags per resource - 50.

  • For each resource, each tag key must be unique, and each tag key can have only one value.

  • Maximum key length - 128 Unicode characters in UTF-8.

  • Maximum value length - 256 Unicode characters in UTF-8.

  • If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.

  • Tag keys and values are case sensitive.

  • Do not use aws:, AWS:, or any upper or lowercase combination of such as a prefix for keys as it is reserved for AWS use. You cannot edit or delete tag keys with this prefix. Values can have this prefix. If a tag value has aws as its prefix but the key does not, then Clean Rooms ML considers it to be a user tag and will count against the limit of 50 tags. Tags with only the key prefix of aws do not count against your tags per resource limit.

IV_DESCRIPTION TYPE /AWS1/CRLRESOURCEDESCRIPTION /AWS1/CRLRESOURCEDESCRIPTION

The description of the training dataset.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_CRLCREATETRNDSRSP /AWS1/CL_CRLCREATETRNDSRSP