client Modul

Kelas

DataverseClient

Klien tingkat tinggi untuk operasi Microsoft Dataverse.

Klien ini menyediakan antarmuka yang sederhana dan stabil untuk berinteraksi dengan lingkungan Dataverse melalui API Web. Ini menangani autentikasi melalui identitas Azure dan mendelegasikan operasi HTTP ke klien OData internal.

Kemampuan utama:

  • Operasi CRUD OData: membuat, membaca, memperbarui, menghapus rekaman

  • Kueri SQL: menjalankan SQL baca-saja melalui parameter API ?sql Web

  • Metadata tabel: membuat, memeriksa, dan menghapus tabel kustom; membuat dan menghapus kolom

  • Unggahan file: mengunggah file ke kolom file dengan dukungan potongan

Nota

Klien dengan malas menginisialisasi klien OData internalnya pada penggunaan pertama, memungkinkan konstruksi ringan tanpa panggilan jaringan segera.

Nota

Semua metode yang berkomunikasi dengan API Web Dataverse dapat dinaikkan

HttpError pada tidak berhasil

Respons HTTP (misalnya 401, 403, 404, 429, 500). Metode individual

dokumen dokumen hanya pengecualian khusus domain.

Operasi diatur ke dalam namespace:

  • client.records – membuat, memperbarui, menghapus, dan mendapatkan rekaman (kueri tunggal atau paginasi)

  • client.query – operasi kueri dan pencarian

  • client.tables – manajemen metadata tabel dan kolom

  • client.files – operasi pengunggah file

  • client.dataframe – pembungkus DataFrame pandas untuk rekam CRUD

  • client.batch – batch beberapa operasi ke dalam satu permintaan HTTP

Metode beta v0 (client.create, , client.query_sqldll.) dihapus dalam 1,0 GA. Memanggil seseorang sekarang muncul AttributeError dengan pesan yang menamai penggantian GA dan perintah codemod - sebelumnya panggilan ini memunculkan AttributeError tanpa petunjuk migrasi, jadi penelusuran kesalahan kode setengah dimigrasikan menyakitkan. Lihat _REMOVED_BETA_METHODS.

Klien mendukung protokol manajer konteks Python untuk pembersihan sumber daya otomatis dan pengumpulan koneksi HTTP: