6.5.7 mysqlslap — A Load Emulation Client

6.5.7 mysqlslap — A Load Emulation Client

mysqlslap은 MySQL 서버에 대한 클라이언트 부하를 에뮬레이션하고 각 단계의 타이밍을 보고하도록 설계된 진단 프로그램입니다. 이는 여러 클라이언트가 서버에 접근하는 것처럼 동작합니다.

mysqlslap을 다음과 같이 호출합니다:

1mysqlslap [options]

--create 또는 --query와 같은 일부 옵션을 사용하면 SQL 문을 포함하는 문자열이나 문들을 포함하는 파일을 지정할 수 있습니다. 파일을 지정하는 경우, 기본적으로 각 줄에 하나의 문만 포함되어야 합니다. (즉, 암묵적인 문 구분자는 개행 문자입니다.) --delimiter 옵션을 사용하여 다른 구분자를 지정하면, 여러 줄에 걸쳐 있는 문을 지정하거나 하나의 줄에 여러 문을 배치할 수 있습니다. 파일에는 주석을 포함할 수 없습니다. mysqlslap은 주석을 인식하지 못합니다.

mysqlslap은 세 단계로 실행됩니다:

1. 테스트에 사용할 스키마, 테이블, 그리고 선택적으로 저장 프로그램이나 데이터를 생성합니다. 이 단계는 단일 클라이언트 연결을 사용합니다.

2. 부하 테스트를 실행합니다. 이 단계는 여러 클라이언트 연결을 사용할 수 있습니다.

3. 정리 작업을 수행합니다(연결 해제, 지정된 경우 테이블 드롭). 이 단계는 단일 클라이언트 연결을 사용합니다.

예제:

직접 작성한 create 및 query SQL 문을 사용하고, 50개의 클라이언트가 각각 200번 select를 수행하도록 합니다 (하나의 줄에 명령을 입력):

1mysqlslap --delimiter=";"
2  --create="CREATE TABLE a (b int);INSERT INTO a VALUES (23)"
3  --query="SELECT * FROM a" --concurrency=50 --iterations=200

mysqlslap이 두 개의 INT 컬럼과 세 개의 VARCHAR 컬럼을 가진 테이블을 사용하여 query SQL 문을 자동으로 생성하도록 합니다. 다섯 개의 클라이언트가 각자 20번씩 query를 수행하게 합니다. 테이블을 생성하거나 데이터를 insert하지 않습니다 (즉, 이전 테스트의 스키마와 데이터를 사용합니다):

1mysqlslap --concurrency=5 --iterations=20
2  --number-int-cols=2 --number-char-cols=3
3  --auto-generate-sql

지정된 파일에서 create, insert, query SQL 문을 로딩하도록 프로그램에 지시합니다. create.sql 파일에는 ';'로 구분된 여러 테이블 생성 문과 ';'로 구분된 여러 insert 문이 포함되어 있습니다. --query 파일에는 ';'로 구분된 여러 query가 포함되어야 합니다. 모든 로딩 문을 실행한 후, query 파일에 있는 모든 query를 다섯 개의 클라이언트(각각 다섯 번씩)로 실행합니다:

1mysqlslap --concurrency=5
2  --iterations=5 --query=query.sql --create=create.sql
3  --delimiter=";"

mysqlslap은 커맨드라인이나 옵션 파일의 [mysqlslap] 및 [client] 그룹에서 지정할 수 있는 다음 옵션을 지원합니다. MySQL 프로그램에서 사용하는 옵션 파일에 대한 정보는 Section 6.2.2.2, “Using Option Files”를 참조하십시오.

Table 6.16 mysqlslap Options

