Dataplex 카탈로그 검색 구문

이 문서에서는 Dataplex 검색어의 구문을 설명합니다. 이 문서를 읽기 전에 데이터 항목, 관점, 관점 유형, 항목 그룹, 항목 유형과 같은 Dataplex 카탈로그의 개념을 이해하는 것이 중요합니다. 자세한 내용은 Dataplex Catalog 개요를 참조하세요.

Google Cloud 콘솔에서 Dataplex Catalog 검색어를 실행하려면 Dataplex 검색 페이지로 이동하여 검색 모드로 Dataplex Catalog를 선택합니다.

검색 페이지로 이동

자세한 내용은 Dataplex 카탈로그에서 리소스 검색을 참고하세요.

가장 간단한 형태의 Dataplex 카탈로그 검색어는 단일 조건자로 구성됩니다. 이러한 조건자는 다음과 같은 여러 메타데이터와 일치할 수 있습니다.

  • 이름, 표시 이름 또는 리소스 설명의 하위 문자열
  • 리소스 유형의 하위 문자열
  • 리소스 스키마에 있는 열 이름의 하위 문자열 (또는 중첩된 열 이름)
  • 프로젝트 ID의 하위 문자열
  • 개요 설명의 문자열

예를 들어 조건자 foo는 다음 항목과 일치합니다.

  • 이름이 foo.bar인 리소스
  • 표시 이름이 Foo Bar인 리소스
  • This is the foo script 설명이 포함된 리소스
  • 정확한 foo 유형의 리소스
  • 리소스 스키마의 열 foo_bar
  • 리소스 스키마의 중첩 열 foo_bar
  • 프로젝트 prod-foo-bar
  • 개요에 foo라는 단어가 포함된 리소스

한정된 조건자

특정 메타데이터 조각으로 일치를 제한하는 키를 조건자에 프리픽스로 지정하여 조건자를 한정시킬 수 있습니다.

  • 등호(=)는 검색을 일치검색으로 제한합니다.
  • 키 뒤의 콜론(:)은 조건자를 검색결과 값의 하위 문자열 또는 토큰과 일치시킵니다.

토큰화는 텍스트 스트림을 일련의 토큰으로 나누며, 각 토큰은 단어 하나에 해당합니다.

예를 들면 다음과 같습니다.

  • name:foofoo 하위 문자열이 포함된 이름의 항목을 선택합니다(예: foo1barfoo).
  • description:foo는 설명에서 foo 토큰이 있는 항목을 선택합니다(예: barfoo).
  • location=foo는 지정된 위치에서 위치 이름이 foo인 리소스와 일치합니다.

조건자 키 type, system, location, orgid는 하위 문자열 한정자(:)가 아닌 완전 일치(=) 한정자만 지원합니다. 예를 들어 type=foo 또는 orgid=number와 같이 사용됩니다.

Dataplex 카탈로그는 다음 한정자를 지원합니다.

한정자 설명
name:x 리소스 ID의 하위 문자열인 x과 일치합니다.
displayname:x 리소스 표시 이름의 하위 문자열인 x과 일치합니다.
column:x 리소스 스키마에서 열 이름 (또는 중첩 열 이름)의 하위 문자열인 x와 일치합니다.
description:x 리소스 설명에 있는 x 토큰을 찾습니다.
label:bar 라벨 (일부 값 포함)이 있고 라벨 키에 bar가 하위 문자열로 있는 BigQuery 리소스와 일치합니다.
label=bar 라벨 (일부 값 포함)이 있고 라벨 키가 문자열인 bar와 같은 BigQuery 리소스와 일치합니다.
label:bar:x BigQuery 리소스에 bar 키가 연결된 라벨의 값에서 하위 문자열인 x와 일치합니다.
label=foo:bar 키가 foo이고 키 값이 bar인 BigQuery 리소스와 일치합니다.
label.foo=bar 키가 foo이고 키 값이 bar인 BigQuery 리소스와 일치합니다.
label.foo 키가 문자열로 foo인 라벨이 있는 BigQuery 리소스와 일치합니다.
type=TYPE 특정 항목 유형 또는 유형 별칭의 리소스와 일치합니다.
projectid:bar ID에 bar를 하위 문자열로 포함하는 Google Cloud 프로젝트 내 리소스와 일치합니다.
parent:x 리소스의 계층적 경로에서 하위 문자열로 x와 일치합니다. 상위 경로는 상위 리소스의 fully_qualified_name입니다.
orgid=number number의 정확한 ID 값을 가진 Google Cloud 조직 내의 리소스와 일치합니다.
system=SYSTEM 지정된 시스템의 리소스를 일치시킵니다.
location=LOCATION

지정된 위치에서 이름이 정확하게 일치하는 리소스를 검색합니다. 예를 들어 location=us-central1은 Iowa에 호스팅되는 애셋과 일치합니다.

BigQuery Omni 애셋은 BigQuery Omni 위치 이름을 사용하여 이 한정자를 지원합니다. 예를 들어 location=aws-us-east-1은 버지니아 북부의 BigQuery Omni 애셋과 일치합니다.

createtime

지정된 날짜나 시간 내에, 이전 또는 이후에 생성된 리소스를 찾습니다.

