Rest catalog implementation. More...

#include <rest_catalog.h>

Inheritance diagram for iceberg::rest::RestCatalog:

Public Member Functions
	RestCatalog (const RestCatalog &)=delete

RestCatalog &	operator= (const RestCatalog &)=delete

	RestCatalog (RestCatalog &&)=delete

RestCatalog &	operator= (RestCatalog &&)=delete

std::string_view	name () const override
	Return the name for this catalog.

Result< std::vector< Namespace > >	ListNamespaces (const Namespace &ns) const override
	List child namespaces from the given namespace.

Status	CreateNamespace (const Namespace &ns, const std::unordered_map< std::string, std::string > &properties) override
	Create a namespace with associated properties.

Result< std::unordered_map< std::string, std::string > >	GetNamespaceProperties (const Namespace &ns) const override
	Get metadata properties for a namespace.

Status	DropNamespace (const Namespace &ns) override
	Drop a namespace.

Result< bool >	NamespaceExists (const Namespace &ns) const override
	Check whether the namespace exists.

Status	UpdateNamespaceProperties (const Namespace &ns, const std::unordered_map< std::string, std::string > &updates, const std::unordered_set< std::string > &removals) override
	Update a namespace's properties by applying additions and removals.

Result< std::vector< TableIdentifier > >	ListTables (const Namespace &ns) const override
	Return all the identifiers under this namespace.

Result< std::shared_ptr< Table > >	CreateTable (const TableIdentifier &identifier, const std::shared_ptr< Schema > &schema, const std::shared_ptr< PartitionSpec > &spec, const std::shared_ptr< SortOrder > &order, const std::string &location, const std::unordered_map< std::string, std::string > &properties) override
	Create a table.

Result< std::shared_ptr< Table > >	UpdateTable (const TableIdentifier &identifier, const std::vector< std::unique_ptr< TableRequirement > > &requirements, const std::vector< std::unique_ptr< TableUpdate > > &updates) override
	Update a table.

Result< std::shared_ptr< Transaction > >	StageCreateTable (const TableIdentifier &identifier, const std::shared_ptr< Schema > &schema, const std::shared_ptr< PartitionSpec > &spec, const std::shared_ptr< SortOrder > &order, const std::string &location, const std::unordered_map< std::string, std::string > &properties) override
	Start a transaction to create a table.

Result< bool >	TableExists (const TableIdentifier &identifier) const override
	Check whether table exists.

Status	RenameTable (const TableIdentifier &from, const TableIdentifier &to) override
	Rename a table.

Status	DropTable (const TableIdentifier &identifier, bool purge) override
	Drop a table; optionally delete data and metadata files.

Result< std::shared_ptr< Table > >	LoadTable (const TableIdentifier &identifier) override
	Load a table.

Result< std::shared_ptr< Table > >	RegisterTable (const TableIdentifier &identifier, const std::string &metadata_file_location) override
	Register a table with the catalog if it does not exist.

Static Public Member Functions
static Result< std::shared_ptr< RestCatalog > >	Make (const RestCatalogProperties &config)
	Create a RestCatalog instance.

Detailed Description

Rest catalog implementation.

Member Function Documentation

◆ CreateNamespace()

Status iceberg::rest::RestCatalog::CreateNamespace	(	const Namespace &	ns,
		const std::unordered_map< std::string, std::string > &	properties
	)

overridevirtual

Create a namespace with associated properties.

Parameters

ns	the namespace to create
properties	a key-value map of metadata for the namespace

Returns: Status indicating success if created successfully; ErrorKind::kAlreadyExists if the namespace already exists; ErrorKind::kNotSupported if the operation is not supported

Implements iceberg::Catalog.

◆ CreateTable()

Result< std::shared_ptr< Table > > iceberg::rest::RestCatalog::CreateTable	(	const TableIdentifier &	identifier,
		const std::shared_ptr< Schema > &	schema,
		const std::shared_ptr< PartitionSpec > &	spec,
		const std::shared_ptr< SortOrder > &	order,
		const std::string &	location,
		const std::unordered_map< std::string, std::string > &	properties
	)

overridevirtual

Create a table.

Parameters

identifier	a table identifier
schema	a schema
spec	a partition spec
order	a sort order
location	a location for the table; leave empty if unspecified
properties	a string map of table properties

Returns: a Table instance or ErrorKind::kAlreadyExists if the table already exists

Implements iceberg::Catalog.

◆ DropNamespace()

Status iceberg::rest::RestCatalog::DropNamespace ( const Namespace & ns )

overridevirtual

Drop a namespace.

Parameters

ns	the namespace to drop

Returns: Status indicating success if dropped successfully; ErrorKind::kNoSuchNamespace if the namespace does not exist; ErrorKind::kNotAllowed if the namespace is not empty

Implements iceberg::Catalog.

◆ DropTable()

Status iceberg::rest::RestCatalog::DropTable	(	const TableIdentifier &	identifier,
		bool	purge
	)

overridevirtual

Drop a table; optionally delete data and metadata files.

If purge is set to true the implementation should delete all data and metadata files.

Parameters

identifier	a table identifier
purge	if true, delete all data and metadata files in the table

Returns

Status indicating the outcome of the operation.

On success, the table was dropped (or did not exist).
On failure, contains error information.

Implements iceberg::Catalog.

◆ GetNamespaceProperties()

Result< std::unordered_map< std::string, std::string > > iceberg::rest::RestCatalog::GetNamespaceProperties ( const Namespace & ns ) const

overridevirtual

Get metadata properties for a namespace.

Parameters

ns	the namespace to look up

