org.apache.asterix.metadata.api

Interface IMetadataNode

All Superinterfaces:

Remote, Serializable

All Known Implementing Classes:

MetadataNode

public interface IMetadataNode
extends Remote, Serializable

A metadata node stores metadata in its local storage structures (currently BTrees). A metadata node services requests on behalf of the (possibly remote) metadata manager by executing local transactions against its local storage. This interface mirrors the methods in IMetadataManager. Users wanting to lock/access metadata shall always go through the MetadataManager, and should never call methods on the MetadataNode directly for any reason.

Method Summary

Methods

Modifier and Type	Method and Description
void	abortTransaction(JobId jobId) Aborts a local transaction against the metadata.
void	addAdapter(JobId jobId, DatasourceAdapter adapter)
void	addCompactionPolicy(JobId jobId, CompactionPolicy compactionPolicy)
void	addDataset(JobId jobId, Dataset dataset) Inserts a new dataset into the metadata, acquiring local locks on behalf of the given transaction id.
void	addDatatype(JobId jobId, Datatype datatype) Inserts a datatype, acquiring local locks on behalf of the given transaction id.
void	addDataverse(JobId jobId, Dataverse dataverse) Inserts a new dataverse into the metadata, acquiring local locks on behalf of the given transaction id.
void	addExternalFile(JobId jobId, ExternalFile externalFile)
void	addFeed(JobId jobId, Feed feed)
void	addFeedPolicy(JobId jobId, FeedPolicy feedPolicy)
void	addFunction(JobId jobId, Function function)
void	addIndex(JobId jobId, Index index) Inserts an index into the metadata, acquiring local locks on behalf of the given transaction id.
void	addLibrary(JobId jobId, Library library) Adds a library, acquiring local locks on behalf of the given transaction id.
void	addNode(JobId jobId, Node node) Inserts a node (compute node), acquiring local locks on behalf of the given transaction id.
void	addNodeGroup(JobId jobId, NodeGroup nodeGroup) Inserts a node group, acquiring local locks on behalf of the given transaction id.
void	beginTransaction(JobId jobId) Begins a local transaction against the metadata.
void	commitTransaction(JobId jobId) Commits a local transaction against the metadata.
void	dropAdapter(JobId jobId, String dataverseName, String adapterName) Deletes a adapter , acquiring local locks on behalf of the given transaction id.
void	dropDataset(JobId jobId, String dataverseName, String datasetName) Deletes the dataset with given name, and all it's associated indexes, acquiring local locks on behalf of the given transaction id.
void	dropDatatype(JobId jobId, String dataverseName, String datatypeName) Deletes the given datatype in given dataverse, acquiring local locks on behalf of the given transaction id.
void	dropDataverse(JobId jobId, String dataverseName) Deletes the dataverse with given name, and all it's associated datasets, indexes, and types, acquiring local locks on behalf of the given transaction id.
void	dropExternalFile(JobId jobId, String dataverseName, String datasetName, int fileNumber) Deletes an externalFile , acquiring local locks on behalf of the given transaction id.
void	dropExternalFiles(JobId jobId, Dataset dataset) Deletes all external files belonging to a dataset, acquiring local locks on behalf of the given transaction id.
void	dropFeed(JobId jobId, String dataverse, String feedName)
void	dropFeedPolicy(JobId jobId, String dataverseName, String policyName) delete a give feed (ingestion) policy
void	dropFunction(JobId jobId, FunctionSignature functionSignature) Deletes a function, acquiring local locks on behalf of the given transaction id.
void	dropIndex(JobId jobId, String dataverseName, String datasetName, String indexName) Deletes the index with given name, in given dataverse and dataset, acquiring local locks on behalf of the given transaction id.
void	dropLibrary(JobId jobId, String dataverseName, String libraryName) Removes a library , acquiring local locks on behalf of the given transaction id.
void	dropNodegroup(JobId jobId, String nodeGroupName) Deletes a node group, acquiring local locks on behalf of the given transaction id.
DatasourceAdapter	getAdapter(JobId jobId, String dataverseName, String adapterName)
CompactionPolicy	getCompactionPolicy(JobId jobId, String dataverse, String policy)
Dataset	getDataset(JobId jobId, String dataverseName, String datasetName) Retrieves a dataset within a given dataverse, acquiring local locks on behalf of the given transaction id.
List<Index>	getDatasetIndexes(JobId jobId, String dataverseName, String datasetName) Retrieves all indexes of a dataset, acquiring local locks on behalf of the given transaction id.
Datatype	getDatatype(JobId jobId, String dataverseName, String datatypeName) Retrieves the datatype with given name in given dataverse, acquiring local locks on behalf of the given transaction id.
Dataverse	getDataverse(JobId jobId, String dataverseName) Retrieves a dataverse with given name, acquiring local locks on behalf of the given transaction id.
List<DatasourceAdapter>	getDataverseAdapters(JobId jobId, String dataverseName)
List<Dataset>	getDataverseDatasets(JobId jobId, String dataverseName) Retrieves all datasets belonging to the given dataverse, acquiring local locks on behalf of the given transaction id.
List<Feed>	getDataverseFeeds(JobId jobId, String dataverseName)
List<Function>	getDataverseFunctions(JobId jobId, String dataverseName)
List<Library>	getDataverseLibraries(JobId jobId, String dataverseName) Retireve libraries installed in a given dataverse.
List<FeedPolicy>	getDataversePolicies(JobId jobId, String dataverse)
List<Dataverse>	getDataverses(JobId jobId) Retrieves all dataverses, acquiring local locks on behalf of the given transaction id.
ExternalFile	getExternalFile(JobId jobId, String dataverseName, String datasetName, Integer fileNumber) Retrieves the file with given number, in given dataverse and dataset, acquiring local locks on behalf of the given transaction id.
List<ExternalFile>	getExternalFiles(JobId jobId, Dataset dataset)
Feed	getFeed(JobId jobId, String dataverse, String feedName)
FeedPolicy	getFeedPolicy(JobId jobId, String dataverse, String policy)
Function	getFunction(JobId jobId, FunctionSignature functionSignature)
Index	getIndex(JobId jobId, String dataverseName, String datasetName, String indexName) Retrieves the index with given name, in given dataverse and dataset, acquiring local locks on behalf of the given transaction id.
Library	getLibrary(JobId jobId, String dataverseName, String libraryName)
int	getMostRecentDatasetId()
NodeGroup	getNodeGroup(JobId jobId, String nodeGroupName) Retrieves a node group, acquiring local locks on behalf of the given transaction id.
void	initializeDatasetIdFactory(JobId jobId)
void	lock(JobId jobId, byte lockMode) Locally locks the entire metadata in given mode on behalf of given transaction id.
void	unlock(JobId jobId, byte lockMode) Releases all local locks of given transaction id.
void	updateDataset(JobId jobId, Dataset dataset) update an existing dataset in the metadata, acquiring local locks on behalf of the given transaction id.

