From a3d8ed8ba7b37bc296c6cce17353ab734ad2781e Mon Sep 17 00:00:00 2001 From: pritishpai Date: Fri, 2 May 2025 10:45:43 -0400 Subject: [PATCH 1/3] Add requirement for matching acc groups to be created before assessment --- docs/ucx/docs/reference/workflows/index.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/ucx/docs/reference/workflows/index.mdx b/docs/ucx/docs/reference/workflows/index.mdx index cef13850c8..beeaab0167 100644 --- a/docs/ucx/docs/reference/workflows/index.mdx +++ b/docs/ucx/docs/reference/workflows/index.mdx @@ -19,6 +19,8 @@ relevant for upgrading to UC to assess the compatibility with UC. The `crawl_` t [inventory database](/docs/installation#installation-resources) so that it can be used for further analysis and decision-making through the [assessment report](/docs/reference/assessment). +> Account groups matching workspace local groups in which UCX is installed need to exist before running assessment, you can run [`create-account-groups` command](/docs/reference/commands#create-account-groups) command before running the assessment workflow. + 1. `crawl_tables`: This task retrieves table definitions from the Hive metastore and persists the definitions in the `tables` table. The definitions include information such as: - Database/schema name @@ -106,7 +108,7 @@ to manage groups from a single place: your Databricks account. We expect UCX use centrally while most other Databricks resources that UCX touches are scoped to a single workspace. For extra confidence, run [`validate-groups-membership` command](/docs/reference/commands#validate-groups-membership) before running the group migration. If you do not have account groups matching groups in the workspace in which UCX is installed, you can -run [`create-account-groups` command](/docs/reference/commands#create-account-groups) before running the group migration workflow. +run [`create-account-groups` command](/docs/reference/commands#create-account-groups) before running the assessment and group migration workflow. The group migration workflow is designed to migrate workspace-local groups to account-level groups. It verifies if the necessary groups are available to the workspace with the correct permissions, and removes unnecessary groups and From 328cac959d68f14178b4763dd3cef4630220d9e2 Mon Sep 17 00:00:00 2001 From: pritishpai Date: Fri, 2 May 2025 10:56:39 -0400 Subject: [PATCH 2/3] Add different ways to create account groups. --- docs/ucx/docs/reference/workflows/index.mdx | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/ucx/docs/reference/workflows/index.mdx b/docs/ucx/docs/reference/workflows/index.mdx index beeaab0167..582c0cc9fe 100644 --- a/docs/ucx/docs/reference/workflows/index.mdx +++ b/docs/ucx/docs/reference/workflows/index.mdx @@ -19,7 +19,13 @@ relevant for upgrading to UC to assess the compatibility with UC. The `crawl_` t [inventory database](/docs/installation#installation-resources) so that it can be used for further analysis and decision-making through the [assessment report](/docs/reference/assessment). -> Account groups matching workspace local groups in which UCX is installed need to exist before running assessment, you can run [`create-account-groups` command](/docs/reference/commands#create-account-groups) command before running the assessment workflow. +> Account groups matching workspace local groups in which UCX is installed need to exist before running assessment. + +The account groups can be created in one of three ways: +1. Manually created using the "Account Console". +2. Using SCIM or other service utilizing the Account API. +3. Using the [`create-account-groups` command](/docs/reference/commands#create-account-groups) command. + 1. `crawl_tables`: This task retrieves table definitions from the Hive metastore and persists the definitions in the `tables` table. The definitions include information such as: From 59f0107846cca533fed6da48d12523f9c3830b87 Mon Sep 17 00:00:00 2001 From: pritishpai Date: Fri, 2 May 2025 11:06:15 -0400 Subject: [PATCH 3/3] Move the new statements --- docs/ucx/docs/reference/workflows/index.mdx | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/ucx/docs/reference/workflows/index.mdx b/docs/ucx/docs/reference/workflows/index.mdx index 582c0cc9fe..3d7c7aa21a 100644 --- a/docs/ucx/docs/reference/workflows/index.mdx +++ b/docs/ucx/docs/reference/workflows/index.mdx @@ -12,13 +12,6 @@ steps of the [migration process](/docs/process). You can view the status of depl The assessment workflow can be triggered using the Databricks UI or via the [`ensure-assessment-run` command](/docs/reference/commands#ensure-assessment-run). -The assessment workflow retrieves - or *crawls* - details of [workspace assets](https://docs.databricks.com/en/workspace/workspace-assets.html) -and [securable objects in the Hive metastore](https://docs.databricks.com/en/data-governance/table-acls/object-privileges.html#securable-objects-in-the-hive-metastore) -relevant for upgrading to UC to assess the compatibility with UC. The `crawl_` tasks retrieve assess and objects. The -`assess_` tasks assess the compatibility with UC. The output of each task is stored in the -[inventory database](/docs/installation#installation-resources) so that it can be used for further analysis and decision-making through -the [assessment report](/docs/reference/assessment). - > Account groups matching workspace local groups in which UCX is installed need to exist before running assessment. The account groups can be created in one of three ways: @@ -26,6 +19,13 @@ The account groups can be created in one of three ways: 2. Using SCIM or other service utilizing the Account API. 3. Using the [`create-account-groups` command](/docs/reference/commands#create-account-groups) command. +The assessment workflow retrieves - or *crawls* - details of [workspace assets](https://docs.databricks.com/en/workspace/workspace-assets.html) +and [securable objects in the Hive metastore](https://docs.databricks.com/en/data-governance/table-acls/object-privileges.html#securable-objects-in-the-hive-metastore) +relevant for upgrading to UC to assess the compatibility with UC. The `crawl_` tasks retrieve assess and objects. The +`assess_` tasks assess the compatibility with UC. The output of each task is stored in the +[inventory database](/docs/installation#installation-resources) so that it can be used for further analysis and decision-making through +the [assessment report](/docs/reference/assessment). + 1. `crawl_tables`: This task retrieves table definitions from the Hive metastore and persists the definitions in the `tables` table. The definitions include information such as: