今天到處都有JSON文檔，但是它們很少像您想要的那樣結(jié)構(gòu)。它們通常包含過(guò)多的數(shù)據(jù)，具有怪異命名的字段，或?qū)?shù)據(jù)放在不必要的嵌套對(duì)像中。圖形相關(guān)對(duì)象查詢（GROQ）是一種查詢語(yǔ)言（例如SQL，但不同），旨在直接在JSON文檔上使用。它基本上使您可以編寫可以快速過(guò)濾的查詢，然後重新格式化JSON文檔，以使其成為最方便的形狀。

GROQ是由Sanity.io（用作主要查詢語(yǔ)言）開(kāi)發(fā)的。它是開(kāi)源的，它為我們提供了內(nèi)置的方式，可以在任何JSON源上使用JavaScript和命令行中使用它。我們一起將GROQ添加到終端工具包中，每當(dāng)您需要將一些JSON數(shù)據(jù)爭(zhēng)吵時(shí)，這將節(jié)省您的時(shí)間。

讓我們安裝groq

像大多數(shù)事情一樣，我們需要安裝GROQ CLI工具，並可以使用終端中的NPM（或YARN）進(jìn)行操作：

 $ npm install -G groq -cli

為了使用它，我們需要有一個(gè)JSON文件。我們將使用Curl下載todo數(shù)據(jù)的示例數(shù)據(jù)集：

 $ curl -o todos.json https://jsonplaceholder.typicode.com/todos

讓我們快速查看數(shù)據(jù)中的示例項(xiàng)目：

 {
  “用戶ID”：1，
  “ id”：1，
  “ title”：“ dlectus aut autem”，
  “完成”：false
}，，

非常簡(jiǎn)單。我們有一個(gè)用戶ID，一個(gè)待辦事項(xiàng)ID，一個(gè)待辦事項(xiàng)標(biāo)題和一個(gè)布爾值，指定待辦事項(xiàng)是否已完成。

現(xiàn)在，讓我們運(yùn)行一個(gè)基本的groq查詢：查找所有已完成的戒酒，但僅返回TODO標(biāo)題和用戶ID。可以復(fù)制/粘貼這一行，因?yàn)槲覀儠?huì)稍微瀏覽它的意思。

 $ cat todos.json | groq'*[完整== true] {title，userId}' -  pretty

GROQ命令行工具接受標(biāo)準(zhǔn)輸入的JSON文檔。這與“做一件事並在文本流一起工作”的Unix哲學(xué)非常有效。為了從文件中讀取JSON，我們將使用CAT命令。另請(qǐng)注意，GROQ默認(rèn)情況下將在一條線上輸出最小的JSON，但是通過(guò)傳遞，我們獲得了一個(gè)很好的縮進(jìn)和突出顯示的語(yǔ)法。

為了存儲(chǔ)結(jié)果，我們可以使用>：

 $ cat todos.json | groq'*[postate == true] {title，userId}'> result.json

查詢本身由三個(gè)部分組成：

• *指數(shù)據(jù)集（即JSON文件中的數(shù)據(jù)）。
• [已完成== true]是一個(gè)濾鏡，它刪除了標(biāo)記為不完整的項(xiàng)目。
• {title，userId}是一個(gè)投影，它導(dǎo)致查詢僅返回“ title”和“ userId”屬性。

讓我們進(jìn)行一些練習(xí)熱身

您可能認(rèn)為您不需要鍛煉才能完成這篇文章！好吧，好消息是，我們只在詳細(xì)介紹更多細(xì)節(jié)之前，我們只用一些事情來(lái)鍛煉頭腦。

1. 如果您刪除[完整== true]和/或{title，userId}，會(huì)發(fā)生什麼？
2. 您如何更改查詢以查找用戶ID 2的用戶所有Todos？
3. 您如何更改查詢以找到用戶ID為2的用戶未完成的戒酒？
4. 如果原始查詢示例中的過(guò)濾器與投影交換，會(huì)發(fā)生什麼？
5. 您將如何編寫一個(gè)單個(gè)命令（帶管道）下載JSON並使用GROQ處理的命令？

我們將答案放在帖子的結(jié)尾，供您參考。

查詢諾貝爾獎(jiǎng)獲得者

TODO數(shù)據(jù)非常適合進(jìn)行熱身，但是說(shuō)實(shí)話：看看使用拉丁語(yǔ)作為佔(zhàn)位符內(nèi)容的列表不是很有動(dòng)力。但是，諾貝爾獎(jiǎng)?chuàng)碛兴羞^(guò)去的獲獎(jiǎng)?wù)叩臄?shù)據(jù)集，可公開(kāi)使用。

