QueryOperations Classe

Namespace para operações de consulta.

Acessado por .client.query Fornece operações de consulta e pesquisa em tabelas do Dataverse.

Exemplo:

   client = DataverseClient(base_url, credential)

   rows = client.query.sql("SELECT TOP 10 name FROM account ORDER BY name")
   for row in rows:
       print(row["name"])

Construtor

QueryOperations(client: DataverseClient)

Parâmetros

Nome	Description
client Obrigatório	DataverseClient A instância pai DataverseClient .

Métodos

sql	Execute uma consulta SQL somente leitura usando a API Web do Dataverse. A consulta SQL deve seguir o subconjunto com suporte: uma única instrução SELECT com WHERE opcional, TOP (literal inteiro), ORDER BY (somente nomes de coluna) e um alias de tabela simples após FROM.

sql

Execute uma consulta SQL somente leitura usando a API Web do Dataverse.

A consulta SQL deve seguir o subconjunto com suporte: uma única instrução SELECT com WHERE opcional, TOP (literal inteiro), ORDER BY (somente nomes de coluna) e um alias de tabela simples após FROM.

sql(sql: str) -> List[Dict[str, Any]]

Parâmetros

Nome	Description
sql Obrigatório	str Instrução SQL SELECT com suporte.

Retornos

Tipo	Description
list of dict	Lista de dicionários de linha de resultados. Retorna uma lista vazia quando nenhuma linha corresponde.

Exceções

Tipo	Description
ValidationError	Se sql não for uma cadeia de caracteres ou estiver vazia.

Exemplos

Consulta SQL básica:

   rows = client.query.sql(
       "SELECT TOP 10 accountid, name FROM account "
       "WHERE name LIKE 'C%' ORDER BY name"
   )
   for row in rows:
       print(row["name"])

Consulta com alias:

   rows = client.query.sql(
       "SELECT a.name, a.telephone1 FROM account AS a "
       "WHERE a.statecode = 0"
   )