query_builder Modul

Penyusun kueri yang fasih untuk membuat kueri OData.

Menyediakan antarmuka jenis yang aman dan dapat ditemukan untuk membangun kueri kompleks terhadap tabel Dataverse dengan penautan metode.

Contoh::

# 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())

Kelas

ExpandOption

Opsi terstruktur untuk $expand properti navigasi.

Memungkinkan menentukan opsi berlapis , , $orderby, dan $top untuk ekspansi properti navigasi tunggal, mengikuti sintaks OData$expand. $filter$select

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

Antarmuka yang fasih untuk membangun dan menjalankan kueri OData terhadap klien sinkronisasi.

Menyediakan penautan metode untuk membuat kueri kompleks dengan ekspresi filter yang dapat disusun. Dapat digunakan mandiri (melalui build()) atau terikat ke klien (melalui execute).

QueryParams

Kamus yang dititik dikembalikan oleh QueryBuilder.build().

Menyediakan pelengkapan otomatis IDE saat meneruskan hasil build ke client.records.list() secara manual.