client Modul

Osztályok

DataverseClient

Magas szintű ügyfél a Microsoft Dataverse-műveletekhez.

Ez az ügyfél egy egyszerű, stabil felületet biztosít a Dataverse-környezetek webes API-val való kezeléséhez. A hitelesítést Azure Identitáson keresztül kezeli, és HTTP-műveleteket delegál egy belső OData-ügyfélnek.

Főbb képességek:

  • OData CRUD-műveletek: rekordok létrehozása, olvasása, frissítése, törlése

  • SQL-lekérdezések: írásvédett SQL végrehajtása webes API-paraméteren ?sql keresztül

  • Tábla metaadatai: egyéni táblák létrehozása, vizsgálata és törlése; oszlopok létrehozása és törlése

  • Fájlfeltöltések: fájlok feltöltése fájloszlopokra adattömb-támogatással

Megjegyzés:

Az ügyfél lazán inicializálja a belső OData-ügyfelet az első használatkor, lehetővé téve a könnyű konstrukciót azonnali hálózati hívások nélkül.

Megjegyzés:

A Dataverse Web API-val kommunikáló összes metódus

HttpError nem sikeres

HTTP-válaszok (pl. 401, 403, 404, 429, 500). Egyéni módszer

A dokumentum csak tartományspecifikus kivételeket tartalmaz.

A műveletek névterekbe vannak rendezve:

  • client.records – rekordok létrehozása, frissítése, törlése és lekérése (egy- vagy többoldalas lekérdezések)

  • client.query – lekérdezési és keresési műveletek

  • client.tables – tábla- és oszlop metaadatok kezelése

  • client.files – fájlfeltöltési műveletek

  • client.dataframe – pandas DataFrame-burkolók a CRUD rekordhoz

  • client.batch – több művelet kötegelése egyetlen HTTP-kérelembe

A v0 bétametenek (client.createstb client.query_sql.) eltávolítása az 1.0 GA-ban megtörtént. Az egyik hívás most egy üzenettel jelenik AttributeError meg, amely a GA-csere és a kódmod parancs elnevezését tartalmazza – korábban ezek a hívások nem adták meg a migrálási tippet, ezért a félig migrált kód hibakeresése AttributeError fájdalmas volt. Lásd: _REMOVED_BETA_METHODS.

Az ügyfél támogatja Python környezetkezelő protokollját az automatikus erőforrás-törléshez és a HTTP-kapcsolatkészletezéshez: