org.apache.iceberg.nessie

Class NessieCatalog

java.lang.Object

org.apache.iceberg.BaseMetastoreCatalog

org.apache.iceberg.nessie.NessieCatalog

All Implemented Interfaces:

java.lang.AutoCloseable, org.apache.hadoop.conf.Configurable, org.apache.iceberg.catalog.Catalog, org.apache.iceberg.catalog.SupportsNamespaces

public class NessieCatalog
extends org.apache.iceberg.BaseMetastoreCatalog
implements java.lang.AutoCloseable, org.apache.iceberg.catalog.SupportsNamespaces, org.apache.hadoop.conf.Configurable

Nessie implementation of Iceberg Catalog.

A note on namespaces: Nessie namespaces are implicit and do not need to be explicitly created or deleted. The create and delete namespace methods are no-ops for the NessieCatalog. One can still list namespaces that have objects stored in them to assist with namespace-centric catalog exploration.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.iceberg.BaseMetastoreCatalog

org.apache.iceberg.BaseMetastoreCatalog.BaseMetastoreCatalogTableBuilder

Nested classes/interfaces inherited from interface org.apache.iceberg.catalog.Catalog

org.apache.iceberg.catalog.Catalog.TableBuilder

Constructor Summary

Constructors

Constructor and Description
NessieCatalog()

Method Summary

Modifier and Type	Method and Description
void	close()
void	createNamespace(org.apache.iceberg.catalog.Namespace namespace, java.util.Map<java.lang.String,java.lang.String> metadata) creating namespaces in nessie is implicit, therefore this is a no-op.
java.lang.String	currentHash()
protected java.lang.String	defaultWarehouseLocation(org.apache.iceberg.catalog.TableIdentifier table)
boolean	dropNamespace(org.apache.iceberg.catalog.Namespace namespace) Namespaces in Nessie are implicit and deleting them results in a no-op.
boolean	dropTable(org.apache.iceberg.catalog.TableIdentifier identifier, boolean purge)
org.apache.hadoop.conf.Configuration	getConf()
void	initialize(java.lang.String inputName, java.util.Map<java.lang.String,java.lang.String> options)
java.util.List<org.apache.iceberg.catalog.Namespace>	listNamespaces(org.apache.iceberg.catalog.Namespace namespace)
java.util.List<org.apache.iceberg.catalog.TableIdentifier>	listTables(org.apache.iceberg.catalog.Namespace namespace)
java.util.Map<java.lang.String,java.lang.String>	loadNamespaceMetadata(org.apache.iceberg.catalog.Namespace namespace) namespace metadata is not supported in Nessie and we return an empty map.
java.lang.String	name()
protected org.apache.iceberg.TableOperations	newTableOps(org.apache.iceberg.catalog.TableIdentifier tableIdentifier)
void	refresh()
boolean	removeProperties(org.apache.iceberg.catalog.Namespace namespace, java.util.Set<java.lang.String> properties)
void	renameTable(org.apache.iceberg.catalog.TableIdentifier from, org.apache.iceberg.catalog.TableIdentifier toOriginal)
void	setConf(org.apache.hadoop.conf.Configuration conf)
boolean	setProperties(org.apache.iceberg.catalog.Namespace namespace, java.util.Map<java.lang.String,java.lang.String> properties)

Methods inherited from class org.apache.iceberg.BaseMetastoreCatalog

buildTable, createTable, fullTableName, isValidIdentifier, loadTable, newCreateTableTransaction, newReplaceTableTransaction, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.iceberg.catalog.SupportsNamespaces

createNamespace, listNamespaces, namespaceExists

Methods inherited from interface org.apache.iceberg.catalog.Catalog

createTable, createTable, createTable, dropTable, newCreateTableTransaction, newCreateTableTransaction, newCreateTableTransaction, newReplaceTableTransaction, newReplaceTableTransaction, newReplaceTableTransaction, tableExists

Constructor Detail

NessieCatalog

public NessieCatalog()

Method Detail

initialize

public void initialize(java.lang.String inputName,
                       java.util.Map<java.lang.String,java.lang.String> options)

Specified by:

initialize in interface org.apache.iceberg.catalog.Catalog

close

public void close()

Specified by:

close in interface java.lang.AutoCloseable

name

public java.lang.String name()

Specified by:

name in interface org.apache.iceberg.catalog.Catalog

newTableOps

