Aracılığıyla paylaş

link-entity öğesi

Sonuçla birlikte ek sütunlar döndürmek için varlık veya bağlantı varlığıyla ilgili bir tabloyu birleştirir. ayrıca, ilgili tablolardaki sütun değerlerine koşul uygulamak için filtre öğeleriyle birlikte kullanılır.

FetchXml kullanarak tabloları birleştirmeyi öğrenin.

Örnekler

Aşağıdaki örneklerde farklı ilişki türleriyle kullanımı link-entity gösterilmektedir.

Çoka bir ilişkisi

Bu sorgu, hesap kaydındaki PrimaryContactId arama sütununu temel alarak hesap ve kişi tablolarından veri döndürür:

<fetch>
  <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>

Bire çok ilişkisi

Bu sorgu, Kişi account_primary_contact bire çok ilişkisine göre kişi ve hesap tablolarından veri döndürür.

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

Çoka çok ilişkisi

Bu sorgu, teammembership_association çoka çok ilişkisini kullanarak SystemUser ve Team tablolarından veri döndürür.

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

Attributes

İsim Gerekli mi? Description
name Yes İlgili tablonun mantıksal adı.
to Hayı Özniteliğinde belirtilen ilişkili tablo sütunuyla eşleşecek üst öğedeki sütunun from mantıksal adı. Teknik olarak gerekli olmasa da, bu öznitelik genellikle kullanılır.
from Hayı özniteliğinde belirtilen sütunla eşleşen ilişkili tablodan sütunun to mantıksal adı. Teknik olarak gerekli olmasa da, bu öznitelik genellikle kullanılır.
alias Hayı İlgili tablonun adını temsil eder. Diğer ad ayarlamazsanız, tüm sütunların benzersiz adlara sahip olduğundan emin olmak için sizin için bir diğer ad oluşturulur, ancak getirme XML'sinin diğer bölümlerindeki bağlantı varlığına başvurmak için bu diğer adı kullanamazsınız. Otomatik olarak oluşturulan diğer adlar, 1'den başlayarak getirme XML'sindeki bağlantı varlığının sıralı numarası olan N desenini {LogicalName}+{N}kullanır.
link-type Hayı Bağlantı kullanımı türü. Varsayılan davranış iç davranıştır. Bağlantı türü seçenekleri hakkında bilgi edinin
intersect Hayı link-entity genellikle çoka çok ilişkisi için tabloları birleştirmek ve herhangi bir sütun döndürmemek için kullanıldığını gösterir. Bu özniteliğin varlığı sorgu yürütmeyi değiştirmez. Bir tabloya katılırken bu özniteliğinize link-entity ekleyebilirsiniz, ancak bunun kasıtlı olduğunu göstermek için herhangi bir öznitelik öğesi eklemeyebilirsiniz.

ve to özniteliklerini kullanma from

Hem hem to de from öznitelikleri için değerleri ayarlamak en iyisidir. Bu özniteliklerin her ikisi de genellikle eşleşecek sütunları açıkça tanımlamak için kullanılır. Ancak ve fromto öznitelikleri teknik olarak gerekli değildir.

Uyarı

Bu özniteliklerden birini kullanmazsanız ve iki tablo arasında çoka çok sistem ilişkisi varsa, Dataverse bu ilişkiyi kullanarak uygun anahtar değerlerini seçer.

veya to özniteliklerinden from yalnızca birini belirtirseniz, Dataverse iki tablo arasındaki ilişki şeması tanımlarını kullanarak doğru ilişkiyi bulmaya çalışır.

Aksi takdirde aşağıdaki hatayı alırsınız:

Kod: 0x80041102
İleti: No system many-to-many relationship exists between <table A> and <table B>. If attempting to link through a custom many-to-many relationship ensure that you provide the from and to attributes.

Örneğin, bu sorguların her ikisi de systemuser ile takım tabloları arasındaki çoka çok ilişkisi teammembership_association kullanır. Bu durumda Dataverse, ve to özniteliklerini ve link-entity kesişen tabloyu belirten öznitelikleri üzerinde çalışabilirfrom.

Tüm öznitelikleri belirtme

<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>

Dataverse'in seçmesine izin ver

<fetch top="2">
<entity name="systemuser">
<attribute name="fullname" />
<link-entity name="team" alias="team">
<attribute name="name" />
</link-entity>
</entity>
</fetch>

Döndürülen kayıtlara filtre uygulamak için kullanın link-type . Aşağıdaki tabloda geçerli link-type değerler açıklanmaktadır:

İsim Description
inner Default. Sonuçları her iki tabloda da eşleşen değerlere sahip satırlarla kısıtlar.
outer Eşleşen değere sahip olmayan üst öğenin sonuçlarını içerir.
any Bunu bir filtre öğesi içinde kullanın. Sonuçları, bağlantılı varlıkta eşleşen satırlarla üst satırlarla kısıtlar. İlgili tablolardaki değerleri filtrelemek için kullanmayı any öğrenin
not any Bunu bir filtre öğesi içinde kullanın. Sonuçları, bağlı varlıkta eşleşen satır içermeyen üst satırlarla kısıtlar. İlgili tablolardaki değerleri filtrelemek için kullanmayı not any öğrenin
all Bunu bir filtre öğesi içinde kullanın. Sonuçları, bağlantı varlığında eşleşen from sütun değerine sahip satırların bulunduğu ancak bu eşleşen satırlardan hiçbirinin bu bağlantı varlığı için tanımlanan ek filtreleri karşılamadığı üst satırlarla kısıtlar. Eşleşen her bağlantı varlık satırının bazı ek ölçütleri karşıladığı üst satırları bulmak için ek filtreleri ters çevirmeniz gerekir. İlgili tablolardaki değerleri filtrelemek için kullanmayı all öğrenin
not all Bunu bir filtre öğesi içinde kullanın. Sonuçları, bağlantılı varlıkta eşleşen satırlarla üst satırlarla kısıtlar. Bu bağlantı türü, ada rağmen ile any eşdeğerdir. İlgili tablolardaki değerleri filtrelemek için kullanmayı not all öğrenin
exists Bunun bir inner çeşidi performans avantajları sağlayabilir. Yan tümcesinde whereEXISTS koşulu kullanır. Sonuçlarda üst satırın birden çok kopyası gerekli olmadığında bunu kullanın. Mevcut ve içindekiler hakkında daha fazla bilgi edinin
in Bunun bir inner çeşidi performans avantajları sağlayabilir. Yan tümcesinde where bir IN koşulu kullanır. Sonuçlarda üst satırın birden çok kopyası gerekli olmadığında bunu kullanın. Mevcut ve içindekiler hakkında daha fazla bilgi edinin
matchfirstrowusingcrossapply Bunun bir inner çeşidi performans avantajları sağlayabilir. Bağlantılı varlıktan eşleşen satırın yalnızca tek bir örneği yeterli olduğunda ve sonuçlardaki üst satırın birden çok kopyası gerekli olmadığında bu türü kullanın. matchfirstrowusingcrossapply hakkında daha fazla bilgi edinin

Üst öğeler

İsim Description
varlık Sorgu için 'üst varlık' olan bir fetch öğesinin alt öğesini belirtir. Yalnızca bir varlığa izin verilir.
bağlantı varlığı Sonuçla birlikte daha fazla sütun döndürmek için varlık veya link-entity ile ilgili bir tabloyu birleştirir.

Alt öğeler

İsim Oluşum Description
all-attributes 0 veya 1 Her satır için null olmayan tüm sütun değerlerinin döndürüldüğünü gösterir. Hiçbir öznitelik öğesi eklememeyle aynıdır. Çoğu durumda bu öğenin kullanılmasını önermiyoruz.
Öznitelik 0 veya çok Sorguyla döndürülecek bir varlıktan veya bağlantı varlığından bir sütun belirtir.
sipariş 0 veya çok Sonuçların satırları için bir sıralama düzeni belirtir.
bağlantı varlığı 0 veya çok Sonuçla birlikte daha fazla sütun döndürmek için varlık veya link-entity ile ilgili bir tabloyu birleştirir.
filtre 0 veya 1 Bir varlığın veya bağlantı varlığının sorguya uygulanacağı karmaşık koşulları belirtin.
  • Last updated on