|
Cliente de alto nível para operações do Microsoft Dataverse.
Esse cliente fornece uma interface simples e estável para interagir com ambientes do Dataverse por meio da API Web. Ele manipula a autenticação por meio de Azure Identity e delega operações HTTP a um cliente OData interno.
Principais capacidades:
Operações OData CRUD: criar, ler, atualizar, excluir registros
Consultas SQL: executar SQL somente leitura por meio do parâmetro da API ?sql Web
Metadados de tabela: criar, inspecionar e excluir tabelas personalizadas; criar e excluir colunas
Uploads de arquivo: carregar arquivos em colunas de arquivo com suporte de agrupamento
Observação
O cliente inicializa lentamente seu cliente OData interno no primeiro uso, permitindo a construção leve sem chamadas de rede imediatas.
Observação
Todos os métodos que se comunicam com a API Web do Dataverse podem gerar
HttpError em não-bem-sucedido
Respostas HTTP (por exemplo, 401, 403, 404, 429, 500). Método individual
Docstrings documenta apenas exceções específicas do domínio.
As operações são organizadas em namespaces:
client.records – criar, atualizar, excluir e obter registros (consultas simples ou paginadas)
client.query – operações de consulta e pesquisa
client.tables – gerenciamento de metadados de tabela e coluna
client.files – operações de upload de arquivo
client.dataframe – wrappers dataframe pandas para crud de registro
client.batch – envio em lote de várias operações em uma única solicitação HTTP
Os métodos beta v0 (client.createetc client.query_sql.) foram removidos em GA 1.0. Chamar um agora é gerado AttributeError com uma mensagem nomeando a substituição de GA e o comando codemod – anteriormente, essas chamadas geravam uma dica de migração sem AttributeError nenhuma dica de migração, portanto, a depuração do código de meia migração era dolorosa. Veja _REMOVED_BETA_METHODS.
O cliente dá suporte ao protocolo do gerenciador de contexto do Python para limpeza automática de recursos e pool de conexões HTTP:
|