Cloudera Docs

Using Basic Search

Basic Search allows you to find entities by type, classification, term, or text, using filters to refine results. It supports logical conditions, partial matches, and attribute-specific searches. Saved searches enable quick reuse for frequent queries.

With Basic Search, Atlas returns all of the entities of the type you select.

There are multiple ways you can define a Basic Search. Setting a value in more than one search field builds a logical AND condition for the search. To repeat the same search, click the Refresh button.

Figure 1. Basic search with classification and glossary term filters
Entities
When using the New User Interface, all entity types with available assets are listed by default in the Basic Search view in a flat or grouped tree. Clicking any type starts a search filtered to the specific entity type.
Figure 2. Search by entity types
Choose _ALL_ENTITY_TYPES to apply an attribute filter for all entity types.
Clicking the icon refreshes the list of types. Selecting the radio button shows all Atlas supported entity types, not only those with assets.
Classifications
All classifications that are assigned to assets are listed by default. Clicking any classification starts a search filtered to the specific classification.
Figure 3. Search by classifications
Clicking the icon refreshes the list of classifications. Selecting the radio button shows all available classifications, not only those with assigned assets.
Business MetaData
You can access your business metadata sets from the Basic Search menu.
Figure 4. Business metadata sets
Glossary
All glossary terms are listed by default. Clicking any terms starts a search filtered to the specific term.
Figure 5. Search by glossary terms
Clicking the icon refreshes the list of terms. Selecting the radio button shows only the available glossary categories.
Search Entities, Classifications Glossaries by text
You can quickly filter your available Entities, Classifications Glossaries by typing in a name of an element.
Figure 6. Filtering Hive entities
Filters
You can add additional filters combined with logical operators to your entity, classification and glossary terms filter conditions.
  • Operator for filter conditions:
    • AND
    • OR
  • Operators for value conditions:
    • String conditions: =, !=, contains, begins_with, ends_with, is_null, not_null
    • Date conditions: =, !=, >, <, >=, <=, Time Range, is_null, not_null
    • Boolean conditions: =, !=, is_null, not_null
Figure 7. Additional filters
Custom Filters

You can also save your search conditions as Custom Filters by clicking Save Filter.

Columns
You can select further column values for your search results to display. The available values depend on the result types.
Figure 8. Column values
Search By Type
  • Choose an entity type to limit the search.
  • Choose _ALL_ENTITY_TYPES to apply an attribute filter for all entity types.
Figure 9. Basic entity search
Search By Type and specify attribute values using the Entity Attribute Filter

The Attribute Filter dialog box lists all the attributes that correspond to the selected entity type, including:

  • Technical attributes specific to the entity type
  • System attributes, including classifications, labels, and user-defined properties
  • Business Metadata attributes
  • Terms
Figure 10. Entity Attribute Filter options
Search By Classification
  • Choose an existing classification; the search returns all entities that have that classification assigned to them.
  • Choose _ALL_CLASSIFICATION_TYPES to apply an attribute filter across all classifications.
  • Choose _CLASSIFIED or _NOT_CLASSIFIED with an entity type selected to find entities of that type with any or no classifications assigned.
Search By Classification and specify attribute values using the Filter
The Attribute Filter dialog box lists all the attributes for the selected classification; set a value to one or more attributes to define the search. You can choose to match partial strings using the "contains", "begins with", and "ends with" operators.
Search by Term
Choose an existing glossary term. Enter the first few letters to select a term from a list of matching terms. This filter is case-sensitive.
Search by Text
Search on string values for technical, system, Business Metadata, and classification attribute values. Labels and terms are also included. This search is the same as the Free-Text search; note that when you enter text in the Free-Text search box, it fills in this Search By Text field also.
Columns
You can select further column values for your search results to display. The available values depend on the result types.
Figure 11. Column values
Favorite Searches

You can also save your search conditions as Favorite Searches.