You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+13-5Lines changed: 13 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@ Databricks Labs UCX
2
2
===
3
3

4
4
5
-
The companion for upgrading to Unity Catalog.
5
+
The companion for upgrading to Unity Catalog (UC).
6
6
7
7
After [installation](#install-ucx), ensure to [trigger](#ensure-assessment-run-command) the [assessment workflow](#assessment-workflow),
8
8
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.
563
563
Use the `create-uber-principal`[UCX Command](#create-uber-principal-command) to create the Uber Principal.
564
564
565
565
##### 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.)
0 commit comments