スキーマのエクスポートとインポート

Data Fabric / Data Service でエンティティとチョイス セットのスキーマをエクスポートおよびインポートして、開発、テスト、運用全体にわたるアプリケーション ライフサイクル管理をサポートします。

概要

スキーマは、すべてのエンティティとチョイス セットのメタデータであり、エンティティ フィールドのデータ型やエンティティ フィールド間のリレーションシップなどの情報を保持します。

スキーマをエクスポートおよびインポートすることにより、テナントとフォルダー間でスキーマをコピーしたり、任意のソース管理ツールを使用してスキーマの変更を追跡したりするなどの機能を考慮して、アプリケーション ライフサイクル管理のベスト プラクティス (開発、テスト、デプロイ) を実装できます。

スキーマをエクスポートすると、エンティティのメタデータを含む JSON ファイルがローカル マシンにダウンロードされます。異なる開発者がインポートするファイルをテナントやフォルダーに共有したり、コミュニティが開発したスキーマを自分でインポートしたりできます。

複数のスコープにわたってエンティティを複製する

エクスポートとインポートを使用して、ネイティブ エンティティ スキーマをスコープ間で複製できます。たとえば、テナント レベルのエンティティをエクスポートしてフォルダーにインポートすると、同じスキーマでフォルダー スコープのコピーが作成されます。スキーマのみが複製され、データはコピーされません。インポートされたエンティティは元のエンティティから独立しており、個別に変更できます。

これは、スキーマを手動で再作成することなく、フォルダー内の既存のエンティティ設計を再利用してソリューションで使用する場合に便利です。

権限

スキーマをエクスポートおよびインポートするユーザーには、以下の管理権限を設定する必要があります。

操作	アクセス許可
スキーマをエクスポート	スキーマの表示
スキーマをインポート	スキーマのカスタマイズ スキーマの表示

必要な権限の設定方法については、「 アクセス権を管理する 」をご覧ください。

スキーマをエクスポートする

注:

• スキーマをエクスポートできるのは、適切な権限を持つユーザーのみです。
• テナントに存在するすべてのネイティブ エンティティがエクスポートされます。
• システム組み込みエンティティと対応するシステム フィールドは、エクスポートから除外されます。

スキーマをエクスポートするには、以下の手順を実行します。

1. Data Fabric/Data Service で目的のテナントに移動します。
2. [ インポート/エクスポート] を選択します。
3. [スキーマをエクスポート] を選択します。エクスポートの確認を求めるポップアップ メッセージが表示されます。
4. [ 確定 ] を選択してエクスポートをトリガーします。スキーマを含む .JSON ファイルがマシンにダウンロードされます。

スキーマをインポートする

注:

• スキーマをインポートできるのは、適切な権限を持つユーザーのみです。
• インポートされるスキーマ ファイルの要件は以下のとおりです。
  • 有効であること
  • JSON 形式であること
  • 30 MB 未満であること
• インポートされたスキーマの [作成者] と [変更者] フィールドには、インポートを実行したユーザーが入力されます。
• [作成時刻] と [最終変更時刻] フィールドには、インポートのタイムスタンプが入力されます。
• インポート プロセスは、一度開始されると停止できません。

スキーマをインポートするには、以下の手順を実行します。

1. Data Fabric/Data Service 内の目的のテナントまたはフォルダーに移動します。
2. [ インポート/エクスポート] を選択します。
3. [スキーマをインポート] を選択します。
4. インポート先の場所 (テナントまたはフォルダー) を選択します。
5. スキーマ ファイルを参照して選択します。
   注:

   スキーマ ファイルは JSON 形式で、有効である必要があります。コーディング エージェントを使用してスキーマ ファイルを生成する場合は、フィールドの型が予期される Data Fabric の種類と一致することを確認してください。型が正しくないと予期しない動作が発生する可能性があるためです。

6. インポートするエンティティとチョイス セットを選択します。
7. 重複が検出されない場合、選択したエンティティが選択した宛先にインポートされます。重複する場合、[ エンティティのインポート ] ウィンドウが表示され、重複するフィールドを既存のエンティティに追加するか、重複するフィールドをインポートしないかを選択できます。

重複を処理する

スキーマのインポート プロセスでは、選択したターゲットの既存のエンティティ、フィールド、またはチョイス セットが、インポートされたスキーマのエンティティ、フィールド、またはチョイス セットと比較されます。

インポートされたスキーマ内で見つかった重複ごとに、以下のオプションが表示されます。

既存の一覧に追加 (既定のオプション)

• 選択したターゲットに存在しないエンティティ フィールドとチョイス セットがインポートされます。
• プロパティ (名前やデータ型など) が異なるフィールドとチョイス セットを含むエンティティはインポートされません。

インポートしない

• エンティティは、選択したインポート先にインポートされません。