Option Name	Description
--auto-generate-sql	파일이나 커맨드 옵션으로 제공되지 않을 때 SQL 문을 자동 생성
--auto-generate-sql-add-autoincrement	자동 생성된 테이블에 AUTO_INCREMENT 컬럼 추가
--auto-generate-sql-execute-number	자동으로 생성할 query 개수 지정
--auto-generate-sql-guid-primary	자동 생성된 테이블에 GUID 기반 프라이머리 키 추가
--auto-generate-sql-load-type	테스트 부하 타입 지정
--auto-generate-sql-secondary-indexes	자동 생성된 테이블에 추가할 세컨더리 인덱스의 개수 지정
--auto-generate-sql-unique-query-number	자동 테스트를 위해 생성할 서로 다른 query 개수
--auto-generate-sql-unique-write-number	--auto-generate-sql-write-number를 위해 생성할 서로 다른 query 개수
--auto-generate-sql-write-number	각 스레드에서 수행할 row insert 개수
--commit	커밋 전에 실행할 문 개수
--compress	클라이언트와 서버 간에 전송되는 모든 정보 압축
--compression-algorithms	서버 연결에 허용되는 압축 알고리즘
--concurrency	SELECT 문을 실행할 때 시뮬레이션할 클라이언트 수
--create	테이블 생성에 사용할 문을 포함하는 파일 또는 문자열
--create-schema	테스트를 실행할 스키마
--csv	comma-separated values 형식으로 출력 생성
--debug	디버깅 로그 기록
--debug-check	프로그램 종료 시 디버깅 정보 출력
--debug-info	프로그램 종료 시 디버깅 정보, 메모리, CPU 통계 출력
--defaults-extra-file	일반적인 옵션 파일에 추가로 지정된 옵션 파일 읽기
--defaults-file	지정된 옵션 파일만 읽기
--defaults-group-suffix	옵션 그룹 suffix 값
--delimiter	SQL 문에서 사용할 구분자
--detach	각 N개의 문 후에 각 연결을 detach(닫고 다시 열기)
--enable-cleartext-plugin	cleartext 인증 플러그인 활성화
--engine	테이블 생성에 사용할 스토리지 엔진
--get-server-public-key	서버로부터 RSA public key 요청
--help	도움말 메시지 출력 후 종료
--host	MySQL 서버가 위치한 호스트
--iterations	테스트를 실행할 횟수
--login-path	.mylogin.cnf에서 로그인 경로 옵션 읽기
--no-defaults	어떤 옵션 파일도 읽지 않기
--no-drop	테스트 실행 중 생성된 스키마를 드롭하지 않기
--no-login-paths	로그인 경로 파일에서 로그인 경로를 읽지 않기
--number-char-cols	--auto-generate-sql이 지정된 경우 사용할 VARCHAR 컬럼 수
--number-int-cols	--auto-generate-sql이 지정된 경우 사용할 INT 컬럼 수
--number-of-queries	각 클라이언트를 대략 이 개수의 query로 제한
--only-print	데이터베이스에 연결하지 않음. mysqlslap은 수행할 작업만 출력
--password	서버에 연결할 때 사용할 패스워드
--password1	서버에 연결할 때 사용할 다중 요소 인증 패스워드 1
--password2	서버에 연결할 때 사용할 다중 요소 인증 패스워드 2
--password3	서버에 연결할 때 사용할 다중 요소 인증 패스워드 3
--pipe	named pipe를 사용하여 서버에 연결(Windows 전용)
--port	연결에 사용할 TCP/IP 포트 번호
--post-query	테스트 완료 후 실행할 문을 포함하는 파일 또는 문자열
--post-system	테스트 완료 후 system()을 사용해 실행할 문자열
--pre-query	테스트 실행 전 실행할 문을 포함하는 파일 또는 문자열
--pre-system	테스트 실행 전 system()을 사용해 실행할 문자열
--print-defaults	프로그램 이름과 옵션 파일에서 가져온 모든 옵션 출력
--protocol	사용할 전송 프로토콜
--query	데이터를 조회할 때 사용할 SELECT 문을 포함하는 파일 또는 문자열
--server-public-key-path	RSA public key를 포함하는 파일의 경로 이름
--shared-memory-base-name	공유 메모리 연결용 공유 메모리 이름(Windows 전용)
--silent	silent 모드
--socket	사용할 Unix 소켓 파일 또는 Windows named pipe
--sql-mode	클라이언트 세션의 SQL 모드 설정
--ssl-ca	신뢰할 수 있는 SSL Certificate Authority 목록을 포함하는 파일
--ssl-capath	신뢰할 수 있는 SSL Certificate Authority 인증서 파일이 있는 디렉터리
--ssl-cert	X.509 인증서를 포함하는 파일
--ssl-cipher	연결 암호화에 허용되는 암호
--ssl-fips-mode	클라이언트 측에서 FIPS 모드를 활성화할지 여부
--ssl-key	X.509 키를 포함하는 파일
--ssl-mode	서버 연결의 원하는 보안 상태
--ssl-session-data	SSL 세션 데이터를 포함하는 파일
--ssl-session-data-continue-on-failed-reuse	세션 재사용이 실패한 경우에도 연결을 설정할지 여부
--tls-ciphersuites	암호화된 연결에 허용되는 TLSv1.3 ciphersuite
--tls-sni-servername	클라이언트가 제공하는 서버 이름
--tls-version	암호화된 연결에 허용되는 TLS 프로토콜
--user	서버에 연결할 때 사용할 MySQL 사용자 이름
--verbose	verbose 모드
--version	버전 정보를 표시하고 종료
--zstd-compression-level	zstd 압축을 사용하는 서버 연결의 압축 레벨

