Newer Version Available

This content describes an older version of this product. View Latest

Dataset Resource

Returns, deletes, or updates a dataset with the specified ID or API name.
Resource URL
1/wave/datasets/<datasetIdOrApiName>
Formats
JSON
Available Version
36.0
HTTP Methods
GET DELETE PATCH
GET Response Body (DatasetRepresentation)

DatasetRepresentation inherits properties from the abstract BaseWaveAssetRepresentation. These base properties appear in DatasetRepresentation alongside the properties defined explicitly in the following table.

Property Name Type Description Filter Group and Version Available Version
client​Shards​Url String The URL for the dataset shards. Small, 36.0 36.0
current​Version​Created​By Wave​User​Representation The creator of the current version of the dataset. Only returned if the filterGroup input parameter is set to Supplemental. Supplemental, 36.0 36.0
current​Version​Created​Date Date The time at which the current version of the dataset was created, in ISO8601 date format. Only returned if the filterGroup input parameter is set to Supplemental. Supplemental, 36.0 36.0
current​Version​Id ID The 18-character ID of the current dataset version. Small, 36.0 36.0
current​Version​Last​Modified​By Wave​User​Representation The user who last updated the current version of the dataset. Only returned if the filterGroup input parameter is set to Supplemental. Supplemental, 36.0 36.0
current​Version​Last​Modified​Date Date The last time the current version of the dataset was modified, in ISO8601 date format. Only returned if the filterGroup input parameter is set to Supplemental. Supplemental, 36.0 36.0
current​Version​Total​Rows Integer The total number of rows in the dataset. Supplemental, 42.0 42.0
current​Version​Url String The URL for the current dataset version. Small, 36.0 36.0
data​Refresh​Date Date The last time this dataset was updated. Small, 40.0 40.0
dataset​Type Connect​Wave​Dataset​Type​Enum The type of the dataset. Valid values are:
  • Default
  • Trended
Small, 41.0 41.0
folder Asset​Reference​Representation The reference to the folder in which this dataset is stored. Small, 36.0 36.0
last​Queried​Date Date The last time this dataset was queried. Small, 39.0 39.0
userXmd Xmd​Representation The associated user XMD. Medium, 36.0 36.0
versions​Url String The URL for dataset versions. Small, 36.0 36.0
PATCH Request Body (DatasetInputRepresentation)

DatasetInputRepresentation inherits properties from the abstract BaseAssetInputRepresentation. These base properties appear in DatasetInputRepresentation alongside the properties defined explicitly in the following table.

Property Name Type Description Required or Optional Available Version
current​Version​Id ID DEPRECATED The 18-character ID of the current version of this dataset. Optional 36.0–40.0
folder ID The 18-character ID of the folder that contains the dataset. Optional 36.0
user​Xmd Xmd​Input​Representation The user XMD associated with this dataset. Optional 39.0

The following JSON shows how to edit an existing dataset description.

1{
2              "description": "This is my dataset",
3              "label": "Test Dataset"
4              }
PATCH Response Body (DatasetRepresentation)

DatasetRepresentation inherits properties from the abstract BaseWaveAssetRepresentation. These base properties appear in DatasetRepresentation alongside the properties defined explicitly in the following table.

Property Name Type Description Filter Group and Version Available Version
client​Shards​Url String The URL for the dataset shards. Small, 36.0 36.0
current​Version​Created​By Wave​User​Representation The creator of the current version of the dataset. Only returned if the filterGroup input parameter is set to Supplemental. Supplemental, 36.0 36.0
current​Version​Created​Date Date The time at which the current version of the dataset was created, in ISO8601 date format. Only returned if the filterGroup input parameter is set to Supplemental. Supplemental, 36.0 36.0
current​Version​Id ID The 18-character ID of the current dataset version. Small, 36.0 36.0
current​Version​Last​Modified​By Wave​User​Representation The user who last updated the current version of the dataset. Only returned if the filterGroup input parameter is set to Supplemental. Supplemental, 36.0 36.0
current​Version​Last​Modified​Date Date The last time the current version of the dataset was modified, in ISO8601 date format. Only returned if the filterGroup input parameter is set to Supplemental. Supplemental, 36.0 36.0
current​Version​Total​Rows Integer The total number of rows in the dataset. Supplemental, 42.0 42.0
current​Version​Url String The URL for the current dataset version. Small, 36.0 36.0
data​Refresh​Date Date The last time this dataset was updated. Small, 40.0 40.0
dataset​Type Connect​Wave​Dataset​Type​Enum The type of the dataset. Valid values are:
  • Default
  • Trended
Small, 41.0 41.0
folder Asset​Reference​Representation The reference to the folder in which this dataset is stored. Small, 36.0 36.0
last​Queried​Date Date The last time this dataset was queried. Small, 39.0 39.0
userXmd Xmd​Representation The associated user XMD. Medium, 36.0 36.0
versions​Url String The URL for dataset versions. Small, 36.0 36.0