Dataplex Universal Catalog 검색을 사용하여 BigQuery 데이터 세트 및 테이블과 같은 BigQuery 내의 Google Cloud 리소스를 찾습니다.
Dataplex Universal Catalog 검색은 자연어 검색어(시맨틱 검색어라고도 함)를 지원하므로 일상적인 언어를 사용하여 리소스를 검색할 수 있습니다.
키워드 검색과 마찬가지로 자연어 검색은 조직 내 리소스와 연결된 메타데이터를 분석하여 리소스 검색을 강조합니다. 검색에서는 사용자가 만든 메타데이터를 비롯하여 리소스를 설명하는 다양한 메타데이터를 고려합니다.
자연어 검색은 정밀도보다 재현율을 높이는 데 중점을 둡니다.
BigQuery에서 테이블 데이터를 검색하는 방법에 대한 자세한 내용은 BigQuery 검색 소개를 참고하세요.
가입하고 미리보기
미리보기에 가입하려면 Google 계정 담당자가 가입 양식을 작성하여 요청을 제출해야 합니다.
양식을 제출하면 BigQuery팀에서 다음 단계를 안내해 드립니다.
시작하기 전에
BigQuery에서 자연어 검색을 사용하여Google Cloud 리소스를 검색하기 전에 이 섹션의 태스크를 완료하세요.
필요한 역할
리소스를 검색하려면 검색에 사용되는 프로젝트에 대한 Dataplex 카탈로그 관리자, Dataplex 카탈로그 편집자, Dataplex 카탈로그 뷰어 Dataplex Universal Catalog IAM 역할 중 하나 이상이 필요합니다. 검색 결과에 대한 권한은 선택한 프로젝트와는 별도로 확인됩니다.
BigQuery의 검색 결과는 기본 리소스에 대한 IAM 권한에 따라 범위가 지정됩니다. BigQuery에서 리소스를 검색하려면 해당 리소스에 액세스할 권한이 있어야 합니다. 자세한 내용은 이 문서의 검색 범위 섹션을 참조하세요.
예를 들어 BigQuery 데이터 세트, 테이블, 뷰, 모델을 검색하려면 해당 리소스에 액세스할 수 있는 권한이 필요합니다. 자세한 내용은 BigQuery 권한을 참조하세요.
다음 목록에서는 필요한 최소 권한을 설명합니다.
테이블을 검색하려면 해당 테이블에 대한 bigquery.tables.get 권한이 필요합니다.
데이터 세트를 검색하려면 해당 데이터 세트에 대한 bigquery.datasets.get 권한이 필요합니다.
BigQuery 메타데이터 뷰어 역할(roles/bigquery.metadataViewer)에는 bigquery.tables.get 및 bigquery.datasets.get 권한이 모두 포함되어 있으며, 이를 통해 모든 BigQuery 리소스를 검색할 수 있습니다.
검색을 사용하려면 Dataplex API를 사용 설정해야 합니다.
Dataplex API는 BigQuery가 있는 모든 새 Google Cloud 프로젝트에서 기본적으로 사용 설정됩니다. 프로젝트에서 Dataplex API가 사용 설정되어 있지 않으면 Dataplex Universal Catalog 사용 설정을 참고하세요.
즐겨찾기에 추가하고 싶은 중요한 검색 결과가 있다면 별표를 표시하면 됩니다. 리소스의 star_border별표를 클릭합니다.
BigQuery Studio에서 별표표시된 리소스를 볼 수 있습니다.
분할 창에서 리소스 요약을 닫으려면 close닫기를 클릭합니다.
필터
필터를 사용하면 검색 결과 범위를 좁힐 수 있습니다.
여러 섹션에 필터를 제공하면 AND 논리 연산자를 사용하여 필터가 평가됩니다. 검색 결과에는 선택한 모든 섹션에서 하나 이상의 조건과 일치하는 리소스가 포함됩니다. 예를 들어 BigQuery 시스템과 dataset 리소스 유형을 선택하면 검색 결과에 BigQuery 데이터 세트가 포함되지만 Vertex AI 데이터 세트는 포함되지 않습니다.
단일 섹션 내에서 여러 필터를 선택하면 필터가 OR 논리 연산자를 사용하여 평가됩니다. 예를 들어 dataset 리소스 유형과 table 리소스 유형을 선택하면 검색 결과에 데이터 세트와 테이블이 모두 포함됩니다.
검색 범위
Google Cloud 조직에 속한 프로젝트의 경우 검색이 해당 조직의 범위 내에서 작동합니다.
검색 결과는 리소스에 대해 사용자가 가진 권한을 존중합니다. 예를 들어 리소스에 대해 BigQuery 메타데이터 읽기 액세스 권한이 있으면 해당 리소스가 검색 결과에 표시됩니다. BigQuery 테이블에 대해 액세스 권한이 있지만 이 테이블을 포함하는 데이터 세트에 대해서는 액세스 권한이 없는 경우에도 예상한 대로 테이블이 검색 결과에 표시됩니다.
검색 결과에는 검색이 수행되는 프로젝트와 동일한 VPC 서비스 제어 경계에 속하는 리소스만 포함됩니다.
Google Cloud 콘솔을 사용하는 경우 이는 콘솔에서 선택한 프로젝트입니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],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)."]]
