Package org.odpi.openmetadata.accessservices.dataengine.server.service

Class DataEngineRESTServices

java.lang.Object

org.odpi.openmetadata.accessservices.dataengine.server.service.DataEngineRESTServices

public class DataEngineRESTServices
extends Object

The DataEngineRESTServices provides the server-side implementation of the Data Engine Open Metadata Assess Service (OMAS). This service provide the functionality to create processes, ports with schema types and corresponding relationships.

Field Summary

Fields

Modifier and Type	Field	Description
static String	EXCEPTION_WHILE_ADDING_LINEAGE_MAPPING
static String	EXCEPTION_WHILE_CREATING_PROCESS
static String	EXCEPTION_WHILE_CREATING_PROCESS_HIERARCHY

Constructor Summary

Constructors

Constructor	Description
DataEngineRESTServices()

Method Summary

Modifier and Type	Method	Description
void	addLineageMappings(String userId, String serverName, List<LineageMapping> lineageMappings, FFDCResponseBase response, String externalSourceName)	Create LineageMappings relationships between schema attributes
VoidResponse	addLineageMappings(String userId, String serverName, LineageMappingsRequestBody lineageMappingsRequestBody)	Create LineageMappings relationships between schema attributes
GUIDResponse	addProcessHierarchy(String userId, String serverName, ProcessHierarchyRequestBody processHierarchyRequestBody)	Add the provided ProcessHierarchy relationship
String	addProcessHierarchyToProcess(String userId, String serverName, ProcessHierarchy processHierarchy, String externalSourceName)	Add a a ProcessHierarchy relationship to the process
String	createExternalDataEngine(String userId, String serverName, SoftwareServerCapability softwareServerCapability)	Create the external data engine as software server capability entity
GUIDResponse	createExternalDataEngine(String serverName, String userId, DataEngineRegistrationRequestBody requestBody)	Create the external data engine as software server capability entity
void	deleteConnection(String userId, String serverName, String externalSourceName, String guid, String qualifiedName, DeleteSemantic deleteSemantic)	Delete the Connection
VoidResponse	deleteConnection(String userId, String serverName, DeleteRequestBody requestBody)	Delete the Connection
void	deleteDatabase(String userId, String serverName, String externalSourceName, String guid, String qualifiedName, DeleteSemantic deleteSemantic)	Delete the Database with all the associated relational tables
VoidResponse	deleteDatabase(String userId, String serverName, DeleteRequestBody requestBody)	Delete the Database with all the associated relational tables
void	deleteDataFile(String userId, String serverName, String externalSourceName, String guid, String qualifiedName, DeleteSemantic deleteSemantic)	Delete the Data File with all the associated Tabular Columns
VoidResponse	deleteDataFile(String userId, String serverName, DeleteRequestBody requestBody)	Delete the Data File with all the associated Tabular Columns
void	deleteEndpoint(String userId, String serverName, String externalSourceName, String guid, String qualifiedName, DeleteSemantic deleteSemantic)	Delete the Endpoint
VoidResponse	deleteEndpoint(String userId, String serverName, DeleteRequestBody requestBody)	Delete the Endpoint
void	deleteExternalDataEngine(String userId, String serverName, String externalSourceName, String guid, String qualifiedName, DeleteSemantic deleteSemantic)	Delete the external data engine.
VoidResponse	deleteExternalDataEngine(String userId, String serverName, DeleteRequestBody requestBody)	Delete the external data engine.
void	deleteFolder(String userId, String serverName, String externalSourceName, String guid, String qualifiedName, DeleteSemantic deleteSemantic)	Delete the File Folder
VoidResponse	deleteFolder(String userId, String serverName, DeleteRequestBody requestBody)	Delete the File Folder
void	deletePort(String userId, String serverName, String externalSourceName, String guid, String qualifiedName, String portType, DeleteSemantic deleteSemantic)	Delete the Port with the associated schema type and relationships
VoidResponse	deletePort(String userId, String serverName, DeleteRequestBody requestBody, String portType)	Delete the Port with the associated schema type and relationships
void	deleteProcess(String userId, String serverName, String externalSourceName, String guid, String qualifiedName, DeleteSemantic deleteSemantic)
VoidResponse	deleteProcess(String userId, String serverName, DeleteRequestBody requestBody)	Delete a process, with the associated port implementations, port aliases and lineage mappings
void	deleteRelationalTable(String userId, String serverName, String externalSourceName, String guid, String qualifiedName, DeleteSemantic deleteSemantic)	Delete the Relational Table with all the associated Relational Columns
VoidResponse	deleteRelationalTable(String userId, String serverName, DeleteRequestBody requestBody)	Delete the Relational Table with all the associated Relational Columns
void	deleteSchemaType(String userId, String serverName, String externalSourceName, String guid, String qualifiedName, DeleteSemantic deleteSemantic)	Delete the SchemaType with schema attributes and corresponding relationships
VoidResponse	deleteSchemaType(String userId, String serverName, DeleteRequestBody requestBody)	Delete the SchemaType with schema attributes and corresponding relationships
Optional<EntityDetail>	getEntityDetails(String serverName, String userId, String qualifiedName, String typeName)	Get the entity details of an entity
Optional<String>	getEntityGUID(String serverName, String userId, String qualifiedName, String typeName)	Get the unique identifier of an entity
GUIDResponse	getExternalDataEngine(String serverName, String userId, String qualifiedName)	Get the unique identifier from a external data engine qualified name
ConnectionResponse	getInTopicConnection(String serverName, String userId)	Retrieve in topic connection details from the service instance hosting Data Engine access service
VoidResponse	updateProcessStatus(String userId, String serverName, String processGUID, InstanceStatus instanceStatus, String externalSourceName)
String	upsertDatabase(String userId, String serverName, Database database, String externalSourceName)	Create or update the Database with corresponding associated schema type and relationship
GUIDResponse	upsertDatabase(String userId, String serverName, DatabaseRequestBody databaseRequestBody)	Create or update the Database with corresponding associated schema type and relationship
String	upsertDataFile(String userId, String serverName, DataFile file, String externalSourceName)	Updates or inserts a DataFile or CSVFile, along with its schema, columns and folder hierarchy
GUIDResponse	upsertDataFile(String serverName, String userId, DataFileRequestBody dataFileRequestBody)	Updates or inserts a DataFile or CSVFile, along with its schema, columns and folder hierarchy
GUIDResponse	upsertPortAlias(String userId, String serverName, PortAliasRequestBody portAliasRequestBody)	Create or update the Port Alias with a PortDelegation relationship
String	upsertPortAliasWithDelegation(String userId, String serverName, PortAlias portAlias, String processGUID, String externalSourceName)	Create or update a Port Alias with a PortDelegation relationship
String	upsertPortImplementation(String userId, String serverName, PortImplementation portImplementation, String processGUID, String externalSourceName)	Create or update a Port Implementation with an associated SchemaType
GUIDResponse	upsertPortImplementation(String userId, String serverName, PortImplementationRequestBody portImplementationRequestBody)	Create or update the Port Implementation with a PortSchema relationship
GUIDResponse	upsertProcess(String userId, String serverName, Process process, String externalSourceName)	Create the process with ports, schema types and lineage mappings
GUIDResponse	upsertProcess(String userId, String serverName, ProcessRequestBody processRequestBody)	Create or update the process with ports, schema types and lineage mappings
String	upsertRelationalTable(String userId, String serverName, String databaseQualifiedName, RelationalTable relationalTable, String externalSourceName)	Create the Relational Table with Relational Columns and corresponding relationships
GUIDResponse	upsertRelationalTable(String userId, String serverName, RelationalTableRequestBody relationalTableRequestBody)	Create the Relational Table with Relational Columns and corresponding relationships
String	upsertSchemaType(String userId, String serverName, String portImplementationGUID, SchemaType schemaType, String externalSourceName)	Create or update a SchemaType
GUIDResponse	upsertSchemaType(String userId, String serverName, SchemaTypeRequestBody schemaTypeRequestBody)	Create the SchemaType with schema attributes and corresponding relationships

