Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The OneLake catalog module helps you find existing Fabric data items, such as lakehouses and databases, and review their context before connecting. You can also access the catalog through integrations outside the Fabric application.
Use Search, the available views, or Filter to narrow the list. To distinguish items with similar names, review the item's type, owner, location, and available endorsement or sensitivity information. Controls and supported item types can vary by host.
Catalog visibility, favorites, and endorsement don't grant data access. You still need the permissions and any credentials required to read the selected source.
When to use the OneLake catalog
| Your goal | How the catalog helps |
|---|---|
| Reuse data your organization already prepares | Find an existing item rather than creating another connection to the original operational source. |
| Find a recommended source among similarly named items | Use Endorsed in your org and review the item's endorsement, owner, and location. |
| Return to data you own or use regularly | Start with My data or Favorites instead of searching the full list. |
| Identify the right item before connecting | Compare its type, owner, location, refresh information, and sensitivity label where available. |
For example, if your team maintains a sales lakehouse, search for that item, confirm its workspace and owner, and continue to select the data you need. You don't need to begin by finding the lakehouse's connection details.
Find an item
- Open Get data, and then select OneLake catalog.
- Use Search to find an item by name.
- Narrow the list with the available views or Filter.
- Review the matching items before choosing a source.
The catalog offers the following views, as shown in the preceding screenshot:
| View | Purpose |
|---|---|
| All | Browse the available catalog items. |
| My data | Focus on items you own. |
| Endorsed in your org | Find items with an endorsement, such as promoted or certified items. |
| Favorites | Return to items you marked as favorites. |
The controls, supported item types, and available actions can vary by the product hosting the get data experience. This guide describes the embedded module, not every feature of the full OneLake catalog.
Use metadata to choose your source
An item's name alone might not tell you whether it's the right source. Use the list's metadata to compare candidates.
| Column | What to consider |
|---|---|
| Name | Does the item match the dataset or business subject you need? |
| Type | Is it the kind of source you expect, such as a lakehouse or SQL database? |
| Owner | Who maintains the item? Use this context to distinguish items with similar names. |
| Refreshed | Where available, does the reported refresh time meet your needs? A blank value doesn't establish whether the data is current. |
| Location | Is the item in the expected workspace? |
| Endorsement | Has the item been promoted or certified? Treat endorsement as a signal to review, not a guarantee that the data meets every requirement. |
| Sensitivity | Does the item carry a sensitivity label that affects how you should handle its data? |
For example, two lakehouses might both contain sales data. Their workspace, owner, and endorsement can help you identify the maintained source rather than a personal test copy. Confirm that its contents and update schedule match your use case before relying on it.
Connect to the data you find
- Select the item you want to use.
- Follow the connection and navigation steps offered for that item type.
- If the source offers a navigator, select the tables or other objects you need and review their previews.
- Continue into the Power Query editor to prepare the selected data.
The catalog helps you discover the source; the item's type determines the remaining connection experience. Selecting an item doesn't guarantee that every table or object it contains is accessible to you. It also doesn't load data into a final destination: review and prepare the selected data before saving or loading it through your host.
If you can't find an expected item, check the search text and active filters, confirm the workspace with the item's owner, and verify your access. If you find an item but can't read its data, resolve its source permissions or connection requirements rather than assuming catalog visibility is sufficient.
Choose between the catalog and other modules
Use OneLake catalog when you're looking for an existing Fabric data item. Use New data source when you need to select a connector and configure a source directly, such as an external database or service.
Use Recents & My Queries to return to recently used sources or reuse your saved M scripts. Use the shared-query browsing experience when you want to import query logic shared by another author rather than discover a data item.
For broader catalog capabilities, including the full Explore, Govern, and Secure experiences, go to OneLake catalog overview. For details about discovery and item metadata in the full catalog, go to Discover and explore Fabric items.