|
Klient wysokiego poziomu dla operacji microsoft Dataverse.
Ten klient udostępnia prosty, stabilny interfejs do interakcji ze środowiskami Dataverse za pośrednictwem internetowego interfejsu API. Obsługuje uwierzytelnianie za pośrednictwem Azure Identity i deleguje operacje HTTP do wewnętrznego klienta OData.
Kluczowe możliwości:
Operacje OData CRUD: tworzenie, odczytywanie, aktualizowanie, usuwanie rekordów
Zapytania SQL: wykonywanie bazy danych SQL tylko do odczytu za pośrednictwem parametru internetowego interfejsu API ?sql
Metadane tabeli: tworzenie, inspekcja i usuwanie tabel niestandardowych; tworzenie i usuwanie kolumn
Przekazywanie plików: przekazywanie plików do kolumn plików z obsługą fragmentowania
Uwaga / Notatka
Klient leniwie inicjuje wewnętrznego klienta OData w pierwszym użyciu, co pozwala na uproszczoną konstrukcję bez natychmiastowych wywołań sieciowych.
Uwaga / Notatka
Wszystkie metody komunikujące się z internetowym interfejsem API usługi Dataverse mogą wywołać
HttpError w przypadku braku powodzenia
Odpowiedzi HTTP (np. 401, 403, 404, 429, 500). Metoda indywidualna
Dokument zawiera tylko wyjątki specyficzne dla domeny.
Operacje są zorganizowane w przestrzenie nazw:
client.records — tworzenie, aktualizowanie, usuwanie i pobieranie rekordów (zapytania pojedyncze lub podzielone na strony)
client.query — operacje zapytań i wyszukiwania
client.tables — zarządzanie metadanymi tabel i kolumn
client.files — operacje przekazywania plików
client.dataframe — otoki ramek danych biblioteki pandas dla rekordu CRUD
client.batch — wsadowe wiele operacji do pojedynczego żądania HTTP
Metody wersji 0 beta (client.create, client.query_sqlitp.) zostały usunięte w wersji 1.0 ogólnie dostępnej. Wywołanie jednego wywołuje AttributeError teraz z komunikatem nazewnictwa zamiany ga i polecenia codemod — wcześniej te wywołania wywołały goły AttributeError bez wskazówki migracji, więc debugowanie częściowo zmigrowanego kodu było bolesne. Zobacz _REMOVED_BETA_METHODS.
Klient obsługuje protokół menedżera kontekstu Python na potrzeby automatycznego czyszczenia zasobów i buforowania połączeń HTTP:
|