Datasets.CreateOrUpdate

func (datasetClient) CreateOrUpdate(
    ctx context.Context,
    kind datasets.DatasetKind,
    codeName string,
    name string,
    fields []datasets.Field,
    options ...datasets.DatasetOption,
) (*datasets.Dataset, error)

Create a dataset or update an existing dataset if a dataset with the given codeName already exists. If the dataset already exists, Tilebox applies the same schema update rules as a direct update. New fields can be added to non-empty datasets. Breaking schema changes are only allowed for empty datasets.

Parameters

datasets.DatasetKind

required

The dataset kind.

string

required

The stable code identifier for the dataset.

string

required

The display name of the dataset.

[]datasets.Field

required

The custom fields in the dataset schema.

[]datasets.DatasetOption

Options for dataset metadata.

Options

Set a short dataset summary.

Set the dataset’s markdown description.

Dataset kinds

datasets.DatasetKind

A dataset that contains timestamp, ID, and ingestion time fields.

datasets.DatasetKind

A dataset that contains timestamp, ID, ingestion time, and geometry fields.

Field types

Field

A string field

Field

A bytes field

Field

A boolean field

Field

A 64-bit signed integer field

Field

A 64-bit unsigned integer field

Field

A 64-bit floating-point number field

Field

A duration field

Field

A timestamp field

Field

A UUID field

Field

A geometry field

Field options

Indicate that the field is an array

Set the description of the field to provide more context and details about the data

Set the example value of the field for documentation purposes

Returns

The created or updated dataset object.

dataset, err := client.Datasets.CreateOrUpdate(ctx,
    datasets.KindSpatiotemporal,
    "my_catalog",
    "My catalog",
    []datasets.Field{
        field.String("field1"),
        field.Int64("field2").Repeated(),
        field.Geometry("field3").Description("Field 3").ExampleValue("Value 3"),
    },
    datasets.WithSummary("Scenes prepared for analysis"),
)

Python

Go

Datasets.CreateOrUpdate

Parameters

Options

Dataset kinds

Field types

Field options

Returns

​Parameters

​Options

​Dataset kinds

​Field types

​Field options

​Returns

Parameters

Options

Dataset kinds

Field types

Field options

Returns