Method Detail

beginTransaction

void beginTransaction(JobId jobId)
                      throws ACIDException,
                             RemoteException

Begins a local transaction against the metadata.

Throws:

ACIDException

RemoteException

commitTransaction

void commitTransaction(JobId jobId)
                       throws ACIDException,
                              RemoteException

Commits a local transaction against the metadata.

Throws:

ACIDException

RemoteException

abortTransaction

void abortTransaction(JobId jobId)
                      throws ACIDException,
                             RemoteException

Aborts a local transaction against the metadata.

Throws:

ACIDException

RemoteException

lock

void lock(JobId jobId,
        byte lockMode)
          throws ACIDException,
                 RemoteException

Locally locks the entire metadata in given mode on behalf of given transaction id.

Throws:

ACIDException

RemoteException

unlock

void unlock(JobId jobId,
          byte lockMode)
            throws ACIDException,
                   RemoteException

Releases all local locks of given transaction id.

Throws:

ACIDException

RemoteException

addDataverse

void addDataverse(JobId jobId,
                Dataverse dataverse)
                  throws MetadataException,
                         RemoteException

Inserts a new dataverse into the metadata, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataverse - Dataverse instance to be inserted.

Throws:

MetadataException - For example, if the dataverse already exists.

RemoteException

getDataverses

List<Dataverse> getDataverses(JobId jobId)
                              throws MetadataException,
                                     RemoteException

Retrieves all dataverses, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

Returns:

A list of dataverse instances.

Throws:

MetadataException - For example, if the dataverse does not exist.

RemoteException

getDataverse

Dataverse getDataverse(JobId jobId,
                     String dataverseName)
                       throws MetadataException,
                              RemoteException

Retrieves a dataverse with given name, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataverseName - Name of the dataverse to retrieve.

Returns:

A dataverse instance.

Throws:

MetadataException - For example, if the dataverse does not exist.

RemoteException

getDataverseDatasets

List<Dataset> getDataverseDatasets(JobId jobId,
                                 String dataverseName)
                                   throws MetadataException,
                                          RemoteException

Retrieves all datasets belonging to the given dataverse, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataverseName - Name of the dataverse of which to find all datasets.

Returns:

A list of dataset instances.

Throws:

MetadataException - For example, if the dataverse does not exist. RemoteException

RemoteException

dropDataverse

void dropDataverse(JobId jobId,
                 String dataverseName)
                   throws MetadataException,
                          RemoteException

Deletes the dataverse with given name, and all it's associated datasets, indexes, and types, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

Throws:

MetadataException - For example, if the dataverse does not exist.

RemoteException

addDataset

void addDataset(JobId jobId,
              Dataset dataset)
                throws MetadataException,
                       RemoteException

Inserts a new dataset into the metadata, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataset - Dataset instance to be inserted.

Throws:

MetadataException - For example, if the dataset already exists.

RemoteException

getDataset

Dataset getDataset(JobId jobId,
                 String dataverseName,
                 String datasetName)
                   throws MetadataException,
                          RemoteException

Retrieves a dataset within a given dataverse, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataverseName - Dataverse name to look for the dataset.

datasetName - Name of dataset to be retrieved.

Returns:

A dataset instance.

Throws:

MetadataException - For example, if the dataset does not exist.

RemoteException

getDatasetIndexes

List<Index> getDatasetIndexes(JobId jobId,
                            String dataverseName,
                            String datasetName)
                              throws MetadataException,
                                     RemoteException

Retrieves all indexes of a dataset, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataverseName - Name of dataverse which holds the given dataset.

datasetName - Name of dataset for which to retrieve all indexes.

Returns:

A list of Index instances.

Throws:

MetadataException - For example, if the dataset and/or dataverse does not exist.

RemoteException

dropDataset

void dropDataset(JobId jobId,
               String dataverseName,
               String datasetName)
                 throws MetadataException,
                        RemoteException

Deletes the dataset with given name, and all it's associated indexes, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataverseName - Name of dataverse which holds the given dataset.

datasetName - Name of dataset to delete.

Throws:

MetadataException - For example, if the dataset and/or dataverse does not exist.

RemoteException

addIndex

void addIndex(JobId jobId,
            Index index)
              throws MetadataException,
                     RemoteException

Inserts an index into the metadata, acquiring local locks on behalf of the given transaction id. The index itself knows its name, and which dataset it belongs to.

Parameters:

jobId - A globally unique id for an active metadata transaction.

index - Index instance to be inserted.

Throws:

MetadataException - For example, if the index already exists.

RemoteException

getIndex

Index getIndex(JobId jobId,
             String dataverseName,
             String datasetName,
             String indexName)
               throws MetadataException,
                      RemoteException

Retrieves the index with given name, in given dataverse and dataset, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataverseName - Name of the datavers holding the given dataset.

datasetName - Name of the dataset holding the index.

Returns:

An Index instance.

Throws:

MetadataException - For example, if the index does not exist.

