Skip to content

Instantly share code, notes, and snippets.

@kenzo0107
Created August 20, 2025 08:19
Show Gist options
  • Save kenzo0107/0f8973b4b2b7a14a9e7d72d7ba868d70 to your computer and use it in GitHub Desktop.
Save kenzo0107/0f8973b4b2b7a14a9e7d72d7ba868d70 to your computer and use it in GitHub Desktop.

https://docs.confluent.io/cloud/current/sr/schemas-manage.html

以下は、Confluent ドキュメント「Manage Schemas in Confluent Cloud(Confluent Cloud におけるスキーマ管理)」の内容を日本語に和訳し、Markdown形式で整理したまとめです。


Confluent Cloud におけるスキーマ管理 (Manage Schemas)

Confluent Cloud 上では、「スキーマレジストリ(Schema Registry)」が環境単位でホストされ、ストリームガバナンス機能の中核を担っています。本ページでは、スキーマの表示・編集・検索・互換性管理などの操作について紹介します。(Confluent Docs)


スキーマに関する主な操作

以下の操作を Confluent Cloud UI にて実施できます:(Confluent Docs)

  • スキーマの表示
  • トピック用スキーマの作成
  • メッセージからのスキーマ抽出
  • Schema References(スキーマ参照)の利用
  • スキーマの編集
  • スキーマバージョンの比較
  • サブジェクト単位での互換性モード設定の変更
  • スキーマやフィールドに対する検索
  • スキーマやフィールドへのタグ付け
  • スキーマ・コンテキスト(Schema contexts)の操作
  • スキーマのダウンロードや削除
  • 環境単位でのスキーマ管理
  • Schema Registry 権限(RBAC)制御
  • サポートされる機能と制限の確認

画面からスキーマを閲覧する

トピック画面からの確認方法

  1. 「Environments」から対象の環境を選択

  2. 「Clusters」から操作するクラスタを選択

  3. 「Topics」で対象トピックを選択

  4. 「Schema」タブに移動し、スキーマを表示(コード表示とツリービューの切替が可能)(Confluent Docs)

    • スキーマタイプ、互換性モード、バージョン、スキーマIDなども確認可能(Confluent Docs)

環境単位でスキーマを一覧表示・検索

  1. 環境選択後、左メニューの「Schema Registry」→「Data contracts」タブへ移動

  2. 環境内の全スキーマ一覧にアクセス・検索・操作(ダウンロード、複製、削除、バージョン比較など)が可能(Confluent Docs)

    • グローバル互換性はコンテキスト単位で設定され、統一的には存在しません(Confluent Docs)

スキーマのダウンロードと削除

  • ダウンロード トピックの「Data contracts」タブでキー/値を選択し、右上のメニューから「Download」選択で JSON スキーマを取得可能。(Confluent Docs)

  • 削除 同じ画面メニューから「Delete」を選び、特定バージョンまたはサブジェクト全体を削除可能。(Confluent Docs)


環境単位でのスキーマ管理

  • 環境単位で Schema Registry を通じて、API キー発行、全スキーマの一覧、検索、互換性設定などを一括で管理可能です。(Confluent Docs)

RBAC によるアクセス制御(ロールベース)

Confluent Cloud では、スキーマ操作に対するアクセス権限を細かく設定できます。代表的なロールと操作可能内容は以下の通りです:(Confluent Docs)

ロール 読み取り 書き込み 削除 互換性設定 権限付与
OrganizationAdmin
EnvironmentAdmin
ResourceOwner
DeveloperManage
DeveloperRead
DataSteward

※ Global compatibility の管理は、Subject 名 __GLOBAL に対して DeveloperManage ロールを付与する必要があります。(Confluent Docs)


サポート機能と制限事項

  • Schema Registry は環境ごとに 1 インスタンスで提供され、複数クラスタに対応。(Confluent Docs)
  • スキーマサイズは最大 1MB。超過時はスキーマ参照(Schema References)活用が推奨されます。(Confluent Docs)
  • スキーマバージョン数にはクラスタータイプ(Basic / Standard / Dedicated)ごとに上限あり。不要なスキーマ削除が可能。(Confluent Docs)
  • API リクエスト制限(環境単位で共通):書き込みは 25 req/秒、読み取りは 75 req/秒。複数キーでも合算されます。(Confluent Docs)

まとめ

Confluent Cloud におけるスキーマ管理では、以下が可能です:

  • スキーマの表示・検索・編集・ダウンロード・削除
  • スキーマ参照、互換性モード設定、コンテキスト管理
  • 環境単位/サブジェクト単位での操作と制御
  • 細かな RBAC によるアクセス管理
  • スキーマサイズ・バージョン上限・APIレート制限の把握と対応策
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment