翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
スキーマのインプレースアップグレード
Cloud Directory では、既存のスキーマ属性とファセットを更新し、アプリケーションを AWS 提供のサービスと統合できます。発行済みまたは適用済みの状態のスキーマにはバージョンがあり、変更することはできません。詳細については、「スキーマのライフサイクル」を参照してください。
スキーマのバージョニング
スキーマのバージョンは、データの特定のルールや形式に準拠するようにアプリケーションをプログラミングするときに、開発者が指定できるスキーマの一意の識別子を示します。開発者は、Cloud Directory のバージョニングの主に 2 つの異なる方法から成り、のバージョニングが重要であることを理解することが重要です。この 2 つとは、メジャーバージョンとマイナーバージョンであり、今後のスキーマのアップグレードとアプリケーションの関係を決定します。
メジャーバージョン
メジャーバージョンは、スキーマの主要なバージョン変更を追跡するためのバージョン識別子です。最大 10 文字を使用できます。同じスキーマの異なるバージョンは完全に独立しています。たとえば、同じ名前でも異なるバージョンの 2 つのスキーマは、それぞれ独自の名前空間を持ち、完全に異なるスキーマとして扱われます。
下位互換性のない変更
メジャーバージョンを変更するのは、スキーマ間に互換性がない場合に限ります。たとえば、既存の属性のデータ型を変更する場合 (string を integer に変更するなど) や、スキーマから必須属性を削除する場合などが該当します。下位互換性のない変更を行うには、前のスキーマバージョンから新しいスキーマバージョンにディレクトリのデータを移行する必要があります。
マイナーバージョン
マイナーバージョンは、スキーマのインプレースアップグレード、または下位互換性のあるアップグレード (属性やファセットを追加するなど) を行う場合に使用するバージョン識別子です。マイナーバージョンを使用してアップグレードしたスキーマは、実行中のアプリケーションを一切破損することなく、それを使用するすべてのディレクトリにわたってインプレースで適用できます。これには、本番稼働用環境で使用されているディレクトリも含まれます。ユースケース例については、インプレーススキーマアップグレードにより Amazon Cloud Directory スキーマの変更を簡単に適用する方法
マイナーバージョンの情報と履歴は、他のスキーマ情報と共に、スキーマメタデータリポジトリに保存されます。オブジェクトには一切のマイナーバージョン情報が保存されません。マイナーバージョンを導入する利点は、メジャーバージョンが変更されない限り、クライアントコードがシームレスに動作することです。
マイナーバージョン制限
Cloud Directory はマイナーバージョンを保持するため、最大5つまで制限されます。ただし、マイナーバージョンの制限は、公開スキーマと適用スキーマに対して次のように異なる方法で適用されます。
適用済みのスキーマ: マイナーバージョンの制限を超えると、Cloud Directory は古いマイナーバージョンを自動的に削除します。
発行済みのスキーマ: マイナーバージョンの制限を超えると、Cloud Directory はマイナーバージョンを削除しませんが、
LimitExceededException制限を超過しました。マイナーバージョンの制限を超えると、スキーマを削除できます。DeleteSchemaAPI を使用するか、制限引き上げをリクエストします。
スキーマアップグレード API オペレーションの使用
発行済みのスキーマをアップグレードするには、UpgradePublishedSchema API コールを使用できます。スキーマのアップグレードは、UpgradeAppliedSchema API コールにより、スキーマに依存するディレクトリにインプレースで適用されます。また、適用済みのスキーマのメジャーバージョンとマイナーバージョンを取得するには、GetAppliedSchemaVersion を呼び出します。ディレクトリに関連付けられたスキーマ ARN とスキーマ改訂履歴を表示するには、を呼び出します。ListAppliedSchemaArns。Cloud Directory は、適用済みスキーマの最新バージョンを 5 つ保持します。
例については、インプレーススキーマアップグレードにより Amazon Cloud Directory スキーマの変更を簡単に適用する方法
