COCKROACH-GEN-EXAMPLE-DATA-TPCCMULTIDB(1)

NAME

cockroach-gen-example-data-tpccmultidb - TPC-C simulates a transaction processing workload using a rich schema of multiple tables. This has been modified to run against multiple instances of the same schema

SYNOPSIS

cockroach gen example-data tpccmultidb [flags]

DESCRIPTION

TPC-C simulates a transaction processing workload using a rich schema of multiple tables. This has been modified to run against multiple instances of the same schema

OPTIONS

--active-warehouses=0
    Run the load generator against a specific number of warehouses. Defaults to --warehouses'

--active-workers=0
    Number of workers that can execute at any given time. Defaults to --workers'

--admin-urls=""
    a list of admin URLs, seperated by commas

--aost=""
    This is an optional parameter to specify AOST; used exclusively in conjunction with the TPC-C consistency check. Example values are ("'-1m'", "'-1h'")

--client-partitions=0
    Make client behave as if the tables are partitioned, but does not actually partition underlying data. Requires --partition-affinity.

--concurrency=40
    Number of concurrent workers

--conn-healthcheck-period=30s
    Interval that health checks are run on connections

--conn-vars=[]
    Session variables to configure on database connections

--conns=0
    Number of connections. Defaults to --warehouses * 2 (except in nowait mode, where it defaults to --workers

--console-api-file=""
    a list of commands to run at the start of each txn

--console-api-password=""
    password used to authenticate the console API

--console-api-username=""
    username used to authenticate the console API

--db=""
    Override for the SQL database to use. If empty, defaults to the generator name

--db-list-file=""
    a file containing a list of databases.

--dns-refresh=30s
    Interval used to refresh cached DNS entries ( disables)

--expensive-checks[=false]
    Run expensive checks

--families[=false]
    Use separate column families for dynamic and static columns

--fks[=true]
    Add the foreign keys

-h, --help[=false]
    help for tpccmultidb

--idle-conns=0
    Number of idle connections. Defaults to 0

--ignore-partitions[=false]
    Ignore partitions during load generation

--import-concurrency-limit=32
    limit for concurrency of import operations

--isolation-level=""
    Isolation level to run workload transactions under [serializable, snapshot, read_committed]. If unset, the workload will run with the default isolation level of the database.

--last-duration=0s
    The duration of the previous workload run (Used to determine which consistency checks to skip for long duration workloads).

--literal-implementation[=false]
    If true, use a literal implementation of the TPC-C kit instead of an optimized version

--local-warehouses[=false]
    Force transactions to use a local warehouse in all cases (in violation of the TPC-C specification)

--max-conn-idle-time=2m30s
    Max time an idle connection will be kept around

--max-conn-lifetime=5m0s
    Max connection lifetime

--max-conn-lifetime-jitter=2m30s
    Jitter max connection lifetime by this amount

--method="cache_statement"
    SQL issue method (cache_statement, cache_describe, describe_exec, exec, simple_protocol)

--min-conns=0
    Minimum number of connections to attempt to keep in the pool

--mix="newOrder=10,payment=10,orderStatus=1,delivery=1,stockLevel=1"
    Weights for the transaction mix. The default matches the TPCC spec.

--partition-affinity=[]
    Run load generator against specific partition (requires partitions). Note that if one value is provided, the assumption is that all urls are associated with that partition. In all other cases the assumption is that the URLs are distributed evenly over the partitions

--partition-strategy=replication
    Partition tables according to which strategy [replication, leases]

--partitions=1
    Partition tables

--query-trace-file=""
    File to write the query traces to. Defaults to no output

--regions=[]
    Regions to use for multi-region partitioning. The first region is the PRIMARY REGION. Does not work with --zones.

--repair-order-ids[=false]
    Attempt to repair next order id field of district rows automatically in reaction to unique violation during new-order txns (useful when running LDR on overlapping warehouses)

--replicate-static-columns[=false]
    Create duplicate indexes for all static columns in district, items and warehouse tables, such that each zone or rack has them locally.

--scatter[=false]
    Scatter ranges

--seed=5993806603444952214
    Random seed. Default changes in each run

--split[=false]
    Split tables

--survival-goal=zone
    Survival goal to use for multi-region setups. Allowed values: [zone, region].

--txn-preamble-file=""
    queries that will be injected before each txn

--txn-retries[=true]
    Run transactions in a retry loop

--wait=true
    Wait mode (include think/keying sleeps): 1/true for tpcc-standard wait, 0/false for no waits, other factors also allowed

--warehouses=1
    Number of warehouses for loading

--warmup-conns=0
    Number of connections to warmup in each connection pool

--workers=0
    Number of concurrent workers. Defaults to --warehouses * 10

--zones=[]
    Zones for legacy partitioning, the number of zones should match the number of partitions and the zones used to start cockroach. Does not work with --regions.

OPTIONS INHERITED FROM PARENT COMMANDS

--enterprise-require-fips-ready[=false]
    abort if FIPS readiness checks fail

--log=

Logging configuration, expressed using YAML syntax. For example, you can
 change the default logging directory with: --log='file-defaults: {dir: ...}'.
 See the documentation for more options and details. To preview how the log
 configuration is applied, or preview the default configuration, you can use
 the 'cockroach debug check-log-config' sub-command.

--log-config-file=

File name to read the logging configuration from. This has the same effect as
 passing the content of the file via the --log flag.

--log-config-vars=[]

Environment variables that will be expanded if present in the body of the
 logging configuration.

--log-dir=

--log-dir=XXX is an alias for --log='file-defaults: {dir: XXX}'.

--logtostderr[=UNKNOWN]

--logtostderr=XXX is an alias for --log='sinks: {stderr: {filter: XXX}}'. If
 no value is specified, the default value for the command is inferred: INFO for
 server commands, WARNING for client commands.

--redactable-logs=false

--redactable-logs=XXX is an alias for --log='file-defaults: {redactable:
 XXX}}'.

--vmodule=
    comma-separated list of pattern=N settings for file-filtered logging (significantly hurts performance)

SEE ALSO

cockroach-gen-example-data(1)

HISTORY

13-May-2026 Auto generated by spf13/cobra