Returns: a key-value map of metadata properties; ErrorKind::kNoSuchNamespace if the namespace does not exist

Implements iceberg::Catalog.

◆ ListNamespaces()

Result< std::vector< Namespace > > iceberg::rest::RestCatalog::ListNamespaces ( const Namespace & ns ) const

overridevirtual

List child namespaces from the given namespace.

Parameters

ns	the parent namespace

Returns: a list of child namespaces; ErrorKind::kNoSuchNamespace if the given namespace does not exist

Implements iceberg::Catalog.

◆ ListTables()

Result< std::vector< TableIdentifier > > iceberg::rest::RestCatalog::ListTables ( const Namespace & ns ) const

overridevirtual

Return all the identifiers under this namespace.

Parameters

ns	a namespace

Returns: a list of identifiers for tables or ErrorKind::kNoSuchNamespace if the namespace does not exist

Implements iceberg::Catalog.

◆ LoadTable()

Result< std::shared_ptr< Table > > iceberg::rest::RestCatalog::LoadTable ( const TableIdentifier & identifier )

overridevirtual

Load a table.

Parameters

identifier a table identifier

Returns: instance of Table implementation referred to by identifier or ErrorKind::kNoSuchTable if the table does not exist

FIXME: support per-table FileIO creation

Implements iceberg::Catalog.

◆ name()

std::string_view iceberg::rest::RestCatalog::name ( ) const

overridevirtual

Return the name for this catalog.

Implements iceberg::Catalog.

◆ NamespaceExists()

Result< bool > iceberg::rest::RestCatalog::NamespaceExists ( const Namespace & ns ) const

overridevirtual

Check whether the namespace exists.

Parameters

ns	the namespace to check

Returns: true if the namespace exists, false otherwise

Implements iceberg::Catalog.

◆ RegisterTable()

Result< std::shared_ptr< Table > > iceberg::rest::RestCatalog::RegisterTable	(	const TableIdentifier &	identifier,
		const std::string &	metadata_file_location
	)

overridevirtual

Register a table with the catalog if it does not exist.

Parameters

identifier	a table identifier
metadata_file_location	the location of a metadata file

Returns: a Table instance or ErrorKind::kAlreadyExists if the table already exists

Implements iceberg::Catalog.

◆ RenameTable()

Status iceberg::rest::RestCatalog::RenameTable	(	const TableIdentifier &	from,
		const TableIdentifier &	to
	)

overridevirtual

Rename a table.

Parameters

from	the current table identifier
to	the new table identifier

Returns

Status indicating the outcome of the operation.

On success, the table was renamed.
On failure, contains error information.

Implements iceberg::Catalog.

◆ StageCreateTable()

Result< std::shared_ptr< Transaction > > iceberg::rest::RestCatalog::StageCreateTable	(	const TableIdentifier &	identifier,
		const std::shared_ptr< Schema > &	schema,
		const std::shared_ptr< PartitionSpec > &	spec,
		const std::shared_ptr< SortOrder > &	order,
		const std::string &	location,
		const std::unordered_map< std::string, std::string > &	properties
	)

overridevirtual

Start a transaction to create a table.

Parameters

identifier	a table identifier
schema	a schema
spec	a partition spec
order	a sort order
location	a location for the table; leave empty if unspecified
properties	a string map of table properties

Returns: a Transaction to create the table or ErrorKind::kAlreadyExists if the table already exists

Implements iceberg::Catalog.

◆ TableExists()

Result< bool > iceberg::rest::RestCatalog::TableExists ( const TableIdentifier & identifier ) const

overridevirtual

Check whether table exists.

Parameters

identifier a table identifier

Returns

Result<bool> indicating table exists or not.

On success, the table existence was successfully checked (actual existence may be inferred elsewhere).
On failure, contains error information.

Implements iceberg::Catalog.

◆ UpdateNamespaceProperties()

Status iceberg::rest::RestCatalog::UpdateNamespaceProperties	(	const Namespace &	ns,
		const std::unordered_map< std::string, std::string > &	updates,
		const std::unordered_set< std::string > &	removals
	)

overridevirtual

Update a namespace's properties by applying additions and removals.

Parameters

ns	the namespace to update
updates	a set of properties to add or overwrite
removals	a set of property keys to remove

Returns: Status indicating success if the update is successful; ErrorKind::kNoSuchNamespace if the namespace does not exist; ErrorKind::kUnsupported if the operation is not supported

Implements iceberg::Catalog.

◆ UpdateTable()

Result< std::shared_ptr< Table > > iceberg::rest::RestCatalog::UpdateTable	(	const TableIdentifier &	identifier,
		const std::vector< std::unique_ptr< TableRequirement > > &	requirements,
		const std::vector< std::unique_ptr< TableUpdate > > &	updates
	)

overridevirtual

Update a table.

Parameters

identifier	a table identifier
requirements	a list of table requirements
updates	a list of table updates

Returns: a Table instance or ErrorKind::kAlreadyExists if the table already exists

Implements iceberg::Catalog.

The documentation for this class was generated from the following files:

iceberg/catalog/rest/rest_catalog.h
iceberg/catalog/rest/rest_catalog.cc

Public Member Functions

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ CreateNamespace()

◆ CreateTable()

◆ DropNamespace()

◆ DropTable()

◆ GetNamespaceProperties()

◆ ListNamespaces()

◆ ListTables()

◆ LoadTable()

◆ name()

◆ NamespaceExists()

◆ RegisterTable()

◆ RenameTable()

◆ StageCreateTable()

◆ TableExists()

◆ UpdateNamespaceProperties()

◆ UpdateTable()