Skip to content

docs: connection pool options for Oracle state store #5221

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nelson-parente wants to merge 3 commits into
base: v1.19
Choose a base branch
from
+4 −0
Open

docs: connection pool options for Oracle state store #5221

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
f786b99
docs: document connection pool options for Oracle state store
nelson-parente Jun 17, 2026
c284594
docs(oracle): fix metadata table formatting and maxIdleConns default …
nelson-parente Jun 18, 2026
259fe35
docs(oracle): match existing table style for new field names (Copilot…
nelson-parente Jun 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions ...n/reference/components-reference/supported-state-stores/setup-oracledatabase.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,10 @@ The above example uses secrets as plain strings. It is recommended to use a secr
| tableName | N | Name of the database table in which this instance of the state store records the data default `"STATE"`| `"MY_APP_STATE_STORE"`
| bulkGetChunkSize | N | Maximum number of keys per internal SQL query when using BulkGet. When the total number of requested keys exceeds this value, multiple chunked queries are executed sequentially. Valid values are between 1 and 1000 ([Oracle's IN-list expression limit](https://docs.oracle.com/en/database/oracle/oracle-database/21/sqlrf/IN-Condition.html)). Values less than or equal to 0 use the default. Values above 1000 are chunked with a warning log. Defaults to `"1000"` | `"100"`
| actorStateStore | N | Consider this state store for actors. Defaults to `"false"` | `"true"`, `"false"`
| maxOpenConns | N | Maximum number of open connections to the database. Defaults to unlimited (Go default: `0`) | `"10"`
| maxIdleConns | N | Maximum number of idle connections in the connection pool. Defaults to Go default (`2`) | `"5"`
| connMaxLifetime | N | Maximum lifetime of a connection as a [Go duration](https://pkg.go.dev/time#ParseDuration). Defaults to connections being reused forever | `"30s"`, `"5m"`
| connMaxIdleTime | N | Maximum idle time for a connection before it is closed, as a [Go duration](https://pkg.go.dev/time#ParseDuration). Defaults to no limit | `"5m"`

## What Happens at Runtime?
When the state store component initializes, it connects to the Oracle Database and checks if a table with the name specified with `tableName` exists. If it does not, it creates this table (with columns Key, Value, Binary_YN, ETag, Creation_Time, Update_Time, Expiration_time).
Expand Down
Loading