|
Cliente de alto nivel para operaciones de Microsoft Dataverse.
Este cliente proporciona una interfaz sencilla y estable para interactuar con entornos de Dataverse a través de la API web. Controla la autenticación a través de Azure Identidad y delega las operaciones HTTP en un cliente OData interno.
Funciones clave:
Operaciones CRUD de OData: crear, leer, actualizar, eliminar registros
Consultas SQL: ejecución de SQL de solo lectura mediante el parámetro de API ?sql web
Metadatos de tabla: crear, inspeccionar y eliminar tablas personalizadas; crear y eliminar columnas
Cargas de archivos: carga de archivos en columnas de archivos con compatibilidad con fragmentación
Nota:
El cliente inicializa su cliente OData interno en primer uso, lo que permite la construcción ligera sin llamadas de red inmediatas.
Nota:
Todos los métodos que se comunican con la API web de Dataverse pueden generar
HttpError en caso de que no se realice correctamente
Respuestas HTTP (por ejemplo, 401, 403, 404, 429, 500). Método individual
docstrings solo documenta excepciones específicas del dominio.
Las operaciones se organizan en espacios de nombres:
client.records : crear, actualizar, eliminar y obtener registros (consultas únicas o paginadas)
client.query – Operaciones de consulta y búsqueda
client.tables : administración de metadatos de tablas y columnas
client.files : operaciones de carga de archivos
client.dataframe – contenedores de DataFrame pandas para cruD de registro
client.batch : procesamiento por lotes de varias operaciones en una sola solicitud HTTP
Los métodos beta v0 (client.create, client.query_sql, etc.) se quitaron en la versión 1.0 de disponibilidad general. La llamada a una genera ahora AttributeError con un mensaje que denomina el reemplazo de disponibilidad general y el comando codemod: anteriormente, estas llamadas generaron una sugerencia de migración sin AttributeError sugerencia de migración, por lo que la depuración del código migrado medio fue dolorosa. Consulte _REMOVED_BETA_METHODS.
El cliente admite el protocolo del administrador de contextos de Python para la limpieza automática de recursos y la agrupación de conexiones HTTP:
|