Autor: WMBrasil

Modificando seus resultados

Nas consultas que vimos até agora, todos os itens que correspondiam a certo padrão eram selecionados e mostrados nos resultados. Mas muitas vezes temos interesse em apenas alguns dos resultados, ou em certo aspecto deles. Nesta seção você vai aprender algumas palavras-chave e funções que o ajudarão a retirar o máximo possível de seus dados.

Até então, nossas consultas tinham apenas duas cláusulas. SELECT, onde declaramos as variáveis que serão mostradas nos resultados, e WHERE, onde estão os padrões que devem ser reconhecidos nos dados.

# Filmes Star Wars
SELECT ?item
WHERE
{
  ?item wdt:P179 wd:Q22092344.
}

Na próxima seção, você vai aprender a modificar os resultados de suas consultas. Isso pode ser feito adicionando palavras-chave e funções adicionais à cláusula SELECT, à WHERE, ou depois de WHERE. Na verdade, você já pode ter visto um exemplo disto neste tutorial – o modificador DISTINCT, que pode ser adicionado à SELECT, para remover duplicatas dos resultados.

COUNT

A função de agregação COUNT (“contar”, em português) pode ser usada para escrever consultas que respondam à pergunta: “Quantos itens correspondem a um certo padrão?”. Em tais casos, não estamos interessados em quais são os itens que correspondem ao padrão de nossa consulta, mas sim em quantos deles existem. 

Suponha que queremos saber quantos itens existem no Wikidata sobre mulheres que são químicas. Para isso, poderíamos usar a consulta a seguir:

Acima da tabela com os resultados, o WDQS mostra quantos itens foram encontrados, e quantos milissegundos foram necessários para rodar a consulta.

Mas essa estratégia nem sempre funciona. Suponha que queremos saber quantos itens existem no Wikidata sobre atrizes. A princípio, poderíamos apenas editar a consulta acima:

# Mulheres que são atrizes

SELECT ?item ?itemLabel
WHERE {
  ?item wdt:P31 wd:Q5.            # Item é uma instância de ser humano.
  ?item wdt:P21 wd:Q6581072.      # Item tem sexo / gênero feminino.
  ?item wdt:P106 wd:Q33999.      # Item tem ocupação: atriz.
   SERVICE wikibase:label { bd:serviceParam wikibase:language "[AUTO_LANGUAGE]". }
}

A princípio, o WDQS retornaria todos os itens que correspondem ao nosso padrão, e nos diria quantos deles existem. Entretanto, como o número de itens que correspondem ao padrão é muito grande, a consulta entrará em timeout (“tempo esgotado”, em português). Isso acontece porque há um tempo limite de 60 segundos para que uma consulta seja executada. Toda consulta que demore mais do que isso para rodar entrará em timeout.

Usaremos outra abordagem para saber quantas atrizes existem no Wikidata. Declaramos uma nova variável na cláusula SELECT, chamada ?contadorAtrizes. A variável será definida como o COUNT (a contagem) de itens cujo padrão corresponda àquele definido na cláusula WHERE.

Esta consulta tem apenas um resultado: a variável contadorAtrizes, com o valor da contagem de todos os itens que correspondem ao padrão de busca (seres humanos, de sexo ou gênero feminino, e que sejam atrizes).

| Exercício: quantos tenistas (Q10833314) existem no Wikidata?