Data Catalog가 지원 중단되었습니다. 프로그래매틱 워크플로, 스크립트, 클라이언트 라이브러리 또는 Terraform 구성을 Data Catalog에서 Knowledge Catalog로 이전하는 경우 Dataplex API를 사용하도록 코드를 업데이트해야 합니다.
이 문서에서는 Data Catalog 리소스, 기능, API 메서드를 Dataplex API의 상응하는 항목에 포괄적으로 매핑합니다.
단계별 이전 프로세스는 Data Catalog에서 Knowledge Catalog로 전환을 참고하세요. API 참조 문서는 Dataplex API REST 문서 및 Dataplex API RPC 문서를 참고하세요.
리소스 매핑
다음 표에서는 Data Catalog의 리소스가 Knowledge Catalog의 리소스에 어떻게 상응하는지 설명합니다.
| Data Catalog 리소스 | Knowledge Catalog 리소스 | 설명 |
|---|---|---|
| 공개 태그 템플릿 | 관점 유형 (global) |
태그 템플릿은 여러 리전에서 사용할 수 있는 Data Catalog의 리전별 리소스입니다. Knowledge Catalog의 global 관점
유형에 해당합니다. |
| 공개 태그 | 선택적 관점 | 공개 태그는 Knowledge Catalog의 항목 또는 열에 연결된 선택적 관점에 해당합니다. |
| 항목 그룹 | 항목 그룹 | 항목 그룹은 두 서비스 모두에서 조직 및 보안 컨테이너 역할을 합니다. 소스의 경우 Google Cloud 와 같은
@bigquery 시스템 항목 그룹이 프로젝트별로 자동으로 설정됩니다. |
| 커스텀 항목 | 커스텀 항목 (필수 관점 포함) | 표준 커스텀 항목 속성은 커스텀 항목의 EntryType으로 정의된 필수 관점
으로 모델링됩니다. |
| 시스템 (Google Cloud) 항목 | 시스템 항목 (필수 관점 포함) | 기본 제공 항목 (예: Schema의
BigQuery 테이블)을 설명하는 메타데이터는 시스템 정의 관점 유형의 필수 관점에 캡처됩니다. |
| 비즈니스 용어집 | 비즈니스 용어집 | 기업 전반에서 비즈니스 컨텍스트를 표준화하는 비즈니스 용어 분류입니다. |
기능 비교
다음 표에서는 Knowledge Catalog와 Data Catalog의 메타데이터 관리 기능을 비교합니다.
| 기능 | Knowledge Catalog | Data Catalog |
|---|---|---|
| 지원되는 Google Cloud 소스 | 지원되는 소스에 설명된 모든 소스 Google Cloud | Data Catalog 문서에 설명된 모든 소스 |
| 커스텀 소스 수집 | 항목 유형으로 정의된 관리되는 구조로 커스텀 항목에 수집 Data Catalog 커스텀 항목 및 항목 그룹은 Knowledge Catalog에서
|
일반 커스텀 항목으로 수집 |
| 메타데이터 보강 | 비즈니스 용어집, 관점, 관점 유형을 사용하여 캡처됩니다. 항목 링크가 지원됩니다. 관점을 항목 링크에 직접 연결할 수 있습니다. |
비즈니스 용어집, 태그, 태그 템플릿을 사용하여 캡처됩니다. 항목 링크는 지원되지 않습니다. |
| 항목 링크 | 지원됨 synonym, definition, related, schema-join과 같은 기본 제공 유형을 사용하면 항목과 열을 연결할 수 있습니다. |
지원되지 않음 |
| 메타데이터 변경 피드 | Pub/Sub로 스트리밍되는 거의 실시간 메타데이터 변경 알림 | 지원되지 않음 |
| 검색 | 검색은 동일한 조직 및 VPC 서비스 제어 경계 내에서 모든 지원되는 Google Cloud 소스, 커스텀 항목, 관점, 이전된 Data Catalog 콘텐츠를 대상으로 실행됩니다. | 검색은 Data Catalog에서 생성된 지원되는 소스, 커스텀 항목, 태그 를 대상으로 실행됩니다. |
| 데이터 계보 | Dataplex API를 사용하여 애셋 노드의 항목 세부정보를 가져옵니다. Google Cloud 콘솔에 연결된 관점을 표시합니다. | Data Catalog API를 사용하여 항목 세부정보를 가져옵니다. |
| 비즈니스 용어집 | 비즈니스 용어 분류를 만들고 데이터 애셋 (항목)과 열 모두에 연결할 수 있습니다. | 용어를 열과 연결할 수 있습니다. |
Data Catalog API 메서드를 Knowledge Catalog에 매핑
다음 표에서는 Data Catalog API (google.cloud.datacatalog.v1)와 Dataplex API (google.cloud.dataplex.v1.CatalogService) 간의 메서드별 매핑을 제공합니다.
항목 그룹
항목 그룹의 개념은 두 서비스 모두에서 일관됩니다.
| Data Catalog API 메서드 | Dataplex API 메서드 |
|---|---|
projects.locations.entryGroups.create (REST)CreateEntryGroup (RPC) |
projects.locations.entryGroups.create (REST)CreateEntryGroup (RPC) |
projects.locations.entryGroups.get (REST)GetEntryGroup (RPC) |
projects.locations.entryGroups.get (REST)GetEntryGroup (RPC) |
projects.locations.entryGroups.patch (REST)UpdateEntryGroup (RPC) |
projects.locations.entryGroups.patch (REST)UpdateEntryGroup (RPC) |
projects.locations.entryGroups.delete (REST)DeleteEntryGroup (RPC) |
projects.locations.entryGroups.delete (REST)DeleteEntryGroup (RPC) |
projects.locations.entryGroups.list (REST)ListEntryGroups (RPC) |
projects.locations.entryGroups.list (REST)ListEntryGroups (RPC) |
항목
데이터 애셋을 나타내는 항목의 개념은 두 서비스 모두에서 일관됩니다.
태그 템플릿 및 관점 유형
관점 유형은 Data Catalog 태그 템플릿의 후속 항목입니다.
| Data Catalog API 메서드 | Dataplex API 메서드 |
|---|---|
projects.locations.tagTemplates.create (REST)CreateTagTemplate (RPC) |
projects.locations.aspectTypes.create (REST)CreateAspectType (RPC) |
projects.locations.tagTemplates.get (REST)GetTagTemplate (RPC) |
projects.locations.aspectTypes.get (REST)GetAspectType (RPC) |
projects.locations.tagTemplates.patch (REST)UpdateTagTemplate (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
projects.locations.tagTemplates.delete (REST)DeleteTagTemplate (RPC) |
projects.locations.aspectTypes.delete (REST)DeleteAspectType (RPC) |
catalog.search (REST) with type=tag_templateSearchCatalog (RPC) with type=tag_template |
projects.locations.aspectTypes.list (REST)ListAspectTypes (RPC) |
태그 템플릿 필드
태그 템플릿 필드는 관점 유형의 metadata_template 필드 콘텐츠에 해당합니다. 수정된 metadata_template과 함께 UpdateAspectType을 사용하여 필드를 만들거나, 업데이트하거나, 이름을 바꾸거나, 삭제합니다.
| Data Catalog API 메서드 | Dataplex API 메서드 |
|---|---|
projects.locations.tagTemplates.fields.create (REST)CreateTagTemplateField (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
projects.locations.tagTemplates.fields.patch (REST)UpdateTagTemplateField (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
projects.locations.tagTemplates.fields.rename (REST)RenameTagTemplateField (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
projects.locations.tagTemplates.fields.delete (REST)DeleteTagTemplateField (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
태그 템플릿 필드 enum 값
해당 관점 유형의 metadata_template 필드를 업데이트하여 enum 값을 수정합니다.
| Data Catalog API 메서드 | Dataplex API 메서드 |
|---|---|
projects.locations.tagTemplates.fields.enumValues.rename (REST)RenameTagTemplateFieldEnumValue (RPC) |
projects.locations.aspectTypes.patch (REST)UpdateAspectType (RPC) |
태그 및 관점
관점은 Data Catalog 태그의 후속 항목입니다. 관점은 상위 항목 또는 항목 링크에 직접 캡슐화되며 update_mask가 있는 UpdateEntry 메서드를 사용하여 관리됩니다.
| Data Catalog API 메서드 | Dataplex API 메서드 |
|---|---|
projects.locations.entryGroups.entries.tags.create (REST)CreateTag (RPC) |
projects.locations.entryGroups.entries.patch (REST)UpdateEntry (RPC) |
projects.locations.entryGroups.entries.tags.list (REST)ListTags (RPC) |
projects.locations.entryGroups.entries.get (REST)GetEntry (RPC)
참고: 응답에서 관점을 필터링하려면 |
projects.locations.entryGroups.entries.tags.patch (REST)UpdateTag (RPC) |
projects.locations.entryGroups.entries.patch (REST)UpdateEntry (RPC) |
projects.locations.entryGroups.entries.tags.delete (REST)DeleteTag (RPC) |
projects.locations.entryGroups.entries.patch (REST)UpdateEntry (RPC) |
정책 태그 및 분류
정책 태그 및 분류의 API는 변경되지 않으며 이전을 요구하지 않습니다.
Knowledge Catalog에서 지원되지 않는 기능
다음 Data Catalog 동작 및 기능은 Knowledge Catalog에서 지원되지 않거나 다르게 작동합니다.
- 비공개 관점 유형: 비공개 관점 및 비공개 관점 유형 (Data Catalog의 비공개 태그 및 비공개 태그 템플릿에 상응) 의 개념은 존재하지 않습니다. 모든 커스텀 관점 유형은 프로젝트 및 항목 그룹 Identity and Access Management 권한에 의거하여 관리됩니다.
- 정책 태그 검색:
policytag또는policytagid조건자를 사용하여 정책 태그를 검색하는 것은 카탈로그 검색에서 지원되지 않습니다. - 권한 이전: Data Catalog 커스텀 항목 그룹, 커스텀 항목, 태그 템플릿, 태그를 Knowledge Catalog로 가져오면 원래 권한이 이월되지 않습니다. 가져온 리소스에 대한 IAM 권한을 구성해야 합니다. 기존 권한과 대체 권한의 자세한 비교는 Data Catalog와 Knowledge Catalog 간의 IAM 권한 매핑을 참고하세요.
- Sensitive Data Protection 검사 결과: Sensitive Data Protection 검사 결과를 Knowledge Catalog로 직접 전송하는 것은 지원되지 않습니다. 대신 검사 결과를 Data Catalog로 전송하고 결과를 Knowledge Catalog로 전환합니다.
- 프로젝트 간 유형 목록: 단일 API 호출에서 프로젝트 간 항목 유형, 항목 링크 유형, 관점 유형을 나열하는 것은 지원되지 않습니다. 요청은 단일 프로젝트로 범위가 지정되어야 합니다.
- 관리자 검색: 관리자 검색 (전체 재현율)은 지원되지 않습니다. 대신 메타데이터를 Cloud Storage로 내보내고 BigQuery를 사용하여 쿼리합니다.