签到成功

知道了

CNDBA社区CNDBA社区

Oracle 12c 中推荐使用 catcon.pl 执行SQL脚本

2016-09-06 01:21 4394 0 原创 Oracle 18c
作者： dave
本文链接：http://www.cndba.cn/cndba/dave/article/225


1    说明

      在Oracle 12c中，Oracle 建议使用catcon.pl 脚本来执行SQL 脚本和SQL 语句，其可以在root 和指定的PDB中执行。 Catcon.pl脚本是一个perl 脚本，需要在操作系统中执行。
    在执行脚本时可以指定-c 参数指定特定的container，如果没有指定，默认对所有container有效。 脚本在$ORACLE_HOME/rdbms/admin目录下。

[oracle@cndba admin]$ pwd
/u01/app/oracle/product/12.1.0/db_1/rdbms/admin[oracle@cndba admin]$ ll catcon.pl
-rw-r--r--. 1 oracle oinstall 13220 Jun 14  2014 catcon.pl[oracle@cndba admin]$[oracle@cndba admin]$ $ORACLE_HOME/perl/bin/perl catcon.pl

  Usage: catcon  [-u username[/password]] [-U username[/password]]                 [-d directory] [-l directory]                 [{-c|-C} container] [-p degree-of-parallelism]                 [-z EZConnect strings]                 [-e] [-s]                 [-E { ON | errorlogging-table-other-than-SPERRORLOG } ]                 [-I]                 [-g]                 [-f]                 [-r]
                 -b log-file-name-base
                 --
                 { sqlplus-script [arguments] | --x<SQL-statement> } ...

   Optional:
     -u username (optional /password; otherwise prompts for password)
        used to connect to the database to run user-supplied scripts or
        SQL statements
        defaults to "/ as sysdba"
     -U username (optional /password; otherwise prompts for password)
        used to connect to the database to perform internal tasks
        defaults to "/ as sysdba"
     -d directory containing the file to be run
     -l directory to use for spool log files
     -c container(s) in which to run sqlplus scripts, i.e. skip all
        Containers not named here; for example,
          -c 'PDB1 PDB2',
     -C container(s) in which NOT to run sqlplus scripts, i.e. skip all
        Containers named here; for example,
          -C 'CDB$ROOT PDB3'

       NOTE: -c and -C are mutually exclusive

     -p expected number of concurrent invocations of this script on a given
        host

       NOTE: this parameter rarely needs to be specified

     -z blank-separated EZConnect strings corresponding to RAC instances
        which can be used to run scripts
     -e sets echo on while running sqlplus scripts
     -s output of running every script will be spooled into a file whose name
        will be
          <log-file-name-base>_<script_name_without_extension>_[<container_name_if_any>].<default_extension>
     -E sets errorlogging on; if ON is specified, default error logging table
        will be used, otherwise, specified error logging table (which must
        have been created in every Container) will be used
     -I do not issue set Errorlogging Identifier (ostensibly because the
        caller already did it and does not want us to override it)
     -g turns on production of debugging info while running this script
     -f instructs catcon to ignore PDBs which are closed or, if -c or -C was
        used, do not exist and process existing PDBs which were specified
        (explicitly or implicitly) and are open
        
        NOTE: if this flag is not specified and some specified PDBs do not
              exist or are not open, an error will be returned and none of
              the Containers will be processed.
      
     -r causes scripts to be run in all PDBs and then in the Root (reverse
        of the default order); required for running catdwgrd.sql in a CDB

   Mandatory:
     -b base name (e.g. catcon_test) for log and spool file names
        
     sqlplus-script - sqlplus script to run OR
     SQL-statement  - a statement to execute

   NOTES:
     - if --x<SQL-statement> is the first non-option string, it needs to be
       preceeded with -- to avoid confusing module parsing options into
       assuming that '-' is an option which that module is not expecting and
       about which it will complain
     - command line parameters to SQL scripts can be introduced using --p
       interactive (or secret) parameters to SQL scripts can be introduced
       using --P

     For example,
       perl catcon.pl ... x.sql '--pJohn' '--PEnter Password for John:' ...





2    使用示例

2.1     在CDB中所有的Containers中执行catblock.sql脚本

[oracle@cndba admin]$ $ORACLE_HOME/perl/bin/perl $ORACLE_HOME/rdbms/admin/catcon.pl -u SYS -d $ORACLE_HOME/rdbms/admin -b catblock_output catblock.sql
catcon: ALL catcon-related output will be written to catblock_output_catcon_24939.lst
catcon: See catblock_output*.log files for output generated by scripts
catcon: See catblock_output_*.lst files for spool files, if any
Enter Password:
catcon.pl: completed successfully[oracle@cndba admin]$



相关参数说明：
-u：指定每个container中执行命令的用户。
-d：指定执行脚本的目录。
-b：指定输出log文件的名称。

我们这里没有指定-c，所以会在所有的container中执行，如果有PDB 没有open，那么就会报错。

2.2     在指定的PDB中执行catblock.sql脚本http://www.cndba.cn/cndba/dave/article/225

http://www.cndba.cn/cndba/dave/article/225 

SQL> show pdbs

    CON_ID CON_NAME              OPEN MODE  RESTRICTED
---------- ------------------------------ ---------- ----------
     2 PDB$SEED              READ ONLY  NO
     3 PDB1               READ WRITE NO
     4 IM                  READ WRITE NO
SQL>[oracle@cndba ~]$ $ORACLE_HOME/perl/bin/perl $ORACLE_HOME/rdbms/admin/catcon.pl -u SYS -U SYS -d $ORACLE_HOME/rdbms/admin -l '/tmp' -c 'IM' -b catblock_output catblock.sql
catcon: ALL catcon-related output will be written to /tmp/catblock_output_catcon_25194.lst
catcon: See /tmp/catblock_output*.log files for output generated by scripts
catcon: See /tmp/catblock_output_*.lst files for spool files, if any
Enter Password:
Enter Password:
catcon.pl: completed successfully[oracle@cndba ~]$




除了上节讲的参数之外，这里还多了3个参数：
-U： 指定执行内部任务的用户。
-l：指定输出日志文件的目录。
-c：指定在哪些PDB上执行脚本。



2.3     在CDB中除了指定的PDB之外的container上执行catblock.sql脚本

http://www.cndba.cn/cndba/dave/article/225
http://www.cndba.cn/cndba/dave/article/225

SQL> show pdbs

    CON_ID CON_NAME              OPEN MODE  RESTRICTED
---------- ------------------------------ ---------- ----------
     2 PDB$SEED              READ ONLY  NO
     3 PDB1               READ WRITE NO
     4 IM                  READ WRITE NO[oracle@cndba ~]$ $ORACLE_HOME/perl/bin/perl $ORACLE_HOME/rdbms/admin/catcon.pl -u SYS -d $ORACLE_HOME/rdbms/admin -l '/tmp' -C 'IM' -b catblock_output catblock.sql
catcon: ALL catcon-related output will be written to /tmp/catblock_output_catcon_25305.lst
catcon: See /tmp/catblock_output*.log files for output generated by scripts
catcon: See /tmp/catblock_output_*.lst files for spool files, if any
Enter Password:
catcon.pl: completed successfully[oracle@cndba ~]$



这里只有一个新参数：
-C：表示除了这个PDB,在其他的PDB上执行。

2.4     执行带有命令行参数的SQL 脚本

$ORACLE_HOME/perl/bin/perl $ORACLE_HOME/rdbms/admin/catcon.pl -u SYS -d /u01/scripts -b custom_script_output custom_script.sql '--phr' '--PEnter password for user hr:'



参数说明如下：
The --p parameter specifies hr for a command line parameter
The --P parameter specifies an interactive parameter that prompts for the password of user hr.


2.5     在CDB的所有Container中执行SQL 语句

http://www.cndba.cn/cndba/dave/article/225
http://www.cndba.cn/cndba/dave/article/225
http://www.cndba.cn/cndba/dave/article/225

[oracle@cndba ~]$ $ORACLE_HOME/perl/bin/perl $ORACLE_HOME/rdbms/admin/catcon.pl -u SYS -e -b select_output -- --x'SELECT * FROM DUAL'
catcon: ALL catcon-related output will be written to select_output_catcon_25562.lst
catcon: See select_output*.log files for output generated by scripts
catcon: See select_output_*.lst files for spool files, if any
Enter Password:
catcon.pl: completed successfully



--查看生成的log：

http://www.cndba.cn/cndba/dave/article/225
http://www.cndba.cn/cndba/dave/article/225

[oracle@cndba ~]$ ls
20831110                   custom_script_output2.log               Desktop                               Public
awrrpt_1_93_94_2.html      custom_script_output3.log               Documents                             select_output0.log
awrrpt_1_93_94.html        custom_script_output_catcon_25434.lst   Downloads                             select_output1.log
awrrpt_1_95_96.html        custom_script_output_catcon_25482.lst   Music                                 select_output2.log
awrrpt_1_96_97.html        custom_script_output_catcon_25507.done  p20831110_121020_Linux-x86-64_db.zip  select_output3.log
cndba.dmp                  custom_script_output_catcon_25508.done  p6880880_121010_Linux-x86-64.zip      select_output_catcon_25562.lst
custom_script_output0.log  custom_script_output_catcon_25509.done  PatchSearch.xml                       Templates
custom_script_output1.log  custom_script_output_catcon_25510.done  Pictures                              Videos[oracle@cndba ~]$ cat select_output0.log

