|
Hoher Client für Microsoft Dataverse-Vorgänge.
Dieser Client bietet eine einfache, stabile Schnittstelle für die Interaktion mit Dataverse-Umgebungen über die Web-API. Sie verarbeitet die Authentifizierung über Azure Identität und delegiert HTTP-Vorgänge an einen internen OData-Client.
Hauptfunktionen:
OData CRUD-Vorgänge: Erstellen, Lesen, Aktualisieren, Löschen von Datensätzen
SQL-Abfragen: Ausführen von schreibgeschütztem SQL über den Web-API-Parameter ?sql
Tabellenmetadaten: Erstellen, Überprüfen und Löschen von benutzerdefinierten Tabellen; Erstellen und Löschen von Spalten
Dateiuploads: Hochladen von Dateien in Dateispalten mit Blockierungsunterstützung
Hinweis
Der Client initialisiert seinen internen OData-Client bei der ersten Verwendung lazily und ermöglicht eine einfache Konstruktion ohne sofortige Netzwerkaufrufe.
Hinweis
Alle Methoden, die mit der Dataverse-Web-API kommunizieren, können auslösen
HttpError bei nicht erfolgreicher Ausführung
HTTP-Antworten (z. B. 401, 403, 404, 429, 500). Individuelle Methode
Docstrings dokumentieren nur domänenspezifische Ausnahmen.
Vorgänge sind in Namespaces organisiert:
client.records – Erstellen, Aktualisieren, Löschen und Abrufen von Datensätzen (einzelne oder paginierte Abfragen)
client.query – Abfrage- und Suchvorgänge
client.tables – Verwaltung von Tabellen- und Spaltenmetadaten
client.files – Dateiuploadvorgänge
client.dataframe – Pandas DataFrame Wrapper für Datensatz CRUD
client.batch – Batch mehrerer Vorgänge in einer einzelnen HTTP-Anforderung
v0 Betamethoden (client.create, client.query_sqlusw.) wurden in 1.0 GA entfernt. Das Aufrufen eines wird jetzt mit einer Meldung ausgelöst AttributeError , die den GA-Ersatz und den Codemod-Befehl benennt – zuvor lösten diese Aufrufe einen bar AttributeError ohne Migrationshinweis aus, sodass das Debuggen von halb migriertem Code schmerzhaft war. Siehe _REMOVED_BETA_METHODS.
Der Client unterstützt das Kontext-Manager-Protokoll Python für die automatische Ressourcenbereinigung und http-Verbindungspooling:
|