data_sets
Creates, updates, deletes, gets or lists a data_sets resource.
Overview
| Name | data_sets |
| Type | Resource |
| Id | aws.m2.data_sets |
Fields
The following fields are returned by SELECT queries:
- list_data_sets
| Name | Datatype | Description |
|---|---|---|
creation_time | string (date-time) | The timestamp when the data set was created. |
data_set_name | string | The name of the data set. (pattern: <code>^\S{1,200}$</code>) |
data_set_org | string | The type of data set. The only supported value is VSAM. (pattern: <code>^\S{1,20}$</code>) |
format_ | string | The format of the data set. (pattern: <code>^\S{1,20}$</code>) |
last_referenced_time | string (date-time) | The last time the data set was referenced. |
last_updated_time | string (date-time) | The last time the data set was updated. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list_data_sets | select | application_id, region | maxResults, nameFilter, nextToken, prefix | Lists the data sets imported for a specific application. In Amazon Web Services Mainframe Modernization, data sets are associated with applications deployed on runtime environments. This is known as importing data sets. Currently, Amazon Web Services Mainframe Modernization can import data sets into catalogs using CreateDataSetImportTask. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
application_id | string | The unique identifier of the application for which you want to list the associated data sets. |
region | string | AWS region (default: us-east-1) |
maxResults | integer | The maximum number of objects to return. |
nameFilter | string | Filter dataset name matching the specified pattern. Can use * and % as wild cards. |
nextToken | string | A pagination token returned from a previous call to this operation. This specifies the next item to return. To return to the beginning of the list, exclude this parameter. |
prefix | string | The prefix of the data set name, which you can use to filter the list of data sets. |
SELECT examples
- list_data_sets
Lists the data sets imported for a specific application. In Amazon Web Services Mainframe Modernization, data sets are associated with applications deployed on runtime environments. This is known as importing data sets. Currently, Amazon Web Services Mainframe Modernization can import data sets into catalogs using CreateDataSetImportTask.
SELECT
creation_time,
data_set_name,
data_set_org,
format_,
last_referenced_time,
last_updated_time
FROM aws.m2.data_sets
WHERE application_id = '{{ application_id }}' -- required
AND region = '{{ region }}' -- required
AND maxResults = '{{ maxResults }}'
AND nameFilter = '{{ nameFilter }}'
AND nextToken = '{{ nextToken }}'
AND prefix = '{{ prefix }}'
;