Package org.apache.gravitino.dto.file

Class FilesetDTO

java.lang.Object

org.apache.gravitino.dto.file.FilesetDTO

All Implemented Interfaces:

Auditable, Fileset

public class FilesetDTO
extends Object
implements Fileset

Represents a Fileset DTO (Data Transfer Object).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	FilesetDTO.FilesetDTOBuilder	Builder for FilesetDTO.

Nested classes/interfaces inherited from interface org.apache.gravitino.file.Fileset

Fileset.Type

Field Summary

Fields inherited from interface org.apache.gravitino.file.Fileset

LOCATION_NAME_UNKNOWN, PROPERTY_CATALOG_PLACEHOLDER, PROPERTY_DEFAULT_LOCATION_NAME, PROPERTY_FILESET_PLACEHOLDER, PROPERTY_LOCATION_PLACEHOLDER_PREFIX, PROPERTY_MULTIPLE_LOCATIONS_PREFIX, PROPERTY_SCHEMA_PLACEHOLDER

Method Summary

Modifier and Type	Method	Description
AuditDTO	auditInfo()
static FilesetDTO.FilesetDTOBuilder	builder()	Create a new FilesetDTO builder.
String	comment()
String	name()
Map<String,String>	properties()
Map<String,String>	storageLocations()	Get the storage location name and corresponding path of the file or directory path that is managed by this fileset object.
Fileset.Type	type()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.gravitino.file.Fileset

storageLocation, supportsCredentials, supportsPolicies, supportsRoles, supportsTags

Method Details

name

public String name()

Specified by:

name in interface Fileset

Returns:

Name of the fileset object.

comment

@Nullable
public String comment()

Specified by:

comment in interface Fileset

Returns:

The comment of the fileset object. Null is returned if no comment is set.

type

public Fileset.Type type()

Specified by:

type in interface Fileset

Returns:

The type of the fileset object.

storageLocations

public Map<String,String> storageLocations()

Description copied from interface: Fileset

Get the storage location name and corresponding path of the file or directory path that is managed by this fileset object. The key is the name of the storage location and the value is the storage location path.

Each storageLocation in the values can either be the one specified when creating the fileset object, or the one specified in the catalog / schema level if the fileset object is created under this catalog / schema.

The "unknown" location name is reserved to indicate the storage location of the fileset. It can be specified in catalog / schema level by the property "location" or in the fileset level by the field "storageLocation". Other location names can be specified in the fileset level by the key-value pairs in the field "storageLocations", and by "location-{name}" properties in the catalog / schema level.

The storageLocation in each level can contain placeholders, format as {{name}}, which will be replaced by the corresponding fileset property value when the fileset object is created. The placeholder property in the fileset object is formed as "placeholder-{{name}}". For example, if the storageLocation is "file:///path/{{schema}}-{{fileset}}-{{version}}", and the fileset object "catalog1.schema1.fileset1" has the property "placeholder-version" set to "v1", then the storageLocation will be "file:///path/schema1-fileset1-v1".

For managed fileset, the storageLocation can be:

1) The one specified when creating the fileset object, and the placeholders in the storageLocation will be replaced by the placeholder value specified in the fileset properties.

2) When catalog property "location" is specified but schema property "location" is not specified, then the storageLocation will be:

a. "{catalog location}/schemaName/filesetName" if {catalog location} does not contain any placeholder.

b. "{catalog location}" - placeholders in the {catalog location} will be replaced by the placeholder value specified in the fileset properties.

3) When catalog property "location" is not specified but schema property "location" is specified, then the storageLocation will be:

a. "{schema location}/filesetName" if {schema location} does not contain any placeholder.

b. "{schema location}" - placeholders in the {schema location} will be replaced by the placeholder value specified in the fileset properties.

4) When both catalog property "location" and schema property "location" are specified, then the storageLocation will be:

a. "{schema location}/filesetName" if {schema location} does not contain any placeholder.

b. "{schema location}" - placeholders in the {schema location} will be replaced by values specified in the fileset properties.

5) When there is no location specified in catalog level, schema level, storageLocation of fileset, and storageLocations of fileset at the same time, this situation is illegal.

For external fileset, the storageLocation can be:

1) The one specified when creating the fileset object, and the placeholders in the storageLocation will be replaced by the placeholder value specified in the fileset properties.

Specified by:

storageLocations in interface Fileset

Returns:

The storage locations of the fileset object, the key is the name of the storage location and the value is the storage location path.

properties

public Map<String,String> properties()

Specified by:

properties in interface Fileset

Returns:

The properties of the fileset object. Empty map is returned if no properties are set.

auditInfo

public AuditDTO auditInfo()

Specified by:

auditInfo in interface Auditable

Returns:

The audit information of the entity.

builder

public static FilesetDTO.FilesetDTOBuilder builder()

Create a new FilesetDTO builder.

Returns:

A new FilesetDTO builder.