'+ escapeHtml(title) + '
' + escapeHtml(summary) +'
404
83 |Page not found
84 |' + escapeHtml(summary) +'
' + noResultsText + '
'); 52 | } 53 | } 54 | 55 | function doSearch () { 56 | var query = document.getElementById('mkdocs-search-query').value; 57 | if (query.length > min_search_length) { 58 | if (!window.Worker) { 59 | displayResults(search(query)); 60 | } else { 61 | searchWorker.postMessage({query: query}); 62 | } 63 | } else { 64 | // Clear results for short queries 65 | displayResults([]); 66 | } 67 | } 68 | 69 | function initSearch () { 70 | var search_input = document.getElementById('mkdocs-search-query'); 71 | if (search_input) { 72 | search_input.addEventListener("keyup", doSearch); 73 | } 74 | var term = getSearchTermFromLocation(); 75 | if (term) { 76 | search_input.value = term; 77 | doSearch(); 78 | } 79 | } 80 | 81 | function onWorkerMessage (e) { 82 | if (e.data.allowSearch) { 83 | initSearch(); 84 | } else if (e.data.results) { 85 | var results = e.data.results; 86 | displayResults(results); 87 | } else if (e.data.config) { 88 | min_search_length = e.data.config.min_search_length-1; 89 | } 90 | } 91 | 92 | if (!window.Worker) { 93 | console.log('Web Worker API not supported'); 94 | // load index in main thread 95 | $.getScript(joinUrl(base_url, "search/worker.js")).done(function () { 96 | console.log('Loaded worker'); 97 | init(); 98 | window.postMessage = function (msg) { 99 | onWorkerMessage({data: msg}); 100 | }; 101 | }).fail(function (jqxhr, settings, exception) { 102 | console.error('Could not load worker.js'); 103 | }); 104 | } else { 105 | // Wrap search in a web worker 106 | var searchWorker = new Worker(joinUrl(base_url, "search/worker.js")); 107 | searchWorker.postMessage({init: true}); 108 | searchWorker.onmessage = onWorkerMessage; 109 | } 110 | -------------------------------------------------------------------------------- /site/search/worker.js: -------------------------------------------------------------------------------- 1 | var base_path = 'function' === typeof importScripts ? '.' : '/search/'; 2 | var allowSearch = false; 3 | var index; 4 | var documents = {}; 5 | var lang = ['en']; 6 | var data; 7 | 8 | function getScript(script, callback) { 9 | console.log('Loading script: ' + script); 10 | $.getScript(base_path + script).done(function () { 11 | callback(); 12 | }).fail(function (jqxhr, settings, exception) { 13 | console.log('Error: ' + exception); 14 | }); 15 | } 16 | 17 | function getScriptsInOrder(scripts, callback) { 18 | if (scripts.length === 0) { 19 | callback(); 20 | return; 21 | } 22 | getScript(scripts[0], function() { 23 | getScriptsInOrder(scripts.slice(1), callback); 24 | }); 25 | } 26 | 27 | function loadScripts(urls, callback) { 28 | if( 'function' === typeof importScripts ) { 29 | importScripts.apply(null, urls); 30 | callback(); 31 | } else { 32 | getScriptsInOrder(urls, callback); 33 | } 34 | } 35 | 36 | function onJSONLoaded () { 37 | data = JSON.parse(this.responseText); 38 | var scriptsToLoad = ['lunr.js']; 39 | if (data.config && data.config.lang && data.config.lang.length) { 40 | lang = data.config.lang; 41 | } 42 | if (lang.length > 1 || lang[0] !== "en") { 43 | scriptsToLoad.push('lunr.stemmer.support.js'); 44 | if (lang.length > 1) { 45 | scriptsToLoad.push('lunr.multi.js'); 46 | } 47 | if (lang.includes("ja") || lang.includes("jp")) { 48 | scriptsToLoad.push('tinyseg.js'); 49 | } 50 | for (var i=0; i < lang.length; i++) { 51 | if (lang[i] != 'en') { 52 | scriptsToLoad.push(['lunr', lang[i], 'js'].join('.')); 53 | } 54 | } 55 | } 56 | loadScripts(scriptsToLoad, onScriptsLoaded); 57 | } 58 | 59 | function onScriptsLoaded () { 60 | console.log('All search scripts loaded, building Lunr index...'); 61 | if (data.config && data.config.separator && data.config.separator.length) { 62 | lunr.tokenizer.separator = new RegExp(data.config.separator); 63 | } 64 | 65 | if (data.index) { 66 | index = lunr.Index.load(data.index); 67 | data.docs.forEach(function (doc) { 68 | documents[doc.location] = doc; 69 | }); 70 | console.log('Lunr pre-built index loaded, search ready'); 71 | } else { 72 | index = lunr(function () { 73 | if (lang.length === 1 && lang[0] !== "en" && lunr[lang[0]]) { 74 | this.use(lunr[lang[0]]); 75 | } else if (lang.length > 1) { 76 | this.use(lunr.multiLanguage.apply(null, lang)); // spread operator not supported in all browsers: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Spread_operator#Browser_compatibility 77 | } 78 | this.field('title'); 79 | this.field('text'); 80 | this.ref('location'); 81 | 82 | for (var i=0; i < data.docs.length; i++) { 83 | var doc = data.docs[i]; 84 | this.add(doc); 85 | documents[doc.location] = doc; 86 | } 87 | }); 88 | console.log('Lunr index built, search ready'); 89 | } 90 | allowSearch = true; 91 | postMessage({config: data.config}); 92 | postMessage({allowSearch: allowSearch}); 93 | } 94 | 95 | function init () { 96 | var oReq = new XMLHttpRequest(); 97 | oReq.addEventListener("load", onJSONLoaded); 98 | var index_path = base_path + '/search_index.json'; 99 | if( 'function' === typeof importScripts ){ 100 | index_path = 'search_index.json'; 101 | } 102 | oReq.open("GET", index_path); 103 | oReq.send(); 104 | } 105 | 106 | function search (query) { 107 | if (!allowSearch) { 108 | console.error('Assets for search still loading'); 109 | return; 110 | } 111 | 112 | var resultDocuments = []; 113 | var results = index.search(query); 114 | for (var i=0; i < results.length; i++){ 115 | var result = results[i]; 116 | doc = documents[result.ref]; 117 | doc.summary = doc.text.substring(0, 200); 118 | resultDocuments.push(doc); 119 | } 120 | return resultDocuments; 121 | } 122 | 123 | if( 'function' === typeof importScripts ) { 124 | onmessage = function (e) { 125 | if (e.data.init) { 126 | init(); 127 | } else if (e.data.query) { 128 | postMessage({ results: search(e.data.query) }); 129 | } else { 130 | console.error("Worker - Unrecognized message: " + e); 131 | } 132 | }; 133 | } 134 | -------------------------------------------------------------------------------- /postgres/postgres_table_stats_status.sql: -------------------------------------------------------------------------------- 1 | -- Copyright 2024 shaneborden 2 | -- 3 | -- Licensed under the Apache License, Version 2.0 (the "License"); 4 | -- you may not use this file except in compliance with the License. 5 | -- You may obtain a copy of the License at 6 | -- 7 | -- https://www.apache.org/licenses/LICENSE-2.0 8 | -- 9 | -- Unless required by applicable law or agreed to in writing, software 10 | -- distributed under the License is distributed on an "AS IS" BASIS, 11 | -- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 | -- See the License for the specific language governing permissions and 13 | -- limitations under the License. 14 | 15 | WITH table_stats AS ( 16 | SELECT 17 | schemaname, 18 | tablename, 19 | count(1) AS stats_count 20 | FROM 21 | pg_stats 22 | WHERE 23 | schemaname LIKE '%' 24 | GROUP BY 25 | schemaname, 26 | tablename 27 | ) 28 | SELECT 29 | pt.schemaname AS schema_name, 30 | pt.tablename AS table_name, 31 | CASE WHEN pi.inhparent::text IS NULL THEN 32 | NULL 33 | ELSE 34 | pi.inhparent::regclass 35 | END AS top_table_name, 36 | pc.reltuples::numeric AS est_num_live_rows, 37 | ps.n_live_tup AS rows_in_stats, 38 | ps.n_tup_ins AS tot_num_inserts, 39 | ps.n_tup_upd AS tot_num_updates, 40 | ps.n_tup_del AS tot_num_deletes, 41 | ps.n_mod_since_analyze AS modified_rows, 42 | CASE WHEN pc.reltuples::numeric < 0 THEN 43 | 100.00 44 | WHEN (ps.n_tup_ins + ps.n_tup_upd + ps.n_tup_del) = 0 THEN 45 | 0.00 46 | WHEN ps.n_mod_since_analyze::numeric > 0 47 | AND pc.reltuples::numeric > 0 THEN 48 | CASE WHEN (ROUND((ps.n_mod_since_analyze / pc.reltuples)::numeric, 2) * 100) > 100 THEN 49 | 100 50 | ELSE 51 | ROUND((ps.n_mod_since_analyze / pc.reltuples)::numeric, 2) * 100 52 | END 53 | WHEN ps.n_mod_since_analyze::numeric > 0 54 | AND pc.reltuples::numeric = 0 THEN 55 | ROUND((ps.n_mod_since_analyze / 1)::numeric, 2) * 100 56 | WHEN pc.reltuples = 0 57 | AND ps.n_live_tup = 0 58 | AND ps.n_mod_since_analyze = 0 THEN 59 | 0.00 60 | ELSE 61 | ROUND((ps.n_live_tup / pc.reltuples)::numeric - 1, 2) 62 | END AS percent_stale, 63 | CASE WHEN ps.last_analyze IS NULL 64 | AND ps.last_autoanalyze IS NOT NULL THEN 65 | 'Auto - ' || TO_CHAR(ps.last_autoanalyze, 'DD-MON-YY HH24:MI') 66 | WHEN ps.last_analyze IS NULL 67 | AND ts.stats_count IS NULL 68 | AND ps.last_autoanalyze IS NULL THEN 69 | 'No Stats Available' 70 | WHEN ps.last_analyze IS NULL 71 | AND ts.stats_count > 0 72 | AND ps.last_autoanalyze IS NULL THEN 73 | 'pg_stats - Status Unknown' 74 | WHEN ps.last_analyze IS NULL 75 | AND pc.reltuples > 0 76 | AND ps.last_autoanalyze IS NULL THEN 77 | 'pg_class - Status Unknown' 78 | WHEN ps.last_analyze IS NOT NULL 79 | AND ps.last_autoanalyze IS NOT NULL 80 | AND (ps.last_autoanalyze > ps.last_analyze) THEN 81 | 'Auto - ' || TO_CHAR(ps.last_autoanalyze, 'DD-MON-YY HH24:MI') 82 | ELSE 83 | 'Manual - ' || TO_CHAR(ps.last_analyze, 'DD-MON-YY HH24:MI') 84 | END AS last_analyzed, 85 | CASE WHEN ps.last_vacuum IS NULL 86 | AND ps.last_autovacuum IS NOT NULL THEN 87 | 'Auto - ' || TO_CHAR(ps.last_autovacuum, 'DD-MON-YY HH24:MI') 88 | WHEN ps.last_vacuum IS NOT NULL 89 | AND ps.last_autovacuum IS NULL THEN 90 | 'Manual - ' || TO_CHAR(ps.last_vacuum, 'DD-MON-YY HH24:MI') 91 | WHEN ps.last_vacuum > ps.last_autovacuum THEN 92 | 'Manual - ' || TO_CHAR(ps.last_vacuum, 'DD-MON-YY HH24:MI') 93 | ELSE 94 | 'Auto - ' || TO_CHAR(ps.last_autovacuum, 'DD-MON-YY HH24:MI') 95 | END AS vacuum_status 96 | FROM 97 | pg_tables pt 98 | JOIN pg_stat_all_tables ps ON ps.schemaname = pt.schemaname 99 | AND ps.relname = pt.tablename 100 | JOIN pg_class pc ON ps.relid = pc.oid 101 | LEFT JOIN pg_catalog.pg_inherits pi ON ps.relid = pi.inhrelid 102 | LEFT JOIN table_stats ts ON ts.schemaname = pt.schemaname 103 | AND ts.tablename = pt.tablename 104 | WHERE 105 | pt.tablename LIKE '%' 106 | ORDER BY 107 | 3 NULLS LAST, 108 | 1, 109 | 2; -------------------------------------------------------------------------------- /docs/code_of_conduct.md: -------------------------------------------------------------------------------- 1 | # Code of Conduct 2 | 3 | ## Our Pledge 4 | 5 | In the interest of fostering an open and welcoming environment, we as 6 | contributors and maintainers pledge to making participation in our project and 7 | our community a harassment-free experience for everyone, regardless of age, body 8 | size, disability, ethnicity, gender identity and expression, level of 9 | experience, education, socio-economic status, nationality, personal appearance, 10 | race, religion, or sexual identity and orientation. 11 | 12 | ## Our Standards 13 | 14 | Examples of behavior that contributes to creating a positive environment 15 | include: 16 | 17 | * Using welcoming and inclusive language 18 | * Being respectful of differing viewpoints and experiences 19 | * Gracefully accepting constructive criticism 20 | * Focusing on what is best for the community 21 | * Showing empathy towards other community members 22 | 23 | Examples of unacceptable behavior by participants include: 24 | 25 | * The use of sexualized language or imagery and unwelcome sexual attention or 26 | advances 27 | * Trolling, insulting/derogatory comments, and personal or political attacks 28 | * Public or private harassment 29 | * Publishing others' private information, such as a physical or electronic 30 | address, without explicit permission 31 | * Other conduct which could reasonably be considered inappropriate in a 32 | professional setting 33 | 34 | ## Our Responsibilities 35 | 36 | Project maintainers are responsible for clarifying the standards of acceptable 37 | behavior and are expected to take appropriate and fair corrective action in 38 | response to any instances of unacceptable behavior. 39 | 40 | Project maintainers have the right and responsibility to remove, edit, or reject 41 | comments, commits, code, wiki edits, issues, and other contributions that are 42 | not aligned to this Code of Conduct, or to ban temporarily or permanently any 43 | contributor for other behaviors that they deem inappropriate, threatening, 44 | offensive, or harmful. 45 | 46 | ## Scope 47 | 48 | This Code of Conduct applies both within project spaces and in public spaces 49 | when an individual is representing the project or its community. Examples of 50 | representing a project or community include using an official project e-mail 51 | address, posting via an official social media account, or acting as an appointed 52 | representative at an online or offline event. Representation of a project may be 53 | further defined and clarified by project maintainers. 54 | 55 | This Code of Conduct also applies outside the project spaces when the Project 56 | Steward has a reasonable belief that an individual's behavior may have a 57 | negative impact on the project or its community. 58 | 59 | ## Conflict Resolution 60 | 61 | We do not believe that all conflict is bad; healthy debate and disagreement 62 | often yield positive results. However, it is never okay to be disrespectful or 63 | to engage in behavior that violates the project’s code of conduct. 64 | 65 | If you see someone violating the code of conduct, you are encouraged to address 66 | the behavior directly with those involved. Many issues can be resolved quickly 67 | and easily, and this gives people more control over the outcome of their 68 | dispute. If you are unable to resolve the matter for any reason, or if the 69 | behavior is threatening or harassing, report it. We are dedicated to providing 70 | an environment where participants feel welcome and safe. 71 | 72 | Reports should be directed to Cody FincherPage not found
84 |A release should consist of the following two steps from a tested, linted, and up to date copy of the main branch:
111 |make pre-release increment={major/minor/patch} - Commit the version number bump and create a new tag locally. The version number follows semantic versioning standards (major.minor.patch) and the tag is the version number prepended with a 'v'.
git push --follow-tags - Update the main branch with only the changes from the version bump. Publish the new tag and kick off the release workflow.
To begin local development, clone the shane-borden/sqlScripts repository and use one of the following methods to build it. All commands should be executed from inside of the project home folder.
115 |make install
117 | make install - Creates a new virtual environment for development.
make clean - Remove all build, testing, and static documentation files.
make build - Build a folder containing a set of the latest database collection scripts.
make gen-docs - Generate HTML documentation.
make docs - Generate HTML documentation and serve it to the browser.
make pre-release increment={major/minor/patch} - Bump the version and create a release tag. Should only be run from the main branch. Passes the increment value to bump2version to create a new version number dynamically. The new version number will be added to __version__.py and pyproject.toml and a new commit will be logged. The tag will be created from the new commit.