Dataplex 카탈로그에서 리소스 검색

이 문서에서는 Dataplex 카탈로그에서 검색을 사용하여 BigQuery 데이터 세트, Cloud SQL 인스턴스 등의 리소스를 검색하는 방법을 설명합니다. Dataplex 카탈로그에서 지원되는 Google Cloud 애셋에 관한 자세한 내용은 지원되는 Google Cloud 소스를 참고하세요.

검색 범위

Dataplex 카탈로그의 검색 결과는 소스 시스템에서 해당 리소스에 대해 있는 권한을 존중합니다.

예를 들어 객체에 대해 BigQuery 메타데이터 읽기 액세스 권한이 있으면 해당 객체가 Dataplex 카탈로그 검색 결과에 표시됩니다. BigQuery 테이블에 대해 액세스 권한이 있지만 이 테이블을 포함하는 데이터 세트에 대해서는 액세스 권한이 없는 경우에도 예상한 대로 테이블이 Dataplex 카탈로그 검색에 표시됩니다.

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

프로젝트의 VPC 서비스 제어 경계 내 리소스 이상으로 검색 결과의 범위를 확장하려면 VPC 서비스 제어 인그레스 및 이그레스 규칙을 사용하세요. 이러한 규칙은 조직 전반에서 효율적인 비공개 데이터 교환을 용이하게 합니다. Google Cloud 콘솔을 사용하거나 JSON 또는 YAML 파일을 통해 인그레스 및 이그레스 규칙을 구성할 수 있습니다. 다음 YAML 예시를 참고하고 VPC 서비스 제어 문서를 참고하여 특정 요구사항에 맞게 규칙을 조정하세요.

egressPolicies:
  - egressFrom:
      identityType: ANY_USER_ACCOUNT
    egressTo:
      # Specify which resources should be present in the search results. In this example,
      # BigQuery.
      operations:
      - methodSelectors:
        - method: '*'
        serviceName: bigquery.googleapis.com
      # Specify project ids under which the search is performed.
      resources:
      - projects/SEARCH_PROJECT_ID
ingressPolicies:
  - ingressFrom:
      identityType: ANY_USER_ACCOUNT
      sources:
      - accessLevel: '*'
    ingressTo:
      # Specify which resources should be present in the search results. In this example,
      # BigQuery.
      operations:
      - methodSelectors:
        - method: '*'
        serviceName: bigquery.googleapis.com
      # Specify project ids to expose in search results.
      resources:
      - projects/INGRESS_PROJECT_ID

Dataplex 카탈로그 Identity and Access Management 역할에 대한 자세한 내용은 Dataplex IAM 역할을 참고하세요.

검색에서 재현율 제한

Dataplex 카탈로그 검색어는 전체 재현율을 보장하지 않습니다. 후속 결과 페이지에서도 검색어와 일치하는 결과가 반환되지 않을 수 있습니다. 또한 검색어를 반복하면 반환된(및 반환되지 않는) 결과가 달라질 수 있습니다.

필터

필터를 사용하면 검색 결과 범위를 좁힐 수 있습니다. 모든 필터는 다음과 같은 섹션별로 그룹화됩니다.

• BigQuery, Cloud SQL과 같은 시스템. Dataplex 시스템에는 커스텀 항목이 포함되어 있습니다.
• 사용할 수 있는 모든 관점이 나열된 관점(태그)
• 사용할 수 있는 모든 프로젝트가 나열된 프로젝트
• 유형 별칭은 데이터베이스, 데이터 세트, 모델, 테이블, 뷰, 서비스, 커스텀 유형과 같은 리소스 유형을 설명합니다.
• 데이터 세트는 BigQuery에서 가져옵니다.

여러 섹션의 필터를 조합하여 선택한 모든 섹션에서 하나 이상의 조건과 일치하는 자산을 찾을 수 있습니다. 단일 섹션 내에서 선택한 여러 필터는 OR 논리 연산자를 사용하여 평가됩니다.

