vitess.io/vitess@v0.16.2/go/flags/endtoend/vtctldclient.txt (about)

     1  Executes a cluster management command on the remote vtctld server.
     2  
     3  Usage:
     4    vtctldclient [flags]
     5    vtctldclient [command]
     6  
     7  Available Commands:
     8    AddCellInfo                 Registers a local topology service in a new cell by creating the CellInfo.
     9    AddCellsAlias               Defines a group of cells that can be referenced by a single name (the alias).
    10    ApplyRoutingRules           Applies the VSchema routing rules.
    11    ApplySchema                 Applies the schema change to the specified keyspace on every primary, running in parallel on all shards. The changes are then propagated to replicas via replication.
    12    ApplyShardRoutingRules      Applies the provided shard routing rules.
    13    ApplyVSchema                Applies the VTGate routing schema to the provided keyspace. Shows the result after application.
    14    Backup                      Uses the BackupStorage service on the given tablet to create and store a new backup.
    15    BackupShard                 Finds the most up-to-date REPLICA, RDONLY, or SPARE tablet in the given shard and uses the BackupStorage service on that tablet to create and store a new backup.
    16    ChangeTabletType            Changes the db type for the specified tablet, if possible.
    17    CreateKeyspace              Creates the specified keyspace in the topology.
    18    CreateShard                 Creates the specified shard in the topology.
    19    DeleteCellInfo              Deletes the CellInfo for the provided cell.
    20    DeleteCellsAlias            Deletes the CellsAlias for the provided alias.
    21    DeleteKeyspace              Deletes the specified keyspace from the topology.
    22    DeleteShards                Deletes the specified shards from the topology.
    23    DeleteSrvVSchema            Deletes the SrvVSchema object in the given cell.
    24    DeleteTablets               Deletes tablet(s) from the topology.
    25    EmergencyReparentShard      Reparents the shard to the new primary. Assumes the old primary is dead and not responding.
    26    ExecuteFetchAsApp           Executes the given query as the App user on the remote tablet.
    27    ExecuteFetchAsDBA           Executes the given query as the DBA user on the remote tablet.
    28    ExecuteHook                 Runs the specified hook on the given tablet.
    29    FindAllShardsInKeyspace     Returns a map of shard names to shard references for a given keyspace.
    30    GenerateShardRanges         Print a set of shard ranges assuming a keyspace with N shards.
    31    GetBackups                  Lists backups for the given shard.
    32    GetCellInfo                 Gets the CellInfo object for the given cell.
    33    GetCellInfoNames            Lists the names of all cells in the cluster.
    34    GetCellsAliases             Gets all CellsAlias objects in the cluster.
    35    GetFullStatus               Outputs a JSON structure that contains full status of MySQL including the replication information, semi-sync information, GTID information among others.
    36    GetKeyspace                 Returns information about the given keyspace from the topology.
    37    GetKeyspaces                Returns information about every keyspace in the topology.
    38    GetPermissions              Displays the permissions for a tablet.
    39    GetRoutingRules             Displays the VSchema routing rules.
    40    GetSchema                   Displays the full schema for a tablet, optionally restricted to the specified tables/views.
    41    GetShard                    Returns information about a shard in the topology.
    42    GetShardRoutingRules        Displays the currently active shard routing rules as a JSON document.
    43    GetSrvKeyspaceNames         Outputs a JSON mapping of cell=>keyspace names served in that cell. Omit to query all cells.
    44    GetSrvKeyspaces             Returns the SrvKeyspaces for the given keyspace in one or more cells.
    45    GetSrvVSchema               Returns the SrvVSchema for the given cell.
    46    GetSrvVSchemas              Returns the SrvVSchema for all cells, optionally filtered by the given cells.
    47    GetTablet                   Outputs a JSON structure that contains information about the tablet.
    48    GetTabletVersion            Print the version of a tablet from its debug vars.
    49    GetTablets                  Looks up tablets according to filter criteria.
    50    GetTopologyPath             Gets the value associated with the particular path (key) in the topology server.
    51    GetVSchema                  Prints a JSON representation of a keyspace's topo record.
    52    GetWorkflows                Gets all vreplication workflows (Reshard, MoveTables, etc) in the given keyspace.
    53    LegacyVtctlCommand          Invoke a legacy vtctlclient command. Flag parsing is best effort.
    54    PingTablet                  Checks that the specified tablet is awake and responding to RPCs. This command can be blocked by other in-flight operations.
    55    PlannedReparentShard        Reparents the shard to a new primary, or away from an old primary. Both the old and new primaries must be up and running.
    56    RebuildKeyspaceGraph        Rebuilds the serving data for the keyspace(s). This command may trigger an update to all connected clients.
    57    RebuildVSchemaGraph         Rebuilds the cell-specific SrvVSchema from the global VSchema objects in the provided cells (or all cells if none provided).
    58    RefreshState                Reloads the tablet record on the specified tablet.
    59    RefreshStateByShard         Reloads the tablet record all tablets in the shard, optionally limited to the specified cells.
    60    ReloadSchema                Reloads the schema on a remote tablet.
    61    ReloadSchemaKeyspace        Reloads the schema on all tablets in a keyspace. This is done on a best-effort basis.
    62    ReloadSchemaShard           Reloads the schema on all tablets in a shard. This is done on a best-effort basis.
    63    RemoveBackup                Removes the given backup from the BackupStorage used by vtctld.
    64    RemoveKeyspaceCell          Removes the specified cell from the Cells list for all shards in the specified keyspace (by calling RemoveShardCell on every shard). It also removes the SrvKeyspace for that keyspace in that cell.
    65    RemoveShardCell             Remove the specified cell from the specified shard's Cells list.
    66    ReparentTablet              Reparent a tablet to the current primary in the shard.
    67    RestoreFromBackup           Stops mysqld on the specified tablet and restores the data from either the latest backup or closest before `backup-timestamp`.
    68    RunHealthCheck              Runs a healthcheck on the remote tablet.
    69    SetKeyspaceDurabilityPolicy Sets the durability-policy used by the specified keyspace.
    70    SetShardIsPrimaryServing    Add or remove a shard from serving. This is meant as an emergency function. It does not rebuild any serving graphs; i.e. it does not run `RebuildKeyspaceGraph`.
    71    SetShardTabletControl       Sets the TabletControl record for a shard and tablet type. Only use this for an emergency fix or after a finished MoveTables.
    72    SetWritable                 Sets the specified tablet as writable or read-only.
    73    ShardReplicationFix         Walks through a ShardReplication object and fixes the first error encountered.
    74    ShardReplicationPositions   
    75    SleepTablet                 Blocks the action queue on the specified tablet for the specified amount of time. This is typically used for testing.
    76    SourceShardAdd              Adds the SourceShard record with the provided index for emergencies only. It does not call RefreshState for the shard primary.
    77    SourceShardDelete           Deletes the SourceShard record with the provided index. This should only be used for emergency cleanup. It does not call RefreshState for the shard primary.
    78    StartReplication            Starts replication on the specified tablet.
    79    StopReplication             Stops replication on the specified tablet.
    80    TabletExternallyReparented  Updates the topology record for the tablet's shard to acknowledge that an external tool made this tablet the primary.
    81    UpdateCellInfo              Updates the content of a CellInfo with the provided parameters, creating the CellInfo if it does not exist.
    82    UpdateCellsAlias            Updates the content of a CellsAlias with the provided parameters, creating the CellsAlias if it does not exist.
    83    UpdateThrottlerConfig       Update the tablet throttler configuration for all tablets in the given keyspace (across all cells)
    84    Validate                    Validates that all nodes reachable from the global replication graph, as well as all tablets in discoverable cells, are consistent.
    85    ValidateKeyspace            Validates that all nodes reachable from the specified keyspace are consistent.
    86    ValidateSchemaKeyspace      Validates that the schema on the primary tablet for shard 0 matches the schema on all other tablets in the keyspace.
    87    ValidateShard               Validates that all nodes reachable from the specified shard are consistent.
    88    ValidateVersionKeyspace     Validates that the version on the primary tablet of shard 0 matches all of the other tablets in the keyspace.
    89    ValidateVersionShard        Validates that the version on the primary matches all of the replicas.
    90    completion                  Generate the autocompletion script for the specified shell
    91    help                        Help about any command
    92  
    93  Flags:
    94        --action_timeout duration                timeout for the total command (default 1h0m0s)
    95        --alsologtostderr                        log to standard error as well as files
    96        --grpc_auth_static_client_creds string   When using grpc_static_auth in the server, this file provides the credentials to use to authenticate with server.
    97        --grpc_compression string                Which protocol to use for compressing gRPC. Default: nothing. Supported: snappy
    98        --grpc_enable_tracing                    Enable gRPC tracing.
    99        --grpc_initial_conn_window_size int      gRPC initial connection window size
   100        --grpc_initial_window_size int           gRPC initial window size
   101        --grpc_keepalive_time duration           After a duration of this time, if the client doesn't see any activity, it pings the server to see if the transport is still alive. (default 10s)
   102        --grpc_keepalive_timeout duration        After having pinged for keepalive check, the client waits for a duration of Timeout and if no activity is seen even after that the connection is closed. (default 10s)
   103        --grpc_max_message_size int              Maximum allowed RPC message size. Larger messages will be rejected by gRPC with the error 'exceeding the max size'. (default 16777216)
   104        --grpc_prometheus                        Enable gRPC monitoring with Prometheus.
   105    -h, --help                                   help for vtctldclient
   106        --keep_logs duration                     keep logs for this long (using ctime) (zero to keep forever)
   107        --keep_logs_by_mtime duration            keep logs for this long (using mtime) (zero to keep forever)
   108        --log_backtrace_at traceLocation         when logging hits line file:N, emit a stack trace (default :0)
   109        --log_dir string                         If non-empty, write log files in this directory
   110        --log_rotate_max_size uint               size in bytes at which logs are rotated (glog.MaxSize) (default 1887436800)
   111        --logtostderr                            log to standard error instead of files
   112        --mysql_server_version string            MySQL server version to advertise. (default "8.0.30-Vitess")
   113        --purge_logs_interval duration           how often try to remove old logs (default 1h0m0s)
   114        --security_policy string                 the name of a registered security policy to use for controlling access to URLs - empty means allow all for anyone (built-in policies: deny-all, read-only)
   115        --server string                          server to use for connection (required)
   116        --stderrthreshold severity               logs at or above this threshold go to stderr (default 1)
   117    -v, --v Level                                log level for V logs
   118        --version                                version for vtctldclient
   119        --vmodule moduleSpec                     comma-separated list of pattern=N settings for file-filtered logging
   120        --vtctl_client_protocol string           Protocol to use to talk to the vtctl server. (default "grpc")
   121        --vtctld_grpc_ca string                  the server ca to use to validate servers when connecting
   122        --vtctld_grpc_cert string                the cert to use to connect
   123        --vtctld_grpc_crl string                 the server crl to use to validate server certificates when connecting
   124        --vtctld_grpc_key string                 the key to use to connect
   125        --vtctld_grpc_server_name string         the server name to use to validate server certificate
   126  
   127  Use "vtctldclient [command] --help" for more information about a command.