Property	Value
Option Name	Description
---	---

• --help, -?

Property	Value
Command-Line Format	--help

도움말 메시지를 출력하고 종료합니다.

• --auto-generate-sql, -a

Property	Value
Command-Line Format	--auto-generate-sql
Type	Boolean
Default Value	FALSE

파일이나 커맨드 옵션으로 제공되지 않을 때 SQL 문을 자동으로 생성합니다.

• --auto-generate-sql-add-autoincrement

Property	Value
Command-Line Format	--auto-generate-sql-add-autoincrement
Type	Boolean
Default Value	FALSE

자동 생성된 테이블에 AUTO_INCREMENT 컬럼을 추가합니다.

• --auto-generate-sql-execute-number=N

Property	Value
Command-Line Format	--auto-generate-sql-execute-number=#
Type	Numeric

자동으로 생성할 query 개수를 지정합니다.

• --auto-generate-sql-guid-primary

Property	Value
Command-Line Format	--auto-generate-sql-guid-primary
Type	Boolean
Default Value	FALSE

자동 생성된 테이블에 GUID 기반 프라이머리 키를 추가합니다.

• --auto-generate-sql-load-type=type

Property	Value
Command-Line Format	--auto-generate-sql-load-type=type
Type	Enumeration
Default Value	mixed
Valid Values	read<br>write<br>key<br>update<br>mixed

테스트 부하 타입을 지정합니다. 허용되는 값은 read(테이블 스캔), write(테이블에 insert), key(프라이머리 키 read), update(프라이머리 키 update), mixed(insert 절반, 스캔 select 절반)입니다. 기본값은 mixed입니다.

• --auto-generate-sql-secondary-indexes=N

Property	Value
Command-Line Format	--auto-generate-sql-secondary-indexes=#
Type	Numeric
Default Value	0

자동 생성된 테이블에 추가할 세컨더리 인덱스 개수를 지정합니다. 기본적으로 인덱스는 추가되지 않습니다.

• --auto-generate-sql-unique-query-number=N

Property	Value
Command-Line Format	--auto-generate-sql-unique-query-number=#
Type	Numeric
Default Value	10

자동 테스트를 위해 생성할 서로 다른 query 개수입니다. 예를 들어, 1000개의 select를 수행하는 key 테스트를 실행하는 경우, 이 옵션을 1000으로 사용하면 1000개의 고유 query를 실행할 수 있고, 값을 50으로 사용하면 서로 다른 50개의 select를 수행합니다. 기본값은 10입니다.

• --auto-generate-sql-unique-write-number=N

Property	Value
Command-Line Format	--auto-generate-sql-unique-write-number=#
Type	Numeric
Default Value	10

--auto-generate-sql-write-number를 위해 생성할 서로 다른 query 개수입니다. 기본값은 10입니다.

• --auto-generate-sql-write-number=N

Property	Value
Command-Line Format	--auto-generate-sql-write-number=#
Type	Numeric
Default Value	100

수행할 row insert 개수입니다. 기본값은 100입니다.

• --commit=N

Property	Value
Command-Line Format	--commit=#
Type	Numeric
Default Value	0

커밋 전에 실행할 문 개수입니다. 기본값은 0으로, 커밋을 수행하지 않습니다.

• --compress, -C

