FetchXmlQuery Sınıf

Inert FetchXML sorgu nesnesi. Çağrılana kadar veya execute_pages çağrılana kadar execute HTTP isteği yapılmaz.

aracılığıyla client.query.fetchxml(xml)elde edilir.

Oluşturucu

FetchXmlQuery(xml: str, entity_name: str, client: DataverseClient)

Parametreler

Name	Description
xml Gerekli	Soyulmuş, iyi biçimlendirilmiş FetchXML dizesi.
entity_name Gerekli	öğesinden `<entity>` varlık şeması adı.
client Gerekli	Üst öğesi DataverseClient.

Yöntemler

execute

FetchXML sorgusunu yürütür ve tüm sonuçları olarak QueryResultdöndürür.

Engelleme — tüm sayfaları önceden getirir ve geri dönmeden önce bellekteki tüm kayıtları tutar. Küçük-orta sonuç kümeleri için basit; sonuç kümesi büyük olabileceğinde veya kayıtları geldikçe işlemek istediğinizde kullanın execute_pages .

Example:


   rows = client.query.fetchxml(xml).execute()
   df = rows.to_dataframe()

execute_pages

HTTP sayfası başına bir verim QueryResult elde edin.

Akış: Her yineleme bir HTTP isteği tetikler ve bir sayfa verir. Tercih et execute :

Sonuç kümesi büyük olabilir ve tüm kayıtların aynı anda bellekte olmasını istemezsiniz.
Erken çıkış istiyorsunuz: ihtiyacınız olanı bulduğunuzda yinelemeyi durdurun ve kalan HTTP gidiş dönüşleri otomatik olarak atlanır.
Sayfa başına ilerleme durumu raporlaması veya toplu aşağı akış yazma işlemlerine ihtiyacınız vardır.

Tek seferlik— birden çok kez yinelemeyin.

Example:


   for page in client.query.fetchxml(xml).execute_pages():
       process(page.to_dataframe())

execute

FetchXML sorgusunu yürütür ve tüm sonuçları olarak QueryResultdöndürür.

Example:


   rows = client.query.fetchxml(xml).execute()
   df = rows.to_dataframe()

execute() -> QueryResult

Döndürülenler

Tür	Description
QueryResult	Tüm sayfalardaki tüm eşleşen kayıtlar.

execute_pages

HTTP sayfası başına bir verim QueryResult elde edin.

Akış: Her yineleme bir HTTP isteği tetikler ve bir sayfa verir. Tercih et execute :

Sonuç kümesi büyük olabilir ve tüm kayıtların aynı anda bellekte olmasını istemezsiniz.
Erken çıkış istiyorsunuz: ihtiyacınız olanı bulduğunuzda yinelemeyi durdurun ve kalan HTTP gidiş dönüşleri otomatik olarak atlanır.
Sayfa başına ilerleme durumu raporlaması veya toplu aşağı akış yazma işlemlerine ihtiyacınız vardır.

Tek seferlik— birden çok kez yinelemeyin.

Example:


   for page in client.query.fetchxml(xml).execute_pages():
       process(page.to_dataframe())

execute_pages() -> Iterator[QueryResult]

Döndürülenler

Tür	Description
Iterator[QueryResult]	Sayfa QueryResult başına nesnelerin yineleyicisi.