FetchXML を使用しテーブルを結合する

FetchXml を使用したデータのクエリで説明したように、クエリを開始するには、エンティティ要素を使用してテーブルを選択します。

リンク エンティティ要素を使用して、クエリで返す関連テーブルのデータを以下の属性で記述します:

たとえば、次のクエリは、account レコードの PrimaryContactId ルックアップ列に基づいて、accountテーブルとcontactテーブルから最大5レコードを返します：

<fetch top='5'>
   <entity name='account'>
      <attribute name='name' />
      <link-entity name='contact'
         from='contactid'
         to='primarycontactid'
         link-type='inner'
         alias='contact'>
         <attribute name='fullname' />
      </link-entity>
   </entity>
</fetch>

結果はこのようになります:

 -----------------------------------------------------------------
 | name                             | contact.fullname           |
 -----------------------------------------------------------------
 | Litware, Inc. (sample)           | Susanna Stubberod (sample) |
 -----------------------------------------------------------------
 | Adventure Works (sample)         | Nancy Anderson (sample)    |
 -----------------------------------------------------------------
 | Fabrikam, Inc. (sample)          | Maria Campbell (sample)    |
 -----------------------------------------------------------------
 | Blue Yonder Airlines (sample)    | Sidney Higa (sample)       |
 -----------------------------------------------------------------
 | City Power & Light (sample)      | Scott Konersmann (sample)  |
 -----------------------------------------------------------------

制限

クエリには最大 15 の link-entity 要素を追加できます。 各リンク エンティティはクエリに JOIN を追加し、クエリの実行時間を増加させます。 この制限はパフォーマンスを保護するためのものです。 クエリに 15 個以上のリンク エンティティ要素を追加すると、このエラーが発生します。

コード: 0x8004430D
番号: -2147204339
メッセージ: Number of link entities in query exceeded maximum limit.

子要素

link-entity 要素内では、親要素と同様に子要素を次のように追加できます:

• 関連テーブルから 列を選択 する
• 関連テーブルからの行をフィルターする
• 別の関連テーブルに結合する

多対一関連付け

前の例は、多くの取引先レコードが 1 つの取引先責任者レコードを参照できる多対 1 の関係です。 この情報は、account_primary_contact という一対一のリレーションシップ で定義されます:

リレーションシップ情報の取得

XrmToolBox の FetchXML Builder を使用すると、このツールでリレーションシップを選択して適切な name、from、to 属性値を設定できることがわかります。

また、他のツールやAPIを使用してリレーションシップ データを検索し、使用する適切な name、from、to 属性値を調べることもできます。 このデータを取得する方法を確認する。

• ご利用の環境でテーブル定義を参照する
• クエリ スキーマ定義

一対多関連付け

多対 1 と 1 対多の リレーションシップ は、コインの表裏のようなものです。 リレーションシップはテーブル間に存在するため、その使用方法は、どのテーブルがクエリのベース テーブルであるかによって異なります。

連絡先テーブルの側からの場合を除き、同じリレーションシップを使用して、前の例と同じデータを連絡先テーブルから取得できます。 同じ Contact account_primary_contact の 1 対多リレーションシップのデータを使用しますが、リレーションシップの異なるビュー用に値を調整します。

<fetch top='5'>
   <entity name='contact'>
      <attribute name='fullname' />
      <link-entity name='account'
         from='primarycontactid'
         to='contactid'
         alias='account'>
         <attribute name='name' />
      </link-entity>
   </entity>
</fetch>

次の表に、この例でのリンク エンティティの属性値を示します:

結果には、親エンティティ が account ではなく contact となっている点を除き、多対一のリレーションシップを使用した前のクエリと同じレコードとデータが含まれます。

 -----------------------------------------------------------------
 | fullname                   | account.name                     |
 -----------------------------------------------------------------
 | Susanna Stubberod (sample) | Litware, Inc. (sample)           |
 -----------------------------------------------------------------
 | Nancy Anderson (sample)    | Adventure Works (sample)         |
 -----------------------------------------------------------------
 | Maria Campbell (sample)    | Fabrikam, Inc. (sample)          |
 -----------------------------------------------------------------
 | Sidney Higa (sample)       | Blue Yonder Airlines (sample)    |
 -----------------------------------------------------------------
 | Scott Konersmann (sample)  | City Power & Light (sample)      |
 -----------------------------------------------------------------

