6.5.2 mysqladmin — A MySQL Server Administration Program

6.5.2 mysqladmin — A MySQL Server Administration Program

mysqladmin은 관리 작업을 수행하기 위한 클라이언트입니다. 이를 사용하여 서버의 설정과 현재 상태를 확인하고, 데이터베이스를 생성 및 삭제하는 등의 작업을 수행할 수 있습니다.

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

1mysqladmin [options] command [command-arg] [command [command-arg]] ...

mysqladmin은 다음과 같은 커맨드를 지원합니다. 일부 커맨드는 커맨드 이름 뒤에 인수를 받습니다.

• create db_name

_db_name_이라는 이름의 새 데이터베이스를 생성합니다.

• debug

서버에게 디버그 정보를 에러 로그에 기록하도록 지시합니다. 연결된 사용자는 SUPER 권한을 가지고 있어야 합니다. 이 정보의 형식과 내용은 변경될 수 있습니다.

여기에는 이벤트 스케줄러에 대한 정보가 포함됩니다. Section 27.5.5, “Event Scheduler Status”를 참조하십시오.

• drop db_name

_db_name_이라는 이름의 데이터베이스와 그 안의 모든 테이블을 삭제합니다.

• extended-status

서버 상태 변수와 그 값을 표시합니다.

• flush-hosts

호스트 캐시의 모든 정보를 플러시합니다. Section 7.1.12.3, “DNS Lookups and the Host Cache”를 참조하십시오.

• flush-logs [log_type ...]

모든 로그를 플러시합니다.

mysqladmin flush-logs 커맨드는 플러시할 로그를 지정하기 위해 선택적인 로그 타입을 받을 수 있습니다. flush-logs 커맨드 다음에, 다음 로그 타입 중 하나 이상을 공백으로 구분한 목록으로 제공할 수 있습니다: binary, engine, error, general, relay, slow. 이는 FLUSH LOGS SQL 구문에 지정할 수 있는 로그 타입에 해당합니다.

• flush-privileges

그랜트 테이블을 다시 로드합니다 (reload와 동일).

더 이상 사용되지 않으며, 경고를 발생시킵니다. 이 커맨드는 향후 MySQL 버전에서 제거될 것으로 예상해야 합니다.

• flush-status

상태 변수를 초기화합니다.

• flush-tables

모든 테이블을 플러시합니다.

• kill id,id,...

서버 스레드를 종료합니다. 여러 스레드 ID 값을 지정하는 경우, 목록에 공백이 있어서는 안 됩니다.

다른 사용자의 스레드를 종료하려면, 연결된 사용자는 CONNECTION_ADMIN 권한 (또는 더 이상 사용되지 않는 SUPER 권한)을 가지고 있어야 합니다.

• password new_password

새 패스워드를 설정합니다. 이는 서버에 연결할 때 사용하는 계정의 패스워드를 _new_password_로 변경합니다. 따라서 다음 번에 동일한 계정으로 mysqladmin (또는 다른 클라이언트 프로그램)을 호출할 때는 새 패스워드를 지정해야 합니다.

주의

mysqladmin을 사용해 패스워드를 설정하는 것은 안전하지 않은 방법으로 간주해야 합니다. 일부 시스템에서는 다른 사용자가 커맨드 라인을 표시하기 위해 호출할 수 있는 ps와 같은 시스템 상태 프로그램에 패스워드가 노출될 수 있습니다. MySQL 클라이언트는 보통 초기화 과정에서 커맨드 라인의 패스워드 인수를 0으로 덮어씁니다. 하지만 그 값이 보이는 짧은 시간 간격은 여전히 존재합니다. 또한 일부 시스템에서는 이러한 덮어쓰기 전략이 효과가 없어서, 패스워드가 ps에 그대로 보일 수 있습니다. (SystemV Unix 시스템 및 기타 일부 시스템이 이 문제의 영향을 받습니다.)

