8.2. Service Registry serializer/deserializer 구성 속성

SCHEMA_RESOLVER

apicurio.registry.schema-resolver

직렬화 및 역직렬기에 의해 사용됩니다. SchemaResolver 를 구현하는 정규화된 Java 클래스 이름입니다.

문자열

io.apicurio.registry.resolver.DefaultSchemaResolver

REGISTRY_URL

apicurio.registry.url

직렬화 및 역직렬기에 의해 사용됩니다. 레지스트리 API에 액세스하는 URL입니다.

문자열

없음

AUTH_SERVICE_URL

apicurio.auth.service.url

직렬화 및 역직렬기에 의해 사용됩니다. 인증 서비스의 URL입니다. OAuth 클라이언트 인증 정보 흐름을 사용하여 보안 레지스트리에 액세스할 때 필요합니다.

문자열

없음

AUTH_TOKEN_ENDPOINT

apicurio.auth.service.token.endpoint

직렬화 및 역직렬기에 의해 사용됩니다. 토큰 끝점의 URL입니다. 보안 레지스트리에 액세스할 때 필요하며 AUTH_SERVICE_URL 은 지정되지 않습니다.

문자열

없음

AUTH_REALM

apicurio.auth.realm

직렬화 및 역직렬기에 의해 사용됩니다. 인증 서비스에 액세스할 수 있는 영역입니다. OAuth 클라이언트 인증 정보 흐름을 사용하여 보안 레지스트리에 액세스할 때 필요합니다.

문자열

없음

AUTH_CLIENT_ID

apicurio.auth.client.id

직렬화 및 역직렬기에 의해 사용됩니다. 인증 서비스에 액세스할 클라이언트 ID입니다. OAuth 클라이언트 인증 정보 흐름을 사용하여 보안 레지스트리에 액세스할 때 필요합니다.

문자열

없음

AUTH_CLIENT_SECRET

apicurio.auth.client.secret

직렬화 및 역직렬기에 의해 사용됩니다. 인증 서비스에 액세스하기 위한 클라이언트 시크릿입니다. OAuth 클라이언트 인증 정보 흐름을 사용하여 보안 레지스트리에 액세스할 때 필요합니다.

문자열

없음

AUTH_USERNAME

apicurio.auth.username

직렬화 및 역직렬기에 의해 사용됩니다. 레지스트리에 액세스할 사용자 이름입니다. HTTP 기본 인증을 사용하여 보안 레지스트리에 액세스할 때 필요합니다.

문자열

없음

AUTH_PASSWORD

apicurio.auth.password

직렬화 및 역직렬기에 의해 사용됩니다. 레지스트리에 액세스하기 위한 암호입니다. HTTP 기본 인증을 사용하여 보안 레지스트리에 액세스할 때 필요합니다.

문자열

없음

ARTIFACT_RESOLVER_STRATEGY

apicurio.registry.artifact-resolver-strategy

serialize자만 사용합니다. ArtifactReferenceResolverStrategy 를 구현하고 각 Kafka 메시지를 ArtifactReference Reference(groupId,artifactId, version)에 매핑하는 정규화된 Java 클래스 이름입니다. 예를 들어 기본 전략에서는 주제 이름을 스키마 artifactId 로 사용합니다.

문자열

io.apicurio.registry.serde.strategy.TopicIdStrategy

EXPLICIT_ARTIFACT_GROUP_ID

apicurio.registry.artifact.group-id

serialize자만 사용합니다. 아티팩트를 쿼리하거나 생성하는 데 사용되는 groupId 를 설정합니다. ArtifactResolverStrategy 에서 반환된 groupId 를 덮어씁니다.

문자열

없음

EXPLICIT_ARTIFACT_ID

apicurio.registry.artifact.artifact-id

serialize자만 사용합니다. 아티팩트를 쿼리하거나 생성하는 데 사용되는 artifactId 를 설정합니다. ArtifactResolverStrategy 에서 반환된 artifactId 를 덮어씁니다.

문자열

없음

EXPLICIT_ARTIFACT_VERSION

apicurio.registry.artifact.version

serialize자만 사용합니다. 아티팩트를 쿼리하거나 생성하는 데 사용되는 아티팩트 버전을 설정합니다. ArtifactResolverStrategy 에서 반환된 버전을 덮어씁니다.

문자열

없음

FIND_LATEST_ARTIFACT

apicurio.registry.find-latest

serialize자만 사용합니다. serializer가 해당 그룹 ID 및 아티팩트 ID에 대한 레지스트리에서 최신 아티팩트를 찾으려고 하는지 여부를 지정합니다.

boolean

false

AUTO_REGISTER_ARTIFACT

apicurio.registry.auto-register

serialize자만 사용합니다. serializer가 레지스트리에 아티팩트를 생성하려고 하는지 여부를 지정합니다. JSON 스키마 직렬화기에서는 이 기능을 지원하지 않습니다.

