-
Notifications
You must be signed in to change notification settings - Fork 16
/
Copy pathdbfeatusage
executable file
·138 lines (122 loc) · 6.42 KB
/
dbfeatusage
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
#!/bin/env python
##################################################################################################
# Name: dbfeatusage #
# Author: Randy Johnson #
# Description: Report Database Features in Use. #
# #
# Usage: dbfeatusage [options] #
# #
# Options: #
# -h, --help show this help message and exit #
# -o ORDERBY order by 1,2,3 ... #
# -n NAME where feature name like... #
# -u update the feature usage table before report. #
# --s print SQL query. #
# --v print version info. #
# #
# History: #
# #
# Date Ver. Who Change Description #
# ---------- ---- ---------------- ------------------------------------------------------------- #
# 09/16/2015 1.00 Randy Johnson Initial write. #
##################################################################################################
# --------------------------------------
# ---- Import Python Modules -----------
# --------------------------------------
from optparse import OptionParser
from os import environ
from os.path import basename
from sys import argv
from sys import exit
from sys import version_info
from signal import SIGPIPE
from signal import SIG_DFL
from signal import signal
from Oracle import RunSqlplus
from Oracle import SetOracleEnv
from Oracle import ParseConnectString
from Oracle import PrintError
# --------------------------------------
# ---- Main Program --------------------
# --------------------------------------
if (__name__ == '__main__'):
Cmd = basename(argv[0]).split('.')[0]
CmdDesc = 'Database Feature Usage'
Version = '1.00'
VersionDate = 'Tue Sep 15 21:02:11 CDT 2015'
DevState = 'Production'
Banner = CmdDesc + ': Release ' + Version + ' ' + DevState + '. Last updated: ' + VersionDate
Sql = ''
SqlHeader = '/***** ' + CmdDesc.upper() + ' *****/'
ErrChk = False
ArgParser = OptionParser()
ConnStr = ''
# For handling termination in stdout pipe; ex: when you run: oerrdump | head
signal(SIGPIPE, SIG_DFL)
ArgParser.add_option('-o', dest='OrderBy', default='1', type=str, help="order by 1,2,3 ...")
ArgParser.add_option('-n', dest='Name', default='', type=str, help="where feature name like...")
ArgParser.add_option('-u', dest='Update', action='store_true', default=False, help="update the feature usage table before report.")
ArgParser.add_option('--s', dest='Show', action='store_true', default=False, help="print SQL query.")
ArgParser.add_option('--v', dest='ShowVer', action='store_true', default=False, help="print version info.")
# Parse command line arguments
Options, args = ArgParser.parse_args()
Update = Options.Update
OrderBy = Options.OrderBy
Name = Options.Name
Show = Options.Show
ShowVer = Options.ShowVer
if (ShowVer == True):
print('\n%s' % Banner)
exit()
if (Update):
Sql += "execute dbms_feature_usage_internal.exec_db_usage_sampling(SYSDATE)\n"
Sql += "\n"
Sql += "column name format a60 heading 'Name'\n"
Sql += "column detected_usages format 999,999,999,999 heading 'Usage Count'\n"
Sql += "column currently_used format a14 heading 'Currently Used'\n"
Sql += "column version format a12 heading 'Version'\n"
Sql += "\n"
Sql += " SELECT " + SqlHeader + "\n"
Sql += " u1.name\n"
Sql += " , u1.detected_usages\n"
Sql += " , INITCAP(u1.currently_used) currently_used\n"
Sql += " , u1.version\n"
Sql += " FROM dba_feature_usage_statistics u1\n"
Sql += " WHERE version = (SELECT MAX(u2.version)\n"
Sql += " FROM dba_feature_usage_statistics u2\n"
Sql += " WHERE u2.name = u1.name\n"
Sql += " )\n"
Sql += " AND u1.detected_usages > 0\n"
Sql += " AND u1.dbid = (SELECT dbid FROM v$database)\n"
if (Name != ""):
Sql += " AND UPPER(u1.name) LIKE '%" + Name.upper() + "%'\n"
Sql += "ORDER BY " + OrderBy + ";"
if(Show):
print('-----------cut-----------cut-----------cut-----------cut-----------cut-----------')
print(Sql)
print('-----------cut-----------cut-----------cut-----------cut-----------cut-----------')
exit()
# Check/setup the Oracle environment
if (not('ORACLE_SID' in list(environ.keys()))):
print('ORACLE_SID is required.')
exit(1)
else:
# Set the ORACLE_HOME just in case it isn't set already.
if (not('ORACLE_HOME' in list(environ.keys()))):
(OracleSid, OracleHome) = SetOracleEnv(environ['ORACLE_SID'])
# Parse the connect string if any, prompt for username, password if needed.
if (len(args) > 0 and Show == False):
InStr = args[0]
ConnStr = ParseConnectString(InStr)
# Execute the report
if (ConnStr != ''):
(Stdout) = RunSqlplus(Sql, ErrChk, ConnStr)
else:
(Stdout) = RunSqlplus(Sql, ErrChk)
# Print the report
if (Stdout != ''):
print('\n%s' % Stdout)
exit(0)
# --------------------------------------
# ---- End Main Program ----------------
# --------------------------------------