|
Högnivåklient för Microsoft Dataverse-åtgärder.
Den här klienten tillhandahåller ett enkelt, stabilt gränssnitt för att interagera med Dataverse-miljöer via webb-API:et. Den hanterar autentisering via Azure identitet och delegerar HTTP-åtgärder till en intern OData-klient.
Viktiga funktioner:
OData CRUD-åtgärder: skapa, läsa, uppdatera, ta bort poster
SQL-frågor: köra skrivskyddad SQL via webb-API-parameter ?sql
Tabellmetadata: skapa, inspektera och ta bort anpassade tabeller; skapa och ta bort kolumner
Filuppladdningar: Ladda upp filer till filkolumner med stöd för segmentering
Anmärkning
Klienten initierar lazily sin interna OData-klient vid första användning, vilket möjliggör enkel konstruktion utan omedelbara nätverksanrop.
Anmärkning
Alla metoder som kommunicerar med Dataverse Web API kan generera
HttpError på icke-lyckad
HTTP-svar (t.ex. 401, 403, 404, 429, 500). Enskild metod
docstrings dokumenterar endast domänspecifika undantag.
Åtgärder organiseras i namnområden:
client.records – skapa, uppdatera, ta bort och hämta poster (enkla eller sidnumrerade frågor)
client.query – fråge- och sökåtgärder
client.tables – hantering av tabell- och kolumnmetadata
client.files – filuppladdningsåtgärder
client.dataframe – Pandas DataFrame-omslutning för crud-post
client.batch – batcha flera åtgärder i en enda HTTP-begäran
v0 betametoder (client.create, client.query_sqlosv.) togs bort i 1,0 GA. Att anropa en genererar AttributeError nu med ett meddelande som namnger GA-ersättningen och codemod-kommandot – tidigare utlöste dessa anrop en bare AttributeError utan migreringstips, så det var smärtsamt att felsöka halvmigrerad kod. Se _REMOVED_BETA_METHODS.
Klienten stöder Python context manager-protokoll för automatisk resursrensning och HTTP-anslutningspooler:
|