[[["易于理解","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-09-04。"],[],[],null,["# Search for resources\n====================\n\n|\n| **Preview**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n|\n|\n| For information about access to this\n| release, see the\n| [access request page](https://docs.google.com/forms/d/e/1FAIpQLSfeucdQXFDYl88JsxPCylt-iU0KxuQMN6VZRalS1vM4ZD0U0Q/viewform).\n\nUse Dataplex Universal Catalog search to find Google Cloud resources from\nwithin BigQuery, such as BigQuery datasets and tables.\n\nDataplex Universal Catalog search supports natural language search queries\n(also known as semantic search queries), which let you search for resources\nusing everyday language.\n\nSimilar to keyword search, natural language search emphasizes the discovery of\nresources by analyzing the metadata that's associated with the resources within\nyour organization. Search takes into account a broad range of metadata that\ndescribes the resources, including metadata that you create.\n\nNatural language search focuses on enhancing recall rather than precision.\n\nFor more information about how to search for table data in\nBigQuery, see\n[Introduction to search in BigQuery](/bigquery/docs/search-intro).\n\nSign up for Preview\n-------------------\n\nTo sign up for Preview, your Google account representative must submit a\nrequest by filling out the\n[sign-up form](https://docs.google.com/forms/d/e/1FAIpQLSfeucdQXFDYl88JsxPCylt-iU0KxuQMN6VZRalS1vM4ZD0U0Q/viewform).\nAfter you submit the form, the BigQuery team will contact you\nwith next steps.\n\nBefore you begin\n----------------\n\nBefore you use natural language search in BigQuery to search for\nGoogle Cloud resources, complete the tasks in this section.\n\n### Required roles\n\nTo search for resources, you need at least one of the following\n[Dataplex Universal Catalog IAM roles](/dataplex/docs/iam-roles#predefined-roles)\non the project that is used for search: Dataplex Catalog Admin,\nDataplex Catalog Editor, or Dataplex Catalog Viewer. Permissions on search results are\nchecked independently of the selected project.\n\nThe search results in BigQuery are scoped according to\nyour IAM permissions over the underlying resources. To search for\na resource in BigQuery, you must have permissions to access the\ncorresponding resource. For more information, see the\n[Search scope](#search-scope) section of this document.\n\nFor example, to search for BigQuery datasets, tables, views, and\nmodels, you need respective permissions to access those resources. For more\ninformation, see\n[BigQuery permissions](/bigquery/docs/access-control#bq-permissions).\nThe following list describes the minimum permissions required:\n\n- To search for a table, you need `bigquery.tables.get` permission for that table.\n- To search for a dataset, you need `bigquery.datasets.get` permission for that dataset.\n\nThe\n[BigQuery Metadata Viewer role](/iam/docs/understanding-roles#bigquery.metadataViewer) (`roles/bigquery.metadataViewer`)\nincludes both the permissions `bigquery.tables.get` and `bigquery.datasets.get`,\nand it lets you search for any BigQuery resource.\n\nFor more information about granting roles, see\n[Manage access](/iam/docs/granting-changing-revoking-access).\n\nYou might also be able to get the required permissions through\n[custom roles](/iam/docs/creating-custom-roles) or other\n[predefined roles](/iam/docs/understanding-roles).\n\n### Enable the API\n\nTo use search, ensure that you have enabled the Dataplex API.\nThe Dataplex API is\n[enabled by default](/bigquery/docs/service-dependencies)\nfor all new Google Cloud projects with BigQuery. If the\nDataplex API isn't enabled in your project, see\n[Enable Dataplex Universal Catalog](/dataplex/docs/enable-api).\n\nSearch for resources\n--------------------\n\n1. In the Google Cloud console, go to the BigQuery\n **Search** page.\n\n\n [Go to Search](https://console.cloud.google.com/bigquery/search)\n\n \u003cbr /\u003e\n\n2. In the search field, enter your query in natural language and then press\n \u003ckbd\u003eEnter\u003c/kbd\u003e. The following are some sample queries:\n\n - `Show me the datasets that contain taxi information`\n - `Find data on vaccine distribution across different countries`\n - `Get tables with historical temperature data for major world cities`\n - `Search for hurricane tracking and storm activity datasets`\n - `Population data by country`\n3. To filter your search, click **Filters**. The following filters are available:\n\n - **Scope** : search across the organization (default), the current project, or only for starred resources. For more information, see the [Search scope](#search-scope) section of this document.\n - **Systems** : the Google Cloud service that the resource belongs to, such as BigQuery. The Dataplex Universal Catalog system contains [entry groups](/dataplex/docs/ingest-custom-sources#entry-groups).\n - **Projects**: the projects to search in.\n - **Type**: the resource type, such as BigQuery connection, Cloud Storage bucket, or database. Depending on the resource type, you can also filter by subtype, such as the connection type or SQL dialect.\n - **Select locations**: the locations to search in.\n - **Select datasets** : this limits search results to BigQuery resources that belong to the selected BigQuery datasets. In the **Type to filter** field, enter the name of the dataset.\n - **Annotations** : the Dataplex Universal Catalog [aspect types](/dataplex/docs/enrich-entries-metadata#aspect-types) that are associated with the resource that you're searching for. To filter by aspect values, click **Filter on annotation values**, and then select the values.\n\n To remove a filter, click\n clear **Clear** next to the specific\n filter that you want to remove. Or, to remove all filters, click\n **Clear Filters**.\n\n For more information about how filters are evaluated, see the\n [Filters](#filters) section of this document.\n4. Optional: To view more information about a resource, in the search results,\n click the resource name.\n\n This opens a resource summary in a split pane. Do any of the following:\n - To open the resource in the service that the resource belongs to, click **Open in \u003cvar translate=\"no\"\u003ePRODUCT_NAME\u003c/var\u003e** for the resource. For example, to open a BigQuery dataset in BigQuery Studio, click **Open in Studio**. The options that are available depend on the resource.\n - To view the Dataplex Universal Catalog metadata that's associated with a resource, click **Open in Dataplex Catalog** for the resource.\n - If you have important search results that you want to bookmark, you can star them. Click star_border **Star** for the resource. You can view starred resources in BigQuery Studio.\n - To close the resource summary in the split pane, click close **Close**.\n\nFilters\n-------\n\nFilters let you narrow down the search results.\n\nWhen you provide filters in multiple sections, the filters are evaluated using\nthe `AND` logical operator. The search results contain resources that match at\nleast one condition from every selected section. For example, if you select the\nBigQuery system and the `dataset` resource type, the search\nresults include BigQuery datasets but not Vertex AI\ndatasets.\n\nIf you select multiple filters within a single section, the filters are\nevaluated using the `OR` logical operator. For example, if you select the\n`dataset` resource type and the `table` resource type, the search results\ninclude both datasets and tables.\n\nSearch scope\n------------\n\nFor projects that belong to a Google Cloud organization, search operates\nwithin the scope of that organization.\n\nThe search results respect permissions that you have over the resources. For\nexample, if you have BigQuery metadata read access to a\nresource, that resource appears in your search results. If you have access to a\nBigQuery table but not to the dataset containing that table, the\ntable still shows up as expected in the search results.\n| **Note:** Permissions propagation to search might be delayed if the change affects a large number of resources or principals.\n\nThe search results include only those resources that belong to the same\nVPC Service Controls perimeter as the project under which search is performed.\nWhen using the Google Cloud console, this is the project that is selected in\nthe console.\n\nWhat's next\n-----------\n\n- Learn how to [analyze data in BigQuery Studio](/bigquery/docs/query-overview#bigquery-studio).\n- Learn how to [use keyword search in Dataplex Universal Catalog](/dataplex/docs/search-assets)."]]
