# Leitura de entidades do CircleCI
<a name="circleci-reading-from-entities"></a>

**Pré-requisito**

Um objeto do CircleCI do qual você deseja ler. Você precisará do nome do objeto.

**Entidades compatíveis quanto à origem**:


| Entidade | Pode ser filtrada | Oferece suporte a limite | Oferece suporte a Ordenar por | Oferece suporte a Selecionar \* | Oferece suporte a particionamento | 
| --- | --- | --- | --- | --- | --- | 
| Contexto | Sim | Não | Não | Sim | Não | 
| Métrica de resumo da organização | Sim | Não | Não | Sim | Não | 
| Pipeline | Não | Não | Não | Sim | Não | 
| Fluxo de trabalho do pipeline | Sim | Não | Não | Sim | Não | 
| Ramificação do projeto | Sim | Não | Não | Sim | Não | 
| Teste instável do projeto | Não | Não | Não | Sim | Não | 
| Métrica de resumo do projeto | Sim | Não | Não | Sim | Não | 
| Programação | Não | Não | Não | Sim | Não | 
| Séries temporais de trabalhos do fluxo de trabalho | Sim | Não | Não | Sim | Não | 
| Métrica e tendência do fluxo de trabalho | Sim | Não | Não | Sim | Não | 
| Execução recente do fluxo de trabalho | Sim | Não | Não | Sim | Não | 
| Métrica de resumo do fluxo de trabalho | Sim | Não | Não | Sim | Não | 
| Métrica de teste do fluxo de trabalho | Sim | Não | Não | Sim | Não | 

**Exemplo:**

```
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"
    }
```

## Detalhes das entidades e dos campos do CircleCI
<a name="circleci-reading-from-entities-field-details"></a>

Para obter mais informações sobre os detalhes das entidades e dos campos, consulte:
+ [Contextos](https://circleci.com/docs/api/v2/#operation/listContexts)
+ [Métricas de resumo do projeto](https://circleci.com/docs/api/v2/#operation/getProjectWorkflowsPageData)
+ [Séries temporais de trabalhos do fluxo de trabalho](https://circleci.com/docs/api/v2/#operation/getJobTimeseries)
+ [Métricas de resumo da organização](https://circleci.com/docs/api/v2/#operation/getOrgSummaryData)
+ [Ramificações do projeto](https://circleci.com/docs/api/v2/#operation/getAllInsightsBranches)
+ [Testes instáveis do projeto](https://circleci.com/docs/api/v2/#operation/getFlakyTests)
+ [Execuções recentes do fluxo de trabalho](https://circleci.com/docs/api/v2/#operation/getProjectWorkflowRuns)
+ [Métricas de resumo do fluxo de trabalho](https://circleci.com/docs/api/v2/#operation/getProjectWorkflowMetrics)
+ [Métricas e tendências do fluxo de trabalho](https://circleci.com/docs/api/v2/#operation/getWorkflowSummary)
+ [Métricas de teste do fluxo de trabalho](https://circleci.com/docs/api/v2/#operation/getProjectWorkflowTestMetrics)
+ [Pipelines](https://circleci.com/docs/api/v2/#operation/listPipelinesForProject)
+ [Fluxos de trabalho do pipeline](https://circleci.com/docs/api/v2/#operation/listWorkflowsByPipelineId)
+ [Programações](https://circleci.com/docs/api/v2/#operation/listSchedulesForProject)

Entidades com metadados estáticos:



- **Contexto**
  - **Campo:** Criado em / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** ID / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Name / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Tipo de proprietário / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO

- **Métrica de resumo da organização**
  - **Campo:** Todos os projetos / **Tipo de dados:** Lista / **Operadores compatíveis:** 
  - **Campo:** Dados da organização / **Tipo de dados:** Struct / **Operadores compatíveis:** 
  - **Campo:** Dados do projeto da organização / **Tipo de dados:** Lista / **Operadores compatíveis:** 
  - **Campo:** Nomes de projetos / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** Janela de relatórios / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO

- **Pipeline**
  - **Campo:** Ramificação / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** Criado em / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Erros / **Tipo de dados:** Lista / **Operadores compatíveis:** 
  - **Campo:** ID / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Número / **Tipo de dados:** Inteiro / **Operadores compatíveis:** 
  - **Campo:** Slug do projeto / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Estado / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Trigger / **Tipo de dados:** Struct / **Operadores compatíveis:** 
  - **Campo:** Parâmetros de gatilhos / **Tipo de dados:** Struct / **Operadores compatíveis:** 
  - **Campo:** Atualizado em / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** VCS / **Tipo de dados:** Struct / **Operadores compatíveis:** 

- **Fluxo de trabalho do pipeline**
  - **Campo:** Cancelado por / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Criado em / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Erro causado por / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** ID / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Name / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** ID do pipeline / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Número do pipeline / **Tipo de dados:** Inteiro / **Operadores compatíveis:** 
  - **Campo:** Slug do projeto / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Iniciado por / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Status / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Parado em / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Tag / **Tipo de dados:** String / **Operadores compatíveis:** 

- **Ramificação do projeto**
  - **Campo:** Ramificações / **Tipo de dados:** Lista / **Operadores compatíveis:** 
  - **Campo:** ID da organização / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** ID do projeto / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Nome do fluxo de trabalho / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO

- **Teste instável do projeto**
  - **Campo:** Nome da classe / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Arquivo / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Nome do trabalho / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Número do trabalho / **Tipo de dados:** Inteiro / **Operadores compatíveis:** 
  - **Campo:** Número do pipeline / **Tipo de dados:** Inteiro / **Operadores compatíveis:** 
  - **Campo:** Origem / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Nome do teste / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Tempo desperdiçado / **Tipo de dados:** Inteiro / **Operadores compatíveis:** 
  - **Campo:** Ocorrências com falha / **Tipo de dados:** Inteiro / **Operadores compatíveis:** 
  - **Campo:** Fluxo de trabalho criado em / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** ID do fluxo de trabalho / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Nome do fluxo de trabalho / **Tipo de dados:** String / **Operadores compatíveis:** 

- **Métrica de resumo do projeto**
  - **Campo:** Todas as ramificações / **Tipo de dados:** Lista / **Operadores compatíveis:** 
  - **Campo:** Todos os fluxos de trabalho / **Tipo de dados:** Lista / **Operadores compatíveis:** 
  - **Campo:** Ramificações / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** ID da organização / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Dados do projeto / **Tipo de dados:** Struct / **Operadores compatíveis:** 
  - **Campo:** ID do projeto / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Dados da ramificação do fluxo de trabalho do projeto / **Tipo de dados:** Lista / **Operadores compatíveis:** 
  - **Campo:** Dados de fluxos de trabalho do projeto / **Tipo de dados:** Lista / **Operadores compatíveis:** 
  - **Campo:** Janela de relatórios / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** Nomes de fluxos de trabalho / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO

- **Programação**
  - **Campo:** Ator / **Tipo de dados:** Struct / **Operadores compatíveis:** 
  - **Campo:** Criado em / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Descrição / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** ID / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Name / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Parâmetros / **Tipo de dados:** Struct / **Operadores compatíveis:** 
  - **Campo:** Slug do projeto / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Cronograma / **Tipo de dados:** Struct / **Operadores compatíveis:** 
  - **Campo:** Atualizado em / **Tipo de dados:** String / **Operadores compatíveis:** 

- **Séries temporais de trabalhos do fluxo de trabalho**
  - **Campo:** Ramificação / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** Granularity / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** Término máximo em / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Métricas / **Tipo de dados:** Struct / **Operadores compatíveis:** 
  - **Campo:** Início mínimo em / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Name / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Data de início e término / **Tipo de dados:** DateTime / **Operadores compatíveis:** EQUAL\_TO, BETWEEN
  - **Campo:** Timestamp / **Tipo de dados:** String / **Operadores compatíveis:** 

- **Métrica e tendência do fluxo de trabalho**
  - **Campo:** Todas as ramificações / **Tipo de dados:** Booleano / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** Ramificações / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** Métricas / **Tipo de dados:** Struct / **Operadores compatíveis:** 
  - **Campo:** Tendências / **Tipo de dados:** Struct / **Operadores compatíveis:** 
  - **Campo:** Nomes de fluxos de trabalho / **Tipo de dados:** Lista / **Operadores compatíveis:** 

- **Execução recente do fluxo de trabalho**
  - **Campo:** Todas as ramificações / **Tipo de dados:** Booleano / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** Ramificação / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** Criado em / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Créditos usados / **Tipo de dados:** Inteiro / **Operadores compatíveis:** 
  - **Campo:** Duração / **Tipo de dados:** Inteiro / **Operadores compatíveis:** 
  - **Campo:** ID / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** É aprovação / **Tipo de dados:** Booleano / **Operadores compatíveis:** 
  - **Campo:** Data de início e término / **Tipo de dados:** DateTime / **Operadores compatíveis:** EQUAL\_TO, BETWEEN
  - **Campo:** Status / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Parado em / **Tipo de dados:** String / **Operadores compatíveis:** 

- **Métrica de resumo do fluxo de trabalho**
  - **Campo:** Todas as ramificações / **Tipo de dados:** Booleano / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** Ramificação / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** Métricas / **Tipo de dados:** Struct / **Operadores compatíveis:** 
  - **Campo:** Name / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** ID do projeto / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Janela de relatórios / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** Fim da janela / **Tipo de dados:** String / **Operadores compatíveis:** 
  - **Campo:** Início da janela / **Tipo de dados:** String / **Operadores compatíveis:** 

- **Métrica de teste do fluxo de trabalho**
  - **Campo:** Contagem média de testes / **Tipo de dados:** Inteiro / **Operadores compatíveis:** 
  - **Campo:** Ramificação / **Tipo de dados:** String / **Operadores compatíveis:** EQUAL\_TO
  - **Campo:** Testes com mais falhas / **Tipo de dados:** Lista / **Operadores compatíveis:** 
  - **Campo:** Testes com mais falhas adicionais / **Tipo de dados:** Inteiro / **Operadores compatíveis:** 
  - **Campo:** Testes mais lentos / **Tipo de dados:** Lista / **Operadores compatíveis:** 
  - **Campo:** Testes mais lentos adicionais / **Tipo de dados:** Inteiro / **Operadores compatíveis:** 
  - **Campo:** Execuções de testes / **Tipo de dados:** Lista / **Operadores compatíveis:** 
  - **Campo:** Total de execuções de testes / **Tipo de dados:** Inteiro / **Operadores compatíveis:** 



**nota**  
Os tipos de dados Struct e List são convertidos no tipo de dados String na resposta do conector.

**Particionamento de consultas**

O CircleCI não oferece suporte ao particionamento baseado em campos ou em registros.