# メタデータ管理
<a name="metadata-management"></a>

AWS での Cloud Migration Factory ソリューションは、ユーザーインターフェイス内からレコードを追加、編集、削除できる拡張可能なデータストアを提供します。データストアに保存されているデータの更新はすべて、レコードレベルの監査スタンプで監査されます。この監査スタンプには、ユーザーの詳細とともに作成および更新のタイムスタンプが表示されます。レコードへの更新アクセスはすべて、ログインしたユーザーに割り当てられたグループと関連ポリシーによって制御されます。アクセス許可の付与について詳しくは、「**[アクセス許可の管理](permission-management.md)**」を参照してください。

## データの表示
<a name="viewing-data"></a>

**移行管理**ナビゲーションペインから、データストアに保持されているレコードタイプ (アプリケーション、ウェーブ、データベース、サーバー) を選択できます。ビューを選択すると、選択したレコードタイプの既存のレコードの表が表示されます。各レコードタイプのテーブルには、ユーザーが変更できるデフォルトの列セットが表示されます。変更は、セッションが変わっても保持され、変更を行うために使用したブラウザとコンピュータに保存されます。

### カスタムアセット
<a name="custom-assets-side-panel"></a>

**注記**  
カスタムアセットは、ウェーブプランニングマネージャー (WPM) モジュールの機能です。これらを使用するには、CMF をデプロイするときに WPM を有効にする必要があります。

カスタムアセットを作成した場合は、**[カスタムアセット]** ナビゲーションペインに表示されます。各アセットには独自のサブヘッダーがあり、いずれかを選択すると、選択したカスタムアセットの既存のレコードのテーブルが表示されます。その後、通常のアセットと同じ方法で、これらのレコードの作成/編集/削除を行うことができます。

### テーブルに表示されるデフォルト列の変更
<a name="changing-the-default-columns-displayed-in-tables"></a>

デフォルトの列を変更するには、データテーブルの右上隅にある設定アイコンを選択し、表示する列を選択します。この画面では、表示するデフォルトの行数を変更したり、大量のデータを含む列の折り返しを有効にしたりすることもできます。

### レコードを表示する
<a name="viewing-a-record"></a>

テーブル内の特定のレコードを表示するには、行の任意の場所をクリックするか、行の横にあるチェックボックスを選択します。複数の行を選択すると、レコードは表示されません。これにより、画面下部のデータテーブルの下にレコードが読み取り専用モードで表示されます。表示されるレコードには、以下のデフォルトテーブルがあります。

 **詳細** — これはレコードタイプに必要な属性と値をまとめたものです。

 **すべての属性** — すべての属性とその値の完全なリストが表示されます。

選択したレコードタイプによっては、関連するデータや情報を提供する他のタブが表示される場合があります。例えば、**アプリケーション**レコードには**サーバー**タブがあり、選択した**アプリケーション**に関連するサーバーの表が表示されます。

## レコードの追加または編集
<a name="adding-or-editing-a-record"></a>

操作は、ユーザー権限を通じてレコードタイプによって制御されます。ユーザーが特定のタイプのレコードを追加または編集するのに必要な権限を持っていない場合、**[追加]** や **[編集]** ボタンがグレー表示され、無効になっています。

新しいレコードを追加するには:

1. 作成したいレコードタイプのテーブルの右上隅から **[追加]** を選択します。

デフォルトでは、**[アプリケーションを追加]** 画面に **[詳細]** と **[監査]** セクションが表示されますが、タイプやスキーマのカスタマイズによっては、他のセクションも表示される場合があります。

1. フォームに記入してエラーをすべて解決したら、**[保存]** を選択します。

既存のレコードを編集するには:

1. 編集するレコードをテーブルから選択し、**[編集]** を選択します。

1. レコードを編集して検証エラーがないことを確認し、**[保存]** を選択します。

## レコードの削除
<a name="deleting-a-record"></a>

ユーザーが特定のタイプのレコードを削除する権限を持っていない場合、**[削除]** ボタンはグレー表示され、無効になります。

**重要**  
データストアから削除されたレコードは回復できません。DynamoDB テーブルを定期的にバックアップするか、データをエクスポートして、問題が発生した場合に復旧ポイントを確保することをお勧めします。

1 つ以上のレコードを削除するには:

1. テーブルから 1 つまたは複数のレコードを選択します。

