{"id":2133,"date":"2021-07-14T21:39:05","date_gmt":"2021-07-14T21:39:05","guid":{"rendered":"https:\/\/wdqs-tutorial.toolforge.org\/?p=2133"},"modified":"2021-07-20T21:23:49","modified_gmt":"2021-07-20T21:23:49","slug":"basic-sparql-query","status":"publish","type":"post","link":"https:\/\/wdqs-tutorial.toolforge.org\/index.php\/simple-queries-pt-br\/the-simplest-query-pt-br\/basic-sparql-query\/?lang=pt-br","title":{"rendered":"Consulta SPARQL b\u00e1sica"},"content":{"rendered":"\n<h2>Filmes na saga Star Wars<\/h2>\n\n\n\n<p>Esta \u00e9 sua primeira consulta SPARQL. Esta simples consulta encontrar\u00e1 os filmes que s\u00e3o parte da saga Star Wars.<\/p>\n\n\n\n<div class=\"wp-block-codemirror-blocks-code-block code-block\"><pre class=\"CodeMirror cm-s-eclipse\" data-setting=\"{&quot;mode&quot;:&quot;sparql&quot;,&quot;mime&quot;:&quot;application\/sparql-query&quot;,&quot;theme&quot;:&quot;eclipse&quot;,&quot;lineNumbers&quot;:true,&quot;lineWrapping&quot;:false,&quot;readOnly&quot;:true}\">#Filmes Star Wars\nSELECT ?item  \nWHERE \n{\n  ?item wdt:P179 wd:Q22092344.\n}<\/pre><\/div>\n\n\n\n<h3>Legenda de cores do WDQS<\/h3>\n\n\n\n<p>O WDQS usa uma legenda de cores para determinadas palavras em SPARQL, o que ajuda a entender e explicar o c\u00f3digo SPARQL:<\/p>\n\n\n\n<ul style=\"color:#666666\"><li>Cinza: A primeira linha da consulta tem uma hashtag (#) seguida por um texto na cor cinza. Isso indica que se trata de um coment\u00e1rio \u2013 algo que \u00e9 escrito, mas que n\u00e3o vai afetar a consulta. Tudo o que estiver escrito ap\u00f3s uma &#8220;#&#8221; \u00e9 um coment\u00e1rio. Etse texto \u00e9 sempre ignorado pelo WDQS \u2013 com exce\u00e7\u00e3o de alguns padr\u00f5es que veremos nas se\u00e7\u00f5es a seguir.<\/li><\/ul>\n\n\n\n<ul style=\"color:#990000\"><li>Vermelho: as palavras SELECT e WHERE nas linhas 2 e 3 est\u00e3o em vermelho e em letras mai\u00fasculas. Elas s\u00e3o palavras &#8220;reservadas&#8221;, ou seja, palavras que s\u00e3o usadas apenas como sintaxe do SPARQL \u2013 s\u00e3o uma esp\u00e9cie de &#8220;comando&#8221;:<ul><li>SELECT \u2013 com esse comando definimos os nomes das vari\u00e1veis que ser\u00e3o retornadas e mostradas pela consulta.&nbsp;<\/li><li>WHERE \u2013 com esse comando fornecemos o padr\u00e3o que ser\u00e1 usado para selecionar os dados. Ou seja, definimos as condi\u00e7\u00f5es para encontrar os valores referentes \u00e0s vari\u00e1veis indicadas na cl\u00e1usula SELECT. Isso muitas vezes \u00e9 feito na forma de &#8220;triplas&#8221; que refletem a estrutura de Item \u2013 Propriedade \u2013 Valor do banco de dados.<\/li><\/ul><\/li><\/ul>\n\n\n\n<ul style=\"color:#339966\"><li>Verde: nas linhas 2 e 5, &#8220;?item&#8221; aparece na cor verde. Em SPARQL, os nomes de vari\u00e1veis s\u00e3o sempre precedidos por um sinal de interroga\u00e7\u00e3o, e s\u00e3o exibidos em verde. Praticamente qualquer fragmento de texto, tamb\u00e9m chamado de \u201cstring\u201d, pode ser um nome de vari\u00e1vel (com a exce\u00e7\u00e3o das palavras reservadas para comando), como ?filme, ?x, ou ?qualquer_nome_de_vari\u00e1vel. Vari\u00e1veis guardam valores para uso futuro.<\/li><\/ul>\n\n\n\n<ul style=\"color:#006699\"><li>Azul: na linha 5, vemos alguns termos em azul. Isso indica que eles s\u00e3o prefixos. Prefixos s\u00e3o abrevia\u00e7\u00f5es que permitem que as consultas SPARQL sejam apresentadas de forma mais compacta e transparente. Sem os prefixos, precisar\u00edamos especificar a URL completa para cada elemento da consulta.<ul><li>wdt: esse \u00e9 um prefixo para indicar propriedades do Wikidata + o n\u00famero da propriedade (P). Sem o prefixo, precisar\u00edamos nos referir a esta propriedade como: &lt;http:\/\/www.wikidata.org\/prop\/direct\/>:P179<\/li><\/ul><ul><li>wd: esse \u00e9 um prefixo para indicar itens do Wikidata + o QID do valor. Sem o prefixo, precisar\u00edamos inserir antes do QID toda esta URL:&lt;http:\/\/www.wikidata.org\/entity\/>:Q22092344<\/li><\/ul><\/li><\/ul>\n\n\n\n<h3>Explica\u00e7\u00e3o da consulta<\/h3>\n\n\n\n<p>Agora veremos como a consulta funciona.<\/p>\n\n\n\n<p>Uma consulta SPARQL geralmente \u00e9 composta por duas ou mais cl\u00e1usulas, que s\u00e3o partes da consulta com fun\u00e7\u00f5es distintas. Nossa consulta SPARQL simples \u00e9 composta por duas cl\u00e1usulas:<\/p>\n\n\n\n<h5>A cl\u00e1usula SELECT<\/h5>\n\n\n\n<p>O termo significa &#8220;selecionar&#8221;, em portugu\u00eas. Esta cl\u00e1usula lista as vari\u00e1veis que voc\u00ea quer que sejam retornadas na consulta &#8211; neste caso, a vari\u00e1vel ?item. Basicamente, esta linha diz: &#8220;N\u00f3s vamos encontrar alguns valores para guardar em ?item, e depois vamos apresentar esses valores&#8221;.<\/p>\n\n\n\n<h5>A cl\u00e1usula WHERE<\/h5>\n\n\n\n<p>O termo significa &#8220;onde&#8221; em portugu\u00eas. A cl\u00e1usula especifica as condi\u00e7\u00f5es para as vari\u00e1veis, geralmente na forma de triplas. SPARQL funciona sob a l\u00f3gica de reconhecimento de padr\u00f5es. O processador SPARQL faz a correspond\u00eancia entre os padr\u00f5es que voc\u00ea define dentro da cl\u00e1usula WHERE e as declara\u00e7\u00f5es de tr\u00eas partes armazenadas no Wikidata. A cl\u00e1usula WHERE diz ao processador quais valores de propriedade devem ser usados para preencher as vari\u00e1veis que se est\u00e1 SELEC(T)ionando, e como ele deve obter essas informa\u00e7\u00f5es.<\/p>\n\n\n\n<p>Esse padr\u00e3o b\u00e1sico de consulta SPARQL reflete a estrutura de Item-Propriedade-Valor do banco de dados ligados entre si. O padr\u00e3o a ser reconhecido na nossa consulta \u00e9 fornecido como uma declara\u00e7\u00e3o:&nbsp;<br>?item \u2013 tem a propriedade: s\u00e9rie \u2013 com valor: Star Wars (s\u00e9rie de filmes).<br> <br>Ou seja, esta consulta seleciona itens do Wikidata: (1) que tem a propriedade \u201cs\u00e9rie\u201d (P179), e (2) que o valor para esta propriedade seja &#8220;Star Wars (s\u00e9rie de filmes)&#8221; (Q22092344). Note que, se voc\u00ea colocar seu cursor sobre o prefixo ou seu elemento associado, a interface do WDQS mostra o r\u00f3tulo e a descri\u00e7\u00e3o daquele item ou propriedade.<\/p>\n\n\n\n<p>Aperte o bot\u00e3o &#8220;Play&#8221; para rodar a consulta e des\u00e7a a barra de rolagem para ver os resultados.     <\/p>\n\n\n\n<iframe class=\"\" src=\"https:\/\/query.wikidata.org\/#%23Filmes%20Star%20Wars%0ASELECT%20%3Fitem%20%20%0AWHERE%20%0A%7B%0A%20%20%3Fitem%20wdt%3AP179%20wd%3AQ22092344.%0A%7D\" style=\"width:100%;max-width:100%;height:450px\" frameborder=\"0\"><\/iframe>\n\n\n\n<p>A consulta recupera o n\u00famero Q de cada um dos filmes da saga Star Wars listados no Wikidata, mas n\u00e3o seus t\u00edtulos. A seguir, voc\u00ea vai aprender como recuperar os t\u00edtulos dos filmes.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Filmes na saga Star Wars Esta \u00e9 sua primeira consulta SPARQL. Esta simples consulta encontrar\u00e1 os filmes que s\u00e3o parte da saga Star Wars. Legenda de cores do WDQS O WDQS usa uma legenda de cores para determinadas palavras em SPARQL, o que ajuda a entender e explicar o c\u00f3digo SPARQL: Cinza: A primeira linha [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_coblocks_attr":"","_coblocks_dimensions":"","_coblocks_responsive_height":"","_coblocks_accordion_ie_support":""},"categories":[7],"tags":[],"_links":{"self":[{"href":"https:\/\/wdqs-tutorial.toolforge.org\/index.php\/wp-json\/wp\/v2\/posts\/2133"}],"collection":[{"href":"https:\/\/wdqs-tutorial.toolforge.org\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wdqs-tutorial.toolforge.org\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wdqs-tutorial.toolforge.org\/index.php\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/wdqs-tutorial.toolforge.org\/index.php\/wp-json\/wp\/v2\/comments?post=2133"}],"version-history":[{"count":5,"href":"https:\/\/wdqs-tutorial.toolforge.org\/index.php\/wp-json\/wp\/v2\/posts\/2133\/revisions"}],"predecessor-version":[{"id":2431,"href":"https:\/\/wdqs-tutorial.toolforge.org\/index.php\/wp-json\/wp\/v2\/posts\/2133\/revisions\/2431"}],"wp:attachment":[{"href":"https:\/\/wdqs-tutorial.toolforge.org\/index.php\/wp-json\/wp\/v2\/media?parent=2133"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wdqs-tutorial.toolforge.org\/index.php\/wp-json\/wp\/v2\/categories?post=2133"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wdqs-tutorial.toolforge.org\/index.php\/wp-json\/wp\/v2\/tags?post=2133"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}