Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

스키마를 주제와 연결

이 문서에서는 Pub/Sub 주제의 스키마를 연결하는 방법을 보여줍니다.

시작하기 전에

Pub/Sub 스키마의 작동 방식을 이해합니다.
스키마를 만듭니다.

필수 역할 및 권한

스키마 연결 및 관리를 위해 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Pub/Sub 편집자 (roles/pubsub.editor) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 스키마 연결 및 관리를 위해 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

스키마를 연결하고 관리하려면 다음 권한이 필요합니다.

스키마 만들기: pubsub.schemas.create
주제에 스키마 연결: pubsub.schemas.attach
스키마 버전 커밋: pubsub.schemas.commit
스키마 또는 스키마 버전 삭제: pubsub.schemas.delete
스키마 또는 스키마 버전 가져오기: pubsub.schemas.get
스키마 나열: pubsub.schemas.list
스키마 버전 나열: pubsub.schemas.listRevisions
스키마 롤백: pubsub.schemas.rollback
메시지 유효성 검사: pubsub.schemas.validate
스키마의 IAM 정책 가져오기: pubsub.schemas.getIamPolicy
스키마의 IAM 정책 구성: pubsub.schemas.setIamPolicy

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

사용자, 그룹, 도메인, 서비스 계정과 같은 주 구성원에 역할 및 권한을 부여할 수 있습니다. 한 프로젝트에서 스키마를 만들고 이를 다른 프로젝트에 있는 주제에 연결할 수 있습니다. 각 프로젝트에 필요한 권한이 있는지 확인합니다.

스키마를 주제와 연결하기 위한 가이드라인

주제를 만들거나 편집할 때 스키마를 주제와 연결할 수 있습니다. 다음은 스키마를 주제와 연결하기 위한 가이드라인입니다.

스키마를 하나 이상의 주제와 연결할 수 있습니다.

스키마가 주제와 연결된 다음에는 주제가 게시자에서 수신하는 모든 메시지가 해당 스키마를 따라야 합니다.
또한 스키마를 주제와 연결할 때는 게시할 메시지 인코딩을 BINARY 또는 JSON으로 지정해야 합니다. Avro 스키마에서 JSON을 사용하는 경우 union에 대한 인코딩 규칙에 주의하세요.
주제와 연결된 스키마에 여러 버전이 포함된 경우 메시지가 인코딩과 일치해야 하고 사용 가능한 범위 내의 버전에 대해 유효한지 검사해야 합니다. 유효하지 않으면 메시지가 게시되지 않습니다.

버전은 생성 시간의 역순으로 시도됩니다. 스키마 버전을 만들려면 스키마 버전 커밋을 참조하세요.

메시지 스키마의 유효성 검사 논리

스키마를 주제와 연결할 때 스키마에 여러 버전이 포함되어 있으면 사용할 버전의 하위 집합 범위를 지정할 수 있습니다. 범위를 지정하지 않으면 전체 범위가 유효성 검사에 사용됩니다.

특정 버전을 허용된 첫 번째 버전으로 지정하지 않으면 스키마에서 가장 오래된 기존 버전이 유효성 검사에 사용됩니다. 특정 버전을 허용된 마지막 버전으로 지정하지 않으면 스키마에서 가장 새로운 기존 버전이 사용됩니다.

예를 들어 T 주제에 연결된 S 스키마가 있다고 가정해보세요.

S 스키마에는 순서대로 A, B, C, D에 해당하는 버전 ID가 있고, A가 첫 번째 버전 또는 가장 오래된 버전입니다. 스키마는 서로 동일하지 않고 기존 스키마의 롤백이 아닙니다.