Methods inherited from class java.lang.Object

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

Field Detail

EXCEPTION_WHILE_ADDING_LINEAGE_MAPPING

public static final String EXCEPTION_WHILE_ADDING_LINEAGE_MAPPING

See Also:

Constant Field Values

EXCEPTION_WHILE_CREATING_PROCESS

public static final String EXCEPTION_WHILE_CREATING_PROCESS

See Also:

Constant Field Values

EXCEPTION_WHILE_CREATING_PROCESS_HIERARCHY

public static final String EXCEPTION_WHILE_CREATING_PROCESS_HIERARCHY

See Also:

Constant Field Values

Constructor Detail

DataEngineRESTServices

public DataEngineRESTServices()

Method Detail

createExternalDataEngine

public GUIDResponse createExternalDataEngine(String serverName,
                                             String userId,
                                             DataEngineRegistrationRequestBody requestBody)

Create the external data engine as software server capability entity

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

requestBody - properties of the server

Returns:

the unique identifier (guid) of the created external data engine

getExternalDataEngine

public GUIDResponse getExternalDataEngine(String serverName,
                                          String userId,
                                          String qualifiedName)

Get the unique identifier from a external data engine qualified name

Parameters:

serverName - name of the service to route the request to

userId - identifier of calling user

qualifiedName - qualified name of the external data engine

