docs/en/integrations/knowledge-catalog/tools/knowledge-catalog-create-data-asset.md
A dataplex-create-data-asset tool creates a new Data Asset under a 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 >}}
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.
The dataplex-create-data-asset tool accepts the following parameters:
| field | type | required | description |
|---|---|---|---|
| locationId | string | true | The location ID (e.g. us, us-central1) where the parent Data Product is located. |
| dataProductId | string | true | The unique ID of the parent Data Product. |
| dataAssetId | string | true | The unique ID of the Data Asset to create. |
| resourceUri | string | true | The URI of the physical resource associated with the Data Asset (e.g. //bigquery.googleapis.com/projects/my-project/datasets/my-dataset/tables/my-table). |
| labels | map | false | The labels associated with the Data Asset. Keys and values must be strings. |
| accessGroupConfigs | map | false | Map of access group configurations to associate with the Data Asset. Keys represent the access group ID, and the value is a list of string IAM role names (e.g. {"test-group": ["roles/bigquery.dataViewer"]}). To find the list of supported roles that can be granted on the resource, refer to the roles:queryGrantableRoles API method. |
kind: tool
name: create_data_asset
type: dataplex-create-data-asset
source: my-dataplex-source
description: Use this tool to create a Data Asset.
| field | type | required | description |
|---|---|---|---|
| type | string | true | Must be "dataplex-create-data-asset". |
| source | string | true | Name of the source the tool should execute on. |
| description | string | true | Description of the tool that is passed to the LLM. |