Skip to content

Toolbox Stack Grammar

stackSpec: 
  dataset: dataos://icebase:sample/city?acl=rw 
  action: 
    name: set_version 
    value: latest

Configuration Attributes

stackSpec

Description: specifies the toolbox-stack specific section
Data Type: object
Requirement: mandatory
Default Value: none
Possible Value: none
Example Usage:

stackSpec:
  {}

dataset

Description: dataset udl address
Data Type: string
Requirement: mandatory
Default Value: none
Possible Value: any iceberg dataset udl
Additional Information: adding acl=rw after the dataset name is part of best practice in case the source system has separate keys for read and read write
Example Usage:

dataset: dataos://icebase:sample/city?acl=rw

action

Description: toolbox action specific section
Data Type: string
Requirement: optional
Default Value: user-id of the user
Possible Value: user-id of the use-case assignee
Example Usage:

action:
  {}

name

Description: specifies the toolbox action. The set_verison action sets the metadata version to any specific version you want it to.
Data Type: object
Requirement: mandatory
Default Value: none
Possible Value: set_version
Example Usage:

name: set_version

value

Description: the version of the metadata which you want to set to.
Data Type: string
Requirement: mandatory
Default Value: none
Possible Value: latest, v2.json, v1.json
Additional Information: you can use the dataos-ctl list-metadata to check the available metadata version for iceberg datasets.
Example Usage:

value: latest