API / SDK / developer guide
Line protocol writes
| 目標讀者 TA | 遙測匯入開發者 |
|---|---|
| 官方文件能力 | 透過 v3 或相容端點寫入時間戳量測。 |
| 輸入 → 輸出 | Line protocol、資料庫與精度 → 寫入狀態／錯誤。 |
| 執行環境 | InfluxDB3 Core 端點與授權權杖。 |
| 本站選型評估 | v3 預設允許部分寫入；400 仍可能已提交有效資料。 |
| 本站建議驗證 | 計算接受／拒絕筆數；明確設定精度與部分寫入政策。 |
工業 IoT／SCADA · API / SDK
InfluxDB HTTP API
InfluxData
透過 HTTP 接口寫入與查詢時間序列資料。
INFLUXDB 3 CORE / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 公司 | InfluxData 開發 InfluxDB，用於蒐集、儲存與分析時序資料，包括工業遙測與可觀測性。 |
|---|---|
| 範圍 | 本指南以 InfluxDB3 Core 為目標；不可假設 Enterprise、雲端、v1 與 v2 功能可互換。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源。未呼叫供應商 API 或執行推論；結果為內部契約示意。
十項技術入口比較
依實作決策選出的十個技術文件入口，非十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · Line protocol writesAPI / SDK / developer guide | 透過 v3 或相容端點寫入時間戳量測。遙測匯入開發者 |
| 02 · SQL and InfluxQL queriesAPI / SDK / developer guide | 使用支援 SQL 或 InfluxQL 端點查詢資料庫。分析開發者 |
| 03 · API authenticationAPI / SDK / developer guide | 選擇正確權杖認證方式。用戶端開發者 |
| 04 · Token lifecycleAPI / SDK / developer guide | 建立、管理與撤銷認證權杖。資料庫管理者 |
| 05 · Database managementAPI / SDK / developer guide | 建立／列出資料庫並設定保留期限。平台管理者 |
| 06 · Table schema managementAPI / SDK / developer guide | 管理資料表定義與欄位。結構設計者 |
| 07 · Distinct Value CacheAPI / SDK / developer guide | 設定不同欄位值的快取。篩選介面開發者 |
| 08 · Last Value CacheAPI / SDK / developer guide | 依選定鍵欄位快取最近欄位值。最新狀態儀表板開發者 |
| 09 · Processing engine triggersAPI / SDK / developer guide | 設定 Python 外掛觸發器與請求處理器。事件處理開發者 |
| 10 · v1/v2 compatibility migrationAPI / SDK / developer guide | 將支援的舊用戶端操作對應至相容端點。遷移工程師 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
SQL and InfluxQL queries
| 目標讀者 TA | 分析開發者 |
|---|---|
| 官方文件能力 | 使用支援 SQL 或 InfluxQL 端點查詢資料庫。 |
| 輸入 → 輸出 | 查詢、參數與輸出格式 → 紀錄。 |
| 執行環境 | 資料庫讀取權限與選定回應剖析器。 |
| 本站選型評估 | 格式與端點結構不同；資料庫不存在不等於空資料。 |
| 本站建議驗證 | 驗證時間範圍、單位、空值與結果格式。 |
API / SDK / developer guide
API authentication
| 目標讀者 TA | 用戶端開發者 |
|---|---|
| 官方文件能力 | 選擇正確權杖認證方式。 |
| 輸入 → 輸出 | Authorization 標頭 → 認證後操作。 |
| 執行環境 | Bearer 適用各端點；相容認證方式適用範圍較窄。 |
| 本站選型評估 | v1 Basic 密碼欄位為授權權杖，並非一般帳號密碼。 |
| 本站建議驗證 | 確認端點認證方式，避免在 URL／記錄揭露權杖。 |
API / SDK / developer guide
Token lifecycle
| 目標讀者 TA | 資料庫管理者 |
|---|---|
| 官方文件能力 | 建立、管理與撤銷認證權杖。 |
| 輸入 → 輸出 | 權杖管理請求 → 中繼資料或撤銷。 |
| 執行環境 | 適當管理權限。 |
| 本站選型評估 | 管理權杖具有廣泛系統存取權限。 |
| 本站建議驗證 | 驗證預定範圍與到期／撤銷拒絕，報告不存密鑰。 |
API / SDK / developer guide
Database management
| 目標讀者 TA | 平台管理者 |
|---|---|
| 官方文件能力 | 建立／列出資料庫並設定保留期限。 |
| 輸入 → 輸出 | 資料庫設定 → 儲存後設定。 |
| 執行環境 | Core 伺服器與管理授權。 |
| 本站選型評估 | 保留期限變更影響可用歷史；移除期限代表無限保留。 |
| 本站建議驗證 | 讀回資料庫識別與明確保留政策。 |
API / SDK / developer guide
Table schema management
| 目標讀者 TA | 結構設計者 |
|---|---|
| 官方文件能力 | 管理資料表定義與欄位。 |
| 輸入 → 輸出 | 資料庫／資料表結構請求 → 結構結果。 |
| 執行環境 | 目標 Core 版本與允許的結構限制。 |
| 本站選型評估 | 不可假設 Core 具有 Enterprise 顯式結構強制功能。 |
| 本站建議驗證 | 以實際樣本遙測核對欄位型別與標籤設計。 |
API / SDK / developer guide
Distinct Value Cache
| 目標讀者 TA | 篩選介面開發者 |
|---|---|
| 官方文件能力 | 設定不同欄位值的快取。 |
| 輸入 → 輸出 | 資料庫／資料表／欄位 → 快取設定。 |
| 執行環境 | 授權快取管理端點。 |
| 本站選型評估 | 快取值不是所有歷史事件的完整稽核。 |
| 本站建議驗證 | 比較預期不同值與設定的快取範圍。 |
API / SDK / developer guide
Last Value Cache
| 目標讀者 TA | 最新狀態儀表板開發者 |
|---|---|
| 官方文件能力 | 依選定鍵欄位快取最近欄位值。 |
| 輸入 → 輸出 | 鍵／值欄位、數量與 TTL → 最新值快取。 |
| 執行環境 | 支援的 Core 版本與快取設定。 |
| 本站選型評估 | TTL 與設定數量限制快取可見範圍。 |
| 本站建議驗證 | 檢查鍵隔離與過時／到期值處理。 |
API / SDK / developer guide
Processing engine triggers
| 目標讀者 TA | 事件處理開發者 |
|---|---|
| 官方文件能力 | 設定 Python 外掛觸發器與請求處理器。 |
| 輸入 → 輸出 | 觸發事件／請求 → 外掛輸出或錯誤。 |
| 執行環境 | 安裝外掛、觸發規格與並行設定。 |
| 本站選型評估 | 錯誤政策可記錄、重試或停用；重試副作用需冪等。 |
| 本站建議驗證 | 分別驗證觸發執行與觸發器建立。 |
API / SDK / developer guide
v1/v2 compatibility migration
| 目標讀者 TA | 遷移工程師 |
|---|---|
| 官方文件能力 | 將支援的舊用戶端操作對應至相容端點。 |
| 輸入 → 輸出 | 舊工作負載 → 已審查的 Core 端點映射。 |
| 執行環境 | 固定用戶端／伺服器版本與遷移驗證。 |
| 本站選型評估 | 相容端點不代表完整 v1/v2 功能等同。 |
| 本站建議驗證 | 比較寫入、查詢語言、認證與錯誤語意。 |
Official documentation
| TA | 工程師與技術產品負責人 |
|---|---|
| 本站驗證建議 | 實作前固定版本並依目標環境核對支援條件。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
匯入／查詢契約示意。未執行資料庫、寫入、查詢或外掛；筆數與讀值均為虛構。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
寫入與讀回
| 輸入 | 兩行有效合成資料，明確指定秒精度。 |
|---|---|
| 預期結果 | 接受兩行；讀回符合標籤、時間戳與欄位值。 |
| 驗收條件 | 接受空白 204 本文；透過讀回證明映射。 |
空時間區間
| 輸入 | 有效查詢既有資料表，但範圍內無樣本。 |
|---|---|
| 預期結果 | rows=[]；不杜撰零值量測。 |
| 驗收條件 | 保留要求時間範圍，並區分資料庫不存在錯誤。 |
v3 部分寫入
| 輸入 | 混合有效／無效批次，accept_partial=true。 |
|---|---|
| 預期結果 | 錯誤包含拒絕行；有效行可能已儲存。 |
| 驗收條件 | 不可將 HTTP400 視為回復；重試前核對接受行。 |
要求整批拒絕
| 輸入 | 混合批次且 v3 accept_partial=false。 |
|---|---|
| 預期結果 | 整批遭拒；accepted_lines=0。 |
| 驗收條件 | 驗證該隔離批次識別的提交筆數為零。 |
將預期結果對應至你的應用
將實際執行環境回應對應至此建議應用契約。所有數值皆為示意，不含憑證或真實執行。
預期輸出 JSON — 示意，非實測 · InfluxDBAPI-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "InfluxDB 3 Core",
"status": "ok",
"input_id": "sample-001",
"data": {
"database": "demo_factory",
"table": "temperature",
"timestamp_precision": "s",
"submitted_lines": 2,
"accepted_lines": 2,
"rejected_lines": 0,
"readback_verified": true,
"rows": [
{
"time": "2026-10-08T00:00:00Z",
"sensor": "demo-1",
"temperature_c": 23.5
}
]
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 狀態語意 | 有效空結果與錯誤不同；等待中的工作不可提前顯示成功。 |
|---|---|
| 證據 | 記錄服務與 SDK 版本、請求識別、設定及回應映射。此處未執行或量測效能。 |
| 建議驗收 | 以授權代表樣本測試前，先約定數值誤差與負載目標。 |
開發評估
機台趨勢探索工具
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
可先做小原型
確認存取後，用少量真實樣本測試一個有文件的操作。此為開發判斷，不是交期估算。
- 原型輸入規劃
- 測試設備或模擬器、訊號對照表與明確單位。
- 原型交付規劃
- 附時間、資料新鮮度、單位與連線狀態的設備數值。
- 驗收條件
- 對照來源驗證比例與時間；設備斷線時不得顯示正常。
- 依賴條件
- 閘道或服務帳號、設備資料結構與測試環境。
開發順序
- 確認 InfluxDB HTTP API 的存取、授權與支援版本。
- 準備上述樣本，針對「機台趨勢探索工具」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。