Knowledge Catalog(이전 명칭: Dataplex Universal Catalog)의 관점 및 관점 유형을 사용하면 항목, 열, 항목 링크에 구조화된 메타데이터를 추가하여 데이터 애셋과 그 관계를 설명할 수 있습니다. 이 컨텍스트는 데이터 검색 가능성을 개선하고 개인 식별 정보(PII)와 같은 민감한 정보를 분류하여 데이터 품질 또는 액세스 정책을 적용하는 데 도움이 됩니다.
애스펙트 스키마, 시스템 및 커스텀 애스펙트 유형, 타겟 레벨, 데이터 레지던시 제약 조건에 대한 개념 정보는 애스펙트 및 애스펙트 유형 정보를 참조하세요. 전체 메타데이터 메타모델의 아키텍처 개요는 Knowledge Catalog의 메타데이터 정보를 참조하세요. Knowledge Catalog 메타데이터를 처음 사용하는 경우 BigQuery 테이블에 메타데이터 추가 또는 비즈니스 용어집 만들기 및 사용 빠른 시작을 참조하세요.
시작하기 전에
관점 유형과 관점을 만들고 관리하기 전에 이 섹션에 설명된 태스크를 완료합니다.
필요한 역할
관점 유형 및 관점을 만들고 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요. 이러한 역할을 모두 동시에 가질 필요는 없습니다. 특정 워크플로에 맞는 역할 또는 조합을 선택하세요.
관점 유형과 관점을 만들고 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
광범위한 관리자 액세스 권한으로 관점 유형 및 항목을 포함한 모든 카탈로그 리소스를 관리하려면 Dataplex 카탈로그 관리자(
roles/dataplex.catalogAdmin) 또는 Dataplex 카탈로그 편집자(roles/dataplex.catalogEditor)를 사용합니다. -
관점 유형 관리자에게 최소 권한 액세스 권한을 부여하여 커스텀 관점 유형만 만들고 관리:
Dataplex 관점 유형 소유자 (
roles/dataplex.aspectTypeOwner) -
데이터 큐레이터에 대한 최소 권한 액세스로 항목을 만들거나 수정할 때 관점 유형을 사용하려면 Dataplex 관점 유형 사용자 (
roles/dataplex.aspectTypeUser)를 사용합니다. -
schema,contacts,overview와 같은 재사용 가능한 시스템 관점 유형을 항목 및 항목 링크에 연결: Dataplex 항목 및 항목 링크 소유자 (roles/dataplex.entryOwner) -
관점 유형 및 IAM 정책을 수정하지 않고 보려면 Dataplex 카탈로그 뷰어(
roles/dataplex.catalogViewer)를 사용합니다.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이러한 사전 정의된 역할에는 관점 유형 및 관점을 만들고 관리하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
관점 유형과 관점을 만들고 관리하려면 다음 권한이 필요합니다.
-
관점 유형 만들기, 보기, 나열, 업데이트, 삭제:
-
dataplex.aspectTypes.create -
dataplex.aspectTypes.get -
dataplex.aspectTypes.list -
dataplex.aspectTypes.update -
dataplex.aspectTypes.delete
-
-
관점 유형을 사용하여 항목 보강:
dataplex.aspectTypes.use -
항목 및 해당 관점을 만들고, 보고, 업데이트하고, 삭제합니다.
-
dataplex.entries.create -
dataplex.entries.get -
dataplex.entries.list -
dataplex.entries.update -
dataplex.entries.delete
-
-
항목 링크 및 해당 관점을 만들고, 보고, 업데이트하고, 삭제합니다.
-
dataplex.entryLinks.create -
dataplex.entryLinks.get -
dataplex.entryLinks.list -
dataplex.entryLinks.update -
dataplex.entryLinks.delete
-
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
자세한 내용은 Knowledge Catalog IAM 역할을 참조하세요.
API 사용 설정
Knowledge Catalog 프로젝트에서 Dataplex API를 사용 설정합니다. 새 Google Cloud 프로젝트 또는 BigQuery API가 사용 설정된 프로젝트를 사용하는 경우 Dataplex API가 기본적으로 사용 설정됩니다.
커스텀 관점 유형 만들기
콘솔
Google Cloud 콘솔에서 커스텀 관점 유형을 만들려면 다음 하위 작업을 따르세요.
기본 세부정보 구성:
Google Cloud 콘솔에서 Knowledge Catalog 메타데이터 유형 페이지로 이동합니다.
관점 유형 > 커스텀 탭을 클릭한 후 관점 유형 만들기를 클릭합니다.
세부정보 섹션에서 다음을 입력합니다.
- 선택사항: 표시 이름: 관점 유형의 사용자 친화적인 이름입니다.
- 관점 유형 ID: 관점 유형의 고유 식별자입니다.
- 선택사항: 설명: 관점 유형 및 목적에 대한 설명입니다.
- 위치: 관점 유형의 위치를 선택합니다. 생성 후에는 위치를 수정할 수 없습니다. 전역 위치와 리전 위치의 장단점에 대한 안내는 커스텀 관점 유형을 참조하세요.
스키마 템플릿 정의:
템플릿은 관점 유형 내에 그룹화되는 메타데이터 필드의 형식과 스키마를 정의합니다. 필드를 수동으로 정의하거나 템플릿 갤러리에서 데이터 민감도, 데이터 거버넌스, 데이터 수집과 같은 시작 템플릿을 선택하여 스키마 생성을 가속화할 수 있습니다. 예를 들어 데이터 민감도 템플릿을 선택하면 불리언 필드
Is Encrypted및Has PII, enum 필드PII Type가 자동으로 추가됩니다.필드를 수동으로 정의하려면 다음 안내를 따르세요.
- 템플릿 섹션에서 필드 추가를 클릭합니다.
- 새 필드 패널에서 다음을 지정합니다.
- 이름: 필드의 식별자입니다.
- 선택사항: 표시 이름: 사용자 친화적인 라벨입니다.
- 선택사항: 설명: 필드에 대한 간단한 설명입니다.
- 유형: 필드 데이터 유형을 선택합니다. 지원되는 유형에는 텍스트, 정수, 불리언, 날짜 및 시간, Double, enum, 배열, 지도, 레코드가 있습니다.
- 선택사항: 필수: 사용자가 이 관점을 연결할 때 필드를 필수로 만들려면 이 체크박스를 선택합니다.
- 완료를 클릭합니다. 필드를 더 추가하려면 필드 추가를 클릭하고 이 단계를 반복합니다.
리소스 라벨 추가 및 저장:
리소스 라벨은 Google Cloud 리소스를 구성하고 필터링하는 데 도움이 되는 임의의 키-값 쌍입니다. 예를 들어
environment: production또는team: analytics과 같은 라벨을 사용하여 환경 또는 팀 소유권별로 리소스를 구성할 수 있습니다.- 라벨 섹션에서 라벨 추가를 클릭합니다.
- 라벨 키 및 값을 입력합니다.
- 저장을 클릭합니다.
gcloud
커스텀 관점 유형을 만들려면 gcloud dataplex aspect-types
create 명령어를 사용합니다.
C#
C#
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog C# API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Go
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Go API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
자바
Java
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Java API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Node.js API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Python API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Ruby
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Ruby API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
REST
커스텀 관점 유형을 만들려면 aspectType.create 메서드를 사용합니다.
커스텀 관점 유형을 만든 후에는 관점을 항목에 추가할 수 있습니다.
레코드 ID 및 레코드 참조 필드 사용 예시
재귀적 참조를 위해 레코드 ID 및 레코드 참조 필드를 사용할 수 있습니다. 다음 예시에서는 이러한 필드를 사용하는 방법을 보여줍니다.
다음 필드가 있는 Employee 관점 유형을 고려해 보겠습니다.
- 이름(유형:
Text) - 시작일(유형:
Date & time) - 지정(유형:
Text) - 현재 주소(유형:
Record) - 영구 주소(유형:
Record)
두 주소 필드인 현재 주소 및 영구 주소는 같은 Record 데이터 유형입니다. 중복을 방지하려면 이러한 필드를 정의할 때 레코드 ID 및 레코드 참조 값을 설정하면 됩니다.
현재 주소 필드를 정의할 때 레코드 ID를 address-field로 지정할 수 있습니다. 영구 주소의 경우 레코드 참조에 같은 값(address-field)을 지정할 수 있습니다. 예를 들면 다음과 같습니다.
- 이름(유형:
Text) - 시작일(유형:
Date & time) - 지정(유형:
Text) - 현재 주소(유형:
Record, 레코드 ID:address-field) - 영구 주소(유형:
Record, 레코드 참조:address-field)
이렇게 하면 다른 주소의 필드를 중복하지 않아도 됩니다.
항목에 관점 추가
커스텀 관점 유형을 만든 후에는 해당 유형 관점을 만들 수 있습니다. 항목에 관점을 추가하려면 항목을 업데이트해야 합니다. 관점이 항목 내에 저장되기 때문입니다.
유의해야 할 제한사항은 다음과 같습니다.
- 항목이나 항목의 열에 관점을 추가할 수 있습니다.
- 커스텀 항목에 대한 필수 관점만 수정할 수 있습니다. 필수 관점은 삭제할 수 없습니다.
- 커스텀 항목과 시스템 항목 모두에 대해 선택적 관점을 수정하고 삭제할 수 있습니다.
CREATE OR REPLACE TABLE문,TRUNCATE TABLE문 또는WRITE_TRUNCATE작업을 사용하여 BigQuery 테이블을 바꾸거나 새로고침하면 Knowledge Catalog에서 항목의 사용자 연결 관점을 보존합니다. 스키마에 남아 있는 열의 열 수준 관점도 보존됩니다. 하지만DROP TABLE문과CREATE TABLE문을 사용하여 테이블을 삭제하고 다시 만들면 Knowledge Catalog는 원래 테이블의 사용자 연결 관점이 없는 새 항목을 만듭니다. 테이블을 새로고침할 때 가로세로 비율을 유지하려면CREATE OR REPLACE TABLE,TRUNCATE TABLE또는WRITE_TRUNCATE를 사용합니다. 또는 BigQuery 뷰를 만들고 뷰에 관점을 연결할 수 있습니다.
콘솔
Google Cloud 콘솔에서 Knowledge Catalog 검색 페이지로 이동합니다.
관점을 추가할 항목을 검색하고 항목을 클릭합니다. 항목 세부정보 페이지가 열립니다.
항목 세부정보 페이지에서 세부정보 탭을 클릭합니다.
관점 섹션의 필수 관점 또는 선택적 관점 영역에서 추가를 클릭합니다. 항목 유형에서 필수 관점을 정의하는 경우에만 필수 관점을 추가할 수 있습니다.
추가하려는 관점을 검색하고 선택합니다.
관점 추가 창에서 필드 값을 입력합니다.
저장을 클릭합니다.
항목 열에 관점을 추가하려면 다음 안내를 따르세요.
- 항목 세부정보 페이지에서 스키마 탭을 클릭합니다.
- 관점을 추가할 열을 선택합니다.
- 관점 추가를 클릭합니다.
- 추가하려는 관점을 검색하고 선택합니다.
- 관점 추가 창에서 필드 값을 입력합니다.
- 저장을 클릭합니다.
gcloud
항목이나 항목 열에 관점을 추가하려면 gcloud
dataplex entries update 명령어를 사용합니다.
C#
C#
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog C# API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
항목 객체에 관점을 추가하려면 관점을 참고하세요.
Go
Go
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Go API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
항목 객체에 관점을 추가하려면 항목을 참고하세요.
자바
Java
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Java API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Node.js API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Python API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Ruby
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Ruby API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
항목 객체에 관점을 추가하려면 #required_aspects=를 참고하세요.
REST
항목 또는 항목의 열에 관점을 추가하려면 entry.patch 메서드를 사용합니다.
각 관점 유형과 항목이 서로 다른 Google Cloud 조직에 있는 항목에서 관점을 만들고 사용할 수 없습니다.
재사용 가능한 시스템 관점 유형의 관점 연결
Knowledge Catalog는 항목에 연결하여 표준화된 메타데이터를 캡처할 수 있는 사전 정의된 시스템 관점 유형을 제공합니다. 예를 들어 이러한 관점 유형을 사용하여 소유권 연락처, 스키마 정의, 사용량 측정항목, 데이터 품질 결과를 기록할 수 있습니다.
일반 워크플로 및 페이로드 규칙
재사용 가능한 시스템 관점 유형의 관점을 연결할 때는 다음 규칙을 따르세요.
- 콘솔과 CLI/REST 비교:
generic와 같이 중첩된 필드가 없는 관점 유형의 경우 Google Cloud 콘솔,gcloudCLI 또는 REST API를 사용할 수 있습니다.data-quality-scorecard,contacts,data-profile와 같이 복잡하거나 중첩된 구조가 있는 관점 유형의 경우gcloudCLI 또는 REST API를 사용해야 합니다. - 페이로드 구조:
gcloudCLI: 전역 관점 유형 식별자({"dataplex-types.global.<ASPECT_TYPE>": {"data": { ... }}})를 키로 사용하여 관점 맵을 직접 전달합니다.- REST API: 관점 맵을
"aspects"컨테이너 객체({"aspects": {"dataplex-types.global.<ASPECT_TYPE>": {"data": { ... }}}}) 내에 래핑합니다.
- 덮어쓰기 동작: 관점을 업데이트하면 대상 항목 또는 열에서 해당 관점 유형의 기존 데이터가 대체되며 필드가 병합되지 않습니다.
다음 섹션에서는 데이터 품질 스코어카드를 시작으로 재사용 가능한 일반적인 시스템 관점을 연결하는 예시와 스키마를 제공합니다.
데이터 품질 스코어카드
데이터 품질 스코어카드는 데이터 품질 스캔 또는 기타 프로세스를 기반으로 데이터 품질 요약을 제공하는 관점입니다. 항목에 데이터 품질 스코어카드를 연결하여 커스텀 데이터 품질 정보를 제공할 수 있습니다. 이렇게 하려면 시스템 정의 유형 data-quality-scorecard의 관점을 연결합니다.
data-quality-scorecard 관점 내의 data 필드에는 다음 필드가 포함될 수 있습니다.
job: 선택사항. 스코어카드를 생성한 작업에 대한 세부정보가 포함된 레코드입니다.name: 데이터 품질 작업의 리소스 이름입니다.runTime: 데이터 품질 작업의 실행 시간입니다.
score: 선택사항. 전반적인 데이터 품질 점수입니다. 점수 범위는 [0, 100]입니다.status: (필수사항) 데이터 품질 스코어카드의 상태로, 품질 기준을 통과했는지 여부를 나타냅니다(PASS또는FAIL).dimensions: 선택사항. 측정기준 결과의 배열입니다. 각 결과에는 다음이 포함됩니다.name: 측정기준의 이름입니다.ACCURACY,COMPLETENESS,CONSISTENCY,FRESHNESS,UNIQUENESS,VALIDITY,VOLUME또는 맞춤 측정기준 이름 중 하나일 수 있습니다. 맞춤 측정기준 이름은 대문자를 사용해야 하며 30자(영문 기준) 이하여야 합니다.score: 전체 측정기준 수준 점수입니다(0~100).status: 측정기준의 상태로, 품질 기준을 통과했는지 여부를 나타냅니다(PASS또는FAIL).
columns: 선택사항. 열 결과의 배열입니다. 각 결과에는 다음이 포함됩니다.name: 열 이름입니다.score: 전체 열 수준 점수이며 범위는 [0, 100]입니다.status: 품질 기준(PASS또는FAIL)을 통과했는지 또는 실패했는지를 나타내는 열의 상태입니다.dimensions: 열의 측정기준 점수 배열입니다. 각 측정기준 점수에는 다음이 포함됩니다.name: 측정기준의 이름입니다.score: 측정기준의 점수입니다(0~100).status: 열의 측정기준 상태로, 품질 기준을 통과했는지 여부를 나타냅니다(PASS,FAIL,UNKNOWN,NOT_APPLICABLE).
details(선택사항 맵): 평가에 대한 추가 컨텍스트를 제공하는 키-값 쌍입니다.evaluatedAssetCount(선택사항, 정수): 평가된 애셋 수입니다.
관점을 연결하는 명령어를 실행하면 해당 관점의 기존 데이터가 대체됩니다. 예를 들어 점수가 80인 스코어카드를 점수가 90인 새 파일로 업데이트하면 80를 덮어씁니다. 데이터를 병합하지 않습니다.
데이터 품질 스코어카드를 연결하려면 다음 단계를 따르세요.
gcloud
항목의 관점을 업데이트하려면 gcloud dataplex entries
update-aspects 명령어를 사용합니다.
다음 콘텐츠로 JSON 파일(
dq-aspect.json)을 만듭니다.{ "dataplex-types.global.data-quality-scorecard": { "data": { "score": 80, "status": "PASS", "dimensions": [ { "name": "completeness", "score": 90, "status": "PASS" }, { "name": "uniqueness", "score": 70, "status": "FAIL" } ], "columns": [ { "name": "col1", "score": 85, "status": "PASS" } ] } } }다음 명령어를 실행합니다.
gcloud dataplex entries update-aspects ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --aspects=dq-aspect.json
다음 변수를 바꿉니다.
ENTRY_ID: 항목의 ID입니다(예:example-entry).LOCATION: 항목의 위치(예:us-central1)ENTRY_GROUP_ID: 항목 그룹의 ID(예:example-entry-group)PROJECT_ID: 프로젝트 ID입니다(예:example-project).
REST
항목의 관점을 업데이트하려면 entry.patch 메서드를 사용합니다.
payload.json이라는 파일을 만들고 요청의 JSON 콘텐츠를 이 파일에 붙여넣습니다.{ "aspects": { "dataplex-types.global.data-quality-scorecard": { "data": { "score": 80, "status": "PASS", "dimensions": [ { "name": "completeness", "score": 90, "status": "PASS" }, { "name": "uniqueness", "score": 70, "status": "FAIL" } ], "columns": [ { "name": "col1", "score": 85, "status": "PASS" } ] } } } }터미널에서 다음 명령어를 실행합니다.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -d @payload.json \ "https://dataplex.googleapis.com/v1/projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>/entries/<var>ENTRY_ID</var>?updateMask=aspects"다음을 바꿉니다.
PROJECT_ID: 프로젝트 ID(예:example-project)LOCATION: 항목의 위치(예:us-central1)ENTRY_GROUP_ID: 항목 그룹의 ID(예:example-entry-group)ENTRY_ID: 항목의 ID입니다(예:example-entry).
기타 재사용 가능한 관점 유형
항목 보강에는 다음 시스템 관점 유형도 사용할 수 있습니다. 앞부분에 배치된 요약은 다음 섹션에 나열되어 있습니다. 확장 가능한 각 섹션을 클릭하여 필드 스키마와 JSON 페이로드 예시를 확인하세요.
연락처(dataplex-types.global.contacts)
contacts 관점 유형을 사용하여 항목에 소유권, 관리, 운영 역할을 할당합니다.
identities(배열): 연락처 목록입니다. 각 연락처에는role(예:owner,steward,producer,admin),name,id(이메일 주소)가 포함됩니다.
페이로드 예시(REST API):
{ "aspects": { "dataplex-types.global.contacts": { "data": { "identities": [ { "role": "steward", "name": "Jane Doe", "id": "jane.doe@example.com" } ] } } } }
데이터 프로필(dataplex-types.global.data-profile)
data-profile 관점 유형을 사용하여 소스 데이터 스캔에서 생성된 통계 프로파일링 결과를 캡처합니다. 자세한 내용은 데이터 프로파일링 정보를 참조하세요.
sourceDataInfo(레코드):scope(PREVIEW,SAMPLED또는ALL),scannedRows,samplingPercentage를 포함한 스캔에 대한 메타데이터입니다.fields(지도):nullness,uniqueness, 숫자, 문자열, 날짜/시간, 배열 열의 유형별 측정항목을 포함한 열 수준 통계입니다.
페이로드 예시(REST API):
{ "aspects": { "dataplex-types.global.data-profile": { "data": { "sourceDataInfo": { "scope": "ALL", "scannedRows": 100 }, "fields": { "col1": { "nullness": 0.0, "uniqueness": 0.1, "string": { "length": { "min": 1, "max": 20, "avg": 12.54 } } } } } } } }
일반(dataplex-types.global.generic)
커스텀 관점 스키마를 정의하지 않고 generic 관점 유형을 사용하여 자유 형식 항목 정보와 소스 시스템 메타데이터를 캡처합니다.
type(문자열): 사용자 지정 항목 분류 문자열입니다.system(문자열): 커스텀 항목의 소스 시스템 식별자입니다.
페이로드 예시(REST API):
{ "aspects": { "dataplex-types.global.generic": { "data": { "type": "custom-type", "system": "custom-system" } } } }
개요(dataplex-types.global.overview)
overview 관점 유형을 사용하여 인간이 읽을 수 있는 서식 있는 텍스트 문서와 유용한 외부 링크를 제공합니다.
content(문자열): HTML 형식을 지원하는 서식 있는 텍스트 설명입니다.links(배열): 외부 리소스 및 문서 링크로, 각각url및title를 포함합니다.
페이로드 예시(REST API):
{ "aspects": { "dataplex-types.global.overview": { "data": { "content": "This is a rich text description.", "links": [ { "url": "https://example.com", "title": "Example Link" } ] } } } }
스키마(dataplex-types.global.schema)
schema 관점 유형을 사용하여 데이터 애셋의 테이블 형식 스키마, 열 이름, 모드, 데이터 유형을 설명합니다.
fields(배열): 열 목록으로, 각 열에는name,dataType,metadataType(예:STRING,BOOLEAN),mode(NULLABLE,REQUIRED,REPEATED), 선택사항인description가 포함됩니다.
페이로드 예시(REST API):
{ "aspects": { "dataplex-types.global.schema": { "data": { "fields": [ { "name": "id", "dataType": "string", "metadataType": "STRING", "mode": "REQUIRED" } ] } } } }
사용량(dataplex-types.global.usage)
usage 관점 유형을 사용하여 소비 측정항목, 조회수, 시계열 쿼리 패턴을 추적합니다.
metrics(배열): 소비 측정항목으로, 각각name(예:views또는reads) 및 집계 간격과 값이 있는timeSeries데이터 포인트를 포함합니다.refreshTime(날짜/시간): 사용량 측정항목이 마지막으로 계산된 타임스탬프입니다.
페이로드 예시(REST API):
{ "aspects": { "dataplex-types.global.usage": { "data": { "metrics": [ { "name": "views", "timeSeries": [ { "interval": "30d", "value": 100 } ] } ], "refreshTime": "2025-01-01T12:00:00Z" } } } }
항목 링크 만들기
항목 링크를 만들어 두 항목 간의 관계를 설정할 수 있습니다.
항목 링크는 synonym과 같이 대칭이거나 definition과 같이 비대칭일 수 있습니다.
C#
C#
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog C# API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Go
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Go API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
자바
Java
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Java API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Node.js API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Python API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
REST
필수 관점이 있는 항목 링크를 만들려면 요청 본문에 관점 데이터를 포함하여 entryLinks.create 메서드를 사용합니다.
항목 링크에 관점 추가
항목 간 관계에 대한 정보로 메타데이터를 보강하려면 항목 링크에 관점을 추가합니다.
특정 관점이 필요하도록 항목 링크 유형을 구성할 수 있습니다. 이러한 유형의 항목 링크를 만들 때는 필수 관점을 제공해야 합니다.
항목 링크를 만들 때 또는 기존 항목 링크를 업데이트하여 다음과 같이 이러한 관점을 추가할 수 있습니다.
C#
C#
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog C# API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Go
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Go API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
자바
Java
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Java API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Node.js API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Python API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
REST
항목 링크를 업데이트하려면 entryLink 본문에 관점 데이터를 포함하여 entryLinks.patch 메서드를 사용합니다.
항목 링크와 함께 관점을 사용할 때는 다음 제한사항에 유의하세요.
- 선택적 관점은 지원되지 않습니다.
- 데이터 관점은 지원되지 않습니다.
- 커스텀 유형의 관점은 지원되지 않습니다.
schema-join과 같은 시스템 관점 유형으로 정의된 필수 관점만 관리할 수 있습니다.- 관점의 콘텐츠를 기반으로 항목 링크를 검색하는 것은 지원되지 않습니다.
- 항목 링크 관점 가져오기 또는 내보내기는 지원되지 않습니다.
항목의 기존 관점 관리
이 섹션에서는 항목의 기존 관점을 업데이트하고 삭제하는 방법을 설명합니다.
관점 업데이트
커스텀 항목과 시스템 항목 모두에 대한 선택적 관점을 수정할 수 있습니다. 커스텀 항목에 대한 필수 관점만 수정할 수 있습니다.
BigQuery 테이블과 같은 퍼스트 파티(1P) 시스템 항목의 경우 modifyEntry API를 사용하여 관점을 업데이트할 수 있습니다. 이렇게 하면 소스 시스템의 메타데이터 업데이트 권한(예: BigQuery 데이터 편집자(roles/bigquery.dataEditor))을 사용할 수 있습니다.
콘솔
Google Cloud 콘솔에서 Knowledge Catalog 검색 페이지로 이동합니다.
업데이트할 관점이 있는 항목을 검색하고 항목을 클릭합니다.
항목 세부정보 페이지가 열립니다.
- 세부정보 탭을 클릭합니다.
- 관점 섹션에서 업데이트하려는 관점을 펼치고 수정을 클릭합니다.
- 관점 수정 창에서 필수 입력란을 업데이트합니다.
- 저장을 클릭합니다.
gcloud
항목 또는 항목의 열에 대한 관점을 업데이트하려면 gcloud
dataplex entries update 명령어 또는 gcloud dataplex entries update-aspects를 사용합니다.
JSON 파일을 사용하여 관점을 업데이트하려면 다음 안내를 따르세요.
gcloud dataplex entries update-aspects ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --aspects=ASPECTS_JSON_FILE
다음을 바꿉니다.
ENTRY_ID: 항목 IDLOCATION: 항목의 위치입니다.ENTRY_GROUP_ID: 항목 그룹의 ID입니다.PROJECT_ID: 프로젝트 ID입니다.ASPECTS_JSON_FILE: 관점 맵이 포함된 JSON 파일의 경로입니다.
C#
C#
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog C# API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Go
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Go API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
자바
Java
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Java API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Node.js API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Python API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Ruby
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Ruby API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
REST
항목이나 항목 열에 대한 관점을 업데이트하려면 entry.patch 메서드를 사용합니다.
관점 삭제
콘솔
Google Cloud 콘솔에서 Knowledge Catalog 검색 페이지로 이동합니다.
삭제하려는 관점이 있는 항목을 검색하고 항목을 클릭합니다.
항목 세부정보 페이지가 열립니다.
- 세부정보 탭을 클릭합니다.
- 관점 섹션에서 삭제하려는 관점을 펼치고 삭제를 클릭합니다.
- 확인을 클릭합니다.
gcloud
항목의 관점을 삭제하려면 gcloud dataplex entries update 명령어를 --remove-aspects 플래그와 함께 사용합니다.
항목 수준 관점을 삭제하려면 다음 안내를 따르세요.
gcloud dataplex entries update ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --remove-aspects='ASPECT_TYPE'
열 수준 관점을 삭제하려면 다음 안내를 따르세요.
gcloud dataplex entries update ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --remove-aspects='ASPECT_TYPE@Schema.COLUMN_NAME'
다음을 바꿉니다.
ENTRY_ID: 항목 IDLOCATION: 항목의 위치입니다.ENTRY_GROUP_ID: 항목 그룹의 ID입니다.PROJECT_ID: 프로젝트 ID입니다.ASPECT_TYPE: 전체 관점 유형 식별자입니다(예:dataplex-types.global.generic또는<var>PROJECT_ID</var>.<var>LOCATION</var>.<var>ASPECT_TYPE_ID</var>).COLUMN_NAME: 열 이름
C#
C#
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog C# API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Go
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Go API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
자바
Java
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Java API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Node.js API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Python API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Ruby
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Ruby API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
REST
항목 관점을 삭제하려면 entry.patch 메서드를 사용합니다.
항목 링크의 기존 관점 관리
이 섹션에서는 항목 링크의 기존 관점을 업데이트하는 방법을 설명합니다.
관점 업데이트
항목 링크의 경우 재사용 가능한 시스템 관점 유형을 사용하는 필수 관점만 업데이트할 수 있습니다.
자세한 내용은 항목 링크 작업에 대한 IAM 권한을 참조하세요.
REST
필수 관점으로 항목 링크를 업데이트하려면 요청 본문에 관점 데이터를 포함하여 entryLinks.patch 메서드를 사용합니다.
관점 삭제
항목 링크의 필수 관점은 삭제할 수 없습니다.
관점 유형 관리
이 섹션에서는 관점 유형을 보고 커스텀 관점 유형을 업데이트하고 삭제하는 방법을 설명합니다.
사용 가능한 관점 유형 목록 보기
콘솔
Google Cloud 콘솔에서 Knowledge Catalog 메타데이터 유형 페이지로 이동합니다.
관점 유형 탭을 클릭합니다.
이 페이지에는 사용 가능한 모든 Knowledge Catalog 관점 유형이 나열됩니다.
- 커스텀 관점 유형을 보려면 커스텀 탭을 클릭합니다. 커스텀 탭의 카탈로그 소스 열에는 리소스가 Knowledge Catalog에 있는 위치가 표시됩니다.
시스템 관점 유형을 보려면 시스템 탭을 클릭합니다.
커스텀 관점 유형과 시스템 관점 유형에 대한 상세 설명은 이 문서의 관점 유형 카테고리 섹션을 참고하세요.
- 선택사항: 선택한 프로젝트의 관점 유형 목록을 보려면 커스텀 탭을 클릭한 후 모든 프로젝트에서 표시 전환 버튼을 클릭하여 사용 안함 위치로 전환합니다.
모든 프로젝트에서 표시 전환 버튼은 기본적으로 사용 설정되어 있으며 목록에는 선택한 조직의 Knowledge Catalog 리소스가 포함됩니다.
gcloud
사용 가능한 모든 관점 유형을 나열하려면 gcloud dataplex
aspect-types list 명령어를 사용합니다.
C#
C#
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog C# API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Go
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Go API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
자바
Java
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Java API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Node.js API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Python API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Ruby
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Ruby API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
REST
사용 가능한 모든 관점 유형을 나열하려면 aspectTypes.list 메서드를 사용합니다.
관점 유형 세부정보 보기
콘솔
Google Cloud 콘솔에서 Knowledge Catalog 메타데이터 유형 페이지로 이동합니다.
관점 유형 탭을 클릭합니다.
Knowledge Catalog 관점 유형의 세부정보를 보려면 관점 유형을 클릭합니다. 관점 유형 세부정보 페이지가 열리고 여기에서 표시 이름, 관점 유형 ID, 설명, 프로젝트 ID, 위치, 라벨, 생성일, 최종 수정일과 같은 세부정보에 액세스할 수 있습니다.
- 선택한 관점 유형의 구조를 보려면 템플릿 탭을 클릭합니다.
- 최근에 생성된 관련 항목 10개 목록을 보려면 샘플 항목 탭을 클릭합니다.
- 관련 항목을 모두 검색하려면 검색에 관련 항목 모두 표시를 클릭합니다. 이 버튼은 관련 항목이 최소 하나 이상 있는 경우에만 표시됩니다.
gcloud
관점 유형 세부정보를 가져오려면 gcloud dataplex aspect-types
describe 명령어를 사용합니다.
C#
C#
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog C# API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Go
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Go API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
자바
Java
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Java API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Node.js API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Python API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Ruby
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Ruby API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
REST
관점 유형 세부정보를 가져오려면 aspectTypes.get 메서드를 사용합니다.
커스텀 관점 유형 업데이트
커스텀 관점 유형의 표시 이름, 설명, 템플릿 필드, 라벨을 업데이트할 수 있습니다. 템플릿의 기존 필드를 삭제할 수 없습니다.
관점 유형을 만든 후에는 관점 유형 ID와 위치를 업데이트할 수 없습니다.
콘솔
Google Cloud 콘솔에서 Knowledge Catalog 메타데이터 유형 페이지로 이동합니다.
관점 유형 탭을 클릭합니다.
업데이트할 관점 유형을 클릭합니다.
관점 유형 세부정보 페이지에서 수정을 클릭합니다.
필요에 따라 표시 이름, 설명, 템플릿 필드, 라벨을 수정합니다.
선택사항: 관점 유형의 필드를 지원 중단됨으로 표시하려면 다음 단계를 수행합니다.
- 템플릿 섹션에서 필드를 펼칩니다.
- 지원 중단됨을 선택합니다.
- 지원 중단 이유 필드에 선택한 필드의 지원 중단 이유를 입력합니다.
완료를 클릭합니다.
저장을 클릭합니다.
gcloud
커스텀 관점 유형을 업데이트하려면 gcloud dataplex aspect-types
update 명령어를 사용합니다.
C#
C#
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog C# API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Go
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Go API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
자바
Java
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Java API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Node.js API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Python API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Ruby
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Ruby API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
REST
커스텀 관점 유형을 업데이트하려면 aspectTypes.patch 메서드를 사용합니다.
커스텀 관점 유형 삭제
콘솔
Google Cloud 콘솔에서 Knowledge Catalog 메타데이터 유형 페이지로 이동합니다.
관점 유형 탭을 클릭합니다.
삭제하려는 관점 유형을 클릭합니다.
관점 유형 세부정보 페이지에서 삭제를 클릭합니다. 메시지가 표시되면 확인합니다.
gcloud
커스텀 관점 유형을 삭제하려면 gcloud dataplex aspect-types
delete 명령어를 사용합니다.
C#
C#
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 C# 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog C# API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Go
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Go 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Go API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
자바
Java
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Java 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Java API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Node.js
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Node.js 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Node.js API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Python
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Python 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Python API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Ruby
이 샘플을 사용해 보기 전에 Knowledge Catalog 빠른 시작: 클라이언트 라이브러리 사용의 Ruby 설정 안내를 따르세요. 자세한 내용은 Knowledge Catalog Ruby API 참고 문서를 참조하세요.
Knowledge Catalog에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
REST
기존 커스텀 관점 유형을 삭제하려면 aspectTypes.delete 메서드를 사용합니다.
다음 단계
- Knowledge Catalog에서 리소스를 검색하는 방법 알아보기
- 항목 관리 및 커스텀 소스 수집 방법 알아보기
- Knowledge Catalog로 메타데이터를 가져오는 방법 알아보기
- Knowledge Catalog의 메타데이터 자세히 알아보기
- 기본 데이터 컨텍스트를 설정하는 방법을 알아보세요.
- Knowledge Catalog 사용 사례 사용해 보기