RemoteException

dropIndex

void dropIndex(JobId jobId,
             String dataverseName,
             String datasetName,
             String indexName)
               throws MetadataException,
                      RemoteException

Deletes the index with given name, in given dataverse and dataset, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataverseName - Name of the datavers holding the given dataset.

datasetName - Name of the dataset holding the index.

Throws:

MetadataException - For example, if the index does not exist.

RemoteException

addDatatype

void addDatatype(JobId jobId,
               Datatype datatype)
                 throws MetadataException,
                        RemoteException

Inserts a datatype, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

datatype - Datatype instance to be inserted.

Throws:

MetadataException - For example, if the datatype already exists.

RemoteException

getDatatype

Datatype getDatatype(JobId jobId,
                   String dataverseName,
                   String datatypeName)
                     throws MetadataException,
                            RemoteException

Retrieves the datatype with given name in given dataverse, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataverseName - Name of dataverse holding the datatype.

datatypeName - Name of datatype to be retrieved.

Returns:

A datatype instance.

Throws:

MetadataException - For example, if the datatype does not exist.

RemoteException

dropDatatype

void dropDatatype(JobId jobId,
                String dataverseName,
                String datatypeName)
                  throws MetadataException,
                         RemoteException

Deletes the given datatype in given dataverse, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataverseName - Name of dataverse holding the datatype.

datatypeName - Name of datatype to be deleted.

Throws:

MetadataException - For example, if there are still datasets using the type to be deleted.

RemoteException

addNodeGroup

void addNodeGroup(JobId jobId,
                NodeGroup nodeGroup)
                  throws MetadataException,
                         RemoteException

Inserts a node group, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

nodeGroup - Node group instance to insert.

Throws:

MetadataException - For example, if the node group already exists.

RemoteException

getNodeGroup

NodeGroup getNodeGroup(JobId jobId,
                     String nodeGroupName)
                       throws MetadataException,
                              RemoteException

Retrieves a node group, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

nodeGroupName - Name of node group to be retrieved.

Throws:

MetadataException - For example, if the node group does not exist.

RemoteException

dropNodegroup

void dropNodegroup(JobId jobId,
                 String nodeGroupName)
                   throws MetadataException,
                          RemoteException

Deletes a node group, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

nodeGroupName - Name of node group to be deleted.

Throws:

MetadataException - For example, there are still datasets partitioned on the node group to be deleted.

RemoteException

addNode

void addNode(JobId jobId,
           Node node)
             throws MetadataException,
                    RemoteException

Inserts a node (compute node), acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

node - Node instance to be inserted.

Throws:

MetadataException - For example, if the node already exists.

RemoteException

getFunction

Function getFunction(JobId jobId,
                   FunctionSignature functionSignature)
                     throws MetadataException,
                            RemoteException

Parameters:

jobId - A globally unique id for an active metadata transaction.

functionSignature - An instance of functionSignature representing the function

Returns:

Throws:

MetadataException

RemoteException

dropFunction

void dropFunction(JobId jobId,
                FunctionSignature functionSignature)
                  throws MetadataException,
                         RemoteException

Deletes a function, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

functionSignature - An instance of functionSignature representing the function

Throws:

MetadataException - For example, there are still datasets partitioned on the node group to be deleted.

RemoteException

addFunction

void addFunction(JobId jobId,
               Function function)
                 throws MetadataException,
                        RemoteException

Parameters:

jobId - A globally unique id for an active metadata transaction.

function - Function to be inserted

Throws:

MetadataException - for example, if the function already exists or refers to an unknown function

RemoteException

getDataverseFunctions

List<Function> getDataverseFunctions(JobId jobId,
                                   String dataverseName)
                                     throws MetadataException,
                                            RemoteException

Parameters:

ctx -

dataverseName -

Returns:

List A list containing the functions in the specified dataverse

Throws:

MetadataException

RemoteException

getDataverseAdapters

