TiFlash Command-Line Flags
This document introduces the command-line flags that you can use when you launch TiFlash.
server --config-file
- Specifies the path of the TiFlash configuration file
- Default: ""
- You must specify the configuration file. For detailed configuration items, refer to TiFlash configuration parameters.
dttool migrate
Migrates the file format of DTFile (for testing or downgrading). Data is migrated in the unit of a single DTFile. If you want to migrate the whole table, you need to locate all the paths similar to
<data dir>/t_<table id>/stable/dmf_<file id>
and migrate them one by one. You can use scripts to automate the migration.User scenarios:
- If you need to downgrade TiFlash from a version >= v5.4.0 that has enabled data validation to a version < v5.4.0, you can use this tool to downgrade the data format of the DTFile.
- If you upgrade TiFlash to a version >= v5.4.0, and if you hope to enable data validation for existing data, you can use this tool to upgrade the data format of the DTFile.
- Test the space usage and read speed of the DTFile in different configurations.
Parameters:
--imitative
: When you do not use the encryption feature of the DTFile, you can use this flag to avoid using the configuration file and connecting to PD.--version
: The version of DTFile. The value options are1
and2
(default).1
is the old version, and2
is the version corresponding to the new checksum.--algorithm
: The hash algorithm used for data validation. The value options arexxh3
(default),city128
,crc32
,crc64
, andnone
. This parameter is effective only whenversion
is2
.--frame
: The size of the validation frame. The default value is1048576
. This parameter is effective only whenversion
is2
.--compression
: The target compression algorithm. The value options areLZ4
(default),LZ4HC
,zstd
, andnone
.--level
: The target compression level. If not specified, the recommended compression level is used by default according to the compression algorithm. Ifcompression
is set toLZ4
orzstd
, the default level is 1. Ifcompression
is set toLZ4HC
, the default level is 9.--config-file
: The configuration file ofdttool migrate
is the same as the configuration file ofserver
. For more information, see--imitative
.--file-id
: The ID of the DTFile. For example, the ID of the DTFiledmf_123
is123
.--workdir
: The parent directory ofdmf_xxx
.--dry
: The dry run mode. Only the migration process is output.--nokeep
: Does not keep the original data. When this option is not enabled,dmf_xxx.old
files are created.
dttool bench
Provides a basic I/O speed test for the DTFile.
Parameters:
--version
: The version of DTFile. See--version
indttool migrate
.--algorithm
: The hash algorithm used for data validation. See--algorithm
indttool migrate
.--frame
: The size of the validation frame. See--frame
indttool migrate
.--column
: The columns of the table to be tested. The default value is100
.--size
: The rows of the table to be tested. The default value is1000
.--field
: The field length limit of the table to be tested. The default value is1024
.--random
: The random seed. If you do not specify this parameter, the random seed is drawn from the system entropy pool.--encryption
: Enables the encryption feature.--repeat
: The number of times to repeat the test. The default value is5
.--workdir
: The temporary data directory, which points to a path in the file system to be tested. The default value is/tmp/test
.
dttool inspect
Checks the integrity of the DTFile. Data validation is performed in the unit of a single DTFile. If you want to validate the whole table, you need to locate all the paths similar to
<data dir>/t_<table id>/stable/dmf_<file id>
and validate them one by one. You can use scripts to automate the validation.User scenarios:
- After you perform a format upgrade or downgrade, you can validate the data integrity of the DTFile.
- After you migrate the DTFile to a new environment, you can validate the data integrity of the DTFile.
Parameters:
--config-file
: The configuration file ofdttool bench
. See--config-file
indttool migrate
.--check
: Performs hash validation.--file-id
: The ID of the DTFile. See--file-id
indttool migrate
.--imitative
: Imitates the database context. See--imitative
indttool migrate
.--workdir
: The data directory. See--workdir
indttool migrate
.