使用Bash脚本连接Oracle SQLPlus失败：语法确认与问题排查

问题背景 #

• 尝试通过Unix Shell脚本连接Oracle SQLPlus失败，怀疑脚本第3行的用户名、密码、SID写法存在问题，原脚本内容如下：

#!/bin/sh
cd /dev/shrd/alt/test1/stest/ptest
V1=`sqlplus testuser/passwd@testSID <<EOF
SELECT count(*) FROM test_table WHERE region='Aus';
EXIT;
EOF`
if [ -z "$V1" ]; then
  echo "No rows returned"
  exit 0
else
  echo $V1
fi

• 添加sqlplus $username/$password语句后，出现报错：ORA-12162: TNS:net service name is incorrectly specified
• 需要验证sqlplus MyUsername/MyPassword@MyHostname:1521/MyServiceName的语法是否可在Shell脚本中使用，并排查是否遗漏必要配置。

语法验证与问题排查 #

1. 直连语法的有效性 #

你提到的sqlplus MyUsername/MyPassword@MyHostname:1521/MyServiceName属于Oracle Easy Connect（EZCONNECT）语法，完全可以在Shell脚本中使用。该语法无需依赖本地TNS配置文件，直接通过主机名、端口、服务名建立连接，是Shell脚本中连接Oracle的常用方式之一。

2. 原脚本的问题分析 #

原脚本第3行的sqlplus testuser/passwd@testSID写法存在两个核心问题：

• 如果testSID是TNS别名，需确保本地$ORACLE_HOME/network/admin/tnsnames.ora中存在对应正确配置，且环境变量TNS_ADMIN指向该配置文件目录（若路径非默认）。
• 如果testSID是想直接指定数据库实例，这种写法不符合EZCONNECT规范，会被系统当作TNS别名处理，因找不到对应条目触发ORA-12162错误。

3. 必要配置检查 #

要确保连接成功，需确认以下几点：

• 网络可达性：脚本运行服务器能ping通Oracle数据库所在的MyHostname，且1521端口开放（可通过telnet MyHostname 1521或nc -zv MyHostname 1521测试）。
• 服务名正确性：确认MyServiceName是Oracle数据库的真实服务名（注意区分SID与服务名，可在数据库端执行SELECT service_name FROM v$session WHERE sid=(SELECT sid FROM v$mystat WHERE rownum=1);查询）。
• 环境变量配置：若未全局配置Oracle环境，脚本中需添加：

  export ORACLE_HOME=/path/to/oracle/client/home
  export PATH=$ORACLE_HOME/bin:$PATH
  

• 权限问题：运行脚本的用户需有执行sqlplus命令的权限，且能访问Oracle客户端相关文件。

4. 修正后的脚本示例 #

将连接部分替换为EZCONNECT语法，同时优化输出处理以避免冗余信息：

#!/bin/sh
# 配置Oracle环境变量（未全局设置时添加）
export ORACLE_HOME=/path/to/oracle/client/home
export PATH=$ORACLE_HOME/bin:$PATH

cd /dev/shrd/alt/test1/stest/ptest

# 静默模式连接，仅提取纯查询结果
V1=`sqlplus -s MyUsername/MyPassword@MyHostname:1521/MyServiceName <<EOF
SET HEADING OFF;
SET FEEDBACK OFF;
SET PAGESIZE 0;
SELECT count(*) FROM test_table WHERE region='Aus';
EXIT;
EOF`

if [ -z "$V1" ]; then
  echo "No rows returned"
  exit 0
else
  echo $V1
fi

说明：-s参数启用sqlplus静默模式，避免输出欢迎、提示信息；SET系列参数可让返回结果仅包含查询数据，便于后续脚本处理。

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