리소스 검색

Dataplex 범용 카탈로그 검색을 사용하여 BigQuery 데이터 세트, 테이블과 같은 BigQuery 내 Google Cloud 리소스를 찾습니다.

Dataplex 범용 카탈로그 검색은 자연어 검색 쿼리(시맨틱 검색 쿼리라고도 함)를 지원하므로 일상적인 언어로 리소스를 검색할 수 있습니다.

키워드 검색과 마찬가지로 자연어 검색은 조직 내 리소스와 연결된 메타데이터를 분석하여 리소스 검색을 강조합니다. 검색 시 내가 만든 메타데이터를 비롯하여 리소스를 설명하는 다양한 메타데이터가 고려됩니다.

자연어 검색은 정밀도보다 재현율을 높이는 데 중점을 둡니다.

BigQuery에서 테이블 데이터를 검색하는 방법에 관한 자세한 내용은 BigQuery 검색 소개를 참고하세요.

가입하고 미리보기

미리보기에 가입하려면 Google 계정 담당자가 가입 양식을 작성하여 요청을 제출해야 합니다. 양식을 제출하면 BigQuery팀에서 다음 단계를 안내해 드립니다.

시작하기 전에

BigQuery에서 자연어 검색을 사용하여Google Cloud 리소스를 검색하려면 이 섹션의 태스크를 완료하세요.

필요한 역할

리소스를 검색하려면 검색에 사용되는 프로젝트에 Dataplex 카탈로그 관리자, Dataplex 카탈로그 편집자 또는 Dataplex 카탈로그 뷰어 중 하나 이상의 Dataplex 범용 카탈로그 IAM 역할이 있어야 합니다. 검색 결과에 대한 권한은 선택한 프로젝트와는 별도로 확인됩니다.

BigQuery의 검색 결과는 기본 리소스에 대한 IAM 권한에 따라 범위가 지정됩니다. BigQuery에서 리소스를 검색하려면 해당 리소스에 액세스할 권한이 있어야 합니다. 자세한 내용은 이 문서의 검색 범위 섹션을 참고하세요.

예를 들어 BigQuery 데이터 세트, 테이블, 뷰, 모델을 검색하려면 해당 리소스에 액세스할 수 있는 권한이 필요합니다. 자세한 내용은 BigQuery 권한을 참고하세요. 다음 목록에서는 필요한 최소 권한을 설명합니다.

• 테이블을 검색하려면 해당 테이블에 대한 bigquery.tables.get 권한이 필요합니다.
• 데이터 세트를 검색하려면 해당 데이터 세트에 대한 bigquery.datasets.get 권한이 필요합니다.

BigQuery 메타데이터 뷰어 역할 (roles/bigquery.metadataViewer)에는 bigquery.tables.get 및 bigquery.datasets.get 권한이 모두 포함되어 있으며, 이 역할로 BigQuery 리소스를 검색할 수 있습니다.

역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

커스텀 역할 또는 기타 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

API 사용 설정

검색을 사용하려면 Dataplex API를 사용 설정했는지 확인하세요. Dataplex API는 BigQuery가 있는 모든 새 Google Cloud 프로젝트에 기본적으로 사용 설정됩니다. 프로젝트에서 Dataplex API가 사용 설정되어 있지 않으면 Dataplex 범용 카탈로그 사용 설정을 참고하세요.

리소스 검색

1. Google Cloud 콘솔에서 BigQuery 검색 페이지로 이동합니다.

   검색 페이지로 이동

2. 검색창에 자연어로 쿼리를 입력한 다음 Enter 키를 누릅니다. 다음은 몇 가지 샘플 쿼리입니다.

   • Show me the datasets that contain taxi information
   • Find data on vaccine distribution across different countries
   • Get tables with historical temperature data for major world cities
   • Search for hurricane tracking and storm activity datasets
   • Population data by country

