Manage Connection Settings

Change the status of a data object

1. Click Data in the navigation menu and select Connections.

2. Navigate to the connection and go to the level of data object you want to change the status of.

3. Go to the Settings tab and change the Data Object switch to the status you want:

   • Disable: The data object will be disabled until manually changed. Policies will not impact the data object.

   • Enable: The data object will be enabled until manually changed. If the data object is also a data source, policies will impact the data source.

     {% hint style="warning" %} Databricks Unity Catalog behavior

     If you enable a data object and it has no subscription policy set on it, Immuta will REVOKE access to the data in Databricks for all Immuta users, even if they had been directly granted access to the table in Unity Catalog.

     If a user is not registered in Immuta, Immuta will have no effect on that user's access to data in Unity Catalog. See the Databricks Unity Catalog reference guide for more details. {% endhint %}

   • Inherit: The data object will automatically inherit the status of the parent data object. So if it is a table data object, it will inherit the status of the parent schema data object.

4. Review your changes and click Save Changes.

Changing the status of a parent object

If changing the status of a parent object, all the relevant child objects' statuses will be changed. This may take time to complete with a large number of child objects.

You can check the status of the job with the gear icon in the UI, which will be spinning if jobs are active, or use the bulkId to call the /jobs API.

To update the status using the API, see the Connections API guide.

Change the status of new data objects found by object sync

1. Click Data in the navigation menu and select Connections.

2. Navigate to the connection and go to the level of data object you want to change the settings of.

3. Go to the Settings tab and change the Object Sync switch to the status you want:

   • Disable: All new data objects found within this data object will be registered in a disabled state. Policies will not impact disabled objects.

   • Enable: All new data objects found within this data object will be registered in an enabled state. If the data object is also a data source, policies will impact the data source.

     {% hint style="warning" %} Databricks Unity Catalog behavior

     If you enable a data object and it has no subscription policy set on it, Immuta will REVOKE access to the data in Databricks for all Immuta users, even if they had been directly granted access to the table in Unity Catalog.

     If a user is not registered in Immuta, Immuta will have no effect on that user's access to data in Unity Catalog. See the Databricks Unity Catalog reference guide for more details. {% endhint %} * Inherit: All new data objects found within the data object will be registered as the same status as the data object.

4. Review your changes and click Save Changes.

To update the status using the API, see the Connections API guide.

Assign data object permissions

1. Click Data in the navigation menu and select Connections.

2. Navigate to the connection and go to the level of data object you want to assign permissions to.

3. Go to the Permissions tab and click + Add Permissions.

4. Choose how to assign the permission:

   • Individual Users: Select this option from the dropdown and then search for individual users to grant the permission to.

   • Users in Group: Select this option from the dropdown and then search for groups to grant the permission to.

5. Choose the permission to assign:

   • Data Owner permission to allow them to manage a data object and its child objects.

6. Review your changes and click Grant Permissions.

To assign permissions using the API, see the Connections API guide.