這是樣本返回：

 {
  “獲獎(jiǎng)?wù)摺保篬
    {
      “ id”：“ 1”，
      “ firstName”：“ Wilhelm Conrad”，
      “姓”：“r?ntgen”，
      “天生”：“ 1845-03-27”，
      “死”：“ 1923-02-10”，
      “ borncountry”：“普魯士（現(xiàn)在是德國(guó)）”，
      “ borncountrycode”：“ de”，
      “ BornCity”：“ Lennep（現(xiàn)在是Remscheid）”，
      “二歲”：“德國(guó)”，
      “ DIDCOUNTRYCODE”：“ DE”，
      “二歲”：“慕尼黑”，
      “性別”：“男性”，
      “獎(jiǎng)品”：[...]，
    }，，
    // ...
  這是給出的
}

啊!這更有趣！讓我們下載數(shù)據(jù)集並找到所有挪威獲獎(jiǎng)?wù)叩拿?。在這裡，我們將使用 - 輸出標(biāo)誌進(jìn)行捲曲以將數(shù)據(jù)保存到文件。

 $ curl -輸出勞埃特（Laureate.json）
$ cat Laureate.json | groq'*.laureates [borncountrycode ==“ no”] {firstName}'-pretty

你回來(lái)什麼？我收到了12個(gè)挪威諾貝爾獎(jiǎng)獲得者。不錯(cuò)！

請(qǐng)注意，此查詢不像我們寫的第一個(gè)查詢。我們?cè)谶@個(gè)中有一個(gè)額外的.laureates。當(dāng)我們?cè)赥ODO數(shù)據(jù)集中使用 *時(shí)，它代表了整個(gè)JSON文檔，該文檔包含在TODO數(shù)據(jù)集的頂級(jí)陣列中。另一方面，獲獎(jiǎng)文件在頂級(jí)列表中存儲(chǔ)在“獲獎(jiǎng)?wù)摺睂傩灾械捻敿?jí)對(duì)象。

要訪問(wèn)特定項(xiàng)目，我們可以使用過(guò)濾器[0]並僅返回名字。應(yīng)該告訴我們誰(shuí)是挪威人是誰(shuí)贏得諾貝爾獎(jiǎng)。

 $ cat Laureate.json | groq'*.laureates [borncountrycode ==“ no”] {firstName} [0]' -  pretty

//返回的對(duì)象
{
  “ firstName”：“ ivar”
}

更多練習(xí)！

我們將不願(yuàn)意使用此新數(shù)據(jù)集來(lái)查看查詢的工作原理。

1. 寫一個(gè)查詢，以查找您自己國(guó)家的所有諾貝爾獎(jiǎng)獲得者。
2. 寫一個(gè)查詢以返回最後的挪威獲獎(jiǎng)?wù)?。提示?1指的是最後一項(xiàng)。
3. 如果您嘗試直接在根對(duì)像上過(guò)濾會(huì)發(fā)生什麼？ *[borncountrycode ==“否”]？
4. *。

像上次一樣，答案將在這篇文章的結(jié)尾處。

使用過(guò)濾器

現(xiàn)在我們知道，總共有12個(gè)挪威諾貝爾獎(jiǎng)獲得者，其中有多少人在1950年之後出生？弄清Groq沒(méi)問(wèn)題：

 $ cat Laureate.json | groq'*.laureates [borncountrycode ==“ no” && bort> =“ 1950-01-01”] {firstName}' -  pretty

//樣本返回
[
  {
    “ firstName”：“ May-Britt”
  }，，
  {
    “ firstName”：“ Edvard I.”
  }
這是給出的

實(shí)際上，Groq擁有一組豐富的操作員，我們可以在過(guò)濾器中使用。我們可以比較（==），不等於（！=），大於（>），大於或等於（> =），小於（

更多的練習(xí)！

您知道鑽頭：嘗試使用過(guò)濾器玩一些，以了解它們?nèi)绾闻c數(shù)據(jù)集使用。當(dāng)然，答案是最後的。

1. 編寫一個(gè)返回帶有獲獎(jiǎng)?wù)叩牟樵儭?/li>
2. 過(guò)濾器[borncountrycode ==“ no”] [born> =“ 1950-01-01”]
3. 您能找到1973年贏得獎(jiǎng)金的所有獲獎(jiǎng)?wù)邌幔?/li>

使用預(yù)測(cè)

諾貝爾獎(jiǎng)數(shù)據(jù)集將每個(gè)獲獎(jiǎng)?wù)叩拿趾托帐戏珠_(kāi)，但是如果我們想將它們結(jié)合在一起成一個(gè)領(lǐng)域，該怎麼辦？ Groq中的預(yù)測(cè)可以做到這一點(diǎn)！

 *。
  “名稱”：firstName“”姓氏， 
  出生，
  “ prizecount”：count（獎(jiǎng)品），
}