多対多関連付け

多対多のリレーションシップは、交差テーブルに依存します。 通常、交差テーブルには 4 つの列しかありませんが、重要なのはそのうちの 2 つだけです。 2 つの重要な列は、参加しているテーブルの主キー列と一致します。

たとえば、TeamMembership交差 テーブルは、SystemUser テーブルと Team テーブル間の teammembership_association 多対多のリレーションシップをサポートしています。 これにより、ユーザーが複数のチームに参加したり、チームに複数のユーザーが所属したりすることができます。 TeamMembership にはこれらの列があります: systemuserid、teamid.

teammembership_association の多対多のリレーションシップを使用して、ユーザーとそのユーザーが所属するチームに関する情報を取得したい場合は、この fetchXML クエリを使用できます:

<fetch top='2'>
   <entity name='systemuser'>
      <attribute name='fullname' />
      <link-entity name='teammembership'
         from='systemuserid'
         to='systemuserid'
         intersect='true' >
         <link-entity name='team'
            from='teamid'
            to='teamid'
            link-type='inner'
            alias='team'>
            <attribute name='name' />
         </link-entity>
      </link-entity>
   </entity>
</fetch>

入れ子になったリンク エンティティが 2 つあります。

• 最初のものは、systemuser と teammembership が交差するテーブル systemuserid = systemuserid をつないでいます。
• 2つ目は、teammembership が teamid = teamid のチームと交差するテーブルをつないでいます。

結果は次のようになります:

 --------------------------------------
 | fullname             | team.name   |
 --------------------------------------
 | FirstName LastName   | org26ed931d |
 --------------------------------------
 | # PpdfCDSClient      | org26ed931d |
 --------------------------------------

リレーションシップがない

定義されたリレーションシップの一部ではない列を使用して from 属性と to 属性を指定できます。

たとえば、このクエリは、アカウントレコードの Name 列が、連絡先 レコードの FullName 列 と一致するレコードのペアを、それらがルックアップ列のいずれかで互いに参照し合っているかどうかに関係なく見つけます。

<fetch>
   <entity name='account'>
     <attribute name='name' />
     <link-entity name='contact'
       from='fullname'
       to='name'
       link-type='inner'
       alias='contact'>
       <attribute name='fullname' />
     </link-entity>
   </entity>
 </fetch>

次の 列タイプ は from 属性と to 属性では使用できません:

• ファイル
• Image
• MultiSelect フィールド
• PartyList

一部の列は from 属性と to 属性で使用できますが、パフォーマンスが低下する可能性があります:

• 複数行テキスト タイプの列
• 最大長 850 を超える 1 行テキストタイプ の列
• 数式 列
• 計算列
• 論理列

セットにないレコードを検索する

FetchXml を使用して、左外部結合 を使用してセットに含まれていないレコードを返すクエリを作成できます。 左外部結合では、2 番め入力で最初の入力の結合を満たす各列を返します。 また、2 番目入力で一致する列がない最初の入力列を返します。 2 番目の一致しない列が null 値として返されます。

条件要素として entityname 属性を使用して、FetchXML の左外部結合を実行できます。 entityname 属性は、条件、フィルターおよび入れ子フィルターで有効です。 リンク エンティティのフィルターの詳細。

たとえば、次のクエリは、取引先担当者のいないアカウント レコードをすべて返します。

<fetch>
   <entity name='account'>
      <attribute name='name' />
      <order attribute='name' />
      <link-entity name='contact'
         from='parentcustomerid'
         to='accountid'
         link-type='outer'
         alias='contact' />
      <filter type='and'>
         <condition entityname='contact'
            attribute='parentcustomerid'
            operator='null' />
      </filter>
   </entity>
</fetch>

高度なリンク タイプを使用する

次のリンク エンティティ タイプは、T-SQL JOIN 演算子 タイプに直接対応せず、代わりに サブクエリ を使用します。 これらのタイプは、クエリのパフォーマンスを向上させ、より複雑なクエリを定義するために使用できる、より高度な機能を提供します。

exists または in リンク タイプの使用

exists と in は inner の変形で、where 節で異なる条件 (それぞれ EXISTS と IN) を使用し、親行の複数のコピーを結果に返さないようにしたものです。 これらのタイプはどちらも、リンク エンティティ行の列値を返しません。

