Skip to main content

data_taxonomies

Creates, updates, deletes, gets or lists a data_taxonomies resource.

Overview

Namedata_taxonomies
TypeResource
Idgoogle.dataplex.data_taxonomies

Fields

NameDatatypeDescription
namestringOutput only. The relative resource name of the DataTaxonomy, of the form: projects/{project_number}/locations/{location_id}/dataTaxonomies/{data_taxonomy_id}.
descriptionstringOptional. Description of the DataTaxonomy.
attributeCountintegerOutput only. The number of attributes in the DataTaxonomy.
classCountintegerOutput only. The number of classes in the DataTaxonomy.
createTimestringOutput only. The time when the DataTaxonomy was created.
displayNamestringOptional. User friendly display name.
etagstringThis checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
labelsobjectOptional. User-defined labels for the DataTaxonomy.
uidstringOutput only. System generated globally unique ID for the dataTaxonomy. This ID will be different if the DataTaxonomy is deleted and re-created with the same name.
updateTimestringOutput only. The time when the DataTaxonomy was last updated.

Methods

NameAccessible byRequired ParamsDescription
projects_locations_data_taxonomies_getSELECTdataTaxonomiesId, locationsId, projectsIdRetrieves a DataTaxonomy resource.
projects_locations_data_taxonomies_listSELECTlocationsId, projectsIdLists DataTaxonomy resources in a project and location.
projects_locations_data_taxonomies_createINSERTlocationsId, projectsIdCreate a DataTaxonomy resource.
projects_locations_data_taxonomies_deleteDELETEdataTaxonomiesId, locationsId, projectsIdDeletes a DataTaxonomy resource. All attributes within the DataTaxonomy must be deleted before the DataTaxonomy can be deleted.
projects_locations_data_taxonomies_patchUPDATEdataTaxonomiesId, locationsId, projectsIdUpdates a DataTaxonomy resource.

SELECT examples

Lists DataTaxonomy resources in a project and location.

SELECT
name,
description,
attributeCount,
classCount,
createTime,
displayName,
etag,
labels,
uid,
updateTime
FROM google.dataplex.data_taxonomies
WHERE locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';

INSERT example

Use the following StackQL query and manifest file to create a new data_taxonomies resource.

/*+ create */
INSERT INTO google.dataplex.data_taxonomies (
locationsId,
projectsId,
description,
displayName,
labels,
etag
)
SELECT
'{{ locationsId }}',
'{{ projectsId }}',
'{{ description }}',
'{{ displayName }}',
'{{ labels }}',
'{{ etag }}'
;

UPDATE example

Updates a data_taxonomies resource.

/*+ update */
UPDATE google.dataplex.data_taxonomies
SET
description = '{{ description }}',
displayName = '{{ displayName }}',
labels = '{{ labels }}',
etag = '{{ etag }}'
WHERE
dataTaxonomiesId = '{{ dataTaxonomiesId }}'
AND locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';

DELETE example

Deletes the specified data_taxonomies resource.

/*+ delete */
DELETE FROM google.dataplex.data_taxonomies
WHERE dataTaxonomiesId = '{{ dataTaxonomiesId }}'
AND locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';