本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 從 CircleCI 實體讀取
<a name="circleci-reading-from-entities"></a>

**必要條件**

您想要從中讀取的 CircleCI 物件。將需要物件名稱。

**來源的支援實體**：


| 實體 | 可以篩選 | 支援限制 | 支援排序依據 | 支援選取 \* | 支援分區 | 
| --- | --- | --- | --- | --- | --- | 
| Context | 是 | 否 | 否 | 是 | 否 | 
| 組織摘要指標 | 是 | 否 | 否 | 是 | 否 | 
| 管道 | 否 | 否 | 否 | 是 | 否 | 
| 管道工作流程 | 是 | 否 | 否 | 是 | 否 | 
| 專案分支 | 是 | 否 | 否 | 是 | 否 | 
| 專案不穩定的測試 | 否 | 否 | 否 | 是 | 否 | 
| 專案摘要指標 | 是 | 否 | 否 | 是 | 否 | 
| Schedule | 否 | 否 | 否 | 是 | 否 | 
| 工作流程任務時間序列 | 是 | 否 | 否 | 是 | 否 | 
| 工作流程指標和趨勢 | 是 | 否 | 否 | 是 | 否 | 
| 工作流程最近執行 | 是 | 否 | 否 | 是 | 否 | 
| 工作流程摘要指標 | 是 | 否 | 否 | 是 | 否 | 
| 工作流程測試指標 | 是 | 否 | 否 | 是 | 否 | 

**範例**：

```
circleci_read = glueContext.create_dynamic_frame.from_options(
    connection_type="circleci",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "context/e7ea2945-dccb-4205-b673-8391fe1b3a4c",
        "API_VERSION": "v2"
    }
```

## CircleCI 實體和欄位詳細資訊
<a name="circleci-reading-from-entities-field-details"></a>

如需實體和欄位詳細資訊的更多資訊，請參閱：
+ [內容](https://circleci.com/docs/api/v2/#operation/listContexts)
+ [專案摘要指標](https://circleci.com/docs/api/v2/#operation/getProjectWorkflowsPageData)
+ [工作流程任務時間序列](https://circleci.com/docs/api/v2/#operation/getJobTimeseries)
+ [組織摘要指標](https://circleci.com/docs/api/v2/#operation/getOrgSummaryData)
+ [專案分支](https://circleci.com/docs/api/v2/#operation/getAllInsightsBranches)
+ [專案不穩定的測試](https://circleci.com/docs/api/v2/#operation/getFlakyTests)
+ [工作流程最近執行](https://circleci.com/docs/api/v2/#operation/getProjectWorkflowRuns)
+ [工作流程摘要指標](https://circleci.com/docs/api/v2/#operation/getProjectWorkflowMetrics)
+ [工作流程指標和趨勢](https://circleci.com/docs/api/v2/#operation/getWorkflowSummary)
+ [工作流程測試指標](https://circleci.com/docs/api/v2/#operation/getProjectWorkflowTestMetrics)
+ [管道](https://circleci.com/docs/api/v2/#operation/listPipelinesForProject)
+ [管道工作流程](https://circleci.com/docs/api/v2/#operation/listWorkflowsByPipelineId)
+ [排程](https://circleci.com/docs/api/v2/#operation/listSchedulesForProject)

具有靜態中繼資料的實體：



- **Context**
  - **欄位:** 建立時間 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** ID / **資料類型:** String / **支援的運算子:** 
  - **欄位:** Name / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 擁有者類型 / **資料類型:** String / **支援的運算子:** EQUAL\_TO

- **組織摘要指標**
  - **欄位:** 所有專案 / **資料類型:** 清單 / **支援的運算子:** 
  - **欄位:** 組織資料 / **資料類型:** Struct / **支援的運算子:** 
  - **欄位:** 組織專案資料 / **資料類型:** 清單 / **支援的運算子:** 
  - **欄位:** 專案名稱 / **資料類型:** String / **支援的運算子:** EQUAL\_TO
  - **欄位:** 報告時段 / **資料類型:** String / **支援的運算子:** EQUAL\_TO

- **管道**
  - **欄位:** 分支 / **資料類型:** String / **支援的運算子:** EQUAL\_TO
  - **欄位:** 建立時間 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 錯誤 / **資料類型:** 清單 / **支援的運算子:** 
  - **欄位:** ID / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 數字 / **資料類型:** Integer / **支援的運算子:** 
  - **欄位:** 專案動態資料欄位 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** State / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 觸發條件 / **資料類型:** Struct / **支援的運算子:** 
  - **欄位:** 觸發參數 / **資料類型:** Struct / **支援的運算子:** 
  - **欄位:** 更新時間 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** VCS / **資料類型:** Struct / **支援的運算子:** 

- **管道工作流程**
  - **欄位:** 取消者 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 建立時間 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 錯誤者 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** ID / **資料類型:** String / **支援的運算子:** 
  - **欄位:** Name / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 管道 ID / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 管道號碼 / **資料類型:** Integer / **支援的運算子:** 
  - **欄位:** 專案動態資料欄位 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 啟動者 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 狀態 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 停止時間 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** Tag / **資料類型:** String / **支援的運算子:** 

- **專案分支**
  - **欄位:** 分支 / **資料類型:** 清單 / **支援的運算子:** 
  - **欄位:** 組織 ID / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 專案 ID / **資料類型:** String / **支援的運算子:** 
  - **欄位:** Workflow Name (工作流程名稱) / **資料類型:** String / **支援的運算子:** EQUAL\_TO

- **專案不穩定的測試**
  - **欄位:** 類別名稱 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 檔案 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 工作名稱 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 任務編號 / **資料類型:** Integer / **支援的運算子:** 
  - **欄位:** 管道號碼 / **資料類型:** Integer / **支援的運算子:** 
  - **欄位:** 來源 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 測試名稱 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 浪費的時間 / **資料類型:** Integer / **支援的運算子:** 
  - **欄位:** 錯誤次數 / **資料類型:** Integer / **支援的運算子:** 
  - **欄位:** 工作流程建立時間 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 工作流程 ID / **資料類型:** String / **支援的運算子:** 
  - **欄位:** Workflow Name (工作流程名稱) / **資料類型:** String / **支援的運算子:** 

- **專案摘要指標**
  - **欄位:** 所有分支 / **資料類型:** 清單 / **支援的運算子:** 
  - **欄位:** 所有工作流程 / **資料類型:** 清單 / **支援的運算子:** 
  - **欄位:** 分支 / **資料類型:** String / **支援的運算子:** EQUAL\_TO
  - **欄位:** 組織 ID / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 專案資料 / **資料類型:** Struct / **支援的運算子:** 
  - **欄位:** 專案 ID / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 專案工作流程分支資料 / **資料類型:** 清單 / **支援的運算子:** 
  - **欄位:** 專案工作流程資料 / **資料類型:** 清單 / **支援的運算子:** 
  - **欄位:** 報告時段 / **資料類型:** String / **支援的運算子:** EQUAL\_TO
  - **欄位:** 工作流程名稱 / **資料類型:** String / **支援的運算子:** EQUAL\_TO

- **Schedule**
  - **欄位:** Actor / **資料類型:** Struct / **支援的運算子:** 
  - **欄位:** 建立時間 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** Description / **資料類型:** String / **支援的運算子:** 
  - **欄位:** ID / **資料類型:** String / **支援的運算子:** 
  - **欄位:** Name / **資料類型:** String / **支援的運算子:** 
  - **欄位:** Parameters / **資料類型:** Struct / **支援的運算子:** 
  - **欄位:** 專案動態資料欄位 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 時間表 / **資料類型:** Struct / **支援的運算子:** 
  - **欄位:** 更新時間 / **資料類型:** String / **支援的運算子:** 

- **工作流程任務時間序列**
  - **欄位:** 分支 / **資料類型:** String / **支援的運算子:** EQUAL\_TO
  - **欄位:** 精細程度 / **資料類型:** String / **支援的運算子:** EQUAL\_TO
  - **欄位:** 結束時間上限 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 指標 / **資料類型:** Struct / **支援的運算子:** 
  - **欄位:** 開始時間下限 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** Name / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 開始/結束日期 / **資料類型:** DateTime / **支援的運算子:** EQUAL\_TO, BETWEEN
  - **欄位:** 時間戳記 / **資料類型:** String / **支援的運算子:** 

- **工作流程指標和趨勢**
  - **欄位:** 所有分支 / **資料類型:** Boolean / **支援的運算子:** EQUAL\_TO
  - **欄位:** 分支 / **資料類型:** String / **支援的運算子:** EQUAL\_TO
  - **欄位:** 指標 / **資料類型:** Struct / **支援的運算子:** 
  - **欄位:** 趨勢 / **資料類型:** Struct / **支援的運算子:** 
  - **欄位:** 工作流程名稱 / **資料類型:** 清單 / **支援的運算子:** 

- **工作流程最近執行**
  - **欄位:** 所有分支 / **資料類型:** Boolean / **支援的運算子:** EQUAL\_TO
  - **欄位:** 分支 / **資料類型:** String / **支援的運算子:** EQUAL\_TO
  - **欄位:** 建立時間 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 使用的抵用金 / **資料類型:** Integer / **支援的運算子:** 
  - **欄位:** 持續時間 / **資料類型:** Integer / **支援的運算子:** 
  - **欄位:** ID / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 為核准 / **資料類型:** Boolean / **支援的運算子:** 
  - **欄位:** 開始/結束日期 / **資料類型:** DateTime / **支援的運算子:** EQUAL\_TO, BETWEEN
  - **欄位:** 狀態 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 停止時間 / **資料類型:** String / **支援的運算子:** 

- **工作流程摘要指標**
  - **欄位:** 所有分支 / **資料類型:** Boolean / **支援的運算子:** EQUAL\_TO
  - **欄位:** 分支 / **資料類型:** String / **支援的運算子:** EQUAL\_TO
  - **欄位:** 指標 / **資料類型:** Struct / **支援的運算子:** 
  - **欄位:** Name / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 專案 ID / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 報告時段 / **資料類型:** String / **支援的運算子:** EQUAL\_TO
  - **欄位:** 時段結束時間 / **資料類型:** String / **支援的運算子:** 
  - **欄位:** 時段開始時間 / **資料類型:** String / **支援的運算子:** 

- **工作流程測試指標**
  - **欄位:** 平均測試計數 / **資料類型:** Integer / **支援的運算子:** 
  - **欄位:** 分支 / **資料類型:** String / **支援的運算子:** EQUAL\_TO
  - **欄位:** 失敗最多的測試 / **資料類型:** 清單 / **支援的運算子:** 
  - **欄位:** 失敗最多的額外測試 / **資料類型:** Integer / **支援的運算子:** 
  - **欄位:** 最慢的測試 / **資料類型:** 清單 / **支援的運算子:** 
  - **欄位:** 最慢的額外測試 / **資料類型:** Integer / **支援的運算子:** 
  - **欄位:** 測試執行 / **資料類型:** 清單 / **支援的運算子:** 
  - **欄位:** 測試執行總數 / **資料類型:** Integer / **支援的運算子:** 



**注意**  
在連接器的回應中，Struct 和 List 資料類型會轉換為 String 資料類型。

**分區查詢**

CircleCI 不支援欄位型分區或記錄型分區。