1. **[削除]** を選択してアクションを確認します。

## データのエクスポート
<a name="exporting-data"></a>

AWS での Cloud Migration Factory ソリューション内に保存されたデータの大部分は、Excel (.xlsx) ファイルにエクスポートできます。データをレコードタイプレベルでエクスポートすることも、すべてのデータとタイプを完全に出力することもできます。

特定のレコードタイプをエクスポートするには:

1. エクスポートするテーブルに移動します。

1.  *オプション*: Excel シートにエクスポートするレコードを選択します。何も選択されていない場合は、すべてのレコードがエクスポートされます。

1. データテーブル画面の右上隅にある **[エクスポート]** アイコンを選択します。

レコードタイプの名前 (`servers.xlsx` など) の付いた Excel ファイルが、ブラウザのデフォルトのダウンロード場所にダウンロードされます。

すべてのデータをエクスポートするには:

1. **移行管理**に移動してから、**[エクスポート]** を選択します。

1. **[すべてのデータをダウンロードする]** にチェックマークを入れます。

`all-data.xlsx` という名前の付いた Excel ファイルが、ブラウザのデフォルトのダウンロード場所にダウンロードされます。この Excel ファイルには、レコードタイプごとにタブが含まれ、各タイプのすべてのレコードがエクスポートされます。

**注記**  
Excel のセルテキスト制限は 32,767 文字であるため、エクスポートされたファイルに新しい列が含まれる場合があります。この場合、エクスポートでは、Excel がサポートするデータ量を超えるフィールドのテキストは切り捨てられます。切り捨てられたフィールドでは、`[truncated - Excel max chars 32767]` というテキストが追加された新しい列が元の名前でエクスポートに追加されます。また、切り捨てられたセル内には、`[n characters truncated, first x provided]` というテキストも表示されます。切り捨てプロセスは、ユーザーが同じ Excel をエクスポートしてからインポートした場合に、切り捨てられた値でデータが上書きされるというシナリオから保護します。

## データのインポート
<a name="importing-data"></a>

AWS での Cloud Migration Factory ソリューションには、サーバーのリストなどの単純なレコード構造をデータストアにインポートできるデータインポート機能が備わっています。また、より複雑なリレーショナルデータをインポートすることもできます。例えば、同じファイルに含まれる新しいアプリケーションレコードと複数のサーバーを作成し、1 回のインポートタスクでそれらを相互に関連付けることができます。これにより、1 回のインポートプロセスで、インポートすべきあらゆるデータタイプに対応できます。インポートプロセスでは、ユーザーがユーザーインターフェイスでデータを編集するときと同じ検証ルールを使用してデータを検証します。

### テンプレートをダウンロードする
<a name="downloading-a-template"></a>

インポート画面からテンプレート入力フォームをダウンロードするには、**[アクションリスト]** から、必要なテンプレートを選択します。次の 2 つのデフォルトテンプレートを使用できます。

 **必須属性のみを含むテンプレート** — 必須とマークされた属性のみが含まれます。すべてのレコードタイプのデータをインポートするのに必要な最低限の属性セットを提供します。

 **すべての属性を含むテンプレート** — これにはスキーマ内のすべての属性が含まれます。このテンプレートには、各属性について、その属性が検出されたスキーマを識別するための追加のスキーマヘルパー情報が含まれています。列ヘッダーのヘルパープレフィックスは、必要に応じて削除できます。インポート中にそのままにしておくと、列内の値は特定のレコードタイプにのみ読み込まれ、リレーショナル値には使用されません。詳細については、「**インポートヘッダー、スキーマ、ヘルパー**」を参照してください。

### ファイルのインポート
<a name="importing-a-file"></a>

インポートファイルは .xlsx または .csv 形式で作成できます。CSV の場合は UTF8 エンコーディングを使用して保存する必要があります。そうしないと、アップロード前の検証テーブルを表示したときにファイルが空と表示されます。

ファイルをインポートするには:

1. **移行管理**に移動してから、**[インポート]** を選択します。

1. **[ファイルの選択]** を選択します。デフォルトでは、`–0—csv` または `–1—xlsx` 拡張機能のいずれかのファイルしか選択できません。ファイルが正常に読み込まれると、ファイルの名前とサイズが表示されます。

1. [**次へ**] を選択します。

