Dataplex 범용 카탈로그에 저장된 메타데이터 변경사항

2026년 1월 12일과 2026년 2월 2일 사이에 Dataplex Universal Catalog에 저장된 일부 메타데이터가 변경됩니다.

이 변경사항으로 인해 Dataplex Universal Catalog에 저장된 메타데이터가 원래 소스 시스템의 메타데이터와 일관성을 유지하게 됩니다.

워크로드가 다음 섹션에 설명된 변경사항의 범위에 속하는 경우 이 문서의 안내를 따르세요.

변경 범위

이 섹션에 설명된 변경사항은 다음 소스 시스템의 항목에 적용됩니다.

  • Vertex AI
  • Bigtable
  • Spanner
  • Pub/Sub
  • Dataform
  • Dataproc Metastore

다음 Dataplex API 메서드는 이러한 변경사항의 영향을 받습니다.

리소스 이름

최상위 항목 필드 entrySource.resource의 리소스 이름이 변경됩니다. 필드가 API를 사용하여 전체 리소스 이름 대신 상대 리소스 이름을 포함하도록 수정됩니다. //<service_name>.googleapis.com/ 접두사가 리소스 이름에서 삭제됩니다. 다음 표에는 몇 가지 샘플 예가 나와 있습니다.

소스 시스템 변경 전 값 변경 후 값
Vertex AI //aiplatform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
예: //aiplatform.googleapis.com/projects/test-project-id/locations/us-central1/featureOnlineStores/test-store		 projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/REMAINING_PATH
예: projects/test-project-id/locations/us-central1/featureOnlineStores/test-store
Bigtable //bigtable.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
예: //bigtable.googleapis.com/projects/test-project-id/instances/test-instance/tables/test-table		 projects/PROJECT_ID/instances/INSTANCE_ID/tables/TABLE_ID
예: projects/test-project-id/instances/test-instance/tables/test-table
Spanner //spanner.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
예: //spanner.googleapis.com/projects/test-project-id/instances/test-instance/databases/test-database		 projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID
예: projects/test-project-id/instances/test-instance/databases/test-database
Pub/Sub //pubsub.googleapis.com/projects/PROJECT_ID/topics/TOPIC_ID
예: //pubsub.googleapis.com/projects/test-project-id/topics/test-topic		 projects/PROJECT_ID/topics/TOPIC_ID
예: projects/test-project-id/topics/test-topic
Dataform //dataform.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
예: //dataform.googleapis.com/projects/test-project-id/locations/us-central1/repositories/test-repo		 projects/PROJECT_ID/locations/LOCATION_ID/repositories/REPOSITORY_ID
예: projects/test-project-id/locations/us-central1/repositories/test-repo
Dataproc Metastore //metastore.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
예: //metastore.googleapis.com/projects/test-project-id/locations/us-central1/services/test-service		 projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID
예: projects/test-project-id/locations/us-central1/services/test-service

이 필드에 대한 자세한 내용은 EntrySource API 참조를 확인하세요.

상위 유형 값

최상위 항목 필드 entrySource.ancestors.type가 Dataplex 유형 프로젝트 번호 (655216118709) 대신 Dataplex 유형 프로젝트 ID (dataplex-types)를 포함하도록 변경됩니다. 다음 표에 몇 가지 샘플이 나와 있습니다.

소스 시스템 변경 전 값 변경 후 값
Vertex AI DATAPLEX_TYPE_PROJECT_NUMBER.global.vertexai-feature-online-store
예: 655216118709.global.vertexai-feature-online-store		 DATAPLEX_TYPE_PROJECT_ID.global.vertexai-feature-online-store
예: dataplex-types.global.vertexai-feature-online-store
Dataproc Metastore DATAPLEX_TYPE_PROJECT_NUMBER.global.DataprocMetastoreDatabase
예: 655216118709.global.DataprocMetastoreDatabase		 DATAPLEX_TYPE_PROJECT_ID.global.dataproc-metastore-database
예: dataplex-types.global.dataproc-metastore-database
Spanner DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-spanner-instance
예: 655216118709.global.cloud-spanner-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-spanner-instance
예: dataplex-types.global.cloud-spanner-instance
Bigtable DATAPLEX_TYPE_PROJECT_NUMBER.global.cloud-bigtable-instance
예: 655216118709.global.cloud-bigtable-instance		 DATAPLEX_TYPE_PROJECT_ID.global.cloud-bigtable-instance
예: dataplex-types.global.cloud-bigtable-instance

이 필드에 대한 자세한 내용은 Ancestor API 참조를 확인하세요.

필요한 조치

출시 기간은 2026년 1월 12일에 시작하여 2026년 2월 2일에 종료됩니다. 메타데이터 변경사항은 출시 기간 동안 점진적으로 적용됩니다.

필요한 작업은 다음과 같습니다.

  • 2026년 1월 12일 전에 워크로드를 업데이트하여 기존 버전의 메타데이터와 업데이트된 버전의 메타데이터를 모두 해석하세요.

  • 출시 기간 동안 항목은 기존 버전의 메타데이터 또는 업데이트된 버전의 메타데이터를 캡처할 수 있습니다. 워크로드는 두 버전을 모두 해석할 수 있어야 합니다.

  • 2026년 2월 2일 이후에는 선택적으로 워크로드를 업데이트하여 새 버전의 메타데이터만 해석할 수 있습니다.

메타데이터 버전을 확인하는 방법

항목이 업데이트된 메타데이터를 사용하는지 확인하려면 항목의 aspects 객체를 찾아 관련 관점 유형을 찾습니다. 관점 유형의 aspectSource 객체에서 dataVersion 필드가 있고 Ingestion/1.0.0로 설정되어 있으면 항목이 업데이트된 메타데이터 버전을 사용합니다. 자세한 내용은 lookupEntry 및 getAspectType API를 참고하세요.

지원

궁금한 점이 있으면 dataplex-msa-support@google.com에 문의하세요.

추가 정보