英語で読む

次の方法で共有


Metadata

メタデータは、値に関連付けられている値に関する情報です。 メタデータは、メタデータ レコードと呼ばれるレコード値として表されます。 メタデータ レコードのフィールドは、値のメタデータを格納するために使用できます。 すべての値には、メタデータ レコードがあります。 メタデータ レコードの値が指定されていない場合は、メタデータ レコードは空になります (フィールドはありません)。 メタデータ レコードを値に関連付けることは、メタデータ レコードを明示的に検査する場合を除き、評価での値の動作を変更しません。

メタデータ レコード

メタデータ レコード値は、構文値メタ [レコード] を使用して値 x に関連付けられます。 たとえば、次の例では、Rating フィールドと Tags フィールドを含むメタデータ レコードが "Mozart" というテキスト値に関連付けられています。

"Mozart" meta [ Rating = 5,
Tags = {"Classical"} ]

Value.Metadata 関数を使用して、値のメタデータ レコードにアクセスできます。 次の例では、ComposerRating フィールドの式で Composer フィールドの値のメタデータ レコードにアクセスしてから、メタデータ レコードの Rating フィールドにアクセスします。

[  
    Composer = "Mozart" meta [ Rating = 5, Tags = {"Classical"} ],
    ComposerRating = Value.Metadata(Composer)[Rating]   // 5
]  

新しい値を構築する演算子または関数で値が使用されている場合、メタデータ レコードは保持されません。 たとえば、2 つのテキスト値が & 演算子を使用して連結されている場合、結果として得られるテキスト値のメタデータは空のレコード [] となります。

標準ライブラリ関数 Value.RemoveMetadata および Value.ReplaceMetadata を使用して、値からすべてのメタデータを削除したり、値のメタデータを置き換えたりすることができます。

制限事項

Power Query を使用してデータを変換または移動する一部のホストでは、ストレージへのカスタム メタデータの格納がサポートされていません。 次のホストでは、カスタム メタデータの格納はサポートされていません。

  • Power BI データフロー
  • ファブリック データフロー Gen2
  • Power Platform データフロー