Skip to content

Commit 3a5bce8

Browse files
authored
Document preparing external locations when creating catalogs (#2915)
## Changes Document preparing external locations when creating catalogs. ### Functionality - [x] update `README.md`
1 parent d2a50cf commit 3a5bce8

File tree

1 file changed

+13
-5
lines changed

1 file changed

+13
-5
lines changed

README.md

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ Databricks Labs UCX
22
===
33
![UCX by Databricks Labs](docs/logo-no-background.png)
44

5-
The companion for upgrading to Unity Catalog.
5+
The companion for upgrading to Unity Catalog (UC).
66

77
After [installation](#install-ucx), ensure to [trigger](#ensure-assessment-run-command) the [assessment workflow](#assessment-workflow),
88
so that you'll be able to [scope the migration](docs/assessment.md) and execute the [group migration workflow](#group-migration-workflow).
@@ -563,10 +563,18 @@ Once the upgrade is completed, these principals can (and should) be deleted.
563563
Use the `create-uber-principal` [UCX Command](#create-uber-principal-command) to create the Uber Principal.
564564

565565
##### Step 2.5: Create Catalogs and Schemas
566-
In this step we will create the UC catalogs and schemas required for the target tables.
567-
The `create-catalogs-schemas` [UCX command](#create-catalogs-schemas-command) can be used to create the UC catalogs and schemas.
568-
569-
The command will create the UC catalogs and schemas based on the mapping file created in the previous step.
566+
In this step, we will create the UC catalogs and schemas required for the target tables using the
567+
[`create-catalogs-schemas` command](#create-catalogs-schemas-command). The command will create the UC catalogs and
568+
schemas based on the mapping file created in the previous step.
569+
570+
This step requires considering how to [physically separate data in storage](https://docs.databricks.com/en/data-governance/unity-catalog/best-practices.html#data-is-physically-separated-in-storage)
571+
within UC. As [Databricks recommends storing managed data at the catalog level](https://docs.databricks.com/en/data-governance/unity-catalog/best-practices.html#configure-a-unity-catalog-metastore),
572+
we advise to prepare the external locations for the to-be created catalogs before running the `create-catalogs-schemas`
573+
command. Either, reuse [previously created external locations](#step-23-create-external-locations) or create additional
574+
external locations outside of UCX if data separation restrictions requires that. Note that external locations can be
575+
reused when using subpaths, for example, a folder in a cloud storage
576+
(`abfss://[email protected]/folder`) can reuse the external location of the cloud storage
577+
(`abfss://[email protected]/`). (The previous example also holds for other clouds.)
570578

571579
#### Step 3: Upgrade the Metastore
572580
Upgrading the metastore is done in steps.

0 commit comments

Comments
 (0)