이 문서는 Dataplex Universal Catalog 메타데이터 변경 피드와 관련된 일반적인 문제를 해결하는 데 도움이 됩니다.
메타데이터 변경 피드 생성 오류
이 섹션에서는 메타데이터 변경 피드를 만들 때 발생할 수 있는 오류를 해결하는 방법을 설명합니다.
권한 거부 오류
메타데이터 변경 피드를 만들려고 하면 PERMISSION_DENIED 오류가 표시됩니다.
이 문제는 사용자 또는 Dataplex 범용 카탈로그 서비스 계정에 필요한 권한이 누락되어 발생합니다.
이 문제를 해결하려면 다음 요구사항을 검토하세요.
dataplex.metadataFeeds.create권한이 있는지 확인합니다.피드 범위 (조직, 프로젝트 또는 항목 그룹)에 대한
dataplex.entryGroups.export권한이 있는지 확인합니다.Dataplex Universal Catalog 서비스 계정(
service-{PROJECT_NUMBER}@gcp-sa-dataplex.iam.gserviceaccount.com)에 대상 Pub/Sub 주제에 대한roles/pubsub.publisher역할이 있는지 확인합니다.
VPC 서비스 제어 오류
피드를 만들 때 PERMISSION_DENIED 또는 VPC 서비스 제어 오류가 표시됩니다.
이 문제를 해결하려면 메타데이터 변경 피드와 모니터링하는 리소스가 동일한 VPC 서비스 제어 경계에 속하는지 확인하세요.
피드가 조직 범위인 경우 동일한 경계 내의 프로젝트만 모니터링됩니다.
피드가 프로젝트 범위 또는 항목 그룹 범위인 경우 지정된 모든 프로젝트 또는 항목 그룹이 피드를 만드는 프로젝트와 동일한 경계에 있는지 확인합니다.
알림 전송 문제
이 섹션에서는 알림 전송 문제를 해결하는 방법을 설명합니다.
알림이 수신되지 않음
Pub/Sub 주제에서 알림을 수신하지 않습니다. 이 문제는 다음과 같은 여러 가지 요인으로 인해 발생할 수 있습니다.
권한 누락: Dataplex Universal Catalog 서비스 계정에서 주제에 대한
roles/pubsub.publisher역할이 누락되었습니다.활성화 지연: 새로 생성되거나 업데이트된 피드가 활성화되는 데 최대 10분이 걸릴 수 있습니다.
주제 삭제됨: 대상 Pub/Sub 주제가 삭제되면 Dataplex Universal Catalog에서 게시를 중지합니다.
범위 또는 필터 불일치: 변경사항이 구성된 범위 또는 필터와 일치하지 않을 수 있습니다.
이 문제를 해결하려면 다음을 확인하세요.
Dataplex Universal Catalog 서비스 계정에 주제에 대한
roles/pubsub.publisher역할이 있는지 확인합니다.피드를 만들거나 업데이트한 후 10분 이상 기다립니다.
Pub/Sub 주제가 있는지 확인합니다. 삭제된 경우 다시 만들어야 합니다.
피드 구성을 검토하여 범위와 필터가 수신할 것으로 예상되는 메타데이터 변경사항과 일치하는지 확인합니다.
중복 알림
알림 메시지가 중복으로 수신됩니다. Dataplex 범용 카탈로그는 '최소 1회' 전송을 보장하므로 특히 재시도 중에 중복 메시지가 발생할 수 있습니다.
잠재적인 중복을 처리하도록 구독자 애플리케이션을 구성합니다. messageId 또는 변경 타임스탬프를 사용하여 메시지를 식별하고 중복을 삭제할 수 있습니다.
콘텐츠 문제
이 섹션에서는 메타데이터 변경 피드 알림의 콘텐츠 문제를 해결하는 방법을 설명합니다.
페이로드에 전체 메타데이터가 누락됨
알림 메시지에는 리소스 이름과 변경 유형만 포함되며 전체 메타데이터나 구체적인 변경사항은 포함되지 않습니다.
이는 설계상 메타데이터 변경 피드 알림이 전체 페이로드 대신 '변경 서명' (변경된 항목)을 제공하기 때문입니다. 이렇게 하면 메시지가 가벼워지고 페이로드 크기 제한을 피할 수 있습니다.
알림에 제공된 리소스 이름을 사용하여 Dataplex Universal Catalog API (예: GetEntry)를 호출하고 리소스의 현재 상태를 가져옵니다.