허용된 첫 번째 버전 필드를 B로만 설정할 경우에는 A 스키마와 호환되는 메시지만 거부되고 B, C, D 스키마와 호환되는 메시지는 허용됩니다.
허용된 마지막 버전 필드를 C로만 설정할 경우에는 A, B, C 스키마와 호환되는 메시지가 허용되고 D 스키마와 호환되는 메시지만 거부됩니다.
허용된 첫 번째 버전 필드를 B로 설정하고 허용된 마지막 버전 필드를 C로 설정하면 B 및 C 스키마와 호환되는 메시지가 허용됩니다.
또한 첫 번째 버전과 마지막 버전을 동일한 버전 ID로 설정할 수도 있습니다. 이 경우 해당 버전과 호환되는 메시지만 허용됩니다.

주제를 만들 때 스키마 만들기 및 연결

Google Cloud 콘솔, gcloud CLI, Pub/Sub API, Cloud 클라이언트 라이브러리를 사용하여 스키마가 있는 주제를 만들 수 있습니다.

콘솔

Google Cloud 콘솔에서 Pub/Sub 주제 페이지로 이동합니다.

주제로 이동
주제 만들기를 클릭합니다.
주제 ID 필드에 주제의 ID를 입력합니다.

주제 이름을 지정하려면 가이드라인을 참조하세요.
스키마 사용 체크박스를 선택합니다.

나머지 필드는 기본 설정을 그대로 둡니다.

스키마를 만들거나 기존 스키마를 사용할 수 있습니다.
스키마를 만들려면 다음 단계를 수행합니다.
1. Pub/Sub 스키마 선택에 대해 새 스키마 만들기를 선택합니다.
스키마 만들기 페이지가 보조 탭에 표시됩니다.

스키마 만들기의 단계를 수행합니다.
1. 주제 만들기 탭으로 이동하고 새로고침을 클릭합니다.
2. Pub/Sub 스키마 선택 필드에서 스키마를 검색합니다.
3. 메시지 인코딩을 JSON 또는 바이너리로 선택합니다.
방금 만든 스키마에 버전 ID가 포함됩니다. 스키마 버전 커밋에 설명된 대로 추가 스키마 버전을 만들 수 있습니다.
이미 생성된 스키마를 연결하는 경우 다음 단계를 수행합니다.
1. Pub/Sub 스키마 선택에 대해 기존 스키마를 선택합니다.
2. 메시지 인코딩을 JSON 또는 바이너리로 선택합니다.
선택사항: 선택한 스키마에 버전이 포함된 경우 버전 범위에 대해 허용된 첫 번째 버전 및 허용된 마지막 버전의 드롭다운 메뉴를 사용합니다.

요구사항에 따라 두 필드를 모두 지정하거나, 하나만 지정하거나, 기본 설정을 그대로 둘 수 있습니다.

나머지 필드는 기본 설정을 그대로 둡니다.
만들기를 클릭하여 주제를 저장하고 선택한 스키마에 할당합니다.

gcloud

이전에 만든 스키마로 할당된 주제를 만들려면 gcloud pubsub topics create 명령어를 실행합니다.

gcloud pubsub topics create TOPIC_ID \
        --message-encoding=ENCODING_TYPE \
        --schema=SCHEMA_ID \
        --first-revision-id=FIRST_REVISION_ID \
        --last-revision-id=LAST_REVISION_ID \

각 항목의 의미는 다음과 같습니다.

TOPIC_ID는 만들려는 주제의 ID입니다.
ENCODING_TYPE은 스키마에 대해 검증된 메시지의 인코딩 유형입니다. 이 값은 JSON 또는 BINARY로 설정해야 합니다.
SCHEMA_ID는 기존 스키마의 ID입니다.
FIRST_REVISION_ID는 유효성을 검사할 가장 오래된 버전의 ID입니다.
LAST_REVISION_ID는 유효성을 검사할 최신 버전의 ID입니다.

--first-revision-id와 --last-revision-id 모두 선택사항입니다.

다른 Google Cloud 프로젝트의 스키마를 할당할 수도 있습니다.

gcloud pubsub topics create TOPIC_ID \
        --message-encoding=ENCODING_TYPE \
        --schema=SCHEMA_ID \
        --schema-project=SCHEMA_PROJECT

스키마를 주제와 연결 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.