List<DatasourceAdapter> getDataverseAdapters(JobId jobId,
                                           String dataverseName)
                                             throws MetadataException,
                                                    RemoteException

Parameters:

ctx -

dataverseName -

Returns:

List A list containing the adapters in the specified dataverse

Throws:

MetadataException

RemoteException

getAdapter

DatasourceAdapter getAdapter(JobId jobId,
                           String dataverseName,
                           String adapterName)
                             throws MetadataException,
                                    RemoteException

Parameters:

jobId -

dataverseName -

adapterName -

Returns:

Throws:

MetadataException

RemoteException

dropAdapter

void dropAdapter(JobId jobId,
               String dataverseName,
               String adapterName)
                 throws MetadataException,
                        RemoteException

Deletes a adapter , acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataverseName - dataverse asociated with the adapter that is to be deleted.

adapterName - Name of adapter to be deleted. MetadataException for example, if the adapter does not exists.

Throws:

RemoteException

MetadataException

addAdapter

void addAdapter(JobId jobId,
              DatasourceAdapter adapter)
                throws MetadataException,
                       RemoteException

Parameters:

jobId - A globally unique id for an active metadata transaction.

adapter - Adapter to be inserted

Throws:

MetadataException - for example, if the adapter already exists.

RemoteException

addCompactionPolicy

void addCompactionPolicy(JobId jobId,
                       CompactionPolicy compactionPolicy)
                         throws MetadataException,
                                RemoteException

Parameters:

jobId -

compactionPolicy -

Throws:

MetadataException

RemoteException

getCompactionPolicy

CompactionPolicy getCompactionPolicy(JobId jobId,
                                   String dataverse,
                                   String policy)
                                     throws MetadataException,
                                            RemoteException

Parameters:

jobId -

dataverse -

policy -

Returns:

Throws:

MetadataException

RemoteException

initializeDatasetIdFactory

void initializeDatasetIdFactory(JobId jobId)
                                throws MetadataException,
                                       RemoteException

Parameters:

jobId -

Throws:

MetadataException

RemoteException

getMostRecentDatasetId

int getMostRecentDatasetId()
                           throws MetadataException,
                                  RemoteException

Returns:

Throws:

MetadataException

RemoteException

addFeed

void addFeed(JobId jobId,
           Feed feed)
             throws MetadataException,
                    RemoteException

Parameters:

jobId -

feed -

Throws:

MetadataException

RemoteException

getFeed

Feed getFeed(JobId jobId,
           String dataverse,
           String feedName)
             throws MetadataException,
                    RemoteException

Parameters:

jobId -

dataverse -

feedName -

Returns:

Throws:

MetadataException

RemoteException

dropFeed

void dropFeed(JobId jobId,
            String dataverse,
            String feedName)
              throws MetadataException,
                     RemoteException

Parameters:

jobId -

dataverse -

feedName -

Throws:

MetadataException

RemoteException

addFeedPolicy

void addFeedPolicy(JobId jobId,
                 FeedPolicy feedPolicy)
                   throws MetadataException,
                          RemoteException

Parameters:

jobId -

feedPolicy -

Throws:

MetadataException

RemoteException

getFeedPolicy

FeedPolicy getFeedPolicy(JobId jobId,
                       String dataverse,
                       String policy)
                         throws MetadataException,
                                RemoteException

Parameters:

jobId -

dataverse -

policy -

Returns:

Throws:

MetadataException

RemoteException

dropLibrary

void dropLibrary(JobId jobId,
               String dataverseName,
               String libraryName)
                 throws MetadataException,
                        RemoteException

Removes a library , acquiring local locks on behalf of the given transaction id.

Parameters:

txnId - A globally unique id for an active metadata transaction.

dataverseName - dataverse asociated with the adapter that is to be deleted.

libraryName - Name of library to be deleted. MetadataException for example, if the library does not exists.

Throws:

RemoteException

MetadataException

addLibrary

void addLibrary(JobId jobId,
              Library library)
                throws MetadataException,
                       RemoteException

Adds a library, acquiring local locks on behalf of the given transaction id.

