client Modül

Sınıflar

DataverseClient

Microsoft Dataverse işlemleri için üst düzey istemci.

Bu istemci, Web API'si aracılığıyla Dataverse ortamlarıyla etkileşime geçmek için basit ve kararlı bir arabirim sağlar. kimlik doğrulamasını Azure Identity aracılığıyla işler ve HTTP işlemlerini bir iç OData istemcisine devreder.

Önemli özellikler:

  • OData CRUD işlemleri: kayıtları oluşturma, okuma, güncelleştirme, silme

  • SQL sorguları: Web API ?sql parametresi aracılığıyla salt okunur SQL yürütme

  • Tablo meta verileri: özel tablolar oluşturma, inceleme ve silme; sütun oluşturma ve silme

  • Dosya yüklemeleri: Öbekleme desteğiyle dosyaları dosya sütunlarına yükleme

Uyarı

İstemci, iç OData istemcisini ilk kullanımda gevşek bir şekilde başlatır ve anında ağ çağrıları olmadan basit bir yapıya olanak tanır.

Uyarı

Dataverse Web API'siyle iletişim kuran tüm yöntemler

HttpError başarılı olmayan bir

HTTP yanıtları (örn. 401, 403, 404, 429, 500). Tek tek yöntem

docstrings yalnızca etki alanına özgü özel durumları belgeler.

İşlemler ad alanları halinde düzenlenir:

  • client.records – kayıtları oluşturma, güncelleştirme, silme ve alma (tek veya sayfalandırılmış sorgular)

  • client.query – sorgu ve arama işlemleri

  • client.tables – tablo ve sütun meta veri yönetimi

  • client.files – dosya yükleme işlemleri

  • client.dataframe – kayıt CRUD için pandas DataFrame sarmalayıcıları

  • client.batch – birden çok işlemi tek bir HTTP isteğinde toplu işleyin

v0 beta yöntemleri (client.create, client.query_sqlvb.) 1.0 GA'da kaldırıldı. Bir çağrısı artık GA değişimini ve codemod komutunu adlandıran bir iletiyle tetikleniyor AttributeError . Daha önce bu çağrılar geçiş ipucu olmadan bir boşluk AttributeError oluşturmuştu, bu nedenle yarı geçirilen kodun hata ayıklaması zor oldu. Bkz. _REMOVED_BETA_METHODS.

İstemci, otomatik kaynak temizleme ve HTTP bağlantı havuzu için Python bağlam yöneticisi protokolünü destekler: