dataplex-update-data-product

A “dataplex-update-data-product” tool updates metadata for an existing Data Product in Knowledge Catalog.

About

A dataplex-update-data-product tool updates an existing Data Product in Knowledge Catalog (formerly known as Dataplex). This is a long-running operation, and the tool returns immediately with the operation’s location ID and operation ID.

View the Data Products guide for more information.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Knowledge Catalog (formerly known as Dataplex) Source

Requirements

IAM Permissions

Knowledge Catalog uses Identity and Access Management (IAM) to control user and group access to Knowledge Catalog resources. Toolbox will use your Application Default Credentials (ADC) to authorize and authenticate when interacting with Knowledge Catalog.

In addition to setting the ADC for your server, you need to ensure the IAM identity has been given the correct IAM permissions for the tasks you intend to perform. See Knowledge Catalog IAM permissions and Knowledge Catalog IAM roles for more information on applying IAM permissions and roles to an identity.

Parameters

The dataplex-update-data-product tool accepts the following parameters:

fieldtyperequireddescription
locationIdstringtrueThe location ID (e.g. us, us-central1) of the Data Product.
dataProductIdstringtrueThe unique ID of the Data Product to update.
displayNamestringfalseThe display name of the Data Product.
descriptionstringfalseThe description of the Data Product.
ownerEmailsarray of stringsfalseThe list of owner emails for the Data Product.
accessGroupsarray of objectsfalseList of access groups to associate with the Data Product. Each group object can contain: id (required), displayName (required), description, and at least one of googleGroup and serviceAccount.
updateMaskarray of stringsfalseList of paths indicating which fields to update (e.g., displayName, description, ownerEmails, accessGroups). If not specified, all fields provided will be updated.

Example

kind: tool
name: update_data_product
type: dataplex-update-data-product
source: my-dataplex-source
description: Use this tool to update a Data Product.

Reference

fieldtyperequireddescription
typestringtrueMust be “dataplex-update-data-product”.
sourcestringtrueName of the source the tool should execute on.
descriptionstringtrueDescription of the tool that is passed to the LLM.