1. **[アップロード前検証]** 画面には、ファイル内のヘッダーをスキーマ内の属性にマッピングし、提供された値を検証した結果が表示されます。
   + ファイル列ヘッダーのマッピングは、画面上のテーブル列名に表示されます。どのファイル列ヘッダーがマップされたかを確認するには、ヘッダー内の拡張可能な名前を選択すると、元のファイルヘッダーやマップ先のスキーマ名など、マッピングに関する詳細情報が表示されます。マップされていないファイルヘッダー、または複数のスキーマに重複する名前がある場合、**[検証]** 列に警告が表示されます。
   + すべてのヘッダーは、ファイルの各行の値をマップされた属性の要件と照らし合わせて検証します。ファイルコンテンツ内の警告やエラーは、すべて **[検証] 列**に表示されます。

1. 検証エラーがなくなったら、**[次へ]** を選択します。

1. **[データをアップロード]** ステップには、このファイルがアップロードされた後に行われる変更の概要が表示されます。アップロード時に変更が加えられるすべての項目については、特定の更新タイプの下で **[詳細]** を選択すると、実行される変更を確認できます。

1. レビューが完了したら、**[アップロード]** を選択して、これらの変更をライブデータにコミットします。

アップロードが成功すると、フォームの上部にメッセージが表示されます。アップロード中に発生したエラーは、**[アップロードの概要]** の下に表示されます。

#### ヘッダースキーマヘルパーをインポートする
<a name="import-header-schema-helpers"></a>

デフォルトでは、取り込みファイルの列ヘッダーに任意のスキーマの属性名を設定する必要があります。インポートプロセスはすべてのスキーマを検索し、ヘッダー名を属性と一致させようとします。属性が複数のスキーマで見つかった場合、特にほとんどの場合無視できるリレーションシップ属性については警告が表示されます。ただし、特定の列を特定のスキーマ属性にマップすることが目的の場合は、列ヘッダーの前にスキーマヘルパープレフィックスを付けることでこの動作を無効にできます。このプレフィックスは、形式 `{attribute name}` です。この場合、`{schema name}` はシステム名 (ウェーブ、アプリケーション、サーバー、データベース) に基づくスキーマの名前で、`{attribute name}` はスキーマ内の属性のシステム名です。このプレフィックスがある場合、属性名が他のスキーマに存在していても、すべての値はこの特定のスキーマのレコードにのみ入力されます。

次の図に示すように、列 C のヘッダーには `[database]` のプレフィックスが付けられていますが、これにより属性は強制的にデータベーススキーマの `database_type` 属性にマッピングされます。

 **ヘッダースキーマヘルパーをインポートする** 

![ヘッダースキーマヘルパーをインポートする](http://docs.aws.amazon.com/ja_jp/solutions/latest/cloud-migration-factory-on-aws/images/import-header-schema-helper.png)


#### 属性インポートフォーマット
<a name="attribute-import-format"></a>

次の表は、Cloud Migration Factory 属性に正しくインポートできるようにインポートファイル内の値をフォーマットするためのガイドです。


| タイプ | サポートされているインポート形式 | 例 | 
| --- | --- | --- | 
| String | 英数字と特殊文字を受け入れます。 |  `123456AbCd.!`  | 
| 複数値文字列 | セミコロンで区切られた文字列タイプのリスト。 |  `Item1;Item2;Item3`  | 
| パスワード | 英数字と特殊文字を受け入れます。 |  `123456AbCd.!`  | 
| 日付 | MM/DD/YYYY HH:mm |  `01/30/2023 10:00`  | 
| Checkbox (チェックボックス) | 文字列形式のブール値。選択した場合は `TRUE`、未選択の場合は `FALSE`。 |  `TRUE`-または-`FALSE`  | 
| Textarea | ラインフィードとキャリッジリターンをサポートする文字列型。 |  `Test line1`-または-`Testline 2`  | 
| タグ | タグは `key=value;` 形式にする必要があります。複数のタグはセミコロンで区切る必要があります。 |  `TagKey1=Tagvalue1;TagKey2=tagvalue2;`  | 
| リスト | 1 つの値リスト属性を設定する場合は文字列型と同じ形式を使用し、複数選択リストを設定する場合は複数値文字列型に従って設定します。 |  `Selection1;Selection2;`  | 
| Relationship | 英数字と特殊文字を使用できます。これらは、属性定義で定義されたキーに基づく値と一致する必要があります。 |  `Application1`  |