SAService Architect Back to designer
SAService ArchitectDocumentation
Scheduling & TemporalTemporal
Scheduling guide type: Temporal

Temporal connector

Owns the Temporal connection, Activity and Workflow workers, durable submission clients, and Worker shutdown policy.

When to use

Use this page while designing, implementing, operating, or troubleshooting scheduled and durable execution.

Behavior

  • One managed connector instance is built per configured connector.
  • Workers start before datasource admission.
  • Worker concurrency is derived from the endpoints registered on each Task Queue, not from connector-level fields.
  • Worker admission stops after ordinary Sources drain; clients remain until outbound Sinks finish.

Connection properties

Cluster and namespace.

PropertyTypeDescription
addressstring

Temporal frontend address.

RequiredDefault: temporal:7233
namespacestring

Temporal namespace.

RequiredDefault: default
identitystring

Worker/client identity override.

apiKeystring

Authentication API key.

TLS properties

Conditional transport security.

PropertyTypeDescription
tlsEnabledboolean

Enables TLS.

Default: false
tlsServerNamestring

Expected server name.

When tlsEnabled is true.
tlsCaFilestring

CA certificate path.

When tlsEnabled is true.
tlsCertFilestring

Client certificate path.

When tlsEnabled is true.
tlsKeyFilestring

Client key path.

When tlsEnabled is true.

Worker shutdown properties

Connector-level drain policy. Concurrency belongs to Temporal endpoints.

PropertyTypeDescription
workerStopTimeoutmilliseconds

Maximum Worker drain time. Zero inherits the owning service shutdownTimeout; a positive value cannot exceed it.

Default: 0Minimum: 0

Implementation properties

Allowed adapters.

PropertyTypeDescription
goImplementationenum

Go SDK adapter.

RequiredAllowed: temporal/go
pythonImplementationenum

Python SDK adapter.

RequiredAllowed: temporal/python
typeScriptImplementationenum

TypeScript SDK adapter.

RequiredAllowed: temporal/typescript

Product-level example

type: Temporal
address: temporal:7233
namespace: default
workerStopTimeout: 0