예를 들면 다음과 같습니다.

  • createtime:2019-01-01은 2019-01-01에 생성된 리소스와 일치합니다.
  • createtime<2019-02는 2019-02-01T00:00:00 이전에 생성된 리소스와 일치합니다.
  • createtime>2019-02는 2019-02-01T00:00:00 이후에 생성된 리소스와 일치합니다.

YYYY-MM-DDThh:mm:ss 타임스탬프 형식:

모든 타임스탬프는 GMT여야 합니다(시간대가 지원되지 않음). 부분 타임스탬프, 하이픈(-) 날짜 구분선, 슬래시(/) 날짜 구분선이 지원됩니다.

예를 들면 다음과 같습니다.

  • 2010-10-22T05:36:24
  • 2010-10-22T05:36
  • 2010-10-22T05
  • 2010-10-22
  • 2010-10
  • 2010
  • 2010/10/22
updatetime

지정된 날짜나 시간 내에, 이전 또는 이후에 업데이트된 리소스를 찾습니다.

예를 들면 다음과 같습니다.

  • updatetime:2019-01-01은 2019-01-01에 업데이트된 리소스와 일치합니다.
  • updatetime<2019-02는 2019-02-01T00:00:00 이전에 업데이트된 리소스와 일치합니다.
  • updatetime>2019-02는 2019-02-01T00:00:00 이후에 업데이트된 리소스와 일치합니다.

YYYY-MM-DDThh:mm:ss 타임스탬프 형식:

모든 타임스탬프는 GMT여야 합니다(시간대가 지원되지 않음). 부분 타임스탬프, 하이픈(-) 날짜 구분선, 슬래시(/) 날짜 구분선이 지원됩니다.

예를 들면 다음과 같습니다.

  • 2010-10-22T05:36:24
  • 2010-10-22T05:36
  • 2010-10-22T05
  • 2010-10-22
  • 2010-10
  • 2010
  • 2010/10/22
fully_qualified_name:x fully_qualified_name의 하위 문자열로서 x와 일치합니다.
fully_qualified_name=x fully_qualified_name으로 x와 일치합니다.

연결된 관점을 기반으로 항목을 검색하려면 다음 쿼리 문법을 사용하세요.

한정자 설명
aspect:x 항목에 연결된 관점의 관점 유형에 대한 전체 경로의 하위 문자열로서 x와 일치합니다(projectid.location.ASPECT_TYPE_ID 형식).
aspect=x 항목에 연결된 관점의 관점 유형에 대한 전체 경로로서 x와 일치합니다(projectid.location.ASPECT_TYPE_ID 형식).
aspect:xOPERATORvalue

관점 필드 값을 검색합니다. 항목에 연결된 관점의 관점 유형 및 필드 이름에 대한 전체 경로의 하위 문자열로서 x와 일치합니다(projectid.location.ASPECT_TYPE_ID.FIELD_NAME 형식).

지원되는 연산자 목록은 다음과 같이 관점의 필드 유형에 따라 다릅니다.

  • 문자열: = (일치검색) 및 : (하위 문자열)
  • 모든 숫자 유형: =, :, <, >, <=, >=, =>, =<
  • Enum: =
  • 날짜/시간: 숫자와 동일하지만 비교할 값이 숫자가 아닌 날짜/시간으로 처리됩니다.
  • 불리언: =

관점의 최상위 필드만 검색할 수 있습니다.

예를 들어 다음 쿼리는 모두 employee-info 관점의 is-enrolled 필드 값이 true인 항목과 일치합니다. 하위 문자열과 일치하는 다른 항목도 반환됩니다.

  • aspect:example-project.us-central1.employee-info.is-enrolled=true
  • aspect:example-project.us-central1.employee=true
  • aspect:employee=true

논리 연산자

쿼리는 논리 연산자와 여러 조건자로 구성될 수 있습니다. 연산자를 지정하지 않으면 논리적 AND가 암시적으로 사용됩니다. 예를 들어 foo bar는 조건자 foo와 조건자 bar 모두와 일치하는 항목을 반환합니다.

논리적 AND 및 논리적 OR가 지원됩니다. 예를 들면 foo OR bar입니다.

-(하이픈) 또는 NOT 프리픽스를 사용하여 조건자를 부정할 수 있습니다. 예를 들어 -name:foo는 이름이 foo 조건자와 일치하지 않는 항목을 반환합니다.

논리 연산자는 대소문자를 구분하지 않습니다. 예를 들어 orOR 모두 사용 가능합니다.

축약된 구문

OR 연산자에 |(세로 막대)를 사용하고 AND 연산자에 ,(쉼표)를 사용하여 축약 검색 문법을 사용할 수도 있습니다.

예를 들어 OR 연산자를 사용하여 여러 프로젝트 중 하나에서 항목을 검색하려면 다음과 같은 축약된 문법을 사용할 수 있습니다.

projectid:(id1|id2|id3|id4)

축약된 문법을 사용하지 않고 동일한 검색을 수행하면 다음과 같이 표시됩니다.

projectid:id1 OR projectid:id2 OR projectid:id3 OR projectid:id4

일치하는 열 이름이 있는 항목을 검색하려면 다음을 사용하세요.

  • AND: column:(name1, name2, name3)
  • OR: column:(name1|name2|name3)

축약된 문법은 label을 제외한 한정된 조건자에 적용됩니다.

다음 단계