new_password 값에 공백이나 커맨드 인터프리터에서 특수하게 처리되는 문자가 포함되어 있는 경우, 값을 따옴표로 감싸야 합니다. Windows에서는 작은따옴표가 패스워드에서 제거되지 않고 패스워드의 일부로 해석되므로, 반드시 작은따옴표가 아닌 큰따옴표를 사용해야 합니다. 예:

1mysqladmin password "my new password"

password 커맨드 뒤에 새 패스워드를 생략할 수도 있습니다. 이 경우 mysqladmin이 패스워드 값을 입력하라는 프롬프트를 표시하며, 이를 통해 커맨드 라인에 패스워드를 지정하지 않을 수 있습니다. 패스워드 값을 생략하는 것은 password가 mysqladmin 커맨드 라인의 마지막 커맨드인 경우에만 수행해야 합니다. 그렇지 않으면 다음 인수가 패스워드로 간주됩니다.

주의

서버가 --skip-grant-tables 옵션과 함께 시작된 경우, 이 커맨드를 사용하지 마십시오. 어떠한 패스워드 변경도 적용되지 않습니다. 이는 같은 커맨드 라인에서 그랜트 테이블을 다시 활성화하기 위해 password 커맨드 앞에 flush-privileges를 붙여도 마찬가지입니다. 플러시 작업은 연결 후에 발생하기 때문입니다. 하지만 mysqladmin flush-privileges를 사용해 그랜트 테이블을 다시 활성화한 다음, 별도의 mysqladmin password 커맨드로 패스워드를 변경할 수 있습니다.

• ping

서버가 사용 가능한지 확인합니다. mysqladmin의 반환 상태는 서버가 실행 중이면 0, 실행 중이 아니면 1입니다. 서버가 실행 중이지만 연결을 거부한 경우(예: Access denied와 같은 에러)에도 값은 0입니다. 이는 서버가 실행 중이지 않은 경우와는 다른 상황입니다.

• processlist

활성 서버 스레드 목록을 표시합니다. 이는 SHOW PROCESSLIST 구문의 출력과 유사합니다. --verbose 옵션이 지정되면 출력은 SHOW FULL PROCESSLIST와 같습니다. (Section 15.7.7.32, “SHOW PROCESSLIST Statement”를 참조하십시오.)

• reload

그랜트 테이블을 다시 로드합니다.

더 이상 사용되지 않으며 경고를 발생시킵니다. 이 커맨드는 향후 MySQL 버전에서 제거될 것으로 예상해야 합니다.

• refresh

모든 테이블을 플러시하고 로그 파일을 닫았다가 다시 엽니다.

이 커맨드에 의한 권한 플러시는 더 이상 사용되지 않습니다. 이 동작은 향후 MySQL 버전에서 제거될 것으로 예상해야 합니다.

• shutdown

서버를 중지합니다.

• start-replica

레플리카 서버에서 복제를 시작합니다.

• start-slave

이는 start-replica의 더 이상 사용되지 않는 별칭입니다.

• status

짧은 서버 상태 메시지를 표시합니다.

• stop-replica

레플리카 서버에서 복제를 중지합니다.

• stop-slave

이는 stop-replica의 더 이상 사용되지 않는 별칭입니다.

• variables

서버 시스템 변수와 그 값을 표시합니다.

• version

서버의 버전 정보를 표시합니다.

모든 커맨드는 유일하게 식별 가능한 접두어까지 줄여서 사용할 수 있습니다. 예:

1$> mysqladmin proc stat
2+----+-------+-----------+----+---------+------+-------+------------------+
3| Id | User  | Host      | db | Command | Time | State | Info             |
4+----+-------+-----------+----+---------+------+-------+------------------+
5| 51 | jones | localhost |    | Query   | 0    |       | show processlist |
6+----+-------+-----------+----+---------+------+-------+------------------+
7Uptime: 1473624  Threads: 1  Questions: 39487
8Slow queries: 0  Opens: 541  Flush tables: 1
9Open tables: 19  Queries per second avg: 0.0268