運(yùn)行此查詢告訴我們，May-Britt Moser和Edvard Moser獲得了一個(gè)獎(jiǎng)項(xiàng)（實(shí)際上是同一獎(jiǎng)項(xiàng)）：

 [
  {
    “名稱”：“ May-Britt Moser”，
    “天生”：“ 1963-01-04”，
    “ prizecount”：1
  }，，
  {
    “名稱”：“ Edvard I. Moser”，
    “天生”：“ 1962-04-27”，
    “ prizecount”：1
  }
這是給出的

這裡發(fā)生了什麼？好吧，當(dāng)我們?cè)趃roq中撰寫投影時(shí)，我們真正寫的是一個(gè)JSON對(duì)象。以前，我們有簡(jiǎn)單的投影（例如{firstName}），但這是寫入{“ firstName”：firstName}的快捷方式。通過(guò)使用擴(kuò)展的對(duì)象語(yǔ)法，我們可以重命名鍵並轉(zhuǎn)換值。

GROQ具有一組豐富的運(yùn)算符和用於轉(zhuǎn)換數(shù)據(jù)的功能，包括字符串串聯(lián)，算術(shù)運(yùn)算符（ - ， *， *， /，％，**），計(jì)數(shù)數(shù)組（count（count（prizes））和圓形數(shù)字（round（num，num，

練習(xí)

希望此時(shí)您對(duì)事情有很好的感覺(jué)，但是這裡還有一些練習(xí)預(yù)測(cè)工作的方法：

1. 找到所有贏得兩個(gè)或更多獎(jiǎng)項(xiàng)的獲獎(jiǎng)?wù)摺?/li>
2. 找到女性贏得了多少獎(jiǎng)。
3. 格式化一個(gè)將結(jié)果名稱和firstName組合在結(jié)果中的fullname鍵。

一次做更多

觀看以下內(nèi)容：

 $ cat Laureate.json | groq -pretty'
{
  “計(jì)數(shù)”：count（*。獲獎(jiǎng)），
  “挪威人”： *。 
}
'

結(jié)果：

 {
  “計(jì)數(shù)”：928，
  “挪威人”：[
    {
      “ firstName”：“ ivar”
    }，，
    {
      “ firstName”：“ lars”
    }，，
    …
  這是給出的
}

抓到嗎？ GROQ查詢不必從 *開(kāi)始。在此查詢中，我們正在創(chuàng)建一個(gè)JSON對(duì)象，其中值是由單獨(dú)的查詢產(chǎn)生的。這為我們使用GROQ產(chǎn)生的東西提供了很大的靈活性。也許您希望戒酒的總數(shù)以及最後五個(gè)列表的列表?；蛘?，也許您想將招待員分為兩個(gè)單獨(dú)的列表：一個(gè)用於完成，一個(gè)用於不完整。或者，也許您需要將所有內(nèi)容包裝在對(duì)像中，因?yàn)檫@是另一個(gè)工具/庫(kù)/框架所期望的。無(wú)論如何，Groq都可以覆蓋。

讓我們嘗試最後一個(gè)練習(xí)。您可以投影一個(gè)獲獎(jiǎng)?wù)甙粋€(gè)陣列的對(duì)象，其中每個(gè)獲獎(jiǎng)?wù)咭呀?jīng)運(yùn)行的獎(jiǎng)品總數(shù)的圓形百分比，並返回了獲獎(jiǎng)?wù)叩拿?？然後，嘗試輸出分發(fā)出的總數(shù)。

概括

在從GROQ中獲得一些充分利用之前，您不需要學(xué)習(xí)太多。如果您遵循了練習(xí)，那麼您將成為成為Groq Guru的好途徑。自然，此介紹不會(huì)涉及GROQ的所有不同功能和方面，因此請(qǐng)隨時(shí)在Github上探索規(guī)範(fàn)和項(xiàng)目本身。如果您對(duì)Groq的數(shù)據(jù)爭(zhēng)吵有疑問(wèn)，請(qǐng)隨時(shí)與Sanity.io接觸。

鍛煉答案

 *[userId == 2]

 *[userId == 2 &&完成== false]或 *[userId == 2 &&！已完成]

 curl https://jsonplaceholder.typicode.com/todos | groq'*[postate == true] {title，userId}'> result.json

 *。

 *。

 *。

 *.laureates [“ 1973”獎(jiǎng)品[]

 *.laureates [count（獎(jiǎng)品）> = 2]

計(jì)數(shù)（*。獲獎(jiǎng)[性別==“女性”]）

 *.laureates {“ fullname”：surname“，” firstName}

 *.laureates {“獲獎(jiǎng)?wù)摺保簕firstName，“百分比”：round（count（count（prizes） / count（*。獲獎(jiǎng)[]。

以上是查詢終端中的JSON文檔與GROQ的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！