exists

これらの FetchXml と SQL の例は、exists で適用されるパターンを示しています。

<fetch>
   <entity name='contact'>
      <attribute name='fullname' />
      <link-entity name='account'
         from='primarycontactid'
         to='contactid'
         link-type='exists'>
         <filter type='and'>
            <condition attribute='statecode'
               operator='eq'
               value='1' />
         </filter>
      </link-entity>
   </entity>
</fetch>

select 
    "contact0".fullname as "fullname" 
from Contact as "contact0" 
where exists (
    select "account1".primarycontactid
    from Account as "account1"
    where "account1".statecode = 1
        and "contact0".contactid = "account1".primarycontactid)

in

これらの FetchXml と SQL の例は、in で適用されるパターンを示しています。

<fetch>
   <entity name='contact'>
      <attribute name='fullname' />
      <link-entity name='account'
         from='primarycontactid'
         to='contactid'
         link-type='in'>
         <filter type='and'>
            <condition attribute='statecode'
               operator='eq'
               value='1' />
         </filter>
      </link-entity>
   </entity>
</fetch>

select 
    "contact0".fullname as "fullname" 
from Contact as "contact0" 
where "contact0".contactid in (
    select "account1".primarycontactid
    from Account as "account1"
    where "account1".statecode = 1)

exists または in リンク タイプを使用すると、特に、同じ親行に対して一致するリンク行が多数存在する場合や、同じ親に対して複数のリンク エンティティを使用する場合に、中間または最終的なクエリ結果のサイズを小さくすることができます。 exists または in リンク タイプを使用すると、各親行に対して異なるリンク エンティティからの行のすべての可能な並べ替えを含むデカルト積を返す必要がないため、inner タイプに比べてクエリのパフォーマンスを向上させることができます。

これらのリンク タイプでは、Dataverse 各親行に対して最初に一致するリンク エンティティ行のみを検索することもできます。これは、inner 結合のリンク エンティティで一致するすべての行を検索するよりも効率的です。

リンク タイプ matchfirstrowusingcrossapply を使用する

このリンク タイプは、このパターンに従った を使用するサブクエリを持つ CROSS APPLYtop 1 演算子を生成します:

<fetch>
   <entity name='contact'>
      <attribute name='fullname' />
      <link-entity name='account'
         from='primarycontactid'
         to='contactid'
         link-type='matchfirstrowusingcrossapply'>
         <attribute name='accountid' />
         <attribute name='name' />
      </link-entity>
   </entity>
</fetch>

select 
    "contact0".fullname as "fullname",
    "account1".accountid as "accountid",
    "account1".name as "name" 
from Contact as "contact0"
cross apply (
    select top 1
        "account1".accountid as "accountid",
        "account1".name as "name"
    from Account as "account1"
    where "contact0".contactid = "account1".primarycontactid
  ) "account1"

matchfirstrowusingcrossapply リンク型は、親行を最大 1 回しか返さない点を除けば、inner 型と同等です。 リンクされたエンティティ内に一致する行がある場合にのみ親行が返されますが、in 型や exists 型とは異なり、リンクされたエンティティ内の一致する行の 1 つから列値を返します。 これは、リンクされたエンティティの一致する行の例が 1 つだけで十分で、結果に親行の複数のコピーが必要ない場合に使用します。

関連するテーブルのプロパティ/属性名が一致しない

matchfirstrowusingcrossapply リンク タイプを使用するときは、関連するテーブル列の Web API または SDK Entity.Attributes コレクション Keys 値を使用して返されるプロパティの名前、他のタイプの結合とは異なります。 通常、これらは <tablealias>.<logicalname> 形式に従います。 ただし、matchfirstrowusingcrossapply リンクタイプ、スキーマ名 値はテーブル エイリアス プレフィックスなしで使用されます。

他のリンク タイプで前のクエリの例を使用すると、プロパティまたはキーが次の名前を持つことが期待できます。

• fullname
• contactid
• account1.accountid
• account1.name

しかし、matchfirstrowusingcrossapply リンク タイプのプロパティまたはキーには次の名前があります。

• fullname
• contactid
• AccountId
• Name

次の手順

列の注文方法について解説します。