SQL*Plus: Release 12.1.0.2.0 Production on Sat Nov 7 06:00:36 2015

Copyright (c) 1982, 2014, Oracle.  All rights reserved.

SQL> Connected.
SQL>   2  
Session altered.

SQL>   2  
Session altered.

SQL> SQL>   2  
Session altered.

SQL>   2  
Session altered.

SQL> SQL>
SQL>   2  
Session altered.

SQL>
NOW_CONNECTED_TO
--------------------------------------------------------------------------------
==== Current Container = CDB$ROOT Id = 1 ====

SQL>
NOW_CONNECTED_TO
--------------------------------------------------------------------------------
==== Current Container = CDB$ROOT Id = 1 ====

SQL>   2  
Session altered.

SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL>   2  
CATCONSECTION
--------------------------
==== CATCON EXEC ROOT ====

SQL>
BEGIN_RUNNING
--------------------------------------------------------------------------------
==== SELECT * FROM DUAL Container:CDB$ROOT Id:1 15-11-07 06:00:37 Proc:0 ====

SQL>
BEGIN_RUNNING
--------------------------------------------------------------------------------
==== SELECT * FROM DUAL Container:CDB$ROOT Id:1 15-11-07 06:00:37 Proc:0 ====

SQL>   2  
Session altered.

SQL>   2  
Session altered.

SQL>   2  
D
-
X

SQL>
END_RUNNING
--------------------------------------------------------------------------------
==== SELECT * FROM DUAL Container:CDB$ROOT Id:1 15-11-07 06:00:37 Proc:0 ====

SQL>
END_RUNNING
--------------------------------------------------------------------------------
==== SELECT * FROM DUAL Container:CDB$ROOT Id:1 15-11-07 06:00:37 Proc:0 ====

SQL> SQL>
SQL>   2  
Session altered.

SQL> SQL>
SQL>   2  
Session altered.

SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL> SQL>   2  
Session altered.

SQL>
NOW_CONNECTED_TO
--------------------------------------------------------------------------------
==== Current Container = PDB$SEED Id = 2 ====

SQL>
NOW_CONNECTED_TO
--------------------------------------------------------------------------------
==== Current Container = PDB$SEED Id = 2 ====

SQL> SQL>   2  
CATCONSECTION
-----------------------------------
==== CATCON EXEC IN CONTAINERS ====

SQL>
BEGIN_RUNNING
--------------------------------------------------------------------------------
==== SELECT * FROM DUAL Container:PDB$SEED Id:2 15-11-07 06:00:38 Proc:0 ====

SQL>
BEGIN_RUNNING
--------------------------------------------------------------------------------
==== SELECT * FROM DUAL Container:PDB$SEED Id:2 15-11-07 06:00:38 Proc:0 ====

SQL>   2  
Session altered.

SQL>   2  
Session altered.

SQL>   2  
D
-
X

SQL>
END_RUNNING
--------------------------------------------------------------------------------
==== SELECT * FROM DUAL Container:PDB$SEED Id:2 15-11-07 06:00:38 Proc:0 ====

SQL>
END_RUNNING
--------------------------------------------------------------------------------
==== SELECT * FROM DUAL Container:PDB$SEED Id:2 15-11-07 06:00:38 Proc:0 ====

SQL> SQL>
SQL>   2  
Session altered.

SQL> SQL>
SQL> ========== PROCESS ENDED ==========
SQL> Disconnected from Oracle Database 12c Enterprise Edition Release 12.1.0.2.0 - 64bit Production
With the Partitioning, OLAP, Advanced Analytics and Real Application Testing options[oracle@cndba ~]$


http://www.cndba.cn/cndba/dave/article/225


版权声明：本文为博主原创文章，未经博主允许不得转载。

用户评论
* 以下用户言论只代表其个人观点，不代表CNDBA社区的观点或立场
dave

dave

关注

人的一生应该是这样度过的：当他回首往事的时候，他不会因为虚度年华而悔恨，也不会因为碌碌无为而羞耻；这样，在临死的时候，他就能够说：“我的整个生命和全部精力，都已经献给世界上最壮丽的事业....."

  • 2284
    原创
  • 3
    翻译
  • 579
    转载
  • 196
    评论
  • 访问：8188502次
  • 积分：4431
  • 等级：核心会员
  • 排名：第1名
精华文章

    达梦数据库运维实战

    Oracle 18c 必须掌握的新特性：管理与实战

    Oracle数据库问题解决方案和故障排除手册
    最新问题
    查看更多+
    热门文章
      热门用户
      推荐用户
        友情链接： CNDBA社区 | openGauss | openEuler | openAnolis | 广告联系: database@ustc.edu
        Copyright © 2016 All Rights Reserved. Powered by CNDBA · 皖ICP备2022006297号-1·

        QQ交流群

        注册联系QQ