mysqladmin status 커맨드 결과는 다음 값을 표시합니다:

• Uptime

MySQL 서버가 실행된 시간(초)입니다.

• Threads

활성 스레드(클라이언트)의 수입니다.

• Questions

서버가 시작된 이후 클라이언트로부터 받은 쿼리 수입니다.

• Slow queries

long_query_time초를 초과한 쿼리 수입니다. Section 7.4.5, “The Slow Query Log”를 참조하십시오.

• Opens

서버가 오픈한 테이블 수입니다.

• Flush tables

서버가 실행한 flush-*, refresh, reload 커맨드 수입니다.

• Open tables

현재 오픈 상태인 테이블 수입니다.

Unix 소켓 파일을 사용하여 로컬 서버에 연결된 상태에서 mysqladmin shutdown을 실행하면, mysqladmin은 서버가 올바르게 중지되었는지 확인하기 위해 서버의 프로세스 ID 파일이 제거될 때까지 기다립니다.

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

Table 6.11 mysqladmin Options

Option Name	Description
--bind-address	MySQL 서버에 연결할 때 사용할 네트워크 인터페이스 지정
--character-sets-dir	문자 집합이 위치한 디렉터리
--compress	클라이언트와 서버 간에 전송되는 모든 정보를 압축
--compression-algorithms	서버 연결에 허용되는 압축 알고리즘
--connect-timeout	연결 타임아웃까지의 초 단위 시간
--count	반복 커맨드 실행 시 수행할 반복 횟수
--debug	디버깅 로그 출력
--debug-check	프로그램 종료 시 디버깅 정보 출력
--debug-info	프로그램 종료 시 디버깅 정보, 메모리 및 CPU 통계를 출력
--default-auth	사용할 인증 플러그인
--default-character-set	기본 문자 집합 지정
--defaults-extra-file	일반적인 옵션 파일 외에 추가로 읽을 옵션 파일
--defaults-file	지정된 옵션 파일만 읽기
--defaults-group-suffix	옵션 그룹 접미사 값
--enable-cleartext-plugin	클리어텍스트 인증 플러그인 활성화
--force	SQL 에러가 발생해도 계속 실행
--get-server-public-key	서버로부터 RSA 공개 키 요청
--help	도움말 메시지 표시 후 종료
--host	MySQL 서버가 위치한 호스트
--login-path	.mylogin.cnf에서 로그인 경로 옵션 읽기
--no-beep	에러 발생 시 비프 소리 비활성화
--no-defaults	어떠한 옵션 파일도 읽지 않기
--no-login-paths	로그인 경로 파일에서 로그인 경로를 읽지 않기
--password	서버에 연결할 때 사용할 패스워드
--password1	다중 요소 인증을 위한 첫 번째 패스워드
--password2	다중 요소 인증을 위한 두 번째 패스워드
--password3	다중 요소 인증을 위한 세 번째 패스워드
--pipe	네임드 파이프를 사용해 서버에 연결 (Windows 전용)
--plugin-dir	플러그인이 설치된 디렉터리
--port	연결에 사용할 TCP/IP 포트 번호
--print-defaults	기본 옵션을 출력
--protocol	사용할 전송 프로토콜
--relative	--sleep 옵션과 함께 사용 시 현재와 이전 값의 차이를 표시
--server-public-key-path	RSA 공개 키를 포함하는 파일의 경로 이름
--shared-memory-base-name	공유 메모리 연결에 사용할 공유 메모리 이름 (Windows 전용)
--show-warnings	구문 실행 후 경고 표시
--shutdown-timeout	서버 종료를 기다릴 최대 초 단위 시간
--silent	조용한 모드
--sleep	커맨드를 반복 실행하고, 그 사이에 delay 초 동안 대기
--socket	사용할 Unix 소켓 파일 또는 Windows 네임드 파이프
--ssl-ca	신뢰할 수 있는 SSL 인증 기관 목록을 포함하는 파일
--ssl-capath	신뢰할 수 있는 SSL 인증 기관 인증서 파일이 위치한 디렉터리
--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 암호 모음
--tls-sni-servername	클라이언트가 제공하는 서버 이름
--tls-version	암호화된 연결에 허용되는 TLS 프로토콜
--user	서버에 연결할 때 사용할 MySQL 사용자 이름
--verbose	자세한 모드
--version	버전 정보를 표시하고 종료
--vertical	쿼리 출력 행을 세로(각 컬럼 값을 한 줄)에 출력
--wait	연결을 설정할 수 없으면 중단하지 않고 대기 후 재시도
--zstd-compression-level	zstd 압축을 사용하는 서버 연결에 대한 압축 레벨

