タイプを作成する
このガイドでは、Manufacturing Data Engine（MDE）で新しいタイプを作成する方法について説明します。タイプは、構成 API または MDE ウェブ インターフェースを使用して作成できます。
始める前に
タイプを使用すると、他の構成設定の中でも、そのタイプのレコードのコンテキスト化スコープ（レコードのコンテキスト化に使用できる、または使用する必要があるメタデータ バケット）を定義できます。メタデータ バケットをタイプに関連付ける場合は、まずバケットを作成する必要があります。詳細については、 メタデータ バケットを作成する方法をご覧ください。
タイプの命名
タイプを作成する場合、名前は MDE デプロイで一意である必要があります。タイプ名にスペースや特殊文字（&、@、% など）を含めることはできません。
タイプを作成する
1 つのメタデータ バケットの関連付けと一般的なストレージ仕様を使用してタイプを作成するには、ターミナルまたはコンソール インターフェースを使用します。
REST
次の REST API リクエストを実行します。
POST /configuration/v1/types
{
"archetype": "ARCHETYPE NAME",
"name": "TYPE_NAME",
"metadataBuckets": [
{
"bucketName": "BUCKET_NAME",
"version": "BUCKET_VERSION"
}
],
"storageSpecs": [
{
"sink": "BIG_QUERY",
"disabled": "false",
"materializeCloudMetadata": "true"
},
{
"sink": "BIG_TABLE",
"disabled": "false",
"materializeCloudMetadata": "false"
},
{
"sink": "GCS",
"disabled": "false",
"materializeCloudMetadata": "false"
},
{
"sink": "PUBSUB_PROTO",
"disabled": "false",
"materializeCloudMetadata": "false"
},
{
"sink": "PUBSUB_JSON",
"disabled": "false",
"materializeCloudMetadata": "false"
}
]
}
次のように置き換えます。
ARCHETYPE: アーキタイプの名前。DISCRETE_DATA_SERIES、CLUSTERED_DISCRETE_DATA_SERIES、NUMERIC_DATA_SERIES、CLUSTERED_NUMERIC_DATA_SERIES、CONTINUOUS_DATA_SERIES、CLUSTERED_CONTINUOUS_DATA_SERIESのいずれか。TYPE_NAME: 作成するタイプの名前。BUCKET_NAME: このタイプに関連付けるバケットの名前。BUCKET_VERSION: このタイプに関連付けるバケットのバージョン。
コンソール
コンソールを使用して新しいタイプ を作成するには、[タイプ] セクションのタブを開きます。
このセクションには、MDE インスタンスで使用可能なすべてのタイプが一覧表示されます。リストには、各タイプの基本的な構成が表示されます。
- 名前: タイプの固有の名前。すべてのタイプに異なる一意の名前を付ける必要があります。
- ストレージ: タイプに関連付けられている現在のストレージ仕様を表示します。
- アーキタイプ: タイプを定義するアーキタイプの名前を表示します。 各タイプは一意のアーキタイプに関連付けられています。タイプを作成した後にアーキタイプの関連付けを変更することはできません。
- バージョン: タイプのバージョン番号。タイプはバージョン管理できます。このリストのデフォルト ビューには、タイプで使用可能な最新バージョンのみが表示されます。[最新バージョンを表示] チェックボックスをオフにすると、古いバージョンを表示できます。
- メタデータ: タイプに関連付けられているメタデータ バケットごとに色分けされたバッジを表示します。タグ メタデータ バケットは、バッジ内の特定のアイコンを使用してレコード メタデータ バケットと区別されます。
- 変換: タイプに関連付けられている変換タイプごとにバッジを表示します。
- 有効: タイプが有効な場合は
true値、 有効でない場合はfalse値が表示されます。タイプはいつでも有効または無効にできます。 - 有効: タイプの作成には時間がかかります。
タイプがプロビジョニングされている間、有効ステータスは
falseです。準備が整うと、trueと表示されます。
新しいタイプを作成すると、すべてのデータシンクのタグとレコードを保存するための独自のインフラストラクチャがプロビジョニングされます。たとえば、新しいタイプを作成すると、BigQuery に新しいテーブルが作成され、そのアーキタイプに対応するスキーマが自動的に入力されます。タイプがプロビジョニングされている間は、Non Active と表示されます。
新しい**タイプ**を作成するには、[**新しいタイプを追加**]をクリックします。次のフォームが表示されます。
新しいタイプ を定義するには、名前とアーキタイプを指定します。タイプを作成した後は、名前とアーキタイプを変更できません。すべてのタイプに異なる一意の名前を付ける必要があります。アーキタイプは、使用可能なアーキタイプ リストから選択する必要があります。既存のアーキタイプはシステム構成の一部であるため、作成または変更することはできません。
[データスキーマ] セクションを開き、必要に応じて、新しいタイプのデータフィールドを定義する
JSON schemaを定義します。
データスキーマ は有効な
JSON Schemaである必要があります。そうでない場合は受け入れられません。このデータスキーマは、取り込みパイプラインの一部として適用されません。今後の MDE バージョンでは、受信メッセージのデータ オブジェクトが、そのタイプのデータスキーマに対して検証されます。データスキーマを使用すると、さまざまなデータシンクで使用可能なデータフィールドの構造を確認できます。各データスキーマの仕様は、アーキタイプの特性に従って定義する必要があります。[メタデータ バケット] セクションを開いて、タイプに関連付けられているメタデータ バケットを定義し、新しいタイプの定義を完了します。
タイプにメタデータ バケット を追加するには、[追加] をクリックします。
追加する使用可能なメタデータ バケット のリストから選択します。これらのバケットの最新バージョンのみが表示されます。メタデータ バケットのバージョンは、タイプの新しいバージョンを作成することで後で更新できます。バケットを追加すると、[メタデータ] セクションに新しいバッジが表示されます。
フォームの [ストレージ設定] セクションを開いて、デフォルトのストレージ設定 を定義します。このセクションには、この MDE インスタンスで使用可能なデータシンクごとに切り替えボタンがあります。
このタイプに属するタグがデフォルトで保存されるシンクを選択します。ストレージ仕様は、タグの作成時にタグに継承されます。ストレージ仕様は、タグレベルでいつでも変更できます。
新しいタイプ の定義を完了するには、[変換と接続] セクションを開いて、このタイプに関連付ける変換を選択します。
タイプに関連付ける変換 を選択し、 変換を構成する方法に沿って パラメータを定義します。
すべてのパラメータを追加したら、[作成] をクリックして新しいタイプ を保存します。パラメータが正しくない場合は、エラー メッセージが表示されます。操作が成功すると、確認メッセージが表示されます。