> For the complete documentation index, see [llms.txt](https://whiteklay.gitbook.io/virtual-data-assistant/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whiteklay.gitbook.io/virtual-data-assistant/how-to-guides/data-catalog/data-discovery.md).

# Data Discovery

VDA offers powerful and comprehensive data exploration capabilities, allowing users to efficiently locate and access the data they need. This functionality supports searches based on various criteria, including table names, column names, database names, schema names, and tags associated with tables. Here’s a detailed overview of these search capabilities:&#x20;

#### Table Search&#x20;

Description: Allows users to search for data by specifying the table name.&#x20;

Use Case: Ideal for users who know the specific table they need to access or analyze.&#x20;

Example: A user can quickly locate the "Bank" table to review the data&#x20;

Benefit: Streamlines the process of finding relevant tables, saving time and effort.&#x20;

<img src="https://803373986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEZ25VHhdl67JelwmVtBp%2Fuploads%2FlnHzmgya5nnWX7RGfFk7%2Funknown.png?alt=media&amp;token=348e64b6-f558-4634-8ee9-e6c4afc35785" alt="" height="381" width="664">

#### Column Search&#x20;

Description: Enables users to search within tables based on column names.&#x20;

Use Case: Useful when users are looking for specific data attributes or fields across multiple tables.&#x20;

Example: A user searching for "card" can find all tables containing this column.&#x20;

Benefit: Facilitates detailed and targeted data searches, enhancing data discovery.&#x20;

<img src="https://803373986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEZ25VHhdl67JelwmVtBp%2Fuploads%2FUYlnD2m7i0ccFsm665nh%2Funknown.png?alt=media&amp;token=a974e845-d217-4958-abf1-33ca7a56a2eb" alt="" height="319" width="664">

#### Database Search&#x20;

Description: Supports searches by database names(Ex. postgres, Oracle etc), helping users locate data within specific databases.&#x20;

Use Case: Essential for organizations with multiple databases, allowing users to focus their search on a particular database.&#x20;

Example: A user can search for the "postgres" to find all relevant tables and datasets within this type of database.&#x20;

Benefit: Simplifies navigation through large, complex data environments by narrowing down search scope.&#x20;

<img src="https://803373986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEZ25VHhdl67JelwmVtBp%2Fuploads%2FW8uGn8y3GcB04F1padm1%2Funknown.png?alt=media&amp;token=ed7d711f-a3a9-4a1a-83ac-a3432344f7bf" alt="" height="209" width="664">

#### Schema Search&#x20;

Description: Allows users to search based on schema names within a database.&#x20;

Use Case: Beneficial for users who need to access data organized under specific schemas.&#x20;

Example: Searching for the "public" schema will return all tables and objects within that schema.&#x20;

Benefit: Provides an organized view of data structures, making it easier to locate data assets.&#x20;

<img src="https://803373986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEZ25VHhdl67JelwmVtBp%2Fuploads%2FgHgz1upOS9gPpQUu7aW5%2Funknown.png?alt=media&amp;token=280dd162-c723-45ae-9116-144b7bd025f7" alt="" height="316" width="664">

#### Tag-Based Search&#x20;

Description: Enables searches using tags associated with tables, allowing for thematic or categorical searches.&#x20;

Use Case: Useful for users who categorize data tables with tags such as "financial," "archived," or "sensitive."&#x20;

Example: A user searching for the tag "sensitive" will find all tables marked as containing sensitive information.&#x20;

Benefit: Enhances data organization and discoverability, enabling users to find data based on specific characteristics or purposes.&#x20;

<img src="https://803373986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEZ25VHhdl67JelwmVtBp%2Fuploads%2FpofpRRJ7JGbs6g75LveG%2Funknown.png?alt=media&amp;token=7ceda63c-650e-475e-ba8d-44d95fcc4ced" alt="" height="316" width="664">

<img src="https://803373986-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEZ25VHhdl67JelwmVtBp%2Fuploads%2F95ALS3rcYtU6YTdOYWGd%2Funknown.png?alt=media&amp;token=8c3d729b-82ab-4b1c-a293-d909b63c38fd" alt="" height="329" width="664">

### Data Exploration Benefits&#x20;

Efficiency: The ability to search based on table, column, database, schema, and tags significantly reduces the time spent locating specific data.&#x20;

Comprehensiveness: By supporting multiple search criteria, the VDA tool ensures that users can find exactly what they need, regardless of their starting point or the detail they have.&#x20;

Usability: A user-friendly search interface allows both technical and non-technical users to perform searches with ease, promoting wider adoption and usage.&#x20;

Data Discovery: Enhanced search capabilities foster better data discovery, enabling users to uncover hidden insights and relationships within the data.&#x20;

Organization: Helps maintain a well-organized data environment, where data assets are easily accessible and efficiently categorized.&#x20;

&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://whiteklay.gitbook.io/virtual-data-assistant/how-to-guides/data-catalog/data-discovery.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
