Salesforceのカスタムメタデータとは？その機能と活用方法を解説

技術コラム 2025/02/14

Takeru Furuta

Salesforceのカスタムメタデータとは？
その機能と活用方法を解説

Takeru Furuta

Salesforceを触り始めたばかりの方にとって、「メタデータ」という言葉は少し難しく感じるかもしれません。

本記事では、「メタデータ」とは何か、さらにSalesforceの「カスタムメタデータ」の特徴や使い方を初心者の方にもわかりやすく解説します。

図を交えながら、具体例も挙げて説明していきますので、ぜひ参考にしてください！

そもそもメタデータとは？

メタデータとは、「データについてのデータ」のことです。

簡単に言うと、ファイルや情報そのものではなく、それらを説明する付加情報を指します。

例：

Salesforceでは、環境の構築やカスタマイズを行う際、メタデータが重要な役割を果たします。

たとえば、以下のような設定情報はすべてメタデータに該当します。

例：

カスタムメタデータは、簡単に言うと設定内で保持できる小さなカスタムオブジェクトです。

通常のカスタムオブジェクトと同じように項目やレコードを作成する事が可能で、以下のような利点があります。

Sandbox⇒本番環境間での設定データの簡単な移行
- 通常作成したレコードは変更セットで移行する事はできませんが、
  カスタムメタデータで作成したレコードは移行する事が可能です。
Apexコードからの参照による自動処理の管理
- Apexコードを作成する際にカスタムメタデータを使用する事が可能となり、
  記述を短縮することでハードコーディングを避ける事ができます。
- Apexのカスタムメタデータはガバナ制限の対象外です。
  通常SOQLクエリの1トランザクションでの発行数は100回までという制限がありますが、
  カスタムメタデータはその数に含まれません。

例えば「地域のマスタ」や「部署のマスタ」など、頻繁には変更しないものの年に数回変更があるようなデータを保存や移行をするのに適しています。

カスタムメタデータ型の使用量は組織全体で 1,000 万文字までの制限があります。
- 1,000 万文字の制限に満たない場合でもカスタムメタデータ型は組織全体で 200 個までの制限があります。
- かつ1 つのカスタムメタデータ型に含めることができる項目数は 100 個までです。
ロングテキストエリア項目は 1,000 万文字の制限に含まれ、項目ごとに 255 文字としてカウントされます。
カスタムメタデータ型作成時および項目作成時での説明項目には 1,000 文字まで入力できます。
標準項目（表示ラベル、名前、名前空間など）は使用量の計算に含まれます。
説明と修飾された API 参照名は計算に含まれません。
メタデータリレーション項目は、参照先がカスタムメタデータ型の場合は 15 文字、
オブジェクトまたは項目の場合は10 文字としてカウントされます。
選択リストとチェックボックスは10 文字としてカウントされます。
Apex からカスタムメタデータを使用する場合、SOQL クエリ数に制限はありません。
フローで使用する場合、Apex ガバナ制限が適用されます。
ロングテキストエリア項目を含む SOQL クエリは、Apex ガバナ制限の対象となります。