Parameters:

txnId - A globally unique id for an active metadata transaction.

library - Library to be added

Throws:

MetadataException - for example, if the library is already added.

RemoteException

getLibrary

Library getLibrary(JobId jobId,
                 String dataverseName,
                 String libraryName)
                   throws MetadataException,
                          RemoteException

Parameters:

txnId - A globally unique id for an active metadata transaction.

dataverseName - dataverse asociated with the library that is to be retrieved.

libraryName - name of the library that is to be retrieved

Returns:

Library

Throws:

MetadataException

RemoteException

getDataverseLibraries

List<Library> getDataverseLibraries(JobId jobId,
                                  String dataverseName)
                                    throws MetadataException,
                                           RemoteException

Retireve libraries installed in a given dataverse.

Parameters:

txnId - A globally unique id for an active metadata transaction.

dataverseName - dataverse asociated with the library that is to be retrieved.

Returns:

Library

Throws:

MetadataException

RemoteException

getDataverseFeeds

List<Feed> getDataverseFeeds(JobId jobId,
                           String dataverseName)
                             throws MetadataException,
                                    RemoteException

Parameters:

jobId -

dataverseName -

Returns:

Throws:

MetadataException

RemoteException

dropFeedPolicy

void dropFeedPolicy(JobId jobId,
                  String dataverseName,
                  String policyName)
                    throws MetadataException,
                           RemoteException

delete a give feed (ingestion) policy

Parameters:

jobId -

dataverseName -

policyName -

Throws:

RemoteException

MetadataException

getDataversePolicies

List<FeedPolicy> getDataversePolicies(JobId jobId,
                                    String dataverse)
                                      throws MetadataException,
                                             RemoteException

Parameters:

jobId -

dataverse -

Returns:

Throws:

MetadataException

RemoteException

addExternalFile

void addExternalFile(JobId jobId,
                   ExternalFile externalFile)
                     throws MetadataException,
                            RemoteException

Parameters:

jobId - A globally unique id for an active metadata transaction.

externalFile - An object representing the external file entity

Throws:

MetadataException - for example, if the file already exists.

RemoteException

getExternalFiles

List<ExternalFile> getExternalFiles(JobId jobId,
                                  Dataset dataset)
                                    throws MetadataException,
                                           RemoteException

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataset - A dataset the files belongs to.

Throws:

MetadataException

RemoteException

dropExternalFile

void dropExternalFile(JobId jobId,
                    String dataverseName,
                    String datasetName,
                    int fileNumber)
                      throws MetadataException,
                             RemoteException

Deletes an externalFile , acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataverseName - dataverse asociated with the external dataset that owns the file to be deleted.

datasetName - Name of dataset owning the file to be deleted.

fileNumber - the id number for the file to be deleted

Throws:

RemoteException

MetadataException

dropExternalFiles

void dropExternalFiles(JobId jobId,
                     Dataset dataset)
                       throws MetadataException,
                              RemoteException

Deletes all external files belonging to a dataset, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataset - An external dataset the files belong to.

Throws:

RemoteException

MetadataException

getExternalFile

ExternalFile getExternalFile(JobId jobId,
                           String dataverseName,
                           String datasetName,
                           Integer fileNumber)
                             throws MetadataException,
                                    RemoteException

Retrieves the file with given number, in given dataverse and dataset, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataverseName - Name of the datavers holding the given dataset.

datasetName - Name of the dataset holding the index.

fileNumber - Number of the file

Returns:

An ExternalFile instance.

Throws:

MetadataException - For example, if the index does not exist.

RemoteException

updateDataset

void updateDataset(JobId jobId,
                 Dataset dataset)
                   throws MetadataException,
                          RemoteException

update an existing dataset in the metadata, acquiring local locks on behalf of the given transaction id.

Parameters:

jobId - A globally unique id for an active metadata transaction.

dataset - updated Dataset instance.

Throws:

MetadataException - For example, if the dataset already exists.

RemoteException