Option Name	Description

• --help, -?

Property	Value
Command-Line Format	--help

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

• --bind-address=ip_address

Property	Value
Command-Line Format	--bind-address=ip_address

여러 개의 네트워크 인터페이스를 가진 컴퓨터에서, 이 옵션을 사용해 MySQL 서버에 연결할 때 사용할 인터페이스를 선택합니다.

• --character-sets-dir=dir_name

Property	Value
Command-Line Format	--character-sets-dir=path
Type	String
Default Value	[none]

문자 집합이 설치된 디렉터리입니다. Section 12.15, “Character Set Configuration”를 참조하십시오.

• --compress, -C

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

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

이 옵션은 더 이상 사용되지 않습니다. 향후 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”를 참조하십시오.

• --connect-timeout=value

Property	Value
Command-Line Format	--connect-timeout=value
Type	Numeric
Default Value	43200

연결 타임아웃까지의 최대 초 수입니다. 기본값은 43200 (12시간)입니다.

• --count=N, -c N

Property	Value
Command-Line Format	--count=#

--sleep 옵션이 지정된 경우, 반복 커맨드 실행 시 수행할 반복 횟수입니다.

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

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

디버깅 로그를 기록합니다. 일반적인 debug_options 문자열은 d:t:o,file_name입니다. 기본값은 d:t:o,/tmp/mysqladmin.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

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”를 참조하십시오.

• --default-character-set=charset_name

Property	Value
Command-Line Format	--default-character-set=charset_name
Type	String

기본 문자 집합으로 _charset_name_을 사용합니다. Section 12.15, “Character Set Configuration”를 참조하십시오.

• --defaults-extra-file=file_name

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