Returns:

the unique identifier from a software server capability definition for an external data engine

deleteExternalDataEngine

public VoidResponse deleteExternalDataEngine(String userId,
                                             String serverName,
                                             DeleteRequestBody requestBody)

Delete the external data engine. Not yet implemented, it will throw FunctionNotSupportedException if used

Parameters:

serverName - name of the service to route the request to

userId - identifier of calling user

requestBody - properties of the external data engine

Returns:

void response

deleteExternalDataEngine

public void deleteExternalDataEngine(String userId,
                                     String serverName,
                                     String externalSourceName,
                                     String guid,
                                     String qualifiedName,
                                     DeleteSemantic deleteSemantic)
                              throws InvalidParameterException,
                                     UserNotAuthorizedException,
                                     PropertyServerException,
                                     FunctionNotSupportedException

Delete the external data engine. Not yet implemented, it will throw FunctionNotSupportedException if used

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

externalSourceName - the unique name of the external source

guid - the unique identifier of the schema type

qualifiedName - the qualified name of the schema type

deleteSemantic - the delete semantic

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

FunctionNotSupportedException - the repository does not support this call.

getEntityGUID

public Optional<String> getEntityGUID(String serverName,
                                      String userId,
                                      String qualifiedName,
                                      String typeName)
                               throws InvalidParameterException,
                                      PropertyServerException,
                                      UserNotAuthorizedException

Get the unique identifier of an entity

Parameters:

serverName - name of the service to route the request to

userId - identifier of calling user

qualifiedName - qualified name of the port

typeName - the type name of the entity

Returns:

the unique identifier of the entity or empty optional

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

getEntityDetails

public Optional<EntityDetail> getEntityDetails(String serverName,
                                               String userId,
                                               String qualifiedName,
                                               String typeName)
                                        throws InvalidParameterException,
                                               PropertyServerException,
                                               UserNotAuthorizedException

Get the entity details of an entity

Parameters:

serverName - name of the service to route the request to

userId - identifier of calling user

qualifiedName - qualified name of the port

typeName - the type name of the entity

Returns:

the entity details of the entity or empty optional

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

upsertSchemaType

public GUIDResponse upsertSchemaType(String userId,
                                     String serverName,
                                     SchemaTypeRequestBody schemaTypeRequestBody)

Create the SchemaType with schema attributes and corresponding relationships

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

schemaTypeRequestBody - properties of the schema type

Returns:

the unique identifier (guid) of the created schema type

deleteSchemaType

public VoidResponse deleteSchemaType(String userId,
                                     String serverName,
                                     DeleteRequestBody requestBody)

Delete the SchemaType with schema attributes and corresponding relationships

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

requestBody - properties of the schema type

Returns:

void response

deleteSchemaType

public void deleteSchemaType(String userId,
                             String serverName,
                             String externalSourceName,
                             String guid,
                             String qualifiedName,
                             DeleteSemantic deleteSemantic)
                      throws InvalidParameterException,
                             UserNotAuthorizedException,
                             PropertyServerException,
                             FunctionNotSupportedException,
                             EntityNotDeletedException

