
ScyllaDB Queries
CertifiedExecute SELECT statements sequentially in ScyllaDB
ScyllaDB Queries
Execute SELECT statements sequentially in ScyllaDB
Runs SELECT statements in their supplied order using one session, returning one output per statement. Queries do not share a transactional snapshot.
type: io.kestra.plugin.scylladb.QueriesExamples
Read cluster and data center information in order
id: scylladb_queries
namespace: company.team
tasks:
- id: queries
type: io.kestra.plugin.scylladb.Queries
connection:
contactPoints:
- "{{ secret('SCYLLADB_HOST') }}:9042"
localDatacenter: datacenter1
username: "{{ secret('SCYLLADB_USERNAME') }}"
password: "{{ secret('SCYLLADB_PASSWORD') }}"
cql:
- SELECT cluster_name FROM system.local
- SELECT data_center FROM system.local
fetchType: FETCH_ONE
fetchSize: 100
Properties
connection *
Native CQL connection settings, including contact points, local datacenter, authentication, and optional TLS.
ScyllaDB connection
Native CQL connection settings rendered at task execution.
Contact points
Non-empty list of hosts, host: port, or [IPv6]: port addresses. The default port is 9042.
Local datacenter
Datacenter used by the driver's load balancing policy, for example datacenter1.
Keyspace
Optional default keyspace. Omit when creating a keyspace with DDL.
passwordClient keystore password
Optional client keystore password. Requires keystorePath. Use a Kestra secret expression.
Client keystore path
Optional JKS client keystore path on the worker filesystem for mutual TLS. Requires TLS.
passwordPassword
Native CQL authentication password. Use a Kestra secret expression.
Request timeout
Optional strictly positive CQL request timeout as an ISO-8601 duration, for example PT30S. Otherwise the driver default applies.
falseEnable TLS
Enable certificate and hostname verification. Uses JVM trust roots unless a truststore is supplied.
passwordTruststore password
Optional truststore password. Requires truststorePath. Use a Kestra secret expression.
Truststore path
Optional JKS truststore path on the worker filesystem. Requires TLS.
Username
Native CQL authentication username. Set together with password; secret expressions are supported.
cql *array
Ordered CQL statements
A non-empty list of non-blank SELECT statements. All statements are rendered and validated before the first is executed. Named : name markers bind the shared parameters map.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150fetchSize integerstring
Driver page size
Optional positive page size applied to every statement. This does not limit the total number of rows; FETCH and STORE consume all pages.
fetchType string
FETCHSTOREFETCHFETCH_ONENONEResult fetch mode
Applied to every statement: FETCH returns all rows, FETCH_ONE returns at most one, STORE streams rows to a separate Ion file per statement.
parameters object
Bound parameters
Values for named : name markers in cql. Each value is rendered, then bound to a prepared statement using that marker's CQL type. Use this for flow inputs and upstream outputs instead of interpolating them into the statement text. Keys that are not markers of a statement are ignored.
Outputs
outputs array
Ordered statement results
One Query output per CQL statement, in the same order as the input statements.
io.kestra.plugin.scylladb.Query-Output
First fetched row
Populated for FETCH_ONE; null when the result is empty.
All fetched rows
Populated for FETCH in result order, including all pages.
Number of emitted rows
Zero or one for FETCH_ONE, or the total row count for FETCH and STORE.
uriStored result URI
Internal storage URI of the Ion file, populated for STORE.