use of org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException in project egeria-connector-sas-viya by odpi.
the class MetadataCollection method getEntityNeighborhood.
/**
* Return the entities and relationships that radiate out from the supplied entity GUID.
* The results are scoped both the instance type guids and the level.
*
* @param userId unique identifier for requesting user.
* @param entityGUID the starting point of the query.
* @param entityTypeGUIDs list of entity types to include in the query results. Null means include
* all entities found, irrespective of their type.
* @param relationshipTypeGUIDs list of relationship types to include in the query results. Null means include
* all relationships found, irrespective of their type.
* @param limitResultsByStatus By default, relationships in all non-DELETED statuses are returned. However, it is possible
* to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all
* status values except DELETED.
* @param limitResultsByClassification List of classifications that must be present on all returned entities.
* @param asOfTime Requests a historical query of the relationships for the entity. Null means return the
* present values.
* @param level the number of the relationships out from the starting entity that the query will traverse to
* gather results.
* @return InstanceGraph the sub-graph that represents the returned linked entities and their relationships.
* @throws InvalidParameterException one of the parameters is invalid or null.
* @throws TypeErrorException the type guid passed on the request is not known by the
* metadata collection.
* @throws RepositoryErrorException there is a problem communicating with the metadata repository where
* the metadata collection is stored.
* @throws EntityNotKnownException the entity identified by the entityGUID is not found in the metadata collection.
* @throws PropertyErrorException there is a problem with one of the other parameters.
* @throws FunctionNotSupportedException the repository does not support this call.
* @throws UserNotAuthorizedException the userId is not permitted to perform this operation.
*/
@Override
public InstanceGraph getEntityNeighborhood(String userId, String entityGUID, List<String> entityTypeGUIDs, List<String> relationshipTypeGUIDs, List<InstanceStatus> limitResultsByStatus, List<String> limitResultsByClassification, Date asOfTime, int level) throws InvalidParameterException, TypeErrorException, RepositoryErrorException, EntityNotKnownException, PropertyErrorException, FunctionNotSupportedException, UserNotAuthorizedException {
final String methodName = "getEntityNeighborhood";
/*
* Validate parameters
*/
this.getEntityNeighborhoodParameterValidation(userId, entityGUID, entityTypeGUIDs, relationshipTypeGUIDs, limitResultsByStatus, limitResultsByClassification, asOfTime, level);
InstanceGraph instanceGraph = new InstanceGraph();
try {
List<Relationship> relationships = getRelationshipsForEntity(userId, entityGUID, null, 0, limitResultsByStatus, asOfTime, null, null, 0);
if (relationships == null) {
return instanceGraph;
}
List<EntityDetail> entityList = new ArrayList<EntityDetail>(1);
// Getting a unique set of GUIDs to retrieve the entity details
Set<String> entitiesToRetrieve = new HashSet<String>();
// entitiesToRetrieve.add(entityGUID); //the original entitiy
for (Relationship r : relationships) {
// Right now getEntityDetail returns a prefix but it is not consistent which one.
// This needs to be looked at but for now, I want to make sure we are
// only retriving an object one time.
SASCatalogGuid sasCatalogGuid = SASCatalogGuid.fromGuid(r.getEntityOneProxy().getGUID());
entitiesToRetrieve.add(sasCatalogGuid.getSASCatalogGuid());
sasCatalogGuid = SASCatalogGuid.fromGuid(r.getEntityTwoProxy().getGUID());
entitiesToRetrieve.add(sasCatalogGuid.getSASCatalogGuid());
}
for (String entityId : entitiesToRetrieve) {
entityList.add(getEntityDetail(userId, entityId));
}
instanceGraph.setEntities(entityList);
instanceGraph.setRelationships(relationships);
} catch (PagingErrorException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return instanceGraph;
}
use of org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException in project egeria-connector-sas-viya by odpi.
the class MetadataCollection method getRelationshipsForEntity.
@Override
public List<Relationship> getRelationshipsForEntity(String userId, String entityGUID, String relationshipTypeGUID, int fromRelationshipElement, List<InstanceStatus> limitResultsByStatus, Date asOfTime, String sequencingProperty, SequencingOrder sequencingOrder, int pageSize) throws InvalidParameterException, TypeErrorException, RepositoryErrorException, EntityNotKnownException, PagingErrorException, FunctionNotSupportedException, UserNotAuthorizedException {
final String methodName = "getRelationshipsForEntity";
getRelationshipsForEntityParameterValidation(userId, entityGUID, relationshipTypeGUID, fromRelationshipElement, limitResultsByStatus, asOfTime, sequencingProperty, sequencingOrder, pageSize);
List<Relationship> alRelationships = null;
// Immediately throw unimplemented exception if trying to retrieve historical view or sequence by property
if (asOfTime != null) {
raiseFunctionNotSupportedException(ErrorCode.NO_HISTORY, methodName, repositoryName);
} else if (limitResultsByStatus == null || (limitResultsByStatus.size() == 1 && limitResultsByStatus.contains(InstanceStatus.ACTIVE))) {
// Otherwise, only bother searching if we are after ACTIVE (or "all") entities -- non-ACTIVE means we
// will just return an empty list
// Guid cannot be null here, as validation above ensures it is non-null
SASCatalogGuid sasCatalogGuid = SASCatalogGuid.fromGuid(entityGUID);
String prefix = sasCatalogGuid.getGeneratedPrefix();
// 1. retrieve entity from Catalog by GUID (and its relationships)
SASCatalogObject asset = null;
List<SASCatalogObject> relationships = null;
try {
asset = repositoryConnector.getEntityByGUID(sasCatalogGuid.getSASCatalogGuid());
relationships = repositoryConnector.getRelationshipsForEntity(sasCatalogGuid.getSASCatalogGuid());
} catch (Exception e) {
raiseEntityNotKnownException(ErrorCode.ENTITY_NOT_KNOWN, methodName, e, entityGUID, methodName, repositoryName);
}
// Ensure the entity actually exists (if not, throw error to that effect)
if (asset == null || relationships == null) {
raiseEntityNotKnownException(ErrorCode.ENTITY_NOT_KNOWN, methodName, null, entityGUID, methodName, repositoryName);
} else {
EntityMappingSASCatalog2OMRS entityMap = new EntityMappingSASCatalog2OMRS(repositoryConnector, typeDefStore, attributeTypeDefStore, asset, prefix, userId);
// 2. Apply the mapping to the object, and retrieve the resulting relationships
alRelationships = entityMap.getRelationships(relationships, relationshipTypeGUID, fromRelationshipElement, sequencingProperty, sequencingOrder, pageSize);
}
}
return alRelationships;
}
use of org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException in project egeria-connector-sas-viya by odpi.
the class MetadataCollection method findEntitiesByPropertyValue.
@Override
public List<EntityDetail> findEntitiesByPropertyValue(String userId, String entityTypeGUID, String searchCriteria, int fromEntityElement, List<InstanceStatus> limitResultsByStatus, List<String> limitResultsByClassification, Date asOfTime, String sequencingProperty, SequencingOrder sequencingOrder, int pageSize) throws InvalidParameterException, TypeErrorException, RepositoryErrorException, PropertyErrorException, PagingErrorException, FunctionNotSupportedException, UserNotAuthorizedException {
final String methodName = "findEntitiesByPropertyValue";
findEntitiesByPropertyValueParameterValidation(userId, entityTypeGUID, searchCriteria, fromEntityElement, limitResultsByStatus, limitResultsByClassification, asOfTime, sequencingProperty, sequencingOrder, pageSize);
List<Instance> results = new ArrayList<Instance>();
// Immediately throw unimplemented exception if trying to retrieve historical view
if (asOfTime != null) {
raiseFunctionNotSupportedException(ErrorCode.NO_HISTORY, methodName, repositoryName);
}
// Search criteria is not allowed to be empty for this method, so cannot be null or empty string.
if (!searchCriteria.isEmpty()) {
// Otherwise we need to do an OR-based search across all string properties in Atlas, using whatever the
// regex of searchCriteria contains for each property
// Add all textual properties of the provided entity as matchProperties,
// for an OR-based search of their values
Map<String, Map<String, String>> mappingsToSearch = new HashMap<>();
if (entityTypeGUID != null) {
// We are searching for a particular entity type, get the associated mappings
mappingsToSearch = getMappingsToSearch(entityTypeGUID, userId);
} else {
// We are searching across all entity types, get all mappings
// We will need to send the request only once, so we'll only use the first mapping
mappingsToSearch = typeDefStore.getAllOmrsNameToCatalogNameMappings();
}
for (Map.Entry<String, Map<String, String>> entryToSearch : mappingsToSearch.entrySet()) {
InstanceProperties matchProperties = new InstanceProperties();
String omrsTypeName = entryToSearch.getKey();
String omrsTypeGUID = typeDefStore.getTypeDefByName(omrsTypeName).getGUID();
Map<String, TypeDefAttribute> typeDefAttributeMap = typeDefStore.getAllTypeDefAttributesForName(omrsTypeName);
if (typeDefAttributeMap != null) {
// This will look at all OMRS attributes, but buildAndRunDSLSearch (later) should limit to only those mapped to catalog
for (Map.Entry<String, TypeDefAttribute> attributeEntry : typeDefAttributeMap.entrySet()) {
String attributeName = attributeEntry.getKey();
// Only supporting search by name value for now
if (attributeName.equals("qualifiedName")) {
TypeDefAttribute typeDefAttribute = attributeEntry.getValue();
// Only need to retain string-based attributes for the full text search
AttributeTypeDef attributeTypeDef = typeDefAttribute.getAttributeType();
if (attributeTypeDef.getCategory().equals(AttributeTypeDefCategory.PRIMITIVE)) {
PrimitiveDefCategory primitiveDefCategory = ((PrimitiveDef) attributeTypeDef).getPrimitiveDefCategory();
if (primitiveDefCategory.equals(PrimitiveDefCategory.OM_PRIMITIVE_TYPE_STRING) || primitiveDefCategory.equals(PrimitiveDefCategory.OM_PRIMITIVE_TYPE_BYTE) || primitiveDefCategory.equals(PrimitiveDefCategory.OM_PRIMITIVE_TYPE_CHAR)) {
matchProperties = repositoryHelper.addStringPropertyToInstance(repositoryName, matchProperties, attributeName, searchCriteria, methodName);
} else {
log.debug("Skipping inclusion of non-string attribute: {}", attributeName);
}
} else {
log.debug("Skipping inclusion of non-string attribute: {}", attributeName);
}
}
}
}
List<Instance> innerResults = new ArrayList<Instance>();
try {
innerResults = buildAndRunDSLSearch(methodName, entityTypeGUID, omrsTypeGUID, limitResultsByClassification, matchProperties, MatchCriteria.ANY, fromEntityElement, limitResultsByStatus, sequencingProperty, sequencingOrder, pageSize, userId);
} catch (Exception e) {
log.error("Exception from findEntitiesByPropertyValue inner search for omrsTypeName {}: {}", omrsTypeName, e.getMessage());
}
if (innerResults != null) {
results.addAll(innerResults);
}
// so can break out of the loop
if (entityTypeGUID == null) {
break;
}
}
}
List<EntityDetail> entityDetails = null;
if (results != null) {
entityDetails = sortAndLimitFinalResults(results, entityTypeGUID, fromEntityElement, sequencingProperty, sequencingOrder, pageSize, userId);
}
return (entityDetails == null || entityDetails.isEmpty()) ? null : entityDetails;
}
Aggregations