sql_request 外掛程式
適用於： ✅Microsoft網狀架構✅Azure 數據總管
外掛程式 http_request 會傳送 HTTP GET 要求，並將響應轉換成數據表。
必要條件
- 執行
.enable plugin http_request以 啟用外掛程式 - 將 URI 設定為圖說文字原則中允許的目的地
webapi存取
語法
evaluatehttp_request ( Uri [ RequestHeaders [, , Options]])
深入瞭解 語法慣例。
參數
| 姓名 | 類型 | 必要 | 描述 |
|---|---|---|---|
| URI | string |
✔️ | HTTP 或 HTTPS 要求的目的地 URI。 |
| RequestHeaders | dynamic |
屬性包，其中包含 要隨要求一起傳送的 HTTP 標頭 。 | |
| 選項 | dynamic |
包含要求其他屬性的屬性包。 |
注意
- 若要指定遵循選擇性參數的選擇性參數，請務必提供上述選擇性參數的值。 如需詳細資訊，請參閱 使用選擇性參數。
- 如果您使用驗證，請使用 HTTPS 通訊協定。 嘗試搭配驗證使用 HTTP 會導致錯誤。
驗證與授權
若要進行驗證，請使用 HTTP 標準 Authorization 標頭或任何 Web 服務支援的自定義標頭。
注意
如果查詢包含機密資訊，請確定查詢文字的相關部分已模糊化，以便從任何追蹤中省略它們。 如需詳細資訊，請參閱 模糊字串常值。
傳回
外掛程式會傳回具有具有下列動態數據行之單一記錄的數據表：
- ResponseHeaders：具有響應標頭的屬性包。
- ResponseBody：回應本文剖析為 類型的
dynamic值。
如果 HTTP 回應指出媒體類型為 application/json，Content-Type則響應主體會自動剖析為 JSON 物件。 否則，它會依原樣傳回。
標題
RequestHeaders 自變數可用來將自定義標頭新增至傳出 HTTP 要求。 除了標準 HTTP 要求標頭和使用者提供的自定義標頭之外，外掛程式也會新增下列自定義標頭：
| 名稱 | 描述 |
|---|---|
x-ms-client-request-id |
識別要求的相互關聯標識碼。 相同查詢中外掛程式的多個叫用都會有相同的標識碼。 |
x-ms-readonly |
旗標，表示此要求的處理器不應該進行任何持續性變更。 |
警告
旗 x-ms-readonly 標是針對由查詢所觸發，而不是管理命令所觸發之外掛程式所傳送的每個 HTTP 要求所設定。 Web 服務應該將此旗標的任何要求視為不會進行內部狀態變更的要求，否則應該拒絕要求。 這可保護使用者免於傳送看似無辜的查詢，這些查詢最終會使用 Kusto 查詢作為這類攻擊的啟動控制板來進行不必要的變更。
範例
下列範例會擷取西歐 Azure Purview 的 Azure 零售價格：
let Uri = "https://prices.azure.com/api/retail/prices?$filter=serviceName eq 'Azure Purview' and location eq 'EU West'";
evaluate http_request(Uri)
| project ResponseBody.Items
| mv-expand ResponseBody_Items
| evaluate bag_unpack(ResponseBody_Items)
輸出
| armRegionName | armSkuName | currencyCode | effectiveStartDate | isPrimaryMeterRegion | location | meterId | meterName | productId | productName | retailPrice | serviceFamily | serviceId | serviceName | skuId | skuName | tierMinimumUnits | type | unitOfMeasure | unitPrice |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| westeurope | 資料深入解析 | USD | 2022-06-01T00：00：00Z | false | 歐洲西部 | 8ce915f7-20db-564d-8cc3-5702a7c952ab | Data Insights 報表耗用量 | DZH318Z08M22 | Azure Purview 資料地圖 | 0.21 | 分析 | DZH318Q66D0F | Azure Purview | DZH318Z08M22/006C | 目錄見解 | 0 | 耗用 | 1 個 API 呼叫 | 0.21 |
| westeurope | 數據對應擴充 - 數據深入解析產生 | USD | 2022-06-01T00：00：00Z | false | 歐洲西部 | 7ce2db1d-59a0-5193-8a57-0431a10622b6 | 數據對應擴充 - Data Insights 產生虛擬核心 | DZH318Z08M22 | Azure Purview 資料地圖 | 0.82 | 分析 | DZH318Q66D0F | Azure Purview | DZH318Z08M22/005C | 數據對應擴充 - 深入解析產生 | 0 | 耗用 | 1 小時 | 0.82 |
| westeurope | USD | 2021-09-28T00：00：00Z | false | 歐洲西部 | 053e2dcb-82c0-5e50-86cd-1f1c8d803705 | Power BI 虛擬核心 | DZH318Z08M23 | Azure Purview 掃描擷取和分類 | 0 | 分析 | DZH318Q66D0F | Azure Purview | DZH318Z08M23/0005 | Power BI | 0 | 耗用 | 1 小時 | 0 | |
| westeurope | USD | 2021-09-28T00：00：00Z | false | 歐洲西部 | a7f57f26-5f31-51e5-a5ed-ffc2b0da37b9 | 資源集虛擬核心 | DZH318Z08M22 | Azure Purview 資料地圖 | 0.21 | 分析 | DZH318Q66D0F | Azure Purview | DZH318Z08M22/000X | 資源集 | 0 | 耗用 | 1 小時 | 0.21 | |
| westeurope | USD | 2021-09-28T00：00：00Z | false | 歐洲西部 | 5d157295-441c-5ea7-ba7c-5083026dc456 | SQL Server 虛擬核心 | DZH318Z08M23 | Azure Purview 掃描擷取和分類 | 0 | 分析 | DZH318Q66D0F | Azure Purview | DZH318Z08M23/000F | SQL Server | 0 | 耗用 | 1 小時 | 0 | |
| westeurope | USD | 2021-09-28T00：00：00Z | false | 歐洲西部 | 0745df0d-ce4f-52db-ac31-ac574d4dcfe5 | 標準容量單位 | DZH318Z08M22 | Azure Purview 資料地圖 | 0.411 | 分析 | DZH318Q66D0F | Azure Purview | DZH318Z08M22/0002 | 標準 | 0 | 耗用 | 1 小時 | 0.411 | |
| westeurope | USD | 2021-09-28T00：00：00Z | false | 歐洲西部 | 811e3118-5380-5ee8-a5d9-01d48d0a0627 | 標準虛擬核心 | DZH318Z08M23 | Azure Purview 掃描擷取和分類 | 0.63 | 分析 | DZH318Q66D0F | Azure Purview | DZH318Z08M23/0009 | 標準 | 0 | 耗用 | 1 小時 | 0.63 |