Update a share. — update_share • databricks

Updates the share with the changes and data objects in the request. The caller must be the owner of the share or a metastore admin.

Usage

update_share(
  client,
  name,
  comment = NULL,
  new_name = NULL,
  owner = NULL,
  updates = NULL
)

sharesUpdate(
  client,
  name,
  comment = NULL,
  new_name = NULL,
  owner = NULL,
  updates = NULL
)

Arguments

client: Required. Instance of DatabricksClient()
name: Required. The name of the share.
comment: User-provided free-form text description.
new_name: New name for the share.
owner: Username of current owner of share.
updates: Array of shared data object updates.

Details

When the caller is a metastore admin, only the owner field can be updated.

In the case that the share name is changed, updateShare requires that the caller is both the share owner and a metastore admin.

For each table that is added through this method, the share owner must also have SELECT privilege on the table. This privilege must be maintained indefinitely for recipients to be able to access the table. Typically, you should use a group as the share owner.

Table removals through update do not require additional privileges.