GetTablets

vtctldclient GetTablets

Looks up tablets according to filter criteria.

Synopsis

Looks up tablets according to the filter criteria.

If —tablet-alias is passed, none of the other filters (tablet-type, keyspace, shard, cell) may be passed, and tablets are looked up by tablet alias only.

If —keyspace is passed, then all tablets in the keyspace are retrieved. The —shard flag may also be passed to further narrow the set of tablets to that <keyspace/shard>. Passing —shard without also passing —keyspace will fail.

If —tablet-type is passed, only tablets of the specified type will be returned. Valid tablet types are: “backup”, “drained”, “experimental”, “primary”, “rdonly”, “replica”, “restore”, “spare”.

Passing —cell limits the set of tablets to those in the specified cells. The —cell flag accepts a CSV argument (e.g. —cell “c1,c2”) and may be repeated (e.g. —cell “c1” —cell “c2”).

Valid output formats are “awk” and “json”.

  1. vtctldclient GetTablets [--strict] [{--cell $c1 [--cell $c2 ...] [--tablet-type $t1] [--keyspace $ks [--shard $shard]], --tablet-alias $alias}]

Options

  1. -c, --cell strings List of cells to filter tablets by.
  2. --format string Output format to use; valid choices are (json, awk). (default "awk")
  3. -h, --help help for GetTablets
  4. -k, --keyspace string Keyspace to filter tablets by.
  5. -s, --shard string Shard to filter tablets by.
  6. --strict Require all cells to return successful tablet data. Without --strict, tablet listings may be partial.
  7. -t, --tablet-alias strings List of tablet aliases to filter by.
  8. --tablet-type topodatapb.TabletType Tablet type to filter by (e.g. primary or replica). (default UNKNOWN)

Options inherited from parent commands

  1. --action_timeout duration timeout to use for the command (default 1h0m0s)
  2. --compact use compact format for otherwise verbose outputs
  3. --server string server to use for the connection (required)

SEE ALSO

  • vtctldclient - Executes a cluster management command on the remote vtctld server.