Delete the SchemaType with schema attributes and corresponding relationships

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

externalSourceName - the unique name of the external source

guid - the unique identifier of the schema type

qualifiedName - the qualified name of the schema type

deleteSemantic - the delete semantic

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

FunctionNotSupportedException - the repository does not support this call.

EntityNotDeletedException - the entity could not be deleted

upsertPortImplementation

public GUIDResponse upsertPortImplementation(String userId,
                                             String serverName,
                                             PortImplementationRequestBody portImplementationRequestBody)

Create or update the Port Implementation with a PortSchema relationship

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

portImplementationRequestBody - properties of the port

Returns:

the unique identifier (guid) of the created port

upsertPortAlias

public GUIDResponse upsertPortAlias(String userId,
                                    String serverName,
                                    PortAliasRequestBody portAliasRequestBody)

Create or update the Port Alias with a PortDelegation relationship

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

portAliasRequestBody - properties of the port

Returns:

the unique identifier (guid) of the created port

deletePort

public VoidResponse deletePort(String userId,
                               String serverName,
                               DeleteRequestBody requestBody,
                               String portType)

Delete the Port with the associated schema type and relationships

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

requestBody - properties of the port

portType - the type of the port

Returns:

void response

deletePort

public void deletePort(String userId,
                       String serverName,
                       String externalSourceName,
                       String guid,
                       String qualifiedName,
                       String portType,
                       DeleteSemantic deleteSemantic)
                throws InvalidParameterException,
                       UserNotAuthorizedException,
                       PropertyServerException,
                       FunctionNotSupportedException,
                       EntityNotDeletedException

Delete the Port with the associated schema type and relationships

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

externalSourceName - the unique name of the external source

guid - the unique identifier of the port

qualifiedName - the qualified name of the port

portType - the port type

deleteSemantic - the delete semantic

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

FunctionNotSupportedException - the repository does not support this call.

EntityNotDeletedException - the entity could not be deleted

addProcessHierarchy

public GUIDResponse addProcessHierarchy(String userId,
                                        String serverName,
                                        ProcessHierarchyRequestBody processHierarchyRequestBody)

Add the provided ProcessHierarchy relationship

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

processHierarchyRequestBody - properties of the process hierarchy

Returns:

the unique identifier (guid) of the child of the process hierarchy that was updated

upsertProcess

public GUIDResponse upsertProcess(String userId,
                                  String serverName,
                                  ProcessRequestBody processRequestBody)

Create or update the process with ports, schema types and lineage mappings

Parameters:

userId - the name of the calling user

serverName - name of server instance to call

processRequestBody - properties of the process

Returns:

a list unique identifiers (GUIDs) of the created/updated process

deleteProcess

public VoidResponse deleteProcess(String userId,
                                  String serverName,
                                  DeleteRequestBody requestBody)

Delete a process, with the associated port implementations, port aliases and lineage mappings

Parameters:

userId - the name of the calling user

serverName - name of server instance to call

requestBody - properties of the processes

Returns:

void response

deleteProcess

public void deleteProcess(String userId,
                          String serverName,
                          String externalSourceName,
                          String guid,
                          String qualifiedName,
                          DeleteSemantic deleteSemantic)
                   throws InvalidParameterException,
                          UserNotAuthorizedException,
                          PropertyServerException,
                          FunctionNotSupportedException,
                          EntityNotDeletedException

Throws:

InvalidParameterException

UserNotAuthorizedException

PropertyServerException

FunctionNotSupportedException

EntityNotDeletedException

upsertPortAliasWithDelegation

public String upsertPortAliasWithDelegation(String userId,
                                            String serverName,
                                            PortAlias portAlias,
                                            String processGUID,
                                            String externalSourceName)
                                     throws InvalidParameterException,
                                            PropertyServerException,
                                            UserNotAuthorizedException

Create or update a Port Alias with a PortDelegation relationship

Parameters:

userId - the name of the calling user

serverName - name of server instance to call

portAlias - the port alias values

processGUID - the unique identifier of the process

externalSourceName - the unique name of the external source

