query_builder Modül

OData sorguları oluşturmak için akıcı sorgu oluşturucusu.

Yöntem zincirleme ile Dataverse tablolarında karmaşık sorgular oluşturmak için tür açısından güvenli, bulunabilir bir arabirim sağlar.

Örnek::

# Via client (recommended) -- flat iteration over records
from PowerPlatform.Dataverse.models import col


for record in (client.query.builder("account")
               .select("name", "revenue")
               .where(col("statecode") == 0)
               .where(col("revenue") > 1_000_000)
               .order_by("revenue", descending=True)
               .top(100)
               .execute()):
    print(record["name"])


# With composable expression tree
from PowerPlatform.Dataverse.models import col, raw


for record in (client.query.builder("account")
               .select("name", "revenue")
               .where((col("statecode") == 0) | (col("statecode") == 1))
               .where(col("revenue") > 100000)
               .top(100)
               .execute()):
    print(record["name"])


# Lazy paged iteration (one QueryResult per HTTP page)
for page in (client.query.builder("account")
             .select("name")
             .execute_pages()):
    process_batch(page)


# Get results as a pandas DataFrame
df = (client.query.builder("account")
      .select("name", "telephone1")
      .where(col("statecode") == 0)
      .top(100)
      .execute()
      .to_dataframe())

Sınıflar

ExpandOption

Gezinti $expand özelliği için yapılandırılmış seçenekler.

OData $expand söz dizimini izleyerek tek bir gezinti özelliği genişletmesi için iç içe $select$filter, , $orderbyve $top seçeneklerinin belirtilmesine izin verir.

Example:


   # Expand Account_Tasks with nested options
   opt = (ExpandOption("Account_Tasks")
          .select("subject", "createdon")
          .filter("contains(subject,'Task')")
          .order_by("createdon", descending=True)
          .top(5))

   query = (client.query.builder("account")
            .select("name")
            .expand(opt)
            .execute())

QueryBuilder

Eşitleme istemcisinde OData sorguları oluşturmak ve yürütmek için akıcı arabirim.

Birleştirilebilir filtre ifadeleriyle karmaşık sorgular oluşturmak için yöntem zinciri sağlar. Tek başına kullanılabilir (aracılığıyla build()) veya bir istemciye bağlanabilir (aracılığıyla execute).

QueryParams

tarafından QueryBuilder.build()döndürülen yazılan sözlük.

Derleme sonuçları client.records.list() el ile geçirildiğinde IDE otomatik tamamlama sağlar.