{"id":298,"date":"2021-01-29T16:22:13","date_gmt":"2021-01-29T16:22:13","guid":{"rendered":"https:\/\/adrianotanaka.com.br\/?p=298"},"modified":"2022-03-11T19:17:46","modified_gmt":"2022-03-11T19:17:46","slug":"oci-search-bar","status":"publish","type":"post","link":"https:\/\/adrianotanaka.com.br\/index.php\/2021\/01\/29\/oci-search-bar\/","title":{"rendered":"OCI – Search bar e Advanced Resource Query"},"content":{"rendered":"\n

A barra de pesquisa do OCI est\u00e1 se tornando cada vez mais \u00fatil e funcional, com ela podemos inclusive pesquisar por um IP e identificar em qual m\u00e1quina ele est\u00e1 vinculado:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Mas hoje quero falar um pouco sobre a op\u00e7\u00e3o Advanced Resource Query <\/strong>que potencializa a capacidade de pesquisa, permitindo que montemos nossas pr\u00f3prias consultas, lembrando que ao usar essa op\u00e7\u00e3o, ele vai buscar somente no Tenancy e regi\u00e3o atual.<\/p>\n\n\n\n

Recursos suportados<\/h4>\n\n\n\n

Devemos consultar aqui<\/a> quais s\u00e3o os recursos suportados pela fun\u00e7\u00e3o de pesquisa, a coluna importante \u00e9 a Resource Type<\/strong> que vamos usar nas consultas. <\/p>\n\n\n\n

Sintaxe <\/h4>\n\n\n\n

De acordo com a documenta\u00e7\u00e3o da oracle, a sintaxe que precisamos seguir \u00e9 a seguinte:<\/p>\n\n\n\n

query <resourceType> resources where <conditions> sorted by <fieldName> <order><\/pre>\n\n\n\n
query <resourceType> resources matching <keywords><\/pre>\n\n\n\n
Note que ambas come\u00e7am com a palavra query, seguida do resourceType(que podemos consultar aqui<\/a>) e ap\u00f3s isso aplicamos as condi\u00e7\u00f5es, para quem j\u00e1 trabalha com a linguagem SQL vai notar que as duas s\u00e3o bem parecidas.<\/p>\n\n\n\n
A principal diferen\u00e7a entre elas \u00e9 que ao usar where, voc\u00ea precisa especificar uma condi\u00e7\u00e3o e ao usar matching ele busca pelo texto em todos os campos que ele da suporte.<\/p>\n\n\n\n
Sendo assim, podemos procurar por inst\u00e2ncias que possuam SQL no nome das seguintes formas:<\/p>\n\n\n\n
query\n  instance resources\n    where displayName=~'SQL'<\/pre>\n\n\n\n
query\n  instance resources\n    matching  'SQL'<\/pre>\n\n\n\n
Note que em ambos os exemplos, estou usando o resourceType instance<\/strong>, na primeira query busco instancias cujo o nome (displayName) contenha (=~) SQL e na segunda query ele busca por SQL em todos os campos.<\/p>\n\n\n\n
Essa diferen\u00e7a fica mais evidente quando pesquisamos por todos os recursos do ambiente:<\/p>\n\n\n\n
query\nall resources\nwhere displayname =~'SQL'<\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Perceba que n\u00e3o passei o tipo de recurso(apesar que na tela de pesquisa \u00e9 poss\u00edvel filtrar) e ele me retornou discos de boot que possuem SQL no nome.<\/p>\n\n\n\n
Operadores<\/h5>\n\n\n\n
Abaixo, listo quais operadores podem ser usados nas querys de acordo com a documenta\u00e7\u00e3o da Oracle, mais uma vez, para quem j\u00e1 mexe com a linguagem SQL vai perceber a semelhan\u00e7a.<\/p>\n\n\n\n
peration<\/th>Description<\/th>Supported Field Types<\/th>Case-sensitive?<\/th>Example<\/th><\/tr><\/thead>
=<\/code><\/td>Equals, or exact matching for strings<\/td>String, integer, rational, Boolean, date-time<\/td>No<\/td>If the value<\/code> was \u02c8backUp<\/strong>\u02c8, it would match “backup”, “BACKUP”, “BackUp”, “backUp”, or any other variation in casing.<\/td><\/tr>
!=<\/code><\/td>Does not equal<\/td>String, integer, rational, Boolean, date-time<\/td>No<\/td>If the value<\/code> was \u02c8backUp<\/strong>\u02c8, it would match anything that does not equal “backUp”, “backup”, or any other variation in casing. It also would match anything that does not contain the characters ‘backup’ in that order.<\/td><\/tr>
==<\/code><\/td>Strictly equals<\/td>String<\/td>Yes<\/td>If the value<\/code> was \u02c8backUp<\/strong>\u02c8, it would only match “backUp” and no other variation in casing.<\/td><\/tr>
!==<\/code><\/td>Strictly does not equal<\/td>String<\/td>Yes<\/td>If the value<\/code> was \u02c8backUp<\/strong>\u02c8, it would match “backup”, “BACKup”, or anything except “backUp”, with that exact casing.<\/td><\/tr>
=~<\/code><\/td>Contains<\/td>String<\/td>No<\/td>If the value<\/code> was \u02c8backUp<\/strong>\u02c8, it would match anything that equals “backup”, “BACKUP”, “BackUp”, “backUp”, or any other variation in casing, or contains those characters in that order, alongside other characters.<\/td><\/tr>
>=<\/code><\/td>Greater than or equal to<\/td>Integer, rational, date-time<\/td>Not applicable<\/td>For a query where you have size >= 5<\/code> as the condition, all results have a value of 5<\/strong> or greater in the field named size<\/strong>.<\/td><\/tr>
><\/code><\/td>Greater than<\/td>Integer, rational, date-time<\/td>Not applicable<\/td>For a query where you have size > 5<\/code> as the condition, all results have a value of greater than 5<\/strong> in the field named size<\/strong>.<\/td><\/tr>
<=<\/code><\/td>Less than or equal to<\/td>Integer, rational, date-time<\/td>Not applicable<\/td>For a query where you have size <= 5<\/code> as the condition, all results have a value of 5<\/strong> or less in the field named size<\/strong>.<\/td><\/tr>
<<\/code><\/td>Less than<\/td>Integer, rational, date-time<\/td>Not applicable<\/td>For a query where you have size < 5<\/code> as the condition, all results have a value of 5<\/strong> or less in the field named size<\/strong>.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Exemplos do que podemos fazer<\/h4>\n\n\n\n
Certo, agora j\u00e1 sabemos da exist\u00eancia dessa op\u00e7\u00e3o de consulta, vimos a sua sintaxe e tamb\u00e9m seus operados mas na realidade qual a vantagem de se usar essa op\u00e7\u00e3o comparada com apenas digitar o nome do recurso na barra de pesquisa?<\/p>\n\n\n\n
Abaixo listo alguns exemplos interessantes.<\/p>\n\n\n\n
M\u00e1quinas que foram criadas nos \u00faltimos dias<\/h4>\n\n\n\n
Ao trabalhar com data, podemos tanto passar a data inteira(seguindo o padr\u00e3o que a oracle mostra na documenta\u00e7\u00e3o), usar a vari\u00e1vel now e por ultimo fazer opera\u00e7\u00f5es em cima da string de data, as 3 consultas abaixo retornam a mesma coisa<\/p>\n\n\n\n
query\n  instance resources\n  where timeCreated < 'now-24h'<\/pre>\n\n\n\n
query\n  instance resources\n  where timeCreated > '2021-01-27 00:00:00 UTC'<\/pre>\n\n\n\n
query\n  instance resources\n  where timeCreated > '2021-01-29 00:00:00 UTC -24h'<\/pre>\n\n\n\n
Aplicando diversas condi\u00e7\u00f5es<\/h4>\n\n\n\n
Tamb\u00e9m podemos aplicar mais de uma condi\u00e7\u00e3o em nossa consulta usando os peradores &&(and) e  || (or), juntando tudo, podemos por exemplo consultar quais inst\u00e2ncias foram criadas no \u00faltimos 10 dias e possuem SQL no nome:<\/p>\n\n\n\n
query\ninstance resources\nwhere timeCreated >'now-10d' && displayName=~'SQL'<\/pre>\n\n\n\n
Podemos tamb\u00e9m juntar diversas condi\u00e7\u00f5es, como por exemplo m\u00e1quinas que foram criadas no \u00faltimos 10 dias e possuem SQL no nome ou m\u00e1quinas que possuam SQL no nome, para isso precisamos agrupar as condi\u00e7\u00f5es entre par\u00eanteses :<\/p>\n\n\n\n
query\ninstance resources\nwhere (timeCreated >'now-10d' && displayName=~'SQL') || displayName=~'SQL'<\/pre>\n\n\n\n
Outra funcionalidade que temos \u00e9 a op\u00e7\u00e3o de procurar por mais de um tipo de recurso, aqui mostro como buscar inst\u00e2ncias e discos que possuam SQL no nome:<\/p>\n\n\n\n
query\ninstance, bootVolume resources\nwhere (timeCreated >'now-10d' && displayName=~'SQL') || displayName=~'SQL'<\/pre>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
A barra de pesquisa do OCI est\u00e1 se tornando cada vez mais \u00fatil e funcional, com ela podemos inclusive pesquisar por um IP e identificar em qual m\u00e1quina ele est\u00e1 vinculado: Mas hoje quero falar um pouco sobre a op\u00e7\u00e3o Advanced Resource Query que potencializa a capacidade de pesquisa, permitindo que montemos nossas pr\u00f3prias consultas, […]<\/p>\n","protected":false},"author":1,"featured_media":299,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"material-hide-sections":[],"footnotes":""},"categories":[8,6,1],"tags":[29],"class_list":["post-298","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oci","category-oracle","category-uncategorized","tag-cloud"],"_links":{"self":[{"href":"https:\/\/adrianotanaka.com.br\/index.php\/wp-json\/wp\/v2\/posts\/298","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/adrianotanaka.com.br\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/adrianotanaka.com.br\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/adrianotanaka.com.br\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/adrianotanaka.com.br\/index.php\/wp-json\/wp\/v2\/comments?post=298"}],"version-history":[{"count":10,"href":"https:\/\/adrianotanaka.com.br\/index.php\/wp-json\/wp\/v2\/posts\/298\/revisions"}],"predecessor-version":[{"id":311,"href":"https:\/\/adrianotanaka.com.br\/index.php\/wp-json\/wp\/v2\/posts\/298\/revisions\/311"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/adrianotanaka.com.br\/index.php\/wp-json\/wp\/v2\/media\/299"}],"wp:attachment":[{"href":"https:\/\/adrianotanaka.com.br\/index.php\/wp-json\/wp\/v2\/media?parent=298"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/adrianotanaka.com.br\/index.php\/wp-json\/wp\/v2\/categories?post=298"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/adrianotanaka.com.br\/index.php\/wp-json\/wp\/v2\/tags?post=298"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}