Atlan imports your Google BigQuery tags and allows you to update your Google BigQuery assets with the imported tags. Note that object tagging in Google BigQuery currently requires Enterprise edition or higher.
Once you've crawled Google BigQuery:
- Your Google BigQuery assets in Atlan will be automatically enriched with their Google BigQuery tags.
- Imported Google BigQuery tags will be mapped to corresponding Atlan tags through case-insensitive name match — multiple Google BigQuery tags can be matched to a single tag in Atlan.
- You can also attach Google BigQuery tags, including tag values and hierarchies, to your Google BigQuery assets in Atlan — allowing you to categorize your assets at a more granular level. Atlan supports:
- Tags — enrich your Google BigQuery tables, views, and materialized views with tags and tag values.
- Policy tags — enrich your Google BigQuery columns with policy tags and tag hierarchies.
- You can filter your assets by Google BigQuery tags.
Atlan currently does not support crawling Dataplex tag templates.
Prerequisites
Before you can import tags from Google BigQuery, you will need to do the following:
- Create tags or have existing tags in Google BigQuery.
- Grant permissions to import tags from Google BigQuery.
Import Google BigQuery tags to Atlan
Atlan imports existing Google BigQuery tags through one-way tag sync. The imported Google BigQuery tags are matched to corresponding tags in Atlan through case-insensitive name match and your Google BigQuery assets enriched with the tags synced from Google BigQuery.
To import Google BigQuery tags to Atlan, you can either:
- Create a new Google BigQuery workflow and configure the crawler to import tags.
- Modify the crawler's configuration for an existing Google BigQuery workflow to change Import Tags to Yes. If you subsequently modify the workflow to disable tag import, for any tags already imported, Atlan will preserve those tags.
Once the crawler has completed running, tags synced from Google BigQuery will be available to use for tagging assets! 🎉
View Google BigQuery tags in Atlan
Once you've crawled Google BigQuery, you will be able to view and manage your Google BigQuery tags in Atlan.
To view synced Google BigQuery tags:
- From the left menu of any screen, click Governance.
- Under the Governance heading of the Governance center, click Tags.
- (Optional) Under Tags, click the funnel icon to filter tags by source type. Click BigQuery to filter for tags imported from Google BigQuery.
- In the Overview section, you can view a total count of synced Google BigQuery tags. To the right of Overview, click Synced tags to view additional details — including tag name, type, and values, description, total count of linked assets, connection name, and timestamp for last synced.
- (Optional) Click the Linked assets tab to view linked assets for your Google BigQuery tag.
- (Optional) In the top right, click the pencil icon to add a description and change the tag icon. Tags synced from Google BigQuery cannot be renamed.
You can now attach Google BigQuery tags to your Google BigQuery assets in Atlan! 🎉