[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC)：2025-08-27。"],[[["\u003cp\u003eData Catalog is a Dataplex feature that automatically catalogs metadata for Bigtable resources, aiding in the search and management of Bigtable data assets, but it's being deprecated in favor of Dataplex Catalog.\u003c/p\u003e\n"],["\u003cp\u003eMetadata for Bigtable instances, clusters, and tables (including column family details) is automatically synced to Data Catalog.\u003c/p\u003e\n"],["\u003cp\u003eData Catalog allows users to search for data entries by resource name or details, offering faceted search and allowing tagging data assets for improved discoverability.\u003c/p\u003e\n"],["\u003cp\u003eSpecific IAM roles, such as \u003ccode\u003eroles/bigtable.viewer\u003c/code\u003e, \u003ccode\u003eroles/datacatalog.tagTemplateUser\u003c/code\u003e, and \u003ccode\u003eroles/datacatalog.tagEditor\u003c/code\u003e, are required to view, search, and tag Bigtable resources in Data Catalog.\u003c/p\u003e\n"],["\u003cp\u003eUsers can create a custom role for complete Bigtable metadata management access, and locations constraints may affect metadata syncing, suggesting the inclusion of the 'global' multi-region to location policy.\u003c/p\u003e\n"]]],[],null,["# Manage data assets using Data Catalog\n=====================================\n\n| **Caution:** Data Catalog is [deprecated](/data-catalog/docs/deprecations) in favor of [Dataplex Universal Catalog](/dataplex/docs/catalog-overview). Dataplex Universal Catalog is also integrated with Bigtable, offering similar capabilities. You can use Dataplex Universal Catalog to enrich your data with aspects, which are the equivalent of Data Catalog tags. For more information, see [Manage\n| aspects and enrich metadata](/dataplex/docs/enrich-entries-metadata).\n\nData Catalog automatically\ncatalogs metadata about Bigtable resources. This feature helps your\norganization search for and manage your Bigtable data assets.\n\nMetadata is automatically synced from Bigtable to\nData Catalog for the following Bigtable resources:\n\n- Instances\n- Clusters\n- Tables, including column family details\n\nData Catalog is a fully managed metadata management service.\nIt provides unified view and tagging mechanisms for\ntechnical and business metadata. To learn more about Data Catalog\nand why you should use it, see [What is\nData Catalog](/data-catalog/docs/concepts/overview).\n\nBenefits of using Data Catalog with Bigtable\n--------------------------------------------\n\nData Catalog information about your data can help facilitate\nanalysis, data reuse, application development, and data management.\n\nYou can search entries in Data Catalog by resource name or by\ndetails. For example, you can search for an instance name to find the entry for\nan instance or search for a column family to find the entry for a table. You can\nalso use a faceted search, applying filters to narrow down your search. For more\ninformation, see [Search and view data assets with\nData Catalog](/data-catalog/docs/how-to/search).\n\nTagging data assets can help you understand and catalog the data that is\navailable in your Bigtable tables to make the data more\ndiscoverable and searchable by other Data Catalog users, and as\npart of your larger data estate. You use tags to add your own metadata to your\ncataloged metadata, and then you can use those tags to conduct searches.\n\nGet started with Data Catalog\n-----------------------------\n\nTo get started using Data Catalog to manage your\nBigtable data assets, complete the following tasks:\n\n1. If you are new to Data Catalog, [enable the\n API](/data-catalog/docs/integrate-data-sources#before_you_begin).\n\n2. [Grant IAM roles](#required-roles) to principals who require\n access to Bigtable entries in Data Catalog.\n\n3. Learn how to search for data assets by reading [How to search with\n Data Catalog](/data-catalog/docs/how-to/search).\n\n4. Review [Data Catalog search syntax](/data-catalog/docs/how-to/search-reference)\n to understand how to find your metadata.\n\n5. Read the concepts on tagging Data Catalog entries at [Tags\n and tag templates](/data-catalog/docs/tags-and-tag-templates)\n\nWays to search for Bigtable metadata\n------------------------------------\n\nYou can search synced Bigtable metadata using Data Catalog.\n\nIn addition to [standard qualifiers](/data-catalog/docs/how-to/search-reference#qualified_predicates), you can search for Bigtable resources with the following:\n\n- Instance\n\n - Bigtable instance name\n - Bigtable instance ID\n - Cluster location\n - Cluster ID\n- Table\n\n - Table ID\n - Column family name\n - Bigtable instance name\n - Bigtable instance ID\n\nRequired roles\n--------------\n\nViewing, tagging, and searching Bigtable resources in\nData Catalog have different permission requirements. In general,\ngrant principals in your organization the minimum role required to accomplish a\ntask.\n\n### Permission to view public and private tags\n\nTo get the permissions that you need to view public and private tags on\nBigtable resources, ask your administrator to grant you the\nfollowing IAM roles:\n\n- [`roles/datacatalog.tagTemplateViewer`](/iam/docs/understanding-roles#datacatalog.tagTemplateViewer)\n- [`roles/bigtable.viewer`](/bigtable/docs/access-control#bigtable.viewer)\n\nThese predefined roles contain the permissions required to view public and\nprivate tags. The exact permissions that are required are the following:\n\n- `bigtable.instances.get`\n- `bigtable.clusters.get`\n- `bigtable.tables.get`\n- `datacatalog.tagTemplates.getTag`\n\n### Permission to search Bigtable resources\n\nTo get the permissions that you need to search Bigtable\nresources in Data Catalog, ask your administrator to grant you\nthe following IAM roles:\n\n- [`roles/bigtable.viewer`](/bigtable/docs/access-control#bigtable.viewer)\n\nThese predefined roles contain the permissions required to search\nBigtable resources. The exact permissions that are required are\nthe following:\n\n- `bigtable.instances.get`\n- `bigtable.clusters.get`\n- `bigtable.tables.get`\n\n### Permission to attach tags to Bigtable resources\n\nTo get the permissions that you need to attach tags to Bigtable\nresources in Data Catalog, ask your administrator to grant you\nthe following IAM roles:\n\n- [`roles/datacatalog.tagTemplateUser`](/iam/docs/understanding-roles#datacatalog.tagTemplateUser)\n- [`roles/datacatalog.tagEditor`](/iam/docs/understanding-roles#datacatalog.tagEditor)\n- [`roles/bigtable.admin`](/bigtable/docs/access-control#bigtable.admin)\n\nThese predefined roles contain the permissions required to add public and\nprivate tags. The exact permissions that are required are the following:\n\n- `bigtable.instances.update`\n- `bigtable.clusters.update`\n- `bigtable.tables.update`\n- `datacatalog.tagTemplates.use`\n- `datacatalog.entries.updateTag`\n\n### (Optional) Create a custom role\n\nYou can create a custom role to grant to users who require complete access to all\nBigtable metadata in Data Catalog across your\nproject or organization. Then you can make any user or service account that\nneeds access a principal of the custom role. To learn more about custom roles,\nsee [Roles and permissions](/iam/docs/roles-overview#custom).\n\nChoose a meaningful name for the role, such as Bigtable\nData Catalog Editor, and then assign only the principals who need\naccess to the role. For setup instructions, see [Creating a custom\nrole](/iam/docs/creating-custom-roles#creating_a_custom_role).\n\nGrant the following permissions to the custom role:\n\n- `bigtable.instances.get`\n- `bigtable.instances.update`\n- `bigtable.clusters.get`\n- `bigtable.clusters.update`\n- `bigtable.tables.get`\n- `bigtable.tables.update`\n- `datacatalog.tagTemplates.getTag`\n- `datacatalog.tagTemplates.use`\n\nFor details on Data Catalog permissions, see [Roles to search\nGoogle Cloud resources](/data-catalog/docs/concepts/iam#roles_to_search_resources).\nFor descriptions of Bigtable permissions, see [Permissions](/bigtable/docs/access-control#permissions).\n\nKnown constraints\n-----------------\n\nThe following section lists some constraints that you must note before using\nData Catalog to manage your Bigtable metadata.\n\n#### Location constraints\n\nIf your organization has set up [location\nconstraints](/resource-manager/docs/organization-policy/defining-locations),\nmetadata entries for your Bigtable resources might not be synced\nto Data Catalog. Any entries created before enforcing the\nlocation constraints are retained by Data Catalog.\n\nTo allow Data Catalog to load resources, we recommend adding the `global` multi-region to your location policy.\n\n#### Column family name exception\n\nThe Data Catalog API rejects requests where the column family\nname in your request includes a period (`.`). For example, if the column family\nname is `personal.info`.\n\nWhat's next\n-----------\n\n- [Read an overview of Data Catalog](/data-catalog/docs/concepts/overview).\n- [Explore additional Google Cloud integrations with Data Catalog.](/data-catalog/docs/integrate-data-sources)"]]