3. 검색을 필터링하려면 필터를 클릭합니다. 다음 필터를 사용할 수 있습니다.

   • 범위: 조직 (기본값), 현재 프로젝트 전체에서 검색하거나 별표표시된 리소스만 검색합니다. 자세한 내용은 이 문서의 검색 범위 섹션을 참고하세요.
   • 시스템: Google Cloud 리소스가 속한 서비스입니다(예: BigQuery). Dataplex 범용 카탈로그 시스템에는 항목 그룹이 포함되어 있습니다.
   • 프로젝트: 검색할 프로젝트입니다.
   • 유형: BigQuery 연결, Cloud Storage 버킷, 데이터베이스와 같은 리소스 유형입니다. 리소스 유형에 따라 연결 유형 또는 SQL 언어와 같은 하위유형으로 필터링할 수도 있습니다.
   • 위치 선택: 검색할 위치입니다.
   • 데이터 세트 선택: 선택한 BigQuery 데이터 세트에 속한 BigQuery 리소스로 검색 결과가 제한됩니다. 필터링할 유형 필드에 데이터 세트의 이름을 입력합니다.
   • 주석: 검색 중인 리소스와 연결된 Dataplex 범용 카탈로그 관점 유형입니다. 측정기준 값으로 필터링하려면 주석 값 필터링을 클릭한 다음 값을 선택합니다.

   필터를 삭제하려면 삭제하려는 특정 필터 옆에 있는 clear 지우기를 클릭합니다. 또는 모든 필터를 삭제하려면 필터 지우기를 클릭합니다.

   필터가 평가되는 방식에 관한 자세한 내용은 이 문서의 필터 섹션을 참고하세요.

4. 선택사항: 리소스에 대한 자세한 정보를 보려면 검색 결과에서 리소스 이름을 클릭합니다.

   그러면 분할 창에 리소스 요약이 열립니다. 다음 중 하나를 수행합니다.

   • 리소스가 속한 서비스에서 리소스를 열려면 리소스의 PRODUCT_NAME에서 열기를 클릭합니다. 예를 들어 BigQuery Studio에서 BigQuery 데이터 세트를 열려면 Studio에서 열기를 클릭합니다. 사용 가능한 옵션은 리소스에 따라 다릅니다.
   • 리소스와 연결된 Dataplex 범용 카탈로그 메타데이터를 보려면 리소스의 Dataplex 카탈로그에서 열기를 클릭합니다.
   • 즐겨찾기에 추가하려는 중요한 검색 결과가 있는 경우 별표표시할 수 있습니다. 리소스의 star_border 별표를 클릭합니다. BigQuery 스튜디오에서 별표표시된 리소스를 볼 수 있습니다.
   • 분할 창에서 리소스 요약을 닫으려면 close 닫기를 클릭합니다.

필터

필터를 사용하면 검색 결과 범위를 좁힐 수 있습니다.

여러 섹션에 필터를 제공하면 AND 논리 연산자를 사용하여 필터가 평가됩니다. 검색 결과에는 선택한 모든 섹션에서 하나 이상의 조건과 일치하는 리소스가 포함됩니다. 예를 들어 BigQuery 시스템과 dataset 리소스 유형을 선택하면 검색 결과에 BigQuery 데이터 세트는 포함되지만 Vertex AI 데이터 세트는 포함되지 않습니다.

단일 섹션 내에서 여러 필터를 선택하면 OR 논리 연산자를 사용하여 필터가 평가됩니다. 예를 들어 dataset 리소스 유형과 table 리소스 유형을 선택하면 검색 결과에 데이터 세트와 테이블이 모두 포함됩니다.

검색 범위

Google Cloud 조직에 속한 프로젝트의 경우 검색이 해당 조직의 범위 내에서 작동합니다.

검색 결과는 리소스에 대한 사용자의 권한을 따릅니다. 예를 들어 리소스에 대한 BigQuery 메타데이터 읽기 액세스 권한이 있으면 해당 리소스가 검색 결과에 표시됩니다. BigQuery 테이블에 대해 액세스 권한이 있지만 이 테이블을 포함하는 데이터 세트에 대해서는 액세스 권한이 없는 경우에도 예상한 대로 테이블이 검색 결과에 표시됩니다.

검색 결과에는 검색이 수행되는 프로젝트와 동일한 VPC 서비스 제어 경계에 속하는 리소스만 포함됩니다. Google Cloud 콘솔을 사용하는 경우 이는 콘솔에서 선택한 프로젝트입니다.

다음 단계

• BigQuery 스튜디오에서 데이터를 분석하는 방법을 알아보세요.
• Dataplex 범용 카탈로그에서 키워드 검색을 사용하는 방법을 알아보세요.