Returns:

the unique identifier (guid) of the created port alias

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

addProcessHierarchyToProcess

public String addProcessHierarchyToProcess(String userId,
                                           String serverName,
                                           ProcessHierarchy processHierarchy,
                                           String externalSourceName)
                                    throws InvalidParameterException,
                                           PropertyServerException,
                                           UserNotAuthorizedException

Add a a ProcessHierarchy relationship to the process

Parameters:

userId - the name of the calling user

serverName - name of server instance to call

processHierarchy - the process hierarchy values

externalSourceName - the unique name of the external source

Returns:

the unique identifier (guid) of the child of the process hierarchy that was updated

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

upsertPortImplementation

public String upsertPortImplementation(String userId,
                                       String serverName,
                                       PortImplementation portImplementation,
                                       String processGUID,
                                       String externalSourceName)
                                throws InvalidParameterException,
                                       PropertyServerException,
                                       UserNotAuthorizedException,
                                       FunctionNotSupportedException

Create or update a Port Implementation with an associated SchemaType

Parameters:

userId - the name of the calling user

serverName - name of server instance to call

portImplementation - the port implementation values

processGUID - the unique identifier of the process

externalSourceName - the unique name of the external source

Returns:

the unique identifier (guid) of the created port alias

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

FunctionNotSupportedException - the repository does not support this call.

createExternalDataEngine

public String createExternalDataEngine(String userId,
                                       String serverName,
                                       SoftwareServerCapability softwareServerCapability)
                                throws InvalidParameterException,
                                       PropertyServerException,
                                       UserNotAuthorizedException

Create the external data engine as software server capability entity

Parameters:

userId - the name of the calling user

serverName - name of server instance to call

softwareServerCapability - the software server values

Returns:

he unique identifier (guid) of the created external data engine

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

addLineageMappings

public void addLineageMappings(String userId,
                               String serverName,
                               List<LineageMapping> lineageMappings,
                               FFDCResponseBase response,
                               String externalSourceName)
                        throws InvalidParameterException,
                               PropertyServerException,
                               UserNotAuthorizedException

Create LineageMappings relationships between schema attributes

Parameters:

userId - the name of the calling user

serverName - name of server instance to call

lineageMappings - the list of lineage mappings to be created

response - the response object that will capture the exceptions that might occur during parallel processing

externalSourceName - the unique name of the external source

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

addLineageMappings

public VoidResponse addLineageMappings(String userId,
                                       String serverName,
                                       LineageMappingsRequestBody lineageMappingsRequestBody)

Create LineageMappings relationships between schema attributes

Parameters:

userId - the name of the calling user

serverName - ame of server instance to call

lineageMappingsRequestBody - list of lineage mappings

Returns:

void response

getInTopicConnection

public ConnectionResponse getInTopicConnection(String serverName,
                                               String userId)

Retrieve in topic connection details from the service instance hosting Data Engine access service

Parameters:

serverName - the name of server instance to call

userId - the name/identifier of the calling user

Returns:

OCF API ConnectionResponse object describing the details for the input topic connection used or InvalidParameterException one of the parameters is null or invalid or UserNotAuthorizedException user not authorized to issue this request or PropertyServerException problem retrieving the discovery engine definition

upsertSchemaType

public String upsertSchemaType(String userId,
                               String serverName,
                               String portImplementationGUID,
                               SchemaType schemaType,
                               String externalSourceName)
                        throws InvalidParameterException,
                               UserNotAuthorizedException,
                               PropertyServerException

Create or update a SchemaType

Parameters:

userId - the name of the calling user

serverName - name of server instance to call

portImplementationGUID - the unique identifier of the port implementation

schemaType - the schema type values

externalSourceName - the unique name of the external source

Returns:

the unique identifier (guid) of the created schema type

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

upsertDatabase

public GUIDResponse upsertDatabase(String userId,
                                   String serverName,
                                   DatabaseRequestBody databaseRequestBody)

Create or update the Database with corresponding associated schema type and relationship

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

databaseRequestBody - properties of the database

Returns:

the unique identifier (guid) of the created database

upsertDatabase

