Knowledge Catalog의 검색 기능 정보

Knowledge Catalog (이전의 Dataplex Universal Catalog) 검색을 사용하여 시맨틱 일치, 키워드, 구조화된 술어가 포함된 자연어 쿼리를 사용하여 조직 전체에서 리소스를 검색합니다.

사용 사례

다음 목록에서는 설명 및 쿼리 예와 함께 일반적인 검색 사용 사례를 설명합니다.

  • 타겟팅된 애셋 조회: 애셋 이름, 열 또는 설명과 관련된 키워드를 검색하여 특정 애셋을 찾습니다.

    쿼리 예

    • retail_transactions_2026
    • customer_id
    • column:customer_id

  • 광범위한 데이터 검색: 개방형 자연어 또는 키워드 쿼리를 사용하여 조직 전체에서 관련 애셋을 식별합니다.

    쿼리 예

    • quarterly financial reports
    • ad campaign click through rates tables
    • server health metrics
    • audit logs system=bigquery

  • 워크플로를 위한 범위 지정된 애셋 검색: 프로젝트와 같은 특정 컨테이너 내에서 또는 유형 또는 시스템과 같은 특정 속성을 사용하여 애셋을 열거합니다. 이 접근 방식은 프로그래매틱 워크플로 및 에이전트형 워크플로에 자주 사용됩니다.

    쿼리 예

    • type=table projectid:banking-prod aspect:classification.tier=PII
    • system=spanner projectid:inventory-service (parent=marketing_analytics OR parent=finance_analytics)

작동 방식

검색은 Knowledge Catalog에 유지되는 데이터 애셋의 모든 컨텍스트를 자동으로 색인 생성합니다. 여기에는 다음이 포함됩니다.

  • BigQuery 및 Cloud SQL과 같은 Google Cloud 데이터 소스에서 자동으로 수집되는 메타데이터
  • 커넥터 및 통합을 통해 수집하는 리소스의 컨텍스트
  • 비즈니스 컨텍스트를 나타내거나 데이터 시맨틱스를 설명하는 등 리소스에 대해 만드는 추가 컨텍스트 컨텍스트는 측면 또는 연결된 비즈니스 용어의 형태로도 캡처될 수 있습니다.

검색은 쿼리를 처리할 때 시맨틱 일치와 키워드 일치를 조합하여 적용합니다. 다음 표에서는 설명 및 샘플 쿼리와 함께 Knowledge Catalog 검색에서 사용할 수 있는 쿼리 유형을 설명합니다.

쿼리 유형 사용 예시
단일 키워드 애셋 이름, 설명, 스키마와 같은 메타데이터 요소에서 정확히 일치하는 항목과 하위 문자열 일치 항목을 찾습니다. prd_fin_invoices_fct_v02
부분 키워드 및 토큰화된 프래그먼트 메타데이터 콘텐츠에서 하위 문자열을 일치시켜 약어, 분리된 단어 또는 이름 지정 변형이 있는 리소스도 찾습니다. fin transactions 2026 (일치 항목: prd_fin_transactions_fy2026_raw)
자연어 쿼리 정확한 이름 또는 열 일치가 필요하지 않고 시맨틱 일치를 사용합니다. customer churn prediction features
구조화된 술어 검색 결과를 좁히기 위해 자유 형식 텍스트 쿼리와 명시적 술어 필터를 결합합니다. audit logs system=bigquery
확장된 구문 특정 범위로 좁혀진 정확한 검색을 위해 사용합니다. 확장된 구문은 에이전트형 사용 사례 및 프로그래매틱 사용 사례에서 가장 자주 사용됩니다. 자세한 내용은 검색 구문을 참고하세요. (system:bigquery OR system:spanner) AND column:credit_card_number aspect:classification.tier=PII -projectid:sandbox-project

Knowledge Catalog에서 검색에 액세스하는 옵션은 다음과 같습니다.

검색 범위

Knowledge Catalog의 검색 결과는 소스 시스템에서 해당 리소스에 대해 있는 권한을 존중합니다.

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

기본적으로 검색 범위는 조직으로 지정됩니다. 결과에는 검색 중인 프로젝트와 동일한 조직의 리소스만 포함됩니다.

검색 결과에는 검색이 수행되는 프로젝트와 동일한 VPC 서비스 제어 경계에 속하는 리소스만 포함됩니다. 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

Knowledge Catalog 검색을 사용하는 데 필요한 Identity and Access Management 역할에 관한 자세한 내용은 Knowledge Catalog IAM 역할을 참고하세요.

VPC 서비스 제어를 사용하여 환경별로 검색 결과 격리

개발, 테스트, 프로덕션과 같은 환경 간에 Knowledge Catalog 검색 결과를 격리하려면 환경마다 별도의 VPC 서비스 제어 경계를 구성합니다. 데이터 애셋이 포함된 프로젝트와 검색을 수행하는 데 사용되는 프로젝트 모두 해당 환경의 경계에 할당합니다. 특정 경계 내의 프로젝트에서 수행되는 검색은 동일한 경계 내에 있는 애셋의 결과만 반환합니다.

검색에서 재현율 제한

Knowledge Catalog 검색어는 전체 재현율을 보장하지 않습니다. 즉, 검색에서 쿼리와 일치하는 결과를 반환하지 않을 수 있습니다. 또한 검색어를 반복하면 반환된 결과와 반환되지 않은 결과가 다를 수 있습니다.

모든 Knowledge Catalog 메타데이터를 쿼리하려면 메타데이터를 Cloud Storage로 내보낸 후 BigQuery에서 쿼리하면 됩니다. 자세한 내용은 메타데이터 내보내기를 참고하세요.

다음 단계