이 문서에서는 Dataplex 검색어의 구문을 설명합니다. 이 문서를 읽기 전에 데이터 항목, 관점, 관점 유형, 항목 그룹, 항목 유형과 같은 Dataplex 카탈로그의 개념을 이해하는 것이 중요합니다. 자세한 내용은 Dataplex Catalog 개요를 참조하세요.
Google Cloud 콘솔에서 Dataplex 카탈로그 검색어를 실행하려면 Dataplex 검색 페이지로 이동하여 검색 모드로 Dataplex 카탈로그를 선택합니다.
자세한 내용은 Dataplex 카탈로그에서 데이터 애셋 검색을 참조하세요.
간단한 검색
가장 단순한 형태의 Dataplex 카탈로그 검색어는 단일 조건자로 구성됩니다. 이러한 조건자는 다음과 같은 여러 메타데이터와 일치할 수 있습니다.
- 이름, 표시 이름 또는 데이터 애셋 설명의 하위 문자열
- 데이터 애셋 유형의 하위 문자열
- 데이터 애셋의 스키마에 있는 열 이름의 하위 문자열(또는 중첩된 열 이름)
- 프로젝트 ID의 하위 문자열
- 개요 설명의 문자열
예를 들어 조건자 foo는 다음 항목과 일치합니다.
- 이름이
foo.bar인 데이터 애셋 - 표시 이름이
Foo Bar인 데이터 애셋 This is the foo script설명을 포함한 데이터 애셋- 정확한
foo유형의 데이터 애셋 - 데이터 애셋 스키마의 열
foo_bar - 데이터 애셋 스키마의 중첩 열
foo_bar - 프로젝트
prod-foo-bar - 개요에
foo라는 단어가 포함된 데이터 애셋
한정된 조건자
특정 메타데이터 조각으로 일치를 제한하는 키를 조건자에 프리픽스로 지정하여 조건자를 한정시킬 수 있습니다.
- 등호(
=)는 검색을 일치검색으로 제한합니다. - 키 뒤의 콜론(
:)은 조건자를 검색결과 값의 하위 문자열 또는 토큰과 일치시킵니다.
토큰화는 텍스트 스트림을 일련의 토큰으로 나누며, 각 토큰은 단어 하나에 해당합니다.
예를 들면 다음과 같습니다.
name:foo는foo하위 문자열이 포함된 이름의 항목을 선택합니다(예:foo1및barfoo).description:foo는 설명에서foo토큰이 있는 항목을 선택합니다(예:bar및foo).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 |
지정된 위치에서 이름이 정확하게 일치하는 모든 데이터 애셋과 일치합니다.
예를 들어 BigQuery Omni 애셋은 BigQuery Omni 위치 이름을 사용하여 이 한정자를 지원합니다.
예를 들어 |
createtime |
지정된 날짜나 시간 내에, 이전 또는 이후에 생성된 데이터 애셋을 찾습니다. 예를 들면 다음과 같습니다.
모든 타임스탬프는 GMT여야 합니다(시간대가 지원되지 않음). 부분 타임스탬프, 하이픈( 예를 들면 다음과 같습니다.
|
updatetime |
지정된 날짜나 시간 내에, 이전 또는 이후에 업데이트된 데이터 애셋을 찾습니다. 예를 들면 다음과 같습니다.
모든 타임스탬프는 GMT여야 합니다(시간대가 지원되지 않음). 부분 타임스탬프, 하이픈( 예를 들면 다음과 같습니다.
|
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 |
관점 필드 값을 검색합니다. 항목에 연결된 관점의 관점 유형 및 필드 이름에 대한 전체 경로의 하위 문자열로서 지원되는 연산자 목록은 다음과 같이 관점의 필드 유형에 따라 다릅니다.
관점의 최상위 필드만 검색할 수 있습니다. 예를 들어 다음 쿼리는 모두
|
논리 연산자
논리 연산자와 여러 조건자를 묶어서 쿼리를 구성할 수 있습니다. 연산자를 지정하지 않으면 논리적 AND가 암시적으로 사용됩니다. 예를 들어 foo bar는 조건자 foo와 조건자 bar 모두와 일치하는 항목을 반환합니다.
논리적 AND 및 논리적 OR가 지원됩니다. 예를 들면 foo OR bar입니다.
-(하이픈) 또는 NOT 프리픽스를 사용하여 조건자를 부정할 수 있습니다. 예를 들어 -name:foo는 이름이 foo 조건자와 일치하지 않는 항목을 반환합니다.
논리 연산자는 대소문자를 구분하지 않습니다. 예를 들어 or와 OR 모두 사용 가능합니다.
축약된 구문
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을 제외한 한정된 조건자에 적용됩니다.
다음 단계
- Dataplex 카탈로그에서 데이터 애셋을 검색하는 방법 알아보기
- Dataplex 카탈로그 자세히 알아보기
- 관점을 사용하여 메타데이터로 항목을 보강하는 방법 알아보기
- 항목 관리 및 커스텀 소스 수집 방법 알아보기