부울, 부울 문자열

false

AUTO_REGISTER_ARTIFACT_IF_EXISTS

apicurio.registry.auto-register.if-exists

serialize자만 사용합니다. 아티팩트가 이미 존재하므로 충돌이 발생할 때 클라이언트의 동작을 구성합니다. 사용 가능한 값은 FAIL,UPDATE,RETURN 또는 RETURN_OR_UPDATE 입니다.

문자열

RETURN_OR_UPDATE

CHECK_PERIOD_MS

apicurio.registry.check-period-ms

직렬화 및 역직렬기에 의해 사용됩니다. 자동 제거(밀리초) 전에 아티팩트를 캐시하는 기간을 지정합니다. 0으로 설정하면 매번 아티팩트를 가져옵니다.

java.time.Duration, 음수가 아닌 숫자 또는 정수 문자열

30000

RETRY_BACKOFF_MS

apicurio.registry.retry-backoff-ms

직렬화 및 역직렬기에 의해 사용됩니다. 레지스트리에서 스키마를 검색할 수 없는 경우 여러 번 재시도할 수 있습니다. 이 구성 옵션은 재시도 시도(밀리초) 간 지연을 제어합니다.

java.time.Duration, 음수가 아닌 숫자 또는 정수 문자열

300

RETRY_COUNT

apicurio.registry.retry-count

직렬화 및 역직렬기에 의해 사용됩니다. 레지스트리에서 스키마를 검색할 수 없는 경우 여러 번 재시도할 수 있습니다. 이 구성 옵션은 재시도 횟수를 제어합니다.

음수가 아닌 숫자 또는 정수 문자열

3

USE_ID

apicurio.registry.use-id

직렬화 및 역직렬기에 의해 사용됩니다. 지정된 IdOption 을 아티팩트의 식별자로 사용하도록 를 구성합니다. 옵션은 globalId 및 contentId 입니다. serializer에 지정된 ID를 Kafka에 작성하도록 지시하고, 이 ID를 사용하여 스키마를 찾도록 역직렬화자에게 지시합니다.

문자열

globalId

ENABLE_HEADERS

apicurio.registry.headers.enabled

직렬화 및 역직렬기에 의해 사용됩니다. 메시지 페이로드 대신 Kafka 메시지 헤더에 아티팩트 ID를 읽고 쓸 수 있도록 를 구성합니다.

boolean

true

HEADERS_HANDLER

apicurio.registry.headers.handler

직렬화 및 역직렬기에 의해 사용됩니다. HeadersHandler 를 구현하고 Kafka 메시지 헤더에서 아티팩트 ID를 / 읽기/읽기하는 정규화된 Java 클래스 이름입니다.

문자열

io.apicurio.registry.serde.headers.DefaultHeadersHandler

ID_HANDLER

apicurio.registry.id-handler

직렬화 및 역직렬기에 의해 사용됩니다. IdHandler 를 구현하고 메시지 페이로드에서 아티팩트 식별자를 쓰는 클래스의 정규화된 Java 클래스 이름입니다. apicurio.registry.headers.enabled 가 false 로 설정된 경우에만 사용됩니다.

문자열

io.apicurio.registry.serde.DefaultIdHandler

ENABLE_CONFLUENT_ID_HANDLER

apicurio.registry.as-confluent

직렬화 및 역직렬기에 의해 사용됩니다. IdHandler 의 레거시 Confluent 호환 구현을 활성화하는 바로 가기입니다. apicurio.registry.headers.enabled 가 false 로 설정된 경우에만 사용됩니다.

boolean

true

FALLBACK_ARTIFACT_PROVIDER

apicurio.registry.fallback.provider

역직자만 사용합니다. deserialization에 사용되는 아티팩트를 해결하기 위해 FallbackArtifactProvider 의 사용자 지정 구현을 설정합니다. FallbackArtifactProvider 는 조회가 실패하는 경우 레지스트리에서 가져올 대체 아티팩트를 구성합니다.

문자열

io.apicurio.registry.serde.fallback.DefaultFallbackArtifactProvider

FALLBACK_ARTIFACT_ID

apicurio.registry.fallback.artifact-id

역직자만 사용합니다. 역직렬화에 사용되는 아티팩트를 해결하기 위해 폴백으로 사용되는 artifactId 를 설정합니다.

문자열

없음

FALLBACK_ARTIFACT_GROUP_ID

apicurio.registry.fallback.group-id

역직자만 사용합니다. deserialization에 사용된 그룹을 확인하기 위해 폴백으로 사용되는 groupId 를 설정합니다.

문자열

없음

FALLBACK_ARTIFACT_VERSION

apicurio.registry.fallback.version

역직자만 사용합니다. 역직렬화에 사용되는 아티팩트를 해결하기 위해 폴백으로 사용되는 버전을 설정합니다.

문자열

없음