protected org.apache.iceberg.TableOperations newTableOps(org.apache.iceberg.catalog.TableIdentifier tableIdentifier)

Specified by:

newTableOps in class org.apache.iceberg.BaseMetastoreCatalog

defaultWarehouseLocation

protected java.lang.String defaultWarehouseLocation(org.apache.iceberg.catalog.TableIdentifier table)

Specified by:

defaultWarehouseLocation in class org.apache.iceberg.BaseMetastoreCatalog

listTables

public java.util.List<org.apache.iceberg.catalog.TableIdentifier> listTables(org.apache.iceberg.catalog.Namespace namespace)

Specified by:

listTables in interface org.apache.iceberg.catalog.Catalog

dropTable

public boolean dropTable(org.apache.iceberg.catalog.TableIdentifier identifier,
                         boolean purge)

Specified by:

dropTable in interface org.apache.iceberg.catalog.Catalog

renameTable

public void renameTable(org.apache.iceberg.catalog.TableIdentifier from,
                        org.apache.iceberg.catalog.TableIdentifier toOriginal)

Specified by:

renameTable in interface org.apache.iceberg.catalog.Catalog

createNamespace

public void createNamespace(org.apache.iceberg.catalog.Namespace namespace,
                            java.util.Map<java.lang.String,java.lang.String> metadata)

creating namespaces in nessie is implicit, therefore this is a no-op. Metadata is ignored.

Specified by:

createNamespace in interface org.apache.iceberg.catalog.SupportsNamespaces

Parameters:

namespace - a multi-part namespace

metadata - a string Map of properties for the given namespace

listNamespaces

public java.util.List<org.apache.iceberg.catalog.Namespace> listNamespaces(org.apache.iceberg.catalog.Namespace namespace)
                                                                    throws org.apache.iceberg.exceptions.NoSuchNamespaceException

Specified by:

listNamespaces in interface org.apache.iceberg.catalog.SupportsNamespaces

Throws:

org.apache.iceberg.exceptions.NoSuchNamespaceException

loadNamespaceMetadata

public java.util.Map<java.lang.String,java.lang.String> loadNamespaceMetadata(org.apache.iceberg.catalog.Namespace namespace)
                                                                       throws org.apache.iceberg.exceptions.NoSuchNamespaceException

namespace metadata is not supported in Nessie and we return an empty map.

Specified by:

loadNamespaceMetadata in interface org.apache.iceberg.catalog.SupportsNamespaces

Parameters:

namespace - a namespace. Namespace

Returns:

an empty map

Throws:

org.apache.iceberg.exceptions.NoSuchNamespaceException

dropNamespace

public boolean dropNamespace(org.apache.iceberg.catalog.Namespace namespace)
                      throws org.apache.iceberg.exceptions.NamespaceNotEmptyException

Namespaces in Nessie are implicit and deleting them results in a no-op.

Specified by:

dropNamespace in interface org.apache.iceberg.catalog.SupportsNamespaces

Parameters:

namespace - a namespace. Namespace

Returns:

always false.

Throws:

org.apache.iceberg.exceptions.NamespaceNotEmptyException

setProperties

public boolean setProperties(org.apache.iceberg.catalog.Namespace namespace,
                             java.util.Map<java.lang.String,java.lang.String> properties)
                      throws org.apache.iceberg.exceptions.NoSuchNamespaceException

Specified by:

setProperties in interface org.apache.iceberg.catalog.SupportsNamespaces

Throws:

org.apache.iceberg.exceptions.NoSuchNamespaceException

removeProperties

public boolean removeProperties(org.apache.iceberg.catalog.Namespace namespace,
                                java.util.Set<java.lang.String> properties)
                         throws org.apache.iceberg.exceptions.NoSuchNamespaceException

Specified by:

removeProperties in interface org.apache.iceberg.catalog.SupportsNamespaces

Throws:

org.apache.iceberg.exceptions.NoSuchNamespaceException

setConf

public void setConf(org.apache.hadoop.conf.Configuration conf)

Specified by:

setConf in interface org.apache.hadoop.conf.Configurable

getConf

public org.apache.hadoop.conf.Configuration getConf()

Specified by:

getConf in interface org.apache.hadoop.conf.Configurable

refresh

public void refresh()
             throws org.projectnessie.error.NessieNotFoundException

Throws:

org.projectnessie.error.NessieNotFoundException

currentHash

public java.lang.String currentHash()