6.9 Environment Variables

6.9 Environment Variables

이 섹션에서는 MySQL에서 직접 또는 간접적으로 사용하는 환경 변수를 나열합니다. 이들 대부분은 이 매뉴얼의 다른 위치에서도 찾을 수 있습니다.

커맨드 라인의 옵션은 옵션 파일과 환경 변수에 지정된 값보다 우선하며, 옵션 파일의 값은 환경 변수의 값보다 우선합니다. 많은 경우, MySQL의 동작을 변경하기 위해 환경 변수를 사용하는 것보다 옵션 파일을 사용하는 편이 더 좋습니다. Section 6.2.2.2, “Using Option Files”를 참조하십시오.

Variable	Description
AUTHENTICATION_KERBEROS_CLIENT_LOG	Kerberos 인증 로깅 레벨.
AUTHENTICATION_LDAP_CLIENT_LOG	클라이언트 측 LDAP 인증 로깅 레벨.
AUTHENTICATION_PAM_LOG	PAM<br> 인증 플러그인 디버그 로깅 설정.
CC	C 컴파일러의 이름 (CMake 실행용).
CXX	C++ 컴파일러의 이름 (CMake 실행용).
CC	C 컴파일러의 이름 (CMake 실행용).
DBI_USER	Perl DBI의 기본 사용자 이름.
DBI_TRACE	Perl DBI의 트레이스 옵션.
HOME	mysql 히스토리 파일의 기본 경로는<br> $HOME/.mysql_history입니다.
LD_RUN_PATH	libmysqlclient.so의 위치를 지정하는 데 사용됩니다.
LIBMYSQL_ENABLE_CLEARTEXT_PLUGIN	mysql_clear_password 인증 플러그인 활성화;<br> Section 8.4.1.3, “Client-Side Cleartext Pluggable Authentication”를 참조하십시오.
LIBMYSQL_PLUGIN_DIR	클라이언트 플러그인을 찾을 디렉터리.
LIBMYSQL_PLUGINS	프리로드할 클라이언트 플러그인.
MYSQL_DEBUG	디버깅 시 디버그 트레이스 옵션.
MYSQL_GROUP_SUFFIX	옵션 그룹 suffix 값 ( --defaults-group-suffix를 지정하는 것과 유사).
MYSQL_HISTFILE	mysql 히스토리 파일의 경로. 이 변수가<br> 설정되면, 그 값이<br> $HOME/.mysql_history 기본값을 오버라이드합니다.
MYSQL_HISTIGNORE	mysql이 $HOME/.mysql_history 또는<br> --syslog가 주어진 경우<br> syslog에 로그하지 않아야 할 문장을 지정하는 패턴.
MYSQL_HOME	서버별 my.cnf 파일이 존재하는 디렉터리의 경로.
MYSQL_HOST	mysql 커맨드라인 클라이언트에서 사용하는 기본 호스트 이름.
MYSQL_PS1	mysql 커맨드라인 클라이언트에서 사용할 커맨드 프롬프트.
MYSQL_PWD	mysqld에 연결할 때 사용할 기본 패스워드. 이를<br> 사용하는 것은 보안상 안전하지 않습니다. 표 다음의 노트를 참조하십시오.
MYSQL_TCP_PORT	기본 TCP/IP 포트 번호.
MYSQL_TEST_LOGIN_FILE	.mylogin.cnf 로그인 경로 파일의 이름.
MYSQL_TEST_TRACE_CRASH	테스트 프로토콜 트레이스 플러그인이 클라이언트를 크래시시키는지 여부. 표<br> 다음의 노트를 참조하십시오.
MYSQL_TEST_TRACE_DEBUG	테스트 프로토콜 트레이스 플러그인이 출력을 생성하는지 여부. 표<br> 다음의 노트를 참조하십시오.
MYSQL_UNIX_PORT	기본 Unix 소켓 파일 이름; localhost에 대한 연결에 사용.
MYSQLX_TCP_PORT	X Plugin 기본 TCP/IP 포트 번호.
MYSQLX_UNIX_PORT	X Plugin 기본 Unix 소켓 파일 이름; localhost에 대한 연결에 사용.
NOTIFY_SOCKET	mysqld가 systemd와 통신하는 데 사용하는 소켓.
PATH	셸이 MySQL 프로그램을 찾는 데 사용.
PKG_CONFIG_PATH	mysqlclient.pc pkg-config 파일의 위치. 표 다음의 노트를 참조하십시오.
TMPDIR	임시 파일이 생성되는 디렉터리.
TZ	로컬 타임존으로 설정해야 합니다. Section B.3.3.7, “Time Zone Problems”를<br> 참조하십시오.
UMASK	파일을 생성할 때의 사용자 파일 생성 모드. 표 다음의<br> 노트를 참조하십시오.
UMASK_DIR	디렉터리를 생성할 때의 사용자 디렉터리 생성 모드. 표 다음의<br> 노트를 참조하십시오.
USER	Windows에서 mysqld에 연결할 때 사용할 기본 사용자 이름.

Variable	Description

mysql 히스토리 파일에 대한 정보는 Section 6.5.1.3, “mysql Client Logging”을 참조하십시오.

MySQL 패스워드를 지정하기 위해 MYSQL_PWD를 사용하는 것은 극도로 보안에 취약한 것으로 간주해야 하며 사용해서는 안 됩니다. 일부 버전의 ps에는 실행 중인 프로세스의 환경을 표시하는 옵션이 포함되어 있습니다. 일부 시스템에서는 MYSQL_PWD를 설정하면, ps를 실행하는 다른 모든 사용자에게 패스워드가 노출됩니다. 이러한 버전의 ps가 없는 시스템에서도, 사용자가 프로세스 환경을 조사할 수 있는 다른 방법이 전혀 없다고 가정하는 것은 현명하지 않습니다.

MYSQL_PWD는 MySQL 9.5부터 deprecated되었으며, 앞으로의 MySQL 버전에서 제거될 것으로 예상됩니다.

MYSQL_TEST_LOGIN_FILE은 로그인 경로 파일의 경로 이름입니다 ( mysql_config_editor가 생성하는 파일). 설정되지 않은 경우, 기본값은 Windows에서는 %APPDATA%\MySQL\.mylogin.cnf 디렉터리고, non-Windows 시스템에서는 $HOME/.mylogin.cnf입니다. Section 6.6.7, “mysql_config_editor — MySQL Configuration Utility”를 참조하십시오.

MYSQL_TEST_TRACE_DEBUG와 MYSQL_TEST_TRACE_CRASH 변수는, MySQL이 해당 플러그인이 활성화된 상태로 빌드된 경우 테스트 프로토콜 트레이스 클라이언트 플러그인을 제어합니다. 자세한 내용은 Using the Test Protocol Trace Plugin을 참조하십시오.

기본 UMASK와 UMASK_DIR 값은 각각 0640과 0750입니다. UMASK 또는 UMASK_DIR의 값이 0으로 시작하면, MySQL은 그 값을 8진수로 간주합니다. 예를 들어, UMASK=0600으로 설정하는 것은 UMASK=384로 설정하는 것과 동일한데, 0600(8진수)은 384(10진수)이기 때문입니다.

UMASK와 UMASK_DIR 변수는 이름과는 달리 mask가 아니라 모드로 사용됩니다:

• UMASK가 설정된 경우, mysqld는 파일 생성 시 모드로 ($UMASK | 0600)을 사용하므로, 새로 생성되는 파일의 모드는 0600에서 0666 범위(모두 8진수) 내에 있게 됩니다.

• UMASK_DIR이 설정된 경우, mysqld는 디렉터리 생성 시 기본 모드로 ($UMASK_DIR | 0700)을 사용하고, 그 후 이를 ~(~$UMASK & 0666)와 AND 연산하여, 새로 생성되는 디렉터리의 모드가 0700에서 0777 범위(모두 8진수) 내에 있도록 합니다. AND 연산은 디렉터리 모드에서 읽기 및 쓰기 권한을 제거할 수 있지만, 실행 권한은 제거하지 않습니다.

Section B.3.3.1, “Problems with File Permissions”도 참조하십시오.

MySQL 프로그램을 빌드하는 데 pkg-config를 사용하는 경우, PKG_CONFIG_PATH를 설정해야 할 수도 있습니다. Building C API Client Programs Using pkg-config를 참조하십시오.