

# Search and discover data
<a name="catalog-iam-discover-search"></a>

The **Data** tab in your project shows only the tables your project already has access to. To find tables across the entire domain, including tables you don't have access to yet, you use catalog search. Catalog search matches against table names, business names, descriptions, and business glossary terms. Results show each table's metadata and business context, so you can evaluate whether a table is relevant before requesting access to it.

From the search results, you can open the full search results page to browse and filter across all matches, view an asset's detail page to see its schema and documentation, or request access to a table directly.

You can search from anywhere in Amazon SageMaker Unified Studio using the search bar at the top of the page. As you type, a dropdown shows matching results with the table name, business name, catalog path, and asset type. You can choose a result directly from the dropdown to open its detail page, or choose **Show all results** to open the full search results page.

![Search bar dropdown showing instant results with table name, business name, catalog path, and asset type](http://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/images/search/search-dropdown.png)


## Search results page
<a name="catalog-iam-search-results-page"></a>

The full search results page shows all matching assets. Each result shows the table name, last updated date, business name, catalog path, asset type, and any glossary terms associated with the table. The page includes category filters at the top (such as **All**, **Assets**, and **Models**) and a view toggle to switch between list and grid layouts.

From the search results, you can take the following actions on each result.
+ **Subscribe** appears on tables you do not yet have access to. Choose it to request a subscription.
+ **Query** appears on tables where your subscription has already been approved. Choose it to open the table in the query editor.

![Full search results page showing tables with Subscribe and Query buttons, glossary terms, and category filters](http://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/images/search/search-results-full.png)


**Note**  
To view the actual data in a table, you must first subscribe to it and have your request approved. Search results show table names and metadata regardless of whether you have access to the underlying data.

## Filter search results
<a name="catalog-iam-filter-search-results"></a>

The search results page includes filters that help you narrow results. To access filters, choose the **Assets** category pill on the results page. A **Filters** panel appears.

The filters are dynamic. They are generated based on the actual items in your search results. For example, if the tables in your results have business glossary terms or metadata form fields attached to them, those terms and fields automatically appear as filter options. This means the available filters change depending on what you search for.

The filters panel includes standard options such as whether the result is a table or a view, and when it was last updated. Beyond those, you will see glossary terms and metadata form fields that are present on the tables in the current result set. To apply a filter, choose the value you want to filter by in the panel. To remove all active filters, choose **Clear all**.

### Custom filters
<a name="catalog-iam-custom-filters"></a>

In addition to the dynamic filters, you can create custom filters when you know something specific about the data you're looking for, such as what the name or description contains. Custom filters let you match against table properties that aren't surfaced as dynamic filter options.

**To add a custom filter**

1. Open your project in Amazon SageMaker Unified Studio.

1. In the search bar at the top of the page, enter your search query and choose **Show all results for "[query]"**.

1. On the search results page, choose the **Assets** pill at the top.

1. In the **Filters** panel, choose **Add** next to **Custom**.

1. For **Filter type**, choose **Name**, **Description**, or **Metadata form**.

1. For **Operator**, choose **Contains**.

1. For **Value**, enter the text you want to match.

1. (Optional) Choose **\+ Add condition** to add more conditions.

1. Choose **Save** to apply the filter.

## View an asset's detail page
<a name="catalog-iam-asset-detail-page"></a>

When you choose an asset from the search results, the asset detail page opens. This page shows the table's business name, description, and a **Subscribe** button in the top-right corner. The detail page has the following tabs.


**Asset detail page tabs**  

| Tab | When to use it | 
| --- | --- | 
| Overview | Shows the asset's summary, glossary terms associated with the table, README documentation, and additional metadata added by the owner to the asset. | 
| Schema | Shows each column's name, data type, description, glossary terms, and additional metadata added by the owner to the column. | 
| Data quality | Shows data quality rules and their results for the table, if data quality has been configured by the table owner. | 

![Asset detail page from search showing a table with Overview, Schema, and Data quality tabs and the Subscribe button](http://docs.aws.amazon.com/sagemaker-unified-studio/latest/userguide/images/search/search-asset-detail.png)