예를 들어 다음 이미지의 필터 조합을 살펴보세요 (확대하려면 클릭). 시스템 BigQuery, 유형 별칭 table 및 view, 관점 My aspect type 1 및 My aspect type 2, 프로젝트 my-test-project, 데이터 세트 test_bq_dataset 등의 검색 필터가 선택됩니다.

Dataplex 카탈로그는 다음 애셋을 찾습니다.

• 관점이 My aspect type 1인 test_bq_dataset의 BigQuery 테이블
• 관점이 My aspect type 2인 test_bq_dataset의 BigQuery 테이블
• 관점이 My aspect type 1인 test_bq_dataset의 BigQuery 뷰
• 관점이 My aspect type 2인 test_bq_dataset의 BigQuery 뷰

관점 값으로 필터링

관점 필터를 사용하면 특정 템플릿을 사용하여 태그된 애셋을 쿼리할 수 있습니다. 맞춤설정 메뉴를 사용하여 결과를 미세 조정하고 특정 관점 값으로 필터링할 수 있습니다. 관점 값 필터 조건은 해당 관점 필드의 데이터 유형에 따라 달라집니다. 예를 들어 datetime 및 number 필드의 경우 특정 날짜 또는 범위를 지정할 수 있습니다.

필터 공개 상태

시스템, 유형 별칭, 프로젝트, 데이터 세트 필터는 검색 필드의 현재 검색어에 따라 표시됩니다.

시작하기 전에

리소스를 검색하기 전에 필수 역할이 있고 API가 사용 설정되어 있는지 확인합니다.

필요한 역할

이 섹션에서는 리소스를 검색하고 검색 결과에 액세스하는 데 필요한 역할과 권한에 대해 설명합니다.

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

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

항목 검색에 필요한 역할

항목을 검색하려면 검색에 사용되는 프로젝트에 대한 Dataplex 카탈로그 IAM 역할이 1개 이상 필요합니다. 검색 결과에 대한 권한은 선택한 프로젝트와는 별도로 확인됩니다.

검색 결과에 액세스하는 데 필요한 역할

Dataplex 카탈로그의 검색 결과는 역할에 따라 범위가 지정됩니다. Dataplex 카탈로그에서 애셋을 검색하려면 소스 시스템에서 해당 리소스에 액세스할 권한이 있어야 합니다. 자세한 내용은 이 문서의 검색 범위 섹션을 참조하세요.

예를 들어 BigQuery 데이터 세트, 테이블, 뷰, 모델을 검색하려면 해당 항목에 대한 권한이 필요합니다. 자세한 내용은 BigQuery 권한을 참조하세요.

다음 목록에서는 필요한 최소 권한을 설명합니다.

• 테이블을 검색하려면 해당 테이블에 대한 bigquery.tables.get 권한이 필요합니다.
• 데이터 세트를 검색하려면 해당 데이터 세트에 대한 bigquery.datasets.get 권한이 필요합니다.
• 데이터 세트 또는 테이블의 메타데이터를 검색하려면 BigQuery 메타데이터 뷰어 역할 (roles/bigquery.metadataViewer)이 필요합니다.

또 다른 예시로 Cloud SQL 인스턴스, 데이터베이스, 스키마, 테이블, 뷰를 검색하려면 해당 항목에 대한 권한이 필요합니다. 자세한 내용은 Cloud SQL 역할 및 권한을 참조하세요.

커스텀 항목을 검색하려면 Dataplex 카탈로그 뷰어 역할(roles/dataplex.catalogViewer)이 필요합니다.

API 사용 설정

Enable the Dataplex API.

Enable the API

리소스 검색

항목 세부정보 보기

다음 단계

• Dataplex 카탈로그 검색 구문 이해하기
• Dataplex 카탈로그 자세히 알아보기
• 관점을 사용하여 메타데이터로 항목을 보강하는 방법 알아보기
• 항목 관리 및 커스텀 소스 수집 방법 알아보기