Skip to main content

Create fileset

POST 

/metalakes/:metalake/catalogs/:catalog/schemas/:schema/filesets

Creates a fileset in the schema and returns it. An external fileset must have a storage location, while a managed fileset without one gets a location derived from the schema or catalog location property.

Sign in with a bearer token or a local user's password; see Authentication.

Request​

Path Parameters

    metalake stringrequired

    The name of the metalake

    catalog stringrequired

    The name of the catalog

    schema stringrequired

    The name of the schema

Body

    name stringrequired

    The name of the fileset. Can not be empty.

    type stringnullable

    The type of the fileset. The value of type should be EXTERNAL or MANAGED

    comment stringnullable

    The comment of the fileset. Can be empty.

    storageLocation stringnullable

    The storage location named unknown. A managed fileset can leave it out and take its locations from its schema and catalog. An external fileset must give at least one location. When both this and storageLocations are set, this one replaces storageLocations["unknown"].

    storageLocations

    object

    nullable

    The fileset's storage locations by name. Each name resolves on its own: a location here replaces the schema location of the same name, which replaces the catalog's, and names given only by the schema or catalog are inherited. A managed fileset can leave this out.

    property name* string

    properties

    object

    nullable

    The properties of the fileset. When the fileset ends up with more than one location, counting inherited ones, default-location-name must name one of them or the request returns 400.

    default-location-name string

    The location used when none is named. Required with several locations; with one, the server fills it in.

    property name* string

Responses​

The fileset, with its type, storage locations, comment, properties and audit information.

Schema

    code int32

    Possible values: [0]

    Status code of the response

    fileset

    object

    name stringrequired

    The name of the fileset

    type stringnullable

    The type of the fileset

    comment stringnullable

    The comment of the fileset

    storageLocation stringnullable

    The location of the fileset

    storageLocations

    object

    The fileset's storage locations by location name. A location created without a name is listed as unknown.

    property name* string

    properties

    object

    nullable

    The properties of the fileset

    property name* string

    audit

    object

    Audit information for a Gravitino resource.

    creator string

    The user who created the resource

    createTime date-time

    The time the resource was created

    lastModifier string

    The user who last modified the resource

    lastModifiedTime date-time

    The time the resource was last modified

Loading...