> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisdom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connection

This page describes the schema used for data source connections, including all fields, types, and enums.

## Connection

<ParamField path="id" type="ID!" required>
  Unique identifier for the connection.
</ParamField>

<ParamField path="details" type="ConnectionDetails!" required>
  Configuration and metadata for the connection. See [ConnectionDetails](#connectiondetails).
</ParamField>

<ParamField path="status" type="JobHistory!" required>
  Job execution history for connection operations like metadata refresh. See [JobStatus](/integrations/graphql-api/objects/job-status).
</ParamField>

<ParamField path="createdAt" type="DateTime!" required>
  Timestamp when the connection was created.
</ParamField>

## ConnectionDetails

<ParamField path="name" type="String!" required>
  Human-readable name for the connection.
</ParamField>

<ParamField path="description" type="String!" required>
  Description of the connection and its purpose.
</ParamField>

<ParamField path="dataSourceType" type="DataSourceType!" required>
  The category of data source. See [DataSourceType](#datasourcetype).
</ParamField>

<ParamField path="connectionType" type="ConnectionType!" required>
  The specific type of data source connection. See [ConnectionType](#connectiontype).
</ParamField>

<ParamField path="dialect" type="String!" required>
  The SQL dialect used by this connection.
</ParamField>

## Enums

### DataSourceType

The category of data source. It accepts the following values:

| Data Source Type               | Description                                           |
| ------------------------------ | ----------------------------------------------------- |
| `DATA_SOURCE_TYPE_UNSPECIFIED` | Type not specified                                    |
| `WAREHOUSE`                    | Data warehouse (Snowflake, BigQuery, Redshift, etc.)  |
| `BI_TOOL`                      | Business intelligence tool (Tableau, etc.)            |
| `FILE`                         | File-based data source (S3, Azure Blob Storage, etc.) |
| `DATA_SOURCE_MCP_SERVER`       | MCP server data source                                |

### ConnectionType

The specific type of data source connection. It accepts the following values:

| Connection Type               | Description                            |
| :---------------------------- | :------------------------------------- |
| `CONNECTION_TYPE_UNSPECIFIED` | Type not specified                     |
| `REDSHIFT`                    | Amazon Redshift data warehouse         |
| `SNOWFLAKE`                   | Snowflake data warehouse               |
| `TABLEAU`                     | Tableau business intelligence platform |
| `BIGQUERY`                    | Google BigQuery data warehouse         |
| `POSTGRES`                    | PostgreSQL database                    |
| `SQL_SERVER`                  | Microsoft SQL Server database          |
| `DATABRICKS`                  | Databricks analytics platform          |
| `MYSQL`                       | MySQL database                         |
| `CLICKHOUSE`                  | ClickHouse database                    |
| `ATHENA`                      | Amazon Athena query service            |
| `S3`                          | Amazon S3 file storage                 |
| `MCP_SERVER`                  | MCP server connection                  |
| `AZURE_SYNAPSE`               | Azure Synapse Analytics                |
| `AZURE_BLOB_STORAGE`          | Azure Blob Storage                     |
| `TRINO`                       | Trino distributed SQL query engine     |
| `AZURE_SYNAPSE_SERVERLESS`    | Azure Synapse Analytics Serverless     |
| `SHAREPOINT`                  | Microsoft SharePoint                   |
| `SPANNER`                     | Google Cloud Spanner                   |
| `TERADATA`                    | Teradata database                      |
| `DUCKDB`                      | DuckDB embedded database               |

## Related operations

<CardGroup cols={2}>
  <Card title="Connection Queries" icon="magnifying-glass" href="/integrations/graphql-api/queries/connection/connection">
    Query connection information and status
  </Card>

  <Card title="JobStatus Schema" icon="clock" href="/integrations/graphql-api/objects/job-status">
    Learn about job execution status tracking
  </Card>

  <Card title="Refresh Connection" icon="arrows-rotate" href="/integrations/graphql-api/mutations/connection/refresh-connection">
    Trigger connection metadata refresh
  </Card>

  <Card title="Domain Objects" icon="folder" href="/integrations/graphql-api/objects/domain-model">
    Understand domain and table management
  </Card>
</CardGroup>