public String upsertDatabase(String userId,
                             String serverName,
                             Database database,
                             String externalSourceName)
                      throws InvalidParameterException,
                             UserNotAuthorizedException,
                             PropertyServerException

Create or update the Database with corresponding associated schema type and relationship

Parameters:

userId - the name of the calling user

serverName - name of server instance to call

database - the database values

externalSourceName - the unique name of the external source

Returns:

the unique identifier (guid) of the created database

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

deleteDatabase

public VoidResponse deleteDatabase(String userId,
                                   String serverName,
                                   DeleteRequestBody requestBody)

Delete the Database with all the associated relational tables

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

requestBody - properties of the database

Returns:

void response

deleteDatabase

public void deleteDatabase(String userId,
                           String serverName,
                           String externalSourceName,
                           String guid,
                           String qualifiedName,
                           DeleteSemantic deleteSemantic)
                    throws InvalidParameterException,
                           PropertyServerException,
                           UserNotAuthorizedException,
                           EntityNotDeletedException,
                           FunctionNotSupportedException

Delete the Database with all the associated relational tables

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

externalSourceName - the unique name of the external source

guid - the unique identifier of the database

qualifiedName - the qualified name of the database

deleteSemantic - the delete semantic

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

FunctionNotSupportedException - the repository does not support this call.

EntityNotDeletedException - the entity could not be deleted

upsertRelationalTable

public GUIDResponse upsertRelationalTable(String userId,
                                          String serverName,
                                          RelationalTableRequestBody relationalTableRequestBody)

Create the Relational Table with Relational Columns and corresponding relationships

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

relationalTableRequestBody - properties of the relational table

Returns:

the unique identifier (guid) of the created relational table

upsertRelationalTable

public String upsertRelationalTable(String userId,
                                    String serverName,
                                    String databaseQualifiedName,
                                    RelationalTable relationalTable,
                                    String externalSourceName)
                             throws InvalidParameterException,
                                    UserNotAuthorizedException,
                                    PropertyServerException

Create the Relational Table with Relational Columns and corresponding relationships

Parameters:

userId - the name of the calling user

serverName - name of server instance to call

databaseQualifiedName - the unique name of the database

relationalTable - the relational table values

externalSourceName - the unique name of the external source

Returns:

the unique identifier (guid) of the created relational table

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

deleteRelationalTable

public VoidResponse deleteRelationalTable(String userId,
                                          String serverName,
                                          DeleteRequestBody requestBody)

Delete the Relational Table with all the associated Relational Columns

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

requestBody - properties of the relational table

Returns:

void response

deleteRelationalTable

public void deleteRelationalTable(String userId,
                                  String serverName,
                                  String externalSourceName,
                                  String guid,
                                  String qualifiedName,
                                  DeleteSemantic deleteSemantic)
                           throws InvalidParameterException,
                                  PropertyServerException,
                                  UserNotAuthorizedException,
                                  EntityNotDeletedException,
                                  FunctionNotSupportedException

Delete the Relational Table with all the associated Relational Columns

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

externalSourceName - the unique name of the external source

guid - the unique identifier of the relational table

qualifiedName - the qualified name of the relational table

deleteSemantic - the delete semantic

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

FunctionNotSupportedException - the repository does not support this call.

EntityNotDeletedException - the entity could not be deleted

upsertDataFile

public GUIDResponse upsertDataFile(String serverName,
                                   String userId,
                                   DataFileRequestBody dataFileRequestBody)

Updates or inserts a DataFile or CSVFile, along with its schema, columns and folder hierarchy

Parameters:

userId - the name of the calling user

serverName - name of server instance to call

dataFileRequestBody - properties of the data file

Returns:

the unique identifier (guid) of the created data file

upsertDataFile

public String upsertDataFile(String userId,
                             String serverName,
                             DataFile file,
                             String externalSourceName)
                      throws InvalidParameterException,
                             UserNotAuthorizedException,
                             PropertyServerException

Updates or inserts a DataFile or CSVFile, along with its schema, columns and folder hierarchy

Parameters:

userId - the name of the calling user

serverName - name of server instance to call

file - the data file properties

externalSourceName - the unique name of the external source

Returns:

