GraphQL查詢
這是GraphQL和Adobe Commerce系列的第2部分。 在本教學課程和影片中，瞭解GraphQL查詢，以及如何針對Adobe Commerce執行這些查詢。
本系列中GraphQL的相關影片和教學課程
GraphQL語法範例
以完整的範例直接探討GraphQL查詢語法。 (請記住，您可以對https://venia.magento.com/graphql自行嘗試此做法。)
請注意下列GraphQL查詢，此查詢會依件細分：
{
country (
id: "US"
) {
id
full_name_english
}
categories(
filters: {
name: {
match: "Tops"
}
}
) {
items {
name
products(
pageSize: 10,
currentPage: 2
) {
items {
sku
}
}
}
}
}
GraphQL伺服器對上述查詢的合理回應可能是：
{
"data": {
"country": {
"id": "US",
"full_name_english": "United States"
},
"categories": {
"items": [
{
"name": "Tops",
"products": {
"items": [
{
"sku": "VSW06"
},
{
"sku": "VT06"
},
{
"sku": "VSW07"
},
{
"sku": "VT07"
},
{
"sku": "VSW08"
},
{
"sku": "VT08"
},
{
"sku": "VSW09"
},
{
"sku": "VT09"
},
{
"sku": "VSW10"
},
{
"sku": "VT10"
}
]
}
}
]
}
}
}
上述範例仰賴伺服器所定義的適用於Adobe Commerce的現成GraphQL架構。 在此請求中，您
一次查詢多種型別的資料。 查詢會精確表示您想要的欄位，而傳回的資料會格式化
類似於查詢本身。
{string}」，其中{string}只是您整個查詢的原始字串。 如果請求是以GET形式傳送，則查詢可能會改以查詢字串引數"query"編碼。 不像REST，HTTP要求型別並不重要，只有關鍵查詢的內容。查詢您想要的
針對兩種不同型別的資料，範例中的country和categories代表兩個不同的「查詢」。 不同於類似REST的傳統API範例，後者會針對每種資料型別定義個別且明確的端點。 GraphQL可讓您透過運算式查詢單一端點，以便一次擷取多種型別的資料。
同樣地，查詢也指定了country （id和full_name_english）和categories所需的欄位（items，它本身具有欄位子選項），而您收到的資料會反映該欄位規格。 這些資料型別可能還有許多欄位可供使用，但您只能取回您要求的內容。
items的傳回值實際上是_陣列_的值，但您還是直接為其選取子欄位。 當欄位的型別是清單時，GraphQL會隱含地瞭解要套用至清單中每個專案的子選取範圍。引數
雖然您要傳回的欄位是在每個型別的大括弧內指定，但已命名的引數和它們的值是在型別名稱后的括弧內指定。 引數通常是選用的，通常會影響查詢結果的篩選、格式化或以其他方式轉換的方式。
您正在將id引數傳給country，指定要查詢的特定國家/地區，以及categories的filters引數。
欄位一直向下對齊
雖然您可能會將country和categories視為個別的查詢或實體，但查詢中表達的整個樹狀結構實際上只包含欄位。 products的運算式在語法上與categories的運算式沒有區別。 兩者都是欄位，其結構之間沒有差異。
任何GraphQL資料圖表都有單一「根」型別（通常稱為Query）來啟動樹狀結構，且通常會視為實體的型別會指派給此根目錄上的欄位。 範例查詢實際上正在對根型別進行一個泛型查詢，並選取欄位country和categories。 接著，它會選取這些欄位的子欄位，依此類推，可能深入數個層級。 只要欄位的傳回型別是複雜型別（例如，具有自己欄位的型別，而不是純量型別），請繼續選取您想要的欄位。
這個巢狀欄位概念也是您以同樣方式傳遞最上層categories欄位的products （pageSize和currentPage）引數的原因。
變數
請嘗試不同的查詢：
query getProducts(
$search: String
) {
products(
search: $search
) {
items {
...productDetails
related_products {
...productDetails
}
}
}
}
fragment productDetails on ProductInterface {
sku
name
}
首先要注意的是，在查詢的開頭大括弧前面加上關鍵字query，以及作業名稱(getProducts)。 此作業名稱是任意的；它未對應到伺服器結構描述中的任何內容。 已新增此語法以支援變數的引入。
在上一個查詢中，您可以直接將欄位引數的值硬式編碼，格式為字串或整數。 然而，GraphQL規格具有第一級支援，可透過變數將使用者輸入與主要查詢分開。
在新查詢中，您在整個查詢的開頭大括弧前使用括弧，以定義$search變數（變數一律使用美元符號首碼語法）。 這是提供給products之search引數的變數。
當查詢包含變數時，GraphQL要求應隨查詢本身包含個別的JSON編碼值字典。 對於上述查詢，除了查詢本文之外，您還可以傳送下列變數值JSON：
{
"search": "VT01"
}
related_products中可能會是空的。在您用於測試的任何GraphQL感知使用者端（例如Altair和GraphiQL）中，UI支援與查詢分開輸入變數JSON。
如您所見，GraphQL查詢的實際HTTP要求在其內文中包含「query： {string}」，任何包含變數字典的要求只會在該內文中包含額外的「變數： {json}」，其中{json}是具有變數值的JSON字串。
新查詢也使用 片段 (productDetails)在多個位置重複使用相同的欄位選取專案。 在GraphQL檔案中進一步瞭解片段。