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) 항목 | 시스템 항목 (필수 관점 포함) | 기본 제공 항목 (예: BigQuery 테이블의 Schema)을 설명하는 메타데이터는 시스템 정의 관점 유형의 필수 관점에 캡처됩니다. |
| 비즈니스 용어집 | 비즈니스 용어집 | 기업 전반에서 비즈니스 컨텍스트를 표준화하는 비즈니스 용어 분류 |
기능 비교
다음 표에서는 Knowledge Catalog와 Data Catalog의 메타데이터 관리 기능을 비교합니다.
| 기능 | Knowledge Catalog | Data Catalog |
|---|---|---|
| 지원되는 Google Cloud 소스 | 지원되는 Google Cloud 소스에 설명된 모든 소스 | 데이터 카탈로그 문서에 설명된 모든 소스 |
| 커스텀 소스 수집 | 항목 유형으로 정의된 관리되는 구조로 커스텀 항목에 수집 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) 및 type=tag_templateSearchCatalog (RPC) 및 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) |
태그 템플릿 필드 열거형 값
해당 관점 유형에서 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는 변경되지 않으며 이전할 필요가 없습니다. datacatalog.googleapis.com 엔드포인트 (정책 태그 관리자 서비스)에서 계속 제공됩니다. BigQuery 열 수준 액세스 제어 또는 동적 데이터 마스킹을 사용하는 프로젝트에서는 Data Catalog API(datacatalog.googleapis.com)가 사용 설정된 상태로 유지되어야 합니다.
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를 사용하여 쿼리합니다.