如何用环境变量实现PostgreSQL备份？原命令为何报错？

问题背景 #

我尝试用这条命令备份Docker容器里的PostgreSQL数据库：

sudo docker exec -t db pg_dump -c -U "$DATABASE_USER" > $BACKUP_DIR/backup$DATE.sql

结果却收到报错：

pg_dump: error: connection to database "root" failed: FATAL: role "root" does not exist

我明明在.env文件里定义了DATABASE_USER，而且docker-compose也通过env_file: ./.env引用了这个文件，完全没提到过root角色，这问题到底出在哪？

原因分析 #

问题出在环境变量的作用域：宿主机终端里的$DATABASE_USER是宿主机的环境变量，不是容器内部的。如果宿主机没定义这个变量，pg_dump会默认使用当前执行命令的系统用户（也就是sudo对应的root）作为数据库角色，这就导致了“role 'root' does not exist”的错误。

解决方案 #

要获取容器内部的环境变量，得通过docker exec进入容器读取对应的变量值。我找到的可行命令是：

sudo docker exec -t db pg_dump -c -U $(sudo docker exec -it db /bin/sh -c 'printf $DATABASE_USER') > $BACKUP_DIR/backup$DATE.sql

这条命令里，$(sudo docker exec -it db /bin/sh -c 'printf $DATABASE_USER')会先执行容器内的命令，输出.env里定义的DATABASE_USER值，再作为pg_dump的-U参数传入。

如果需要指定备份的数据库（无需切换数据库即可操作），可以再加上-d参数，读取容器内的DATABASE_NAME变量：

sudo docker exec -t db pg_dump -c -U $(sudo docker exec -it db /bin/sh -c 'printf $DATABASE_USER') -d $(sudo docker exec -it db /bin/sh -c 'printf $DATABASE_NAME') > $BACKUP_DIR/backup$DATE.sql

内容的提问来源于stack exchange，提问作者Downvote Hunter