Property	Value
Command-Line Format	`--compress[={OFF
Deprecated	Yes
Type	Boolean
Default Value	OFF

가능한 경우, 클라이언트와 서버 간에 전송되는 모든 정보를 압축합니다. Section 6.2.8, “Connection Compression Control”를 참조하십시오.

이 옵션은 deprecated되었습니다. 향후 MySQL 버전에서 제거될 예정입니다. Configuring Legacy Connection Compression를 참조하십시오.

• --compression-algorithms=value

Property	Value
Command-Line Format	--compression-algorithms=value
Type	Set
Default Value	uncompressed
Valid Values	zlib<br>zstd<br>uncompressed

서버 연결에 허용되는 압축 알고리즘입니다. 사용 가능한 알고리즘은 protocol_compression_algorithms 시스템 변수와 동일합니다. 기본값은 uncompressed입니다.

자세한 내용은 Section 6.2.8, “Connection Compression Control”을 참조하십시오.

• --concurrency=N, -c N

Property	Value
Command-Line Format	--concurrency=#
Type	Numeric

시뮬레이션할 병렬 클라이언트 수입니다.

• --create=value

Property	Value
Command-Line Format	--create=value
Type	String

테이블 생성을 위해 사용할 문을 포함하는 파일 또는 문자열입니다.

• --create-schema=value

Property	Value
Command-Line Format	--create-schema=value
Type	String

테스트를 실행할 스키마입니다.

참고

--auto-generate-sql 옵션도 지정된 경우, mysqlslap은 테스트 실행이 끝날 때 스키마를 드롭합니다. 이를 피하려면 --no-drop 옵션도 사용하십시오.

• --csv[=file_name]

Property	Value
Command-Line Format	--csv=[file]
Type	File name

comma-separated values 형식으로 출력을 생성합니다. 출력은 지정된 파일로 보내지며, 파일이 지정되지 않은 경우 표준 출력으로 전송됩니다.

• --debug[=debug_options], -# [debug_options]

Property	Value
Command-Line Format	--debug[=debug_options]
Type	String
Default Value	d:t:o,/tmp/mysqlslap.trace

디버깅 로그를 기록합니다. 일반적인 debug_options 문자열은 d:t:o,file_name입니다. 기본값은 d:t:o,/tmp/mysqlslap.trace입니다.

이 옵션은 MySQL이 WITH_DEBUG를 사용하여 빌드된 경우에만 사용 가능합니다. Oracle이 제공하는 MySQL 릴리스 바이너리는 이 옵션을 사용하여 빌드되지 않습니다.

• --debug-check

Property	Value
Command-Line Format	--debug-check
Type	Boolean
Default Value	FALSE

프로그램 종료 시 디버깅 정보를 일부 출력합니다.

이 옵션은 MySQL이 WITH_DEBUG를 사용하여 빌드된 경우에만 사용 가능합니다. Oracle이 제공하는 MySQL 릴리스 바이너리는 이 옵션을 사용하여 빌드되지 않습니다.

• --debug-info, -T

Property	Value
Command-Line Format	--debug-info
Type	Boolean
Default Value	FALSE

프로그램 종료 시 디버깅 정보와 메모리, CPU 사용량 통계를 출력합니다.

이 옵션은 MySQL이 WITH_DEBUG를 사용하여 빌드된 경우에만 사용 가능합니다. Oracle이 제공하는 MySQL 릴리스 바이너리는 이 옵션을 사용하여 빌드되지 않습니다.

• --default-auth=plugin

Property	Value
Command-Line Format	--default-auth=plugin
Type	String

사용할 클라이언트 측 인증 플러그인에 대한 힌트입니다. Section 8.2.17, “Pluggable Authentication”를 참조하십시오.

• --defaults-extra-file=file_name

Property	Value
Command-Line Format	--defaults-extra-file=file_name
Type	File name

global 옵션 파일 다음이지만 (Unix에서는) 사용자 옵션 파일 이전에 이 옵션 파일을 읽습니다. 파일이 존재하지 않거나 접근할 수 없으면 에러가 발생합니다. _file_name_이 절대 경로 이름이 아니면 현재 디렉터리를 기준으로 해석됩니다.

이 옵션과 다른 옵션 파일 관련 옵션에 대한 추가 정보는 Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”를 참조하십시오.

• --defaults-file=file_name

Property	Value
Command-Line Format	--defaults-file=file_name
Type	File name

지정된 옵션 파일만 사용합니다. 파일이 존재하지 않거나 접근할 수 없으면 에러가 발생합니다. _file_name_이 절대 경로 이름이 아니면 현재 디렉터리를 기준으로 해석됩니다.

예외: --defaults-file가 사용되더라도, 클라이언트 프로그램은 .mylogin.cnf를 읽습니다.

이 옵션과 다른 옵션 파일 관련 옵션에 대한 추가 정보는 Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”를 참조하십시오.

• --defaults-group-suffix=str

Property	Value
Command-Line Format	--defaults-group-suffix=str
Type	String

일반적인 옵션 그룹뿐만 아니라, 일반적인 이름에 str suffix가 붙은 그룹도 읽습니다. 예를 들어, mysqlslap은 기본적으로 [client] 및 [mysqlslap] 그룹을 읽습니다. 이 옵션이 --defaults-group-suffix=_other로 지정되면, mysqlslap은 [client_other] 및 [mysqlslap_other] 그룹도 읽습니다.

이 옵션과 다른 옵션 파일 관련 옵션에 대한 추가 정보는 Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”를 참조하십시오.

• --delimiter=str, -F str

Property	Value
Command-Line Format	--delimiter=str
Type	String

파일이나 커맨드 옵션을 통해 제공된 SQL 문에서 사용할 구분자입니다.

• --detach=N

Property	Value
Command-Line Format	--detach=#
Type	Numeric
Default Value	0

각 _N_개의 문 후에 각 연결을 detach(닫고 다시 열기)합니다. 기본값은 0으로, 연결을 detach하지 않습니다.

• --enable-cleartext-plugin

Property	Value
Command-Line Format	--enable-cleartext-plugin
Type	Boolean
Default Value	FALSE

mysql_clear_password cleartext 인증 플러그인을 활성화합니다. (Section 8.4.1.3, “Client-Side Cleartext Pluggable Authentication”를 참조하십시오.)

• --engine=engine_name, -e engine_name

Property	Value
Command-Line Format	--engine=engine_name
Type	String

테이블을 생성하는 데 사용할 스토리지 엔진입니다.

• --get-server-public-key

Property	Value
Command-Line Format	--get-server-public-key
Type	Boolean

키 페어 기반 패스워드 교환을 위해 서버가 사용하는 RSA public key를 서버에서 요청합니다. 이 옵션은 caching_sha2_password 인증 플러그인을 사용하여 인증하는 계정으로 서버에 연결하는 클라이언트에 적용됩니다. 이러한 계정으로의 연결에서는, 요청하지 않는 한 서버는 클라이언트에 public key를 보내지 않습니다. 이 옵션은 해당 플러그인으로 인증하지 않는 계정에 대해서는 무시됩니다. 또한, 클라이언트가 보안 연결을 사용하여 서버에 연결하는 경우와 같이 RSA 기반 패스워드 교환이 필요하지 않을 때도 무시됩니다.

--server-public-key-path=file_name가 지정되고 유효한 public key 파일을 지정하는 경우, 이는 --get-server-public-key보다 우선합니다.

caching_sha2_password 플러그인에 대한 정보는 Section 8.4.1.1, “Caching SHA-2 Pluggable Authentication”을 참조하십시오.

• --host=host_name, -h host_name

Property	Value
Command-Line Format	--host=host_name
Type	String
Default Value	localhost

지정된 호스트의 MySQL 서버에 연결합니다.

• --iterations=N, -i N

Property	Value
Command-Line Format	--iterations=#
Type	Numeric

테스트를 실행할 횟수입니다.

• --login-path=name

Property	Value
Command-Line Format	--login-path=name
Type	String

.mylogin.cnf 로그인 경로 파일의 지정된 로그인 경로에서 옵션을 읽습니다. “로그인 경로”는 어떤 MySQL 서버에 연결하고 어떤 계정으로 인증할지를 지정하는 옵션을 포함하는 옵션 그룹입니다. 로그인 경로 파일을 생성하거나 수정하려면 mysql_config_editor 유틸리티를 사용하십시오. Section 6.6.7, “mysql_config_editor — MySQL Configuration Utility”를 참조하십시오.

이 옵션과 다른 옵션 파일 관련 옵션에 대한 추가 정보는 Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”를 참조하십시오.

• --no-login-paths

Property	Value
Command-Line Format	--no-login-paths

로그인 경로 파일에서 옵션을 읽는 과정을 건너뜁니다.

관련 정보는 --login-path를 참조하십시오.

이 옵션과 다른 옵션 파일 관련 옵션에 대한 추가 정보는 Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”를 참조하십시오.

• --no-drop

Property	Value
Command-Line Format	--no-drop
Type	Boolean
Default Value	FALSE

mysqlslap이 테스트 실행 중 생성한 스키마를 드롭하지 못하도록 방지합니다.

• --no-defaults

Property	Value
Command-Line Format	--no-defaults

어떤 옵션 파일도 읽지 않습니다. 프로그램 시작 시 옵션 파일에서 읽은 알 수 없는 옵션 때문에 시작에 실패하는 경우, --no-defaults를 사용하여 해당 파일이 읽히지 않도록 할 수 있습니다.

예외적으로 .mylogin.cnf 파일은 존재하는 경우 항상 읽힙니다. 이를 통해 --no-defaults를 사용할 때에도 커맨드라인보다 안전한 방식으로 패스워드를 지정할 수 있습니다. .mylogin.cnf를 생성하려면 mysql_config_editor 유틸리티를 사용하십시오. Section 6.6.7, “mysql_config_editor — MySQL Configuration Utility”를 참조하십시오.

이 옵션과 다른 옵션 파일 관련 옵션에 대한 추가 정보는 Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”를 참조하십시오.

• --number-char-cols=N, -x N

Property	Value
Command-Line Format	--number-char-cols=#
Type	Numeric

--auto-generate-sql이 지정된 경우 사용할 VARCHAR 컬럼 수입니다.

• --number-int-cols=N, -y N

Property	Value
Command-Line Format	--number-int-cols=#
Type	Numeric

--auto-generate-sql이 지정된 경우 사용할 INT 컬럼 수입니다.

• --number-of-queries=N

Property	Value
Command-Line Format	--number-of-queries=#
Type	Numeric

각 클라이언트를 대략 이 개수의 query로 제한합니다. query counting에는 문 구분자가 반영됩니다.

예를 들어, 다음과 같이 mysqlslap을 호출하면, ; 구분자가 인식되어 query 문자열의 각 인스턴스가 두 개의 query로 계산됩니다. 그 결과 10개가 아니라 5개의 row만 insert됩니다.

1mysqlslap --delimiter=";" --number-of-queries=10
2            --query="use test;insert into t values(null)"

• --only-print

Property	Value
Command-Line Format	--only-print
Type	Boolean
Default Value	FALSE

데이터베이스에 연결하지 않습니다. mysqlslap은 수행할 작업만 출력합니다.

• --password[=password], -p[password]

Property	Value
Command-Line Format	--password[=password]
Type	String

서버에 연결할 때 사용하는 MySQL 계정의 패스워드입니다. 패스워드 값은 선택 사항입니다. 지정하지 않으면 mysqlslap이 프롬프트를 표시합니다. 지정하는 경우, --password= 또는 -p와 그 뒤에 오는 패스워드 사이에 공백이 없어야 합니다. 패스워드 옵션이 지정되지 않으면, 기본값은 패스워드를 보내지 않는 것입니다.

커맨드라인에 패스워드를 지정하는 것은 보안상 안전하지 않다고 간주해야 합니다. 커맨드라인에서 패스워드를 제공하지 않으려면 옵션 파일을 사용하십시오. Section 8.1.2.1, “End-User Guidelines for Password Security”를 참조하십시오.

패스워드가 없으며 mysqlslap이 패스워드를 요구하는 프롬프트를 표시하지 않도록 명시적으로 지정하려면 --skip-password 옵션을 사용하십시오.

• --password1[=pass_val]

서버에 연결할 때 사용하는 MySQL 계정의 다중 요소 인증 factor 1에 대한 패스워드입니다. 패스워드 값은 선택 사항입니다. 지정하지 않으면 mysqlslap이 프롬프트를 표시합니다. 지정하는 경우, --password1=과 그 뒤에 오는 패스워드 사이에 공백이 없어야 합니다. 패스워드 옵션이 지정되지 않으면, 기본값은 패스워드를 보내지 않는 것입니다.

커맨드라인에 패스워드를 지정하는 것은 보안상 안전하지 않다고 간주해야 합니다. 커맨드라인에서 패스워드를 제공하지 않으려면 옵션 파일을 사용하십시오. Section 8.1.2.1, “End-User Guidelines for Password Security”를 참조하십시오.

패스워드가 없으며 mysqlslap이 패스워드를 요구하는 프롬프트를 표시하지 않도록 명시적으로 지정하려면 --skip-password1 옵션을 사용하십시오.

--password1과 --password는 동의어이며, --skip-password1과 --skip-password도 동의어입니다.

• --password2[=pass_val]

서버에 연결할 때 사용하는 MySQL 계정의 다중 요소 인증 factor 2에 대한 패스워드입니다. 이 옵션의 의미는 --password1의 의미와 유사합니다. 자세한 내용은 해당 옵션 설명을 참조하십시오.

• --password3[=pass_val]

서버에 연결할 때 사용하는 MySQL 계정의 다중 요소 인증 factor 3에 대한 패스워드입니다. 이 옵션의 의미는 --password1의 의미와 유사합니다. 자세한 내용은 해당 옵션 설명을 참조하십시오.

• --pipe, -W

Property	Value
Command-Line Format	--pipe
Type	String

Windows에서 named pipe를 사용하여 서버에 연결합니다. 이 옵션은 named_pipe 시스템 변수가 named-pipe 연결을 지원하도록 활성화된 상태에서 서버가 시작된 경우에만 적용됩니다. 또한, 연결을 시도하는 사용자는 named_pipe_full_access_group 시스템 변수에 의해 지정된 Windows 그룹의 구성원이어야 합니다.

• --plugin-dir=dir_name

Property	Value
Command-Line Format	--plugin-dir=dir_name
Type	Directory name

플러그인을 찾을 디렉터리입니다. --default-auth 옵션을 사용하여 인증 플러그인을 지정했으나 mysqlslap이 이를 찾지 못하는 경우 이 옵션을 지정합니다. Section 8.2.17, “Pluggable Authentication”를 참조하십시오.

• --port=port_num, -P port_num

Property	Value
Command-Line Format	--port=port_num
Type	Numeric
Default Value	3306

TCP/IP 연결에서 사용할 포트 번호입니다.

• --post-query=value

Property	Value
Command-Line Format	--post-query=value
Type	String

테스트가 완료된 후 실행할 문을 포함하는 파일 또는 문자열입니다. 이 실행은 타이밍 용도로 계산되지 않습니다.

• --post-system=str

Property	Value
Command-Line Format	--post-system=str
Type	String

테스트가 완료된 후 system()을 사용하여 실행할 문자열입니다. 이 실행은 타이밍 용도로 계산되지 않습니다.

• --pre-query=value

Property	Value
Command-Line Format	--pre-query=value
Type	String

테스트를 실행하기 전에 실행할 문을 포함하는 파일 또는 문자열입니다. 이 실행은 타이밍 용도로 계산되지 않습니다.

• --pre-system=str

Property	Value
Command-Line Format	--pre-system=str
Type	String

테스트를 실행하기 전에 system()을 사용하여 실행할 문자열입니다. 이 실행은 타이밍 용도로 계산되지 않습니다.

• --print-defaults

Property	Value
Command-Line Format	--print-defaults

프로그램 이름과 옵션 파일에서 가져오는 모든 옵션을 출력합니다.

이 옵션과 다른 옵션 파일 관련 옵션에 대한 추가 정보는 Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”를 참조하십시오.

• --protocol={TCP|SOCKET|PIPE|MEMORY}

Property	Value
Command-Line Format	--protocol=type
Type	String
Default Value	[see text]
Valid Values	TCP<br>SOCKET<br>PIPE<br>MEMORY

서버에 연결하는 데 사용할 전송 프로토콜입니다. 다른 연결 파라미터가 일반적으로 원하는 프로토콜이 아닌 다른 프로토콜을 사용하도록 결정되는 경우에 유용합니다. 허용되는 값에 대한 자세한 내용은 Section 6.2.7, “Connection Transport Protocols”를 참조하십시오.

• --query=value, -q value

Property	Value
Command-Line Format	--query=value
Type	String

데이터를 조회할 때 사용할 SELECT 문을 포함하는 파일 또는 문자열입니다.

• --server-public-key-path=file_name

Property	Value
Command-Line Format	--server-public-key-path=file_name
Type	File name

서버가 RSA 키 페어 기반 패스워드 교환을 위해 요구하는 public key의 클라이언트 측 사본을 포함하는 PEM 포맷 파일의 경로 이름입니다. 이 옵션은 sha256_password 또는 caching_sha2_password 인증 플러그인으로 인증하는 클라이언트에 적용됩니다. 이 플러그인으로 인증하지 않는 계정에 대해서는 무시됩니다. 또한, 클라이언트가 보안 연결을 사용하여 서버에 연결하는 경우와 같이 RSA 기반 패스워드 교환이 사용되지 않을 때도 무시됩니다.

--server-public-key-path=file_name가 지정되고 유효한 public key 파일을 지정하는 경우, 이는 --get-server-public-key보다 우선합니다.

sha256_password의 경우, 이 옵션은 MySQL이 OpenSSL을 사용하여 빌드된 경우에만 적용됩니다.

sha256_password 및 caching_sha2_password 플러그인에 대한 정보는 Section 8.4.1.2, “SHA-256 Pluggable Authentication” 및 Section 8.4.1.1, “Caching SHA-2 Pluggable Authentication”을 참조하십시오.

• --shared-memory-base-name=name

Property	Value
Command-Line Format	--shared-memory-base-name=name
Platform Specific	Windows

Windows에서 로컬 서버에 대한 공유 메모리 연결에 사용할 공유 메모리 이름입니다. 기본값은 MYSQL입니다. 공유 메모리 이름은 대소문자를 구분합니다.

이 옵션은 shared_memory 시스템 변수가 공유 메모리 연결을 지원하도록 활성화된 상태에서 서버가 시작된 경우에만 적용됩니다.

• --silent, -s

Property	Value
Command-Line Format	--silent

silent 모드입니다. 출력이 없습니다.

• --socket=path, -S path

Property	Value
Command-Line Format	`--socket={file_name
Type	String

localhost에 대한 연결에서 사용할 Unix 소켓 파일이거나, Windows에서 사용할 named pipe 이름입니다.

Windows에서 이 옵션은 named_pipe 시스템 변수가 named-pipe 연결을 지원하도록 활성화된 상태에서 서버가 시작된 경우에만 적용됩니다. 또한, 연결을 시도하는 사용자는 named_pipe_full_access_group 시스템 변수에 의해 지정된 Windows 그룹의 구성원이어야 합니다.

• --sql-mode=mode

Property	Value
Command-Line Format	--sql-mode=mode
Type	String

클라이언트 세션의 SQL 모드를 설정합니다.

• --ssl*

--ssl로 시작하는 옵션은 서버에 암호화를 사용하여 연결할지 여부와 SSL 키 및 인증서의 위치를 지정합니다. Command Options for Encrypted Connections를 참조하십시오.

• --ssl-fips-mode={OFF|ON|STRICT}

Property	Value
Command-Line Format	`--ssl-fips-mode={OFF
Deprecated	Yes
Type	Enumeration
Default Value	OFF
Valid Values	OFF<br>ON<br>STRICT

클라이언트 측에서 FIPS 모드를 활성화할지 여부를 제어합니다. --ssl-fips-mode 옵션은 암호화된 연결을 설정하는 데 사용되는 다른 --ssl-xxx 옵션과 달리, 허용할 암호 연산을 제어하는 데 사용됩니다. Section 8.8, “FIPS Support”를 참조하십시오.

허용되는 --ssl-fips-mode 값은 다음과 같습니다:

• OFF: FIPS 모드 비활성화.

• ON: FIPS 모드 활성화.

• STRICT: “strict” FIPS 모드 활성화.

참고

OpenSSL FIPS Object Module을 사용할 수 없는 경우, --ssl-fips-mode에 허용되는 유일한 값은 OFF입니다. 이 경우, --ssl-fips-mode를 ON 또는 STRICT로 설정하면, 클라이언트가 시작 시 경고를 출력하고 non-FIPS 모드에서 동작합니다.

이 옵션은 deprecated되었습니다. 향후 MySQL 버전에서 제거될 예정입니다.

• --tls-ciphersuites=ciphersuite_list

Property	Value
Command-Line Format	--tls-ciphersuites=ciphersuite_list
Type	String

TLSv1.3을 사용하는 암호화된 연결에 허용되는 ciphersuite입니다. 값은 하나 이상의 ciphersuite 이름을 :로 구분한 목록입니다. 이 옵션에 지정할 수 있는 ciphersuite는 MySQL을 컴파일할 때 사용한 SSL 라이브러리에 따라 달라집니다. 자세한 내용은 Section 8.3.2, “Encrypted Connection TLS Protocols and Ciphers”를 참조하십시오.

• --tls-sni-servername=server_name

Property	Value
Command-Line Format	--tls-sni-servername=server_name
Type	String

지정된 경우, 이 이름은 libmysqlclient C API 라이브러리에 mysql_options()의 MYSQL_OPT_TLS_SNI_SERVERNAME 옵션을 사용하여 전달됩니다. 서버 이름은 대소문자를 구분하지 않습니다. 현재 세션에서 클라이언트가 지정한 서버 이름을 확인하려면 Tls_sni_server_name 상태 변수를 확인하십시오.

Server Name Indication(SNI)는 TLS 프로토콜의 확장입니다 (이 옵션이 작동하려면 OpenSSL이 TLS 확장을 사용하여 컴파일되어야 합니다). MySQL의 SNI 구현은 클라이언트 측만을 나타냅니다.

• --tls-version=protocol_list

Property	Value
Command-Line Format	--tls-version=protocol_list
Type	String
Default Value	TLSv1,TLSv1.1,TLSv1.2,TLSv1.3 (OpenSSL 1.1.1 이상)<br>TLSv1,TLSv1.1,TLSv1.2 (그 외의 경우)

암호화된 연결에 허용되는 TLS 프로토콜입니다. 값은 하나 이상의 프로토콜 이름을 comma로 구분한 목록입니다. 이 옵션에 지정할 수 있는 프로토콜은 MySQL을 컴파일할 때 사용한 SSL 라이브러리에 따라 달라집니다. 자세한 내용은 Section 8.3.2, “Encrypted Connection TLS Protocols and Ciphers”를 참조하십시오.

• --user=user_name, -u user_name

Property	Value
Command-Line Format	--user=user_name,
Type	String

서버에 연결할 때 사용할 MySQL 계정의 사용자 이름입니다.

• --verbose, -v

Property	Value
Command-Line Format	--verbose

verbose 모드입니다. 프로그램이 수행하는 작업에 대한 더 많은 정보를 출력합니다. 이 옵션은 출력되는 정보의 양을 늘리기 위해 여러 번 사용할 수 있습니다.

• --version, -V

Property	Value
Command-Line Format	--version

버전 정보를 표시하고 종료합니다.

• --zstd-compression-level=level

Property	Value
Command-Line Format	--zstd-compression-level=#
Type	Integer

zstd 압축 알고리즘을 사용하는 서버 연결에 사용할 압축 레벨입니다. 허용되는 레벨은 1에서 22까지이며, 값이 클수록 더 높은 압축 레벨을 의미합니다. 기본 zstd 압축 레벨은 3입니다. 압축 레벨 설정은 zstd 압축을 사용하지 않는 연결에는 영향을 미치지 않습니다.

자세한 내용은 Section 6.2.8, “Connection Compression Control”을 참조하십시오.