the unique identifier (guid) of the created data file

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

deleteDataFile

public VoidResponse deleteDataFile(String userId,
                                   String serverName,
                                   DeleteRequestBody requestBody)

Delete the Data File with all the associated Tabular Columns

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

requestBody - properties of the data file

Returns:

void response

deleteDataFile

public void deleteDataFile(String userId,
                           String serverName,
                           String externalSourceName,
                           String guid,
                           String qualifiedName,
                           DeleteSemantic deleteSemantic)
                    throws InvalidParameterException,
                           PropertyServerException,
                           EntityNotDeletedException,
                           UserNotAuthorizedException,
                           FunctionNotSupportedException

Delete the Data File with all the associated Tabular Columns

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

externalSourceName - the unique name of the external source

guid - the unique identifier of the data file

qualifiedName - the qualified name of the data file

deleteSemantic - the delete semantic

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

FunctionNotSupportedException - the repository does not support this call.

EntityNotDeletedException - the entity could not be deleted

deleteFolder

public VoidResponse deleteFolder(String userId,
                                 String serverName,
                                 DeleteRequestBody requestBody)

Delete the File Folder

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

requestBody - properties of the folder

Returns:

void response

deleteFolder

public void deleteFolder(String userId,
                         String serverName,
                         String externalSourceName,
                         String guid,
                         String qualifiedName,
                         DeleteSemantic deleteSemantic)
                  throws InvalidParameterException,
                         PropertyServerException,
                         UserNotAuthorizedException,
                         EntityNotDeletedException,
                         FunctionNotSupportedException

Delete the File Folder

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

externalSourceName - the unique name of the external source

guid - the unique identifier of the folder

qualifiedName - the qualified name of the folder

deleteSemantic - the delete semantic

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

FunctionNotSupportedException - the repository does not support this call

EntityNotDeletedException - the entity could not be deleted

deleteConnection

public VoidResponse deleteConnection(String userId,
                                     String serverName,
                                     DeleteRequestBody requestBody)

Delete the Connection

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

requestBody - properties of the connection

Returns:

void response

deleteConnection

public void deleteConnection(String userId,
                             String serverName,
                             String externalSourceName,
                             String guid,
                             String qualifiedName,
                             DeleteSemantic deleteSemantic)
                      throws InvalidParameterException,
                             PropertyServerException,
                             EntityNotDeletedException,
                             UserNotAuthorizedException,
                             FunctionNotSupportedException

Delete the Connection

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

externalSourceName - the unique name of the external source

guid - the unique identifier of the connection

qualifiedName - the qualified name of the connection

deleteSemantic - the delete semantic

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

FunctionNotSupportedException - the repository does not support this call.

EntityNotDeletedException - the entity could not be deleted

deleteEndpoint

public VoidResponse deleteEndpoint(String userId,
                                   String serverName,
                                   DeleteRequestBody requestBody)

Delete the Endpoint

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

requestBody - properties of the endpoint

Returns:

void response

deleteEndpoint

public void deleteEndpoint(String userId,
                           String serverName,
                           String externalSourceName,
                           String guid,
                           String qualifiedName,
                           DeleteSemantic deleteSemantic)
                    throws InvalidParameterException,
                           PropertyServerException,
                           EntityNotDeletedException,
                           UserNotAuthorizedException,
                           FunctionNotSupportedException

Delete the Endpoint

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

externalSourceName - the unique name of the external source

guid - the unique identifier of the endpoint

qualifiedName - the qualified name of the endpoint

deleteSemantic - the delete semantic

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

FunctionNotSupportedException - the repository does not support this call.

EntityNotDeletedException - the entity could not be deleted

updateProcessStatus

public VoidResponse updateProcessStatus(String userId,
                                        String serverName,
                                        String processGUID,
                                        InstanceStatus instanceStatus,
                                        String externalSourceName)

upsertProcess

public GUIDResponse upsertProcess(String userId,
                                  String serverName,
                                  Process process,
                                  String externalSourceName)

Create the process with ports, schema types and lineage mappings

Parameters:

serverName - name of server instance to call

userId - the name of the calling user

process - properties of the process

Returns:

the unique identifier (guid) of the created process