글로벌 옵션 파일 이후이지만 (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_이 절대 경로 이름이 아니면 현재 디렉터리를 기준으로 해석됩니다.

예외: 이 옵션을 사용하더라도 클라이언트 프로그램은 .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 접미사가 붙은 그룹도 읽습니다. 예를 들어, mysqladmin은 보통 [client] 및 [mysqladmin] 그룹을 읽습니다. 이 옵션이 --defaults-group-suffix=_other로 지정되면, mysqladmin은 [client_other], [mysqladmin_other] 그룹도 읽습니다.

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

• --enable-cleartext-plugin

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

mysql_clear_password 클리어텍스트 인증 플러그인을 활성화합니다. (자세한 내용은 Section 8.4.1.3, “Client-Side Cleartext Pluggable Authentication”를 참조하십시오.)

• --force, -f

Property	Value
Command-Line Format	--force

drop db_name 커맨드에 대해 확인을 요구하지 않습니다. 여러 커맨드가 있는 경우, 에러가 발생해도 계속 실행합니다.

• --get-server-public-key

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

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

--server-public-key-path=file_name 옵션이 유효한 공개 키 파일을 지정하는 경우, 이는 --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 서버에 연결합니다.

• --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-beep, -b

Property	Value
Command-Line Format	--no-beep

서버 연결 실패와 같은 에러에 대해 기본적으로 발생하는 경고 비프음을 억제합니다.

• --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”를 참조하십시오.

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

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

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

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

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

• --password1[=pass_val]

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

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

패스워드가 없으며 mysqladmin이 패스워드를 프롬프트하지 않도록 명시적으로 지정하려면 --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_full_access_group 시스템 변수에 지정된 Windows 그룹의 구성원이어야 합니다.

• --plugin-dir=dir_name

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

플러그인을 찾을 디렉터리입니다. --default-auth 옵션을 사용해 인증 플러그인을 지정했지만 mysqladmin이 해당 플러그인을 찾지 못하는 경우 이 옵션을 지정하십시오. 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 연결에 사용할 포트 번호입니다.

• --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”를 참조하십시오.

• --relative, -r

Property	Value
Command-Line Format	--relative

--sleep 옵션과 함께 사용하면 현재 값과 이전 값의 차이를 표시합니다. 이 옵션은 extended-status 커맨드에서만 동작합니다.

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

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

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

--server-public-key-path=file_name 옵션이 유효한 공개 키 파일을 지정하는 경우, 이는 --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 시스템 변수를 활성화하여 공유 메모리 연결을 지원하도록 시작된 경우에만 적용됩니다.

• --show-warnings

Property	Value
Command-Line Format	--show-warnings

서버로 전송된 구문 실행으로 인해 발생한 경고를 표시합니다.

• --shutdown-timeout=value

Property	Value
Command-Line Format	--shutdown-timeout=seconds
Type	Numeric
Default Value	3600

서버 종료를 기다릴 최대 초 단위 시간입니다. 기본값은 3600 (1시간)입니다.

• --silent, -s

Property	Value
Command-Line Format	--silent

서버에 연결을 설정할 수 없는 경우, 메시지 없이 조용히 종료합니다.

• --sleep=delay, -i delay

Property	Value
Command-Line Format	--sleep=delay

커맨드를 반복 실행하고, 그 사이에 _delay_초 동안 대기합니다. --count 옵션은 반복 횟수를 결정합니다. --count가 지정되지 않으면, mysqladmin은 인터럽트될 때까지 무기한 커맨드를 실행합니다.

• --socket=path, -S path

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

localhost에 대한 연결에서 사용할 Unix 소켓 파일 또는 Windows에서 사용할 네임드 파이프의 이름입니다.

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

• --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로 설정하면 클라이언트는 시작 시 경고를 출력하고 비-FIPS 모드로 동작합니다.

이 옵션은 더 이상 사용되지 않습니다. 향후 MySQL 버전에서 제거될 것으로 예상해야 합니다.

• --tls-ciphersuites=ciphersuite_list

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

TLSv1.3을 사용하는 암호화된 연결에 허용되는 암호 모음입니다. 값은 하나 이상의 암호 모음 이름을 콜론으로 구분한 목록입니다. 이 옵션에 지정할 수 있는 암호 모음은 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 프로토콜입니다. 값은 하나 이상의 프로토콜 이름을 콤마로 구분한 목록입니다. 이 옵션에 지정할 수 있는 프로토콜은 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 계정의 사용자 이름입니다.

Rewriter 플러그인을 사용하는 경우, 이 사용자에게 SKIP_QUERY_REWRITE 권한을 부여하십시오.

• --verbose, -v

Property	Value
Command-Line Format	--verbose

자세한 모드입니다. 프로그램이 수행하는 작업에 대한 더 많은 정보를 출력합니다.

• --version, -V

Property	Value
Command-Line Format	--version

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

• --vertical, -E

Property	Value
Command-Line Format	--vertical

출력을 세로로 인쇄합니다. 이는 --relative와 유사하지만 출력을 세로로 인쇄합니다.

• --wait[=count], -w[count]

Property	Value
Command-Line Format	--wait

연결을 설정할 수 없는 경우 중단하지 않고 대기 후 재시도합니다. count 값을 지정하면 재시도 횟수를 의미합니다. 기본값은 1회입니다.

• --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”를 참조하십시오.