updated notebook instructions and removed notebook not related to group migration

Author: HariGS-DB

README.md

@@ -6,7 +6,8 @@ This repo contains various functions and utilities for UC Upgrade.
 ## Latest working version and how-to
 
 Please note that current project statis is 🏗️ **WIP**, but we have a minimal set of already working utilities.
-To run the notebooks please use latest LTS Databricks Runtime (non-ML), without Photon, in a single-user cluster mode with UC enabled.
+To run the notebooks please use latest LTS Databricks Runtime (non-ML), without Photon, in a single-user cluster mode.
+If you have Table ACL Clusters or SQL Warehouse where ACL have been defined, you should create a TableACL cluster to run this notebook
 
 Please note that script is executed only on the driver node, therefore you'll need to use a Single Node Cluster with sufficient amount of cores (e.g. 16 cores).
 

notebooks/GroupMigration/Workspace_Group_Migration_Notebook.py

@@ -57,7 +57,10 @@
 # MAGIC %md
 # MAGIC ## How to Run
 # MAGIC
-# MAGIC Run the script in the following sequence
+
+# COMMAND ----------
+
+# MAGIC %md
 # MAGIC #### Step 1: Initialize the class
 # MAGIC Import the module WSGroupMigration and initialize the class by passing following attributes:
 # MAGIC - list of workspace group to be migrated (make sure these are workspace groups and not account level groups)
@@ -70,20 +73,6 @@
 
 # COMMAND ----------
 
-# MAGIC %md ## Installing the package and it's dependencies
-
-# COMMAND ----------
-
-from notebooks.common import install_uc_upgrade_package
-
-install_uc_upgrade_package()
-
-# COMMAND ----------
-
-# MAGIC %md ## Main process entrypoint
-
-# COMMAND ----------
-
 from uc_upgrade.group_migration import GroupMigration
 
 # COMMAND ----------
@@ -98,6 +87,9 @@
 
 # Find this in the account console
 inventoryTableName = "WorkspaceInventory"
+# the script will create two table
+# WorkspaceInventory - to store all the ACL permission
+# WorkspaceInventoryTableACL - to store the table acl permission specifically
 
 # Pull from your browser URL bar. Should start with "https://" and end with ".com" or ".net"
 workspace_url = "https://<DOMAIN>"
@@ -107,7 +99,7 @@
 token = "<TOKEN>"
 
 # Should the migration Check the ACL on tables/views as well?
-checkTableACL = True
+checkTableACL = False
 
 # What cloud provider? Acceptable values are "AWS" or anything other value.
 cloud = "AWS"
@@ -156,17 +148,34 @@
 # MAGIC %md
 # MAGIC #### Adhoc Step: Selective Inventory
 # MAGIC This is a adhoc step for troubleshooting purpose. Once dryRun is complete and data stored in tables, if the acl of any object is changed in the workspace
+<<<<<<< Updated upstream
 # MAGIC Ex new notebook permission added, User can force a fresh inventory of the selected object instead of doing a full cleanup and dryRun to save time
 # MAGIC Call gm.performInventory with 3 parameters:
 # MAGIC  - mode: Workpace("workspace local group") or Account ("for workspace back up group")
 # MAGIC  - force: setting to True will force fresh inventory capture and updates to the tables
 # MAGIC  - objectType: select the list of object for which to do the fresh inventory, options are
 # MAGIC
+=======
+# MAGIC Ex new notebook permission added, User can force a fresh inventory of the selected object instead of doing a full cleanup and running the dryRun
+# MAGIC To save time call gm.performInventory with 3 parameters:
+# MAGIC  - mode: Workpace("for workspace local group") or Account ("for workspace back up group")
+# MAGIC  - force: setting to True will force fresh inventory capture and updates to the tables 
+# MAGIC  - objectType: select the list of object for which to do the fresh inventory, options are 
+# MAGIC  
+>>>>>>> Stashed changes
 # MAGIC  "Group"(will do members, group list, entitlement, roles), "Password","Cluster","ClusterPolicy","Warehouse","Dashboard","Query","Job","Folder"(Will do folders, notebook and files),"TableACL","Alert","Pool","Experiment","Model","DLT","Repo","Token","Secret"
+# MAGIC  Ex: gm.performInventory('Workspace',force=True,objectType='Cluster') will do:
+# MAGIC  - fresh inventory of all cluster objects and updated the data the inventory table
+# MAGIC  - run printInventory() to verify all the permission again (including clusters).
 
 # COMMAND ----------
 
+<<<<<<< Updated upstream
 gm.performInventory("Workspace", force=True, objectType="Folder")
+=======
+gm.performInventory('Workspace',force=True,objectType='Cluster')
+gm.printInventory()
+>>>>>>> Stashed changes
 
 # COMMAND ----------