# timeplus

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [connect-full.txt](https://docs.redpanda.com/connect-full.txt)

---
title: timeplus
latest-connect-version: 4.93.0
latest-operator-version: v26.1.4
latest-console-tag: v3.7.3
latest-redpanda-tag: v26.1.9
docname: inputs/timeplus
page-component-name: connect
page-version: master
page-component-version: master
page-component-title: Connect
page-relative-src-path: inputs/timeplus.adoc
page-edit-url: https://github.com/redpanda-data/rp-connect-docs/edit/main/modules/components/pages/inputs/timeplus.adoc
page-git-created-date: "2024-11-19"
page-git-modified-date: "2026-05-26"
---

<!-- Source: https://docs.redpanda.com/connect/components/inputs/timeplus.md -->

**Type:** Input ▼

[Input](https://docs.redpanda.com/connect/components/inputs/timeplus/)[Output](https://docs.redpanda.com/connect/components/outputs/timeplus/)

**Available in:** [Cloud](https://docs.redpanda.com/cloud-data-platform/develop/connect/components/inputs/timeplus/%20%22View%20the%20Cloud%20version%20of%20this%20component%22), Self-Managed

Executes a streaming or table query on [Timeplus Enterprise (Cloud or Self-Hosted)](https://docs.timeplus.com/) or the `timeplusd` component, and creates a structured message for each table row received.

If you execute a streaming query, this input runs until the query terminates. For table queries, it shuts down after all rows returned by the query are exhausted.

```yml
inputs:
  label: ""
  timeplus:
    query: "" # No default (required)
    url: tcp://localhost:8463
    workspace: "" # No default (optional)
    apikey: "" # No default (optional)
    username: "" # No default (optional)
    password: "" # No default (optional)
```

## [](#examples)Examples

### [](#from-timeplus-enterprise-cloud-via-http)From Timeplus Enterprise Cloud via HTTP

You will need to create API Key on Timeplus Enterprise Cloud Web console first and then set the `apikey` field.

```yaml
input:
  timeplus:
    url: https://us-west-2.timeplus.cloud
    workspace: my_workspace_id
    query: select * from iot
    apikey: <Your API Key>
```

### [](#from-timeplus-enterprise-self-hosted-via-http)From Timeplus Enterprise (self-hosted) via HTTP

For self-hosted Timeplus Enterprise, you will need to specify the username and password as well as the URL of the App server

```yaml
input:
  timeplus:
    url: http://localhost:8000
    workspace: my_workspace_id
    query: select * from iot
    username: username
    password: pw
```

### [](#from-timeplus-enterprise-self-hosted-via-tcp)From Timeplus Enterprise (self-hosted) via TCP

Make sure the the schema of url is tcp

```yaml
input:
  timeplus:
    url: tcp://localhost:8463
    query: select * from iot
    username: timeplus
    password: timeplus
```

## [](#fields)Fields

### [](#apikey)`apikey`

The API key for the Timeplus Enterprise REST API. You need to generate the key in the web console of Timeplus Enterprise (Cloud). This field is required if you are reading messages from Timeplus Enterprise (Cloud).

> ⚠️ **CAUTION**
>
> This field contains sensitive information that usually shouldn’t be added to a configuration directly. For more information, see [Secrets](https://docs.redpanda.com/connect/configuration/secrets/).

**Type**: `string`

### [](#password)`password`

The password for the Timeplus application server. This field is required if you are reading messages from Timeplus Enterprise (Self-Hosted) or `timeplusd`.

> ⚠️ **CAUTION**
>
> This field contains sensitive information that usually shouldn’t be added to a configuration directly. For more information, see [Secrets](https://docs.redpanda.com/connect/configuration/secrets/).

**Type**: `string`

### [](#query)`query`

The query to execute on Timeplus Enterprise (Cloud or Self-Hosted) or `timeplusd`.

**Type**: `string`

```yaml
# Examples:
query: select * from iot

# ---

query: select count(*) from table(iot)
```

### [](#url)`url`

The URL of your Timeplus instance, which should always include the schema and host.

**Type**: `string`

**Default**: `tcp://localhost:8463`

### [](#username)`username`

The username for the Timeplus application server. This field is required if you are reading messages from Timeplus Enterprise (Self-Hosted) or `timeplusd`.

**Type**: `string`

### [](#workspace)`workspace`

The ID of the workspace you want to read messages from. This field is required if you are connecting to Timeplus Enterprise (Cloud or Self-Hosted) using HTTP.

**Type**: `string`