새 스키마 버전을 만들면 스키마 레지스트리에서 새 버전이 이전 버전과 호환되는지 확인합니다. 스키마 호환성을 적용하면 데이터 구조가 발전함에 따라 데이터 생산자와 소비자가 계속 올바르게 작동할 수 있습니다.
호환성 유형에 지원되는 값은 Backward, Backward transitive, Forward, Forward transitive, Full, Full transitive 또는 None입니다.
호환성 유형은 JSON 객체로 관리됩니다. 예를 들면 다음과 같습니다.
{ "compatibility": "BACKWARD" }명시적으로 설정하지 않으면 스키마 레지스트리의 호환성 유형이 기본적으로 Backward로 설정됩니다.
주제에 호환성 유형이 설정되지 않은 경우 스키마 레지스트리에서 값을 상속합니다.
주체 수준에서 설정된 구성은 스키마 레지스트리 수준의 구성을 재정의합니다.
호환성 유형을 업데이트하면 업데이트 후 등록된 새 스키마 버전에만 영향을 미칩니다.
호환성 유형에 관한 자세한 내용은 호환성 유형 정보를 참고하세요.
호환성 유형 업데이트에 필요한 역할 및 권한
스키마 레지스트리 또는 주제의 호환성 유형을 업데이트하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 관리 Kafka 스키마 레지스트리 편집자 (roles/managedkafka.schemaRegistryEditor) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이 사전 정의된 역할에는 스키마 레지스트리 또는 주제의 호환성 유형을 업데이트하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
스키마 레지스트리 또는 주제의 호환성 유형을 업데이트하려면 다음 권한이 필요합니다.
-
호환성 유형을 업데이트할 리소스에 다음 권한을 부여합니다.
managedkafka.config.update
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
스키마 레지스트리의 호환성 유형 업데이트
콘솔
전체 스키마 레지스트리의 호환성 유형을 업데이트하려면 다음 단계를 따르세요.
- Google Cloud 콘솔에서 스키마 레지스트리 페이지로 이동합니다.
프로젝트의 스키마 레지스트리 목록이 표시됩니다.
- 호환성 유형을 업데이트하려는 스키마 레지스트리의 이름을 클릭합니다.
스키마 레지스트리 세부정보 페이지가 열립니다.
- 레지스트리의 기본 세부정보 섹션에서 호환성 유형 설정을 찾아 옆에 있는 수정 아이콘을 클릭합니다.
호환성 유형 수정 페이지가 열립니다.
- 호환성 유형 드롭다운 메뉴에서 값을 선택합니다.
- 저장을 클릭합니다.
gcloud
스키마 레지스트리의 호환성 유형을 업데이트하려면 gcloud alpha managed-kafka schema-registries update 명령어를 사용합니다.
gcloud alpha managed-kafka schema-registries update SCHEMA_REGISTRY_ID
--location=LOCATION
--compatibility=COMPATIBILITY_TYPE
SCHEMA_REGISTRY_ID: 업데이트할 스키마 레지스트리의 ID입니다.LOCATION: 스키마 레지스트리의 리전입니다.COMPATIBILITY_TYPE: 새 호환성 유형입니다. 유효한 값은BACKWARD,BACKWARD_TRANSITIVE,FORWARD,FORWARD_TRANSITIVE,FULL,FULL_TRANSITIVE,NONE입니다.
예: us-central1 리전의 test-registry 스키마 레지스트리의 호환성 유형을 FORWARD로 업데이트합니다.
gcloud alpha managed-kafka schema-registries update test-registry
--location=us-central1
--compatibility=FORWARD
REST
스키마 레지스트리의 호환성 유형을 업데이트하려면 REST API에 PUT 요청을 실행합니다.
먼저 액세스 토큰을 가져옵니다.
gcloud auth application-default print-access-token
그런 다음 레지스트리의 구성 엔드포인트로 PUT 요청을 보냅니다.
PUT https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID/config
다음 경로 매개변수를 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트 ID입니다.LOCATION: 스키마 레지스트리가 있는 리전입니다.SCHEMA_REGISTRY_ID: 스키마 레지스트리의 ID입니다.
요청 본문에 다음 JSON 객체를 포함합니다.
{ "compatibility": "COMPATIBILITY_TYPE" }
COMPATIBILITY_TYPE을 NONE, BACKWARD, FORWARD, FULL과 같은 유효한 값으로 바꿉니다.
성공하면 API가 200 OK 상태 코드를 반환합니다.
주제의 호환성 유형 업데이트
콘솔
특정 주제의 호환성 유형을 업데이트하려면 다음 단계를 따르세요.
- Google Cloud 콘솔에서 스키마 레지스트리 페이지로 이동합니다.
- 주제가 포함된 스키마 레지스트리의 이름을 클릭합니다.
스키마 레지스트리 세부정보 페이지가 열립니다.
- Subjects in this schema registry(이 스키마 레지스트리의 제목) 표에서 제목 이름을 클릭합니다.
- 주제의 호환성 유형 설정을 찾아 옆에 있는 수정 아이콘을 클릭합니다.
호환성 유형 수정 페이지가 열립니다.
- 호환성 유형 드롭다운 메뉴에서 값을 선택합니다. 여기에서 값을 선택하면 이 주제의 레지스트리 수준 설정이 재정의됩니다.
- 저장을 클릭합니다.
gcloud
주체의 호환성 유형을 업데이트하려면 gcloud alpha managed-kafka schema-registries subject update 명령어를 사용합니다.
gcloud alpha managed-kafka schema-registries subject update SUBJECT_ID
--schema-registry=SCHEMA_REGISTRY_ID
--location=LOCATION
--compatibility=COMPATIBILITY_TYPE
SUBJECT_ID: 업데이트할 주제의 ID입니다.SCHEMA_REGISTRY_ID: 주제가 포함된 스키마 레지스트리의 ID입니다.LOCATION: 스키마 레지스트리의 리전입니다.COMPATIBILITY_TYPE: 새 호환성 유형입니다. 유효한 값은BACKWARD,BACKWARD_TRANSITIVE,FORWARD,FORWARD_TRANSITIVE,FULL,FULL_TRANSITIVE,NONE입니다.
예: us-central1 리전의 test-registry 스키마 레지스트리에서 test-subject 주제의 호환성 유형을 FORWARD_TRANSITIVE로 업데이트합니다.
gcloud alpha managed-kafka schema-registries subject update test-subject
--schema-registry=test-registry
--location=us-central1
--compatibility=FORWARD_TRANSITIVE
REST
주체의 호환성 유형을 업데이트하려면 REST API에 PUT 요청을 합니다.
먼저 액세스 토큰을 가져옵니다.
gcloud auth application-default print-access-token
기본 컨텍스트에서 주제의 호환성을 업데이트합니다.
PUT https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID/config/SUBJECT_ID
특정 컨텍스트에서 주제의 호환성을 업데이트합니다.
PUT https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID/contexts/CONTEXT_ID/config/SUBJECT_ID
다음 경로 매개변수를 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트 ID입니다.LOCATION: 스키마 레지스트리가 있는 리전입니다.SCHEMA_REGISTRY_ID: 스키마 레지스트리의 ID입니다.SUBJECT_ID: 주제의 ID입니다.CONTEXT_ID: 컨텍스트의 ID (해당하는 경우)입니다.
요청 본문에 다음 JSON 객체를 포함합니다.
{ "compatibility": "COMPATIBILITY_TYPE" }
COMPATIBILITY_TYPE을 FORWARD_TRANSITIVE과 같은 유효한 값으로 바꿉니다.
예: user_events 호환성을 FORWARD_TRANSITIVE로 설정합니다.
PUT https://managedkafka.googleapis.com/v1main/projects/test-project/locations/us-central1/schemaRegistries/test_registry/config/user_events에 요청
본문 포함:
{ "compatibility": "FORWARD_TRANSITIVE" }
성공하면 API가 200 OK 상태 코드를 반환합니다.