24 |
114 |
115 |
116 |
117 |
118 |
119 |
120 |
121 |
122 |
--------------------------------------------------------------------------------
/docs/articles/UsingSqlRender_files/accessible-code-block-0.0.1/empty-anchor.js:
--------------------------------------------------------------------------------
1 | // Hide empty tag within highlighted CodeBlock for screen reader accessibility (see https://github.com/jgm/pandoc/issues/6352#issuecomment-626106786) -->
2 | // v0.0.1
3 | // Written by JooYoung Seo (jooyoung@psu.edu) and Atsushi Yasumoto on June 1st, 2020.
4 |
5 | document.addEventListener('DOMContentLoaded', function() {
6 | const codeList = document.getElementsByClassName("sourceCode");
7 | for (var i = 0; i < codeList.length; i++) {
8 | var linkList = codeList[i].getElementsByTagName('a');
9 | for (var j = 0; j < linkList.length; j++) {
10 | if (linkList[j].innerHTML === "") {
11 | linkList[j].setAttribute('aria-hidden', 'true');
12 | }
13 | }
14 | }
15 | });
16 |
--------------------------------------------------------------------------------
/docs/articles/UsingSqlRender_files/anchor-sections-1.0/anchor-sections.css:
--------------------------------------------------------------------------------
1 | /* Styles for section anchors */
2 | a.anchor-section {margin-left: 10px; visibility: hidden; color: inherit;}
3 | a.anchor-section::before {content: '#';}
4 | .hasAnchor:hover a.anchor-section {visibility: visible;}
5 |
--------------------------------------------------------------------------------
/docs/articles/UsingSqlRender_files/anchor-sections-1.0/anchor-sections.js:
--------------------------------------------------------------------------------
1 | // Anchor sections v1.0 written by Atsushi Yasumoto on Oct 3rd, 2020.
2 | document.addEventListener('DOMContentLoaded', function() {
3 | // Do nothing if AnchorJS is used
4 | if (typeof window.anchors === 'object' && anchors.hasOwnProperty('hasAnchorJSLink')) {
5 | return;
6 | }
7 |
8 | const h = document.querySelectorAll('h1, h2, h3, h4, h5, h6');
9 |
10 | // Do nothing if sections are already anchored
11 | if (Array.from(h).some(x => x.classList.contains('hasAnchor'))) {
12 | return null;
13 | }
14 |
15 | // Use section id when pandoc runs with --section-divs
16 | const section_id = function(x) {
17 | return ((x.classList.contains('section') || (x.tagName === 'SECTION'))
18 | ? x.id : '');
19 | };
20 |
21 | // Add anchors
22 | h.forEach(function(x) {
23 | const id = x.id || section_id(x.parentElement);
24 | if (id === '') {
25 | return null;
26 | }
27 | let anchor = document.createElement('a');
28 | anchor.href = '#' + id;
29 | anchor.classList = ['anchor-section'];
30 | x.classList.add('hasAnchor');
31 | x.appendChild(anchor);
32 | });
33 | });
34 |
--------------------------------------------------------------------------------
/docs/articles/UsingSqlRender_files/header-attrs-2.10/header-attrs.js:
--------------------------------------------------------------------------------
1 | // Pandoc 2.9 adds attributes on both header and div. We remove the former (to
2 | // be compatible with the behavior of Pandoc < 2.8).
3 | document.addEventListener('DOMContentLoaded', function(e) {
4 | var hs = document.querySelectorAll("div.section[class*='level'] > :first-child");
5 | var i, h, a;
6 | for (i = 0; i < hs.length; i++) {
7 | h = hs[i];
8 | if (!/^h[1-6]$/i.test(h.tagName)) continue; // it should be a header h1-h6
9 | a = h.attributes;
10 | while (a.length > 0) h.removeAttribute(a[0].name);
11 | }
12 | });
13 |
--------------------------------------------------------------------------------
/docs/articles/UsingSqlRender_files/header-attrs-2.11/header-attrs.js:
--------------------------------------------------------------------------------
1 | // Pandoc 2.9 adds attributes on both header and div. We remove the former (to
2 | // be compatible with the behavior of Pandoc < 2.8).
3 | document.addEventListener('DOMContentLoaded', function(e) {
4 | var hs = document.querySelectorAll("div.section[class*='level'] > :first-child");
5 | var i, h, a;
6 | for (i = 0; i < hs.length; i++) {
7 | h = hs[i];
8 | if (!/^h[1-6]$/i.test(h.tagName)) continue; // it should be a header h1-h6
9 | a = h.attributes;
10 | while (a.length > 0) h.removeAttribute(a[0].name);
11 | }
12 | });
13 |
--------------------------------------------------------------------------------
/docs/articles/UsingSqlRender_files/header-attrs-2.4/header-attrs.js:
--------------------------------------------------------------------------------
1 | // Pandoc 2.9 adds attributes on both header and div. We remove the former (to
2 | // be compatible with the behavior of Pandoc < 2.8).
3 | document.addEventListener('DOMContentLoaded', function(e) {
4 | var hs = document.querySelectorAll("div.section[class*='level'] > :first-child");
5 | var i, h, a;
6 | for (i = 0; i < hs.length; i++) {
7 | h = hs[i];
8 | if (!/^h[1-6]$/i.test(h.tagName)) continue; // it should be a header h1-h6
9 | a = h.attributes;
10 | while (a.length > 0) h.removeAttribute(a[0].name);
11 | }
12 | });
13 |
--------------------------------------------------------------------------------
/docs/articles/UsingSqlRender_files/header-attrs-2.5/header-attrs.js:
--------------------------------------------------------------------------------
1 | // Pandoc 2.9 adds attributes on both header and div. We remove the former (to
2 | // be compatible with the behavior of Pandoc < 2.8).
3 | document.addEventListener('DOMContentLoaded', function(e) {
4 | var hs = document.querySelectorAll("div.section[class*='level'] > :first-child");
5 | var i, h, a;
6 | for (i = 0; i < hs.length; i++) {
7 | h = hs[i];
8 | if (!/^h[1-6]$/i.test(h.tagName)) continue; // it should be a header h1-h6
9 | a = h.attributes;
10 | while (a.length > 0) h.removeAttribute(a[0].name);
11 | }
12 | });
13 |
--------------------------------------------------------------------------------
/docs/articles/index.html:
--------------------------------------------------------------------------------
1 |
2 |
25 |
79 |
80 |
81 |
82 |
83 |
26 |
38 |
39 |
77 |
78 |
40 |
63 |
75 |
76 | -
64 |
-
65 |
66 |
67 | - 68 | 69 | 70 | 71 | 72 | 73 |
84 |
99 |
100 |
101 |
102 |
113 |
85 |
92 |
93 |
97 |
98 |
86 |
88 |
89 | Content not found. Please use links in the navbar.
90 |
91 | Page not found (404)
87 |
9 |
85 |
86 |
87 |
88 |
89 |
90 |
91 |
92 |
93 |
--------------------------------------------------------------------------------
/docs/authors.html:
--------------------------------------------------------------------------------
1 |
2 |
10 |
56 |
57 |
58 |
59 |
11 |
23 |
24 |
55 |
25 |
54 | -
45 |
46 |
47 |
- 48 | 49 | 50 | 51 | 52 | 53 |
60 |
74 |
75 |
76 |
61 |
73 |
62 |
64 |
65 | Articles
63 |
66 |
72 | All vignettes
67 | 68 | 69 |- Using SqlRender 70 |
- 71 |
9 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
--------------------------------------------------------------------------------
/docs/bootstrap-toc.css:
--------------------------------------------------------------------------------
1 | /*!
2 | * Bootstrap Table of Contents v0.4.1 (http://afeld.github.io/bootstrap-toc/)
3 | * Copyright 2015 Aidan Feldman
4 | * Licensed under MIT (https://github.com/afeld/bootstrap-toc/blob/gh-pages/LICENSE.md) */
5 |
6 | /* modified from https://github.com/twbs/bootstrap/blob/94b4076dd2efba9af71f0b18d4ee4b163aa9e0dd/docs/assets/css/src/docs.css#L548-L601 */
7 |
8 | /* All levels of nav */
9 | nav[data-toggle='toc'] .nav > li > a {
10 | display: block;
11 | padding: 4px 20px;
12 | font-size: 13px;
13 | font-weight: 500;
14 | color: #767676;
15 | }
16 | nav[data-toggle='toc'] .nav > li > a:hover,
17 | nav[data-toggle='toc'] .nav > li > a:focus {
18 | padding-left: 19px;
19 | color: #563d7c;
20 | text-decoration: none;
21 | background-color: transparent;
22 | border-left: 1px solid #563d7c;
23 | }
24 | nav[data-toggle='toc'] .nav > .active > a,
25 | nav[data-toggle='toc'] .nav > .active:hover > a,
26 | nav[data-toggle='toc'] .nav > .active:focus > a {
27 | padding-left: 18px;
28 | font-weight: bold;
29 | color: #563d7c;
30 | background-color: transparent;
31 | border-left: 2px solid #563d7c;
32 | }
33 |
34 | /* Nav: second level (shown on .active) */
35 | nav[data-toggle='toc'] .nav .nav {
36 | display: none; /* Hide by default, but at >768px, show it */
37 | padding-bottom: 10px;
38 | }
39 | nav[data-toggle='toc'] .nav .nav > li > a {
40 | padding-top: 1px;
41 | padding-bottom: 1px;
42 | padding-left: 30px;
43 | font-size: 12px;
44 | font-weight: normal;
45 | }
46 | nav[data-toggle='toc'] .nav .nav > li > a:hover,
47 | nav[data-toggle='toc'] .nav .nav > li > a:focus {
48 | padding-left: 29px;
49 | }
50 | nav[data-toggle='toc'] .nav .nav > .active > a,
51 | nav[data-toggle='toc'] .nav .nav > .active:hover > a,
52 | nav[data-toggle='toc'] .nav .nav > .active:focus > a {
53 | padding-left: 28px;
54 | font-weight: 500;
55 | }
56 |
57 | /* from https://github.com/twbs/bootstrap/blob/e38f066d8c203c3e032da0ff23cd2d6098ee2dd6/docs/assets/css/src/docs.css#L631-L634 */
58 | nav[data-toggle='toc'] .nav > .active > ul {
59 | display: block;
60 | }
61 |
--------------------------------------------------------------------------------
/docs/bootstrap-toc.js:
--------------------------------------------------------------------------------
1 | /*!
2 | * Bootstrap Table of Contents v0.4.1 (http://afeld.github.io/bootstrap-toc/)
3 | * Copyright 2015 Aidan Feldman
4 | * Licensed under MIT (https://github.com/afeld/bootstrap-toc/blob/gh-pages/LICENSE.md) */
5 | (function() {
6 | 'use strict';
7 |
8 | window.Toc = {
9 | helpers: {
10 | // return all matching elements in the set, or their descendants
11 | findOrFilter: function($el, selector) {
12 | // http://danielnouri.org/notes/2011/03/14/a-jquery-find-that-also-finds-the-root-element/
13 | // http://stackoverflow.com/a/12731439/358804
14 | var $descendants = $el.find(selector);
15 | return $el.filter(selector).add($descendants).filter(':not([data-toc-skip])');
16 | },
17 |
18 | generateUniqueIdBase: function(el) {
19 | var text = $(el).text();
20 | var anchor = text.trim().toLowerCase().replace(/[^A-Za-z0-9]+/g, '-');
21 | return anchor || el.tagName.toLowerCase();
22 | },
23 |
24 | generateUniqueId: function(el) {
25 | var anchorBase = this.generateUniqueIdBase(el);
26 | for (var i = 0; ; i++) {
27 | var anchor = anchorBase;
28 | if (i > 0) {
29 | // add suffix
30 | anchor += '-' + i;
31 | }
32 | // check if ID already exists
33 | if (!document.getElementById(anchor)) {
34 | return anchor;
35 | }
36 | }
37 | },
38 |
39 | generateAnchor: function(el) {
40 | if (el.id) {
41 | return el.id;
42 | } else {
43 | var anchor = this.generateUniqueId(el);
44 | el.id = anchor;
45 | return anchor;
46 | }
47 | },
48 |
49 | createNavList: function() {
50 | return $('');
51 | },
52 |
53 | createChildNavList: function($parent) {
54 | var $childList = this.createNavList();
55 | $parent.append($childList);
56 | return $childList;
57 | },
58 |
59 | generateNavEl: function(anchor, text) {
60 | var $a = $('');
61 | $a.attr('href', '#' + anchor);
62 | $a.text(text);
63 | var $li = $('');
64 | $li.append($a);
65 | return $li;
66 | },
67 |
68 | generateNavItem: function(headingEl) {
69 | var anchor = this.generateAnchor(headingEl);
70 | var $heading = $(headingEl);
71 | var text = $heading.data('toc-text') || $heading.text();
72 | return this.generateNavEl(anchor, text);
73 | },
74 |
75 | // Find the first heading level (`
10 |
56 |
57 |
58 |
59 |
11 |
23 |
24 |
55 |
25 |
54 | -
45 |
46 |
47 |
- 48 | 49 | 50 | 51 | 52 | 53 |
60 |
99 |
100 |
101 |
102 |
61 |
76 |
97 |
98 |
77 |
82 |
83 |
84 |
78 |
81 | Citation
79 | Source:DESCRIPTION
80 | Schuemie M, Suchard M (2025). 85 | SqlRender: Rendering Parameterized SQL and Translation to Dialects. 86 | R package version 1.19.4, https://github.com/OHDSI/SqlRender, https://ohdsi.github.io/SqlRender/. 87 |
88 |@Manual{,
89 | title = {SqlRender: Rendering Parameterized SQL and Translation to Dialects},
90 | author = {Martijn Schuemie and Marc Suchard},
91 | year = {2025},
92 | note = {R package version 1.19.4, https://github.com/OHDSI/SqlRender},
93 | url = {https://ohdsi.github.io/SqlRender/},
94 | }
95 |
96 | `, then ``, etc.) that has more than one element. Defaults to 1 (for ``).
76 | getTopLevel: function($scope) {
77 | for (var i = 1; i <= 6; i++) {
78 | var $headings = this.findOrFilter($scope, 'h' + i);
79 | if ($headings.length > 1) {
80 | return i;
81 | }
82 | }
83 |
84 | return 1;
85 | },
86 |
87 | // returns the elements for the top level, and the next below it
88 | getHeadings: function($scope, topLevel) {
89 | var topSelector = 'h' + topLevel;
90 |
91 | var secondaryLevel = topLevel + 1;
92 | var secondarySelector = 'h' + secondaryLevel;
93 |
94 | return this.findOrFilter($scope, topSelector + ',' + secondarySelector);
95 | },
96 |
97 | getNavLevel: function(el) {
98 | return parseInt(el.tagName.charAt(1), 10);
99 | },
100 |
101 | populateNav: function($topContext, topLevel, $headings) {
102 | var $context = $topContext;
103 | var $prevNav;
104 |
105 | var helpers = this;
106 | $headings.each(function(i, el) {
107 | var $newNav = helpers.generateNavItem(el);
108 | var navLevel = helpers.getNavLevel(el);
109 |
110 | // determine the proper $context
111 | if (navLevel === topLevel) {
112 | // use top level
113 | $context = $topContext;
114 | } else if ($prevNav && $context === $topContext) {
115 | // create a new level of the tree and switch to it
116 | $context = helpers.createChildNavList($prevNav);
117 | } // else use the current $context
118 |
119 | $context.append($newNav);
120 |
121 | $prevNav = $newNav;
122 | });
123 | },
124 |
125 | parseOps: function(arg) {
126 | var opts;
127 | if (arg.jquery) {
128 | opts = {
129 | $nav: arg
130 | };
131 | } else {
132 | opts = arg;
133 | }
134 | opts.$scope = opts.$scope || $(document.body);
135 | return opts;
136 | }
137 | },
138 |
139 | // accepts a jQuery object, or an options object
140 | init: function(opts) {
141 | opts = this.helpers.parseOps(opts);
142 |
143 | // ensure that the data attribute is in place for styling
144 | opts.$nav.attr('data-toggle', 'toc');
145 |
146 | var $topContext = this.helpers.createChildNavList(opts.$nav);
147 | var topLevel = this.helpers.getTopLevel(opts.$scope);
148 | var $headings = this.helpers.getHeadings(opts.$scope, topLevel);
149 | this.helpers.populateNav($topContext, topLevel, $headings);
150 | }
151 | };
152 |
153 | $(function() {
154 | $('nav[data-toggle="toc"]').each(function(i, el) {
155 | var $nav = $(el);
156 | Toc.init($nav);
157 | });
158 | });
159 | })();
160 |
--------------------------------------------------------------------------------
/docs/docsearch.js:
--------------------------------------------------------------------------------
1 | $(function() {
2 |
3 | // register a handler to move the focus to the search bar
4 | // upon pressing shift + "/" (i.e. "?")
5 | $(document).on('keydown', function(e) {
6 | if (e.shiftKey && e.keyCode == 191) {
7 | e.preventDefault();
8 | $("#search-input").focus();
9 | }
10 | });
11 |
12 | $(document).ready(function() {
13 | // do keyword highlighting
14 | /* modified from https://jsfiddle.net/julmot/bL6bb5oo/ */
15 | var mark = function() {
16 |
17 | var referrer = document.URL ;
18 | var paramKey = "q" ;
19 |
20 | if (referrer.indexOf("?") !== -1) {
21 | var qs = referrer.substr(referrer.indexOf('?') + 1);
22 | var qs_noanchor = qs.split('#')[0];
23 | var qsa = qs_noanchor.split('&');
24 | var keyword = "";
25 |
26 | for (var i = 0; i < qsa.length; i++) {
27 | var currentParam = qsa[i].split('=');
28 |
29 | if (currentParam.length !== 2) {
30 | continue;
31 | }
32 |
33 | if (currentParam[0] == paramKey) {
34 | keyword = decodeURIComponent(currentParam[1].replace(/\+/g, "%20"));
35 | }
36 | }
37 |
38 | if (keyword !== "") {
39 | $(".contents").unmark({
40 | done: function() {
41 | $(".contents").mark(keyword);
42 | }
43 | });
44 | }
45 | }
46 | };
47 |
48 | mark();
49 | });
50 | });
51 |
52 | /* Search term highlighting ------------------------------*/
53 |
54 | function matchedWords(hit) {
55 | var words = [];
56 |
57 | var hierarchy = hit._highlightResult.hierarchy;
58 | // loop to fetch from lvl0, lvl1, etc.
59 | for (var idx in hierarchy) {
60 | words = words.concat(hierarchy[idx].matchedWords);
61 | }
62 |
63 | var content = hit._highlightResult.content;
64 | if (content) {
65 | words = words.concat(content.matchedWords);
66 | }
67 |
68 | // return unique words
69 | var words_uniq = [...new Set(words)];
70 | return words_uniq;
71 | }
72 |
73 | function updateHitURL(hit) {
74 |
75 | var words = matchedWords(hit);
76 | var url = "";
77 |
78 | if (hit.anchor) {
79 | url = hit.url_without_anchor + '?q=' + escape(words.join(" ")) + '#' + hit.anchor;
80 | } else {
81 | url = hit.url + '?q=' + escape(words.join(" "));
82 | }
83 |
84 | return url;
85 | }
86 |
--------------------------------------------------------------------------------
/docs/jquery.sticky-kit.min.js:
--------------------------------------------------------------------------------
1 | /*
2 | Sticky-kit v1.1.2 | WTFPL | Leaf Corcoran 2015 | http://leafo.net
3 | */
4 | (function(){var b,f;b=this.jQuery||window.jQuery;f=b(window);b.fn.stick_in_parent=function(d){var A,w,J,n,B,K,p,q,k,E,t;null==d&&(d={});t=d.sticky_class;B=d.inner_scrolling;E=d.recalc_every;k=d.parent;q=d.offset_top;p=d.spacer;w=d.bottoming;null==q&&(q=0);null==k&&(k=void 0);null==B&&(B=!0);null==t&&(t="is_stuck");A=b(document);null==w&&(w=!0);J=function(a,d,n,C,F,u,r,G){var v,H,m,D,I,c,g,x,y,z,h,l;if(!a.data("sticky_kit")){a.data("sticky_kit",!0);I=A.height();g=a.parent();null!=k&&(g=g.closest(k));
5 | if(!g.length)throw"failed to find stick parent";v=m=!1;(h=null!=p?p&&a.closest(p):b(""))&&h.css("position",a.css("position"));x=function(){var c,f,e;if(!G&&(I=A.height(),c=parseInt(g.css("border-top-width"),10),f=parseInt(g.css("padding-top"),10),d=parseInt(g.css("padding-bottom"),10),n=g.offset().top+c+f,C=g.height(),m&&(v=m=!1,null==p&&(a.insertAfter(h),h.detach()),a.css({position:"",top:"",width:"",bottom:""}).removeClass(t),e=!0),F=a.offset().top-(parseInt(a.css("margin-top"),10)||0)-q,
6 | u=a.outerHeight(!0),r=a.css("float"),h&&h.css({width:a.outerWidth(!0),height:u,display:a.css("display"),"vertical-align":a.css("vertical-align"),"float":r}),e))return l()};x();if(u!==C)return D=void 0,c=q,z=E,l=function(){var b,l,e,k;if(!G&&(e=!1,null!=z&&(--z,0>=z&&(z=E,x(),e=!0)),e||A.height()===I||x(),e=f.scrollTop(),null!=D&&(l=e-D),D=e,m?(w&&(k=e+u+c>C+n,v&&!k&&(v=!1,a.css({position:"fixed",bottom:"",top:c}).trigger("sticky_kit:unbottom"))),eb&&!v&&(c-=l,c=Math.max(b-u,c),c=Math.min(q,c),m&&a.css({top:c+"px"})))):e>F&&(m=!0,b={position:"fixed",top:c},b.width="border-box"===a.css("box-sizing")?a.outerWidth()+"px":a.width()+"px",a.css(b).addClass(t),null==p&&(a.after(h),"left"!==r&&"right"!==r||h.append(a)),a.trigger("sticky_kit:stick")),m&&w&&(null==k&&(k=e+u+c>C+n),!v&&k)))return v=!0,"static"===g.css("position")&&g.css({position:"relative"}),
8 | a.css({position:"absolute",bottom:d,top:"auto"}).trigger("sticky_kit:bottom")},y=function(){x();return l()},H=function(){G=!0;f.off("touchmove",l);f.off("scroll",l);f.off("resize",y);b(document.body).off("sticky_kit:recalc",y);a.off("sticky_kit:detach",H);a.removeData("sticky_kit");a.css({position:"",bottom:"",top:"",width:""});g.position("position","");if(m)return null==p&&("left"!==r&&"right"!==r||a.insertAfter(h),h.remove()),a.removeClass(t)},f.on("touchmove",l),f.on("scroll",l),f.on("resize",
9 | y),b(document.body).on("sticky_kit:recalc",y),a.on("sticky_kit:detach",H),setTimeout(l,0)}};n=0;for(K=this.length;n
2 |
3 |
13 |
--------------------------------------------------------------------------------
/docs/pkgdown.js:
--------------------------------------------------------------------------------
1 | /* http://gregfranko.com/blog/jquery-best-practices/ */
2 | (function($) {
3 | $(function() {
4 |
5 | $('.navbar-fixed-top').headroom();
6 |
7 | $('body').css('padding-top', $('.navbar').height() + 10);
8 | $(window).resize(function(){
9 | $('body').css('padding-top', $('.navbar').height() + 10);
10 | });
11 |
12 | $('[data-toggle="tooltip"]').tooltip();
13 |
14 | var cur_path = paths(location.pathname);
15 | var links = $("#navbar ul li a");
16 | var max_length = -1;
17 | var pos = -1;
18 | for (var i = 0; i < links.length; i++) {
19 | if (links[i].getAttribute("href") === "#")
20 | continue;
21 | // Ignore external links
22 | if (links[i].host !== location.host)
23 | continue;
24 |
25 | var nav_path = paths(links[i].pathname);
26 |
27 | var length = prefix_length(nav_path, cur_path);
28 | if (length > max_length) {
29 | max_length = length;
30 | pos = i;
31 | }
32 | }
33 |
34 | // Add class to parent , and enclosing if in dropdown
35 | if (pos >= 0) {
36 | var menu_anchor = $(links[pos]);
37 | menu_anchor.parent().addClass("active");
38 | menu_anchor.closest("li.dropdown").addClass("active");
39 | }
40 | });
41 |
42 | function paths(pathname) {
43 | var pieces = pathname.split("/");
44 | pieces.shift(); // always starts with /
45 |
46 | var end = pieces[pieces.length - 1];
47 | if (end === "index.html" || end === "")
48 | pieces.pop();
49 | return(pieces);
50 | }
51 |
52 | // Returns -1 if not found
53 | function prefix_length(needle, haystack) {
54 | if (needle.length > haystack.length)
55 | return(-1);
56 |
57 | // Special case for length-0 haystack, since for loop won't run
58 | if (haystack.length === 0) {
59 | return(needle.length === 0 ? 0 : -1);
60 | }
61 |
62 | for (var i = 0; i < haystack.length; i++) {
63 | if (needle[i] != haystack[i])
64 | return(i);
65 | }
66 |
67 | return(haystack.length);
68 | }
69 |
70 | /* Clipboard --------------------------*/
71 |
72 | function changeTooltipMessage(element, msg) {
73 | var tooltipOriginalTitle=element.getAttribute('data-original-title');
74 | element.setAttribute('data-original-title', msg);
75 | $(element).tooltip('show');
76 | element.setAttribute('data-original-title', tooltipOriginalTitle);
77 | }
78 |
79 | if(ClipboardJS.isSupported()) {
80 | $(document).ready(function() {
81 | var copyButton = "";
82 |
83 | $("div.sourceCode").addClass("hasCopyButton");
84 |
85 | // Insert copy buttons:
86 | $(copyButton).prependTo(".hasCopyButton");
87 |
88 | // Initialize tooltips:
89 | $('.btn-copy-ex').tooltip({container: 'body'});
90 |
91 | // Initialize clipboard:
92 | var clipboardBtnCopies = new ClipboardJS('[data-clipboard-copy]', {
93 | text: function(trigger) {
94 | return trigger.parentNode.textContent.replace(/\n#>[^\n]*/g, "");
95 | }
96 | });
97 |
98 | clipboardBtnCopies.on('success', function(e) {
99 | changeTooltipMessage(e.trigger, 'Copied!');
100 | e.clearSelection();
101 | });
102 |
103 | clipboardBtnCopies.on('error', function() {
104 | changeTooltipMessage(e.trigger,'Press Ctrl+C or Command+C to copy');
105 | });
106 | });
107 | }
108 | })(window.jQuery || window.$)
109 |
--------------------------------------------------------------------------------
/docs/pkgdown.yml:
--------------------------------------------------------------------------------
1 | pandoc: '3.2'
2 | pkgdown: 2.1.3
3 | pkgdown_sha: ~
4 | articles:
5 | UsingSqlRender: UsingSqlRender.html
6 | last_built: 2025-09-26T13:47Z
7 |
--------------------------------------------------------------------------------
/docs/pull_request_template.html:
--------------------------------------------------------------------------------
1 |
2 | NA • SqlRender
6 |
7 |
8 |
9 |
10 |
11 |
23 |
24 |
25 | -
45 |
46 |
47 | -
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 | NA
63 |
64 |
65 |
66 | Before you do a pull request, you should always file an issue and make sure the package maintainer agrees that it’s a problem, and is happy with your basic proposal for fixing it. We don’t want you to spend a bunch of time on something that we don’t think is a good idea.
67 | Additional requirements for pull requests:
68 | Adhere to the Developer Guidelines as well as the OHDSI Code Style.
If possible, add unit tests for new functionality you add.
Restrict your pull request to solving the issue at hand. Do not try to ‘improve’ parts of the code that are not related to the issue. If you feel other parts of the code need better organization, create a separate issue for that.
Make sure you pass R check without errors and warnings before submitting.
Always target the develop branch, and make sure you are up-to-date with the develop branch.
74 |
75 |
78 |
79 |
80 |
81 |
82 |
83 |
92 |
93 |
94 |
95 |
96 |
97 |
98 |
99 |
100 |
--------------------------------------------------------------------------------
/docs/reference/Rplot001.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/OHDSI/SqlRender/97eb3b441bb98fa51676c54eca20b296fdcfbf21/docs/reference/Rplot001.png
--------------------------------------------------------------------------------
/docs/reference/SqlRender.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 | SqlRender — SqlRender • SqlRender
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 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
115 |
116 |
117 |
118 |
119 |
120 |
121 |
122 |
127 |
128 |
129 | SqlRender
130 |
131 |
132 |
133 |
134 |
135 |
136 |
142 |
143 |
144 |
145 |
155 |
156 |
157 |
158 |
159 |
160 |
161 |
162 |
163 |
164 |
--------------------------------------------------------------------------------
/docs/reference/camelCaseToSnakeCase.html:
--------------------------------------------------------------------------------
1 |
2 | Convert a camel case string to snake case — camelCaseToSnakeCase • SqlRender
6 |
7 |
8 |
9 |
10 |
11 |
23 |
24 |
25 | -
45 |
46 |
47 | -
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 | Convert a camel case string to snake case
63 | Source: R/HelperFunctions.R
64 | camelCaseToSnakeCase.Rd
65 |
66 |
67 |
68 | Convert a camel case string to snake case
69 |
70 |
71 |
72 | camelCaseToSnakeCase(string)
73 |
74 |
75 |
83 |
84 | Value
85 | A string
86 |
87 |
88 |
89 | Examples
90 | camelCaseToSnakeCase("exposureConceptId1")
91 | #> [1] "exposure_concept_id_1"
92 |
93 |
94 |
95 |
96 |
99 |
100 |
101 |
102 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
--------------------------------------------------------------------------------
/docs/reference/camelCaseToTitleCase.html:
--------------------------------------------------------------------------------
1 |
2 | Convert a camel case string to title case — camelCaseToTitleCase • SqlRender
6 |
7 |
8 |
9 |
10 |
11 |
23 |
24 |
25 | -
45 |
46 |
47 | -
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 | Convert a camel case string to title case
63 | Source: R/HelperFunctions.R
64 | camelCaseToTitleCase.Rd
65 |
66 |
67 |
68 | Convert a camel case string to title case
69 |
70 |
71 |
72 | camelCaseToTitleCase(string)
73 |
74 |
75 |
83 |
84 | Value
85 | A string
86 |
87 |
88 |
89 | Examples
90 | camelCaseToTitleCase("exposureConceptId1")
91 | #> [1] "Exposure Concept Id 1"
92 |
93 |
94 |
95 |
96 |
99 |
100 |
101 |
102 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
--------------------------------------------------------------------------------
/docs/reference/getTempTablePrefix.html:
--------------------------------------------------------------------------------
1 |
2 | Get the prefix used for emulated temp tables for DBMSs that do not support temp tables (e.g. Oracle, BigQuery). — getTempTablePrefix • SqlRender
7 |
8 |
9 |
10 |
11 |
12 |
24 |
25 |
26 | -
46 |
47 |
48 | -
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 |
63 | Get the prefix used for emulated temp tables for DBMSs that do not support temp tables (e.g. Oracle, BigQuery).
64 | Source: R/RenderSql.R
65 | getTempTablePrefix.Rd
66 |
67 |
68 |
69 | Get the prefix used for emulated temp tables for DBMSs that do not support temp tables (e.g. Oracle,
70 | BigQuery).
71 |
72 |
73 |
74 | getTempTablePrefix()
75 |
76 |
77 |
78 | Value
79 | The prefix string.
80 |
81 |
82 |
83 | Examples
84 | getTempTablePrefix()
85 | #> [1] "l3470uc6"
86 |
87 |
88 |
89 |
92 |
93 |
94 |
95 |
104 |
105 |
106 |
107 |
108 |
109 |
110 |
111 |
112 |
--------------------------------------------------------------------------------
/docs/reference/launchSqlRenderDeveloper.html:
--------------------------------------------------------------------------------
1 |
2 | Launch the SqlRender Developer Shiny app — launchSqlRenderDeveloper • SqlRender
6 |
7 |
8 |
9 |
10 |
11 |
23 |
24 |
25 | -
45 |
46 |
47 | -
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 | Launch the SqlRender Developer Shiny app
63 | Source: R/ShinyApps.R
64 | launchSqlRenderDeveloper.Rd
65 |
66 |
67 |
68 | Launch the SqlRender Developer Shiny app
69 |
70 |
71 |
72 | launchSqlRenderDeveloper(launch.browser = TRUE)
73 |
74 |
75 |
76 | Arguments
77 |
78 |
79 |
84 |
85 | Details
86 | Launches a Shiny app that allows the user to develop SQL and see how it translates to the supported
87 | dialects.
88 |
89 |
90 |
91 |
94 |
95 |
96 |
97 |
106 |
107 |
108 |
109 |
110 |
111 |
112 |
113 |
114 |
--------------------------------------------------------------------------------
/docs/reference/snakeCaseToCamelCase.html:
--------------------------------------------------------------------------------
1 |
2 | Convert a snake case string to camel case — snakeCaseToCamelCase • SqlRender
6 |
7 |
8 |
9 |
10 |
11 |
23 |
24 |
25 | -
45 |
46 |
47 | -
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 | Convert a snake case string to camel case
63 | Source: R/HelperFunctions.R
64 | snakeCaseToCamelCase.Rd
65 |
66 |
67 |
68 | Convert a snake case string to camel case
69 |
70 |
71 |
72 | snakeCaseToCamelCase(string)
73 |
74 |
75 |
83 |
84 | Value
85 | A string
86 |
87 |
88 |
89 | Examples
90 | snakeCaseToCamelCase("exposure_concept_id_1")
91 | #> [1] "exposureConceptId1"
92 |
93 |
94 |
95 |
96 |
99 |
100 |
101 |
102 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
--------------------------------------------------------------------------------
/docs/reference/sparkHandleInsert.html:
--------------------------------------------------------------------------------
1 |
2 | Handles Spark Inserts — sparkHandleInsert • SqlRender
7 |
8 |
9 |
10 |
11 |
12 |
24 |
25 |
26 | -
46 |
47 |
48 | -
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 |
67 |
68 |
69 | This function is for Spark connections only,
70 | it handles insert commands, as Spark cannot handle inserts with aliased or subset columns.
71 |
72 |
73 |
74 | sparkHandleInsert(sql, connection)
75 |
76 |
77 |
78 | Arguments
79 |
80 |
81 |
89 |
90 | Value
91 | A sql string with INSERT command modified to contain the full column list, padded with NULLS as needed.
92 |
93 |
94 |
95 |
98 |
99 |
100 |
101 |
110 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
--------------------------------------------------------------------------------
/docs/reference/supportsJava8.html:
--------------------------------------------------------------------------------
1 |
2 | Determine if Java virtual machine supports Java — supportsJava8 • SqlRender
6 |
7 |
8 |
9 |
10 |
11 |
23 |
24 |
25 | -
45 |
46 |
47 | -
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 | Determine if Java virtual machine supports Java
63 | Source: R/HelperFunctions.R
64 | supportsJava8.Rd
65 |
66 |
67 |
68 | Tests Java virtual machine (JVM) java.version system property to check if version >= 8.
69 |
70 |
71 |
72 | supportsJava8()
73 |
74 |
75 |
76 | Value
77 | Returns TRUE if JVM supports Java >= 8.
78 |
79 |
80 |
81 | Examples
82 | supportsJava8()
83 | #> [1] TRUE
84 |
85 |
86 |
87 |
90 |
91 |
92 |
93 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
109 |
110 |
--------------------------------------------------------------------------------
/docs/sitemap.xml:
--------------------------------------------------------------------------------
1 |
2 | /404.html /articles/UsingSqlRender.html /articles/index.html /authors.html /index.html /news/index.html /pull_request_template.html /reference/SqlRender-package.html /reference/camelCaseToSnakeCase.html /reference/camelCaseToSnakeCaseNames.html /reference/camelCaseToTitleCase.html /reference/createRWrapperForSql.html /reference/getTempTablePrefix.html /reference/index.html /reference/launchSqlRenderDeveloper.html /reference/listSupportedDialects.html /reference/loadRenderTranslateSql.html /reference/readSql.html /reference/render.html /reference/renderSql.html /reference/renderSqlFile.html /reference/snakeCaseToCamelCase.html /reference/snakeCaseToCamelCaseNames.html /reference/sparkHandleInsert.html /reference/splitSql.html /reference/supportsJava8.html /reference/translate.html /reference/translateSingleStatement.html /reference/translateSql.html /reference/translateSqlFile.html /reference/writeSql.html
34 |
35 |
--------------------------------------------------------------------------------
/extras/PackageMaintenance.R:
--------------------------------------------------------------------------------
1 | # Copyright 2025 Observational Health Data Sciences and Informatics
2 | #
3 | # This file is part of SqlRender
4 | #
5 | # Licensed under the Apache License, Version 2.0 (the "License");
6 | # you may not use this file except in compliance with the License.
7 | # You may obtain a copy of the License at
8 | #
9 | # http://www.apache.org/licenses/LICENSE-2.0
10 | #
11 | # Unless required by applicable law or agreed to in writing, software
12 | # distributed under the License is distributed on an "AS IS" BASIS,
13 | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 | # See the License for the specific language governing permissions and
15 | # limitations under the License.
16 |
17 | # Format and check code --------------------------------------------------------
18 | styler::style_pkg()
19 | OhdsiRTools::checkUsagePackage("SqlRender")
20 | OhdsiRTools::updateCopyrightYearFolder()
21 | devtools::spell_check()
22 |
23 | # Create manual and vignettes --------------------------------------------------
24 | unlink("extras/SqlRender.pdf")
25 | system("R CMD Rd2pdf ./ --output=extras/SqlRender.pdf")
26 |
27 | dir.create("inst/doc")
28 | rmarkdown::render("vignettes/UsingSqlRender.Rmd",
29 | output_file = "../inst/doc/UsingSqlRender.pdf",
30 | rmarkdown::pdf_document(latex_engine = "pdflatex",
31 | toc = TRUE,
32 | number_sections = TRUE))
33 |
34 | pkgdown::build_site()
35 | OhdsiRTools::fixHadesLogo()
36 |
37 | # Store JAR checksum -----------------------------------------------------------
38 | checksum <- rJava::J("org.ohdsi.sql.JarChecksum", "computeJarChecksum")
39 | write(checksum, file.path("inst", "csv", "jarChecksum.txt"))
40 |
41 | # Release package --------------------------------------------------------------
42 | # Check if DESCRIPTION version matches POM version:
43 | descriptionVersion <- stringr::str_extract(readLines("DESCRIPTION")[grepl("^Version:", readLines("DESCRIPTION"))], "(?<=Version: ).*$")
44 | pomVersion <- stringr::str_extract(readLines("pom.xml")[grepl("SNAPSHOT", readLines("pom.xml"))], "(?<=).*(?=-SNAPSHOT )")
45 | if (descriptionVersion != pomVersion) stop("DESCRIPTION version does not match POM version")
46 |
47 | revdepcheck::revdep_check(num_workers = 4)
48 |
49 | devtools::check_win_devel()
50 |
51 | rhub::rc_submit(platforms = "atlas")
52 |
53 | devtools::release()
54 |
--------------------------------------------------------------------------------
/extras/SqlRender.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/OHDSI/SqlRender/97eb3b441bb98fa51676c54eca20b296fdcfbf21/extras/SqlRender.pdf
--------------------------------------------------------------------------------
/inst/csv/jarChecksum.txt:
--------------------------------------------------------------------------------
1 | dc152542636e6f48d689a17b71cce31ce2d77160b76ce599b76f1e06a7e4d211
2 |
--------------------------------------------------------------------------------
/inst/csv/supportedDialects.csv:
--------------------------------------------------------------------------------
1 | dialect,description
2 | sql server,Microsoft SQL Server
3 | oracle,Oracle
4 | postgresql,PostgreSQL
5 | pdw,Microsoft Parallel Data Warehouse
6 | impala,Apache Impala
7 | netezza,IBM Netezza
8 | bigquery,Google BigQuery
9 | spark,Apache Spark
10 | sqlite,SQLite
11 | redshift,Amazon RedShift
12 | hive,Apache Hive
13 | sqlite extended,SQLite Extended Syntax
14 | duckdb,DuckDB
15 | snowflake,Snowflake
16 | synapse,Azure Synapse Analytics Dedicated
17 | iris,InterSystems IRIS
18 |
--------------------------------------------------------------------------------
/inst/doc/UsingSqlRender.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/OHDSI/SqlRender/97eb3b441bb98fa51676c54eca20b296fdcfbf21/inst/doc/UsingSqlRender.pdf
--------------------------------------------------------------------------------
/inst/java/SqlRender.jar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/OHDSI/SqlRender/97eb3b441bb98fa51676c54eca20b296fdcfbf21/inst/java/SqlRender.jar
--------------------------------------------------------------------------------
/inst/shinyApps/SqlDeveloper/SqlDeveloper.Rproj:
--------------------------------------------------------------------------------
1 | Version: 1.0
2 |
3 | RestoreWorkspace: Default
4 | SaveWorkspace: Default
5 | AlwaysSaveHistory: Default
6 |
7 | EnableCodeIndexing: Yes
8 | UseSpacesForTab: Yes
9 | NumSpacesForTab: 2
10 | Encoding: UTF-8
11 |
12 | RnwWeave: Sweave
13 | LaTeX: pdfLaTeX
14 |
--------------------------------------------------------------------------------
/inst/shinyApps/SqlDeveloper/server.R:
--------------------------------------------------------------------------------
1 | library(shiny)
2 | library(SqlRender)
3 |
4 | shinyServer(function(input, output, session) {
5 |
6 | # cache <- reactiveValues(target = '', clicks = 0, parameters = NULL)
7 |
8 | parameters <- reactive({
9 | params <- regmatches(input$source, gregexpr("@[a-zA-Z0-9_]+", input$source))[[1]]
10 | params <- unique(params)
11 | params <- params[order(params)]
12 | params <- substr(params, 2, nchar(params))
13 | return(params)
14 | })
15 |
16 | output$target <- renderText({
17 | parameterValues <- list()
18 | for (param in parameters()) {
19 | value <- input[[param]]
20 | if (!is.null(value)) {
21 | parameterValues[[param]] <- value
22 | }
23 | }
24 | sql <- do.call("render", append(input$source, parameterValues))
25 | warningString <- c()
26 | handleWarning <- function(e) {
27 | output$warnings <- e$message
28 | }
29 | tempEmulationSchema <- input$tempEmulationSchema
30 | if (tempEmulationSchema == "")
31 | tempEmulationSchema <- NULL
32 | sql <- withCallingHandlers(suppressWarnings(translate(sql,
33 | targetDialect = tolower(input$dialect),
34 | tempEmulationSchema = tempEmulationSchema)), warning = handleWarning)
35 | if (!is.null(warningString))
36 | output$warnings <- warningString
37 | return(sql)
38 | })
39 |
40 | output$parameterInputs <- renderUI({
41 | params <- parameters()
42 | sourceSql <- input$source
43 |
44 | createRow <- function(param, sourceSql) {
45 | # Get current values if already exists:
46 | value <- isolate(input[[param]])
47 |
48 | if (is.null(value)) {
49 | # Get default values:
50 | value <- regmatches(sourceSql,
51 | regexpr(paste0("\\{\\s*DEFAULT\\s*@", param, "\\s=[^}]+}"), sourceSql))
52 | if (length(value) == 1) {
53 | value <- sub(paste0("\\{\\s*DEFAULT\\s*@", param, "\\s=\\s*"), "", sub("\\}$", "", value))
54 | } else {
55 | value <- ""
56 | }
57 | }
58 | textInput(param, param, value = value)
59 | }
60 | lapply(params, createRow, sourceSql = sourceSql)
61 | })
62 |
63 | observeEvent(input$open, {
64 | sql <- SqlRender::readSql(input$open$datapath)
65 | updateTextAreaInput(session, "source", value = sql)
66 | })
67 |
68 | output$save <- downloadHandler(filename = function() {
69 | paste("query-", Sys.Date(), ".sql", sep = "")
70 | }, content = function(con) {
71 | SqlRender::writeSql(sql = input$source, targetFile = con)
72 | })
73 | })
74 |
75 |
--------------------------------------------------------------------------------
/inst/shinyApps/SqlDeveloper/ui.R:
--------------------------------------------------------------------------------
1 | library(shiny)
2 | library(shinydashboard)
3 | source("widgets.R")
4 |
5 | dashboardPage(
6 | dashboardHeader(title = "SqlRender Developer"),
7 | dashboardSidebar(
8 | sidebarMenu(
9 | menuItemFileInput("open", "Open file", icon = shiny::icon("folder-open")),
10 | menuItemDownloadLink("save", "Save", icon = shiny::icon("save")),
11 | menuItem("Open new tab", href = "", icon = shiny::icon("plus-square")),
12 | menuItemCopyTextAreaToClipboard("source", "Copy source to clipboard"),
13 | menuItemCopyDivToClipboard("target", "Copy target to clipboard")
14 | )
15 | ),
16 | dashboardBody(
17 | fluidRow(
18 | column(width = 9,
19 | box(
20 | title = "Source: OHDSI SQL", width = NULL, status = "primary",
21 | textAreaInput("source", NULL, width = "100%", height = "300px")
22 | ),
23 | box(
24 | title = "Target: Rendered translation", width = NULL,
25 | # tags$table(width = "100%",
26 | # tags$tr(
27 | # tags$td(align = "left", actionButton("renderTranslate", "Render and translate")),
28 | # tags$td(align = "right", checkboxInput("continuous", "Auto render and translate")))),
29 | pre(textOutput("target"))
30 | )
31 | ),
32 | column(width = 3,
33 | box(background = "light-blue",
34 | h4("Target dialect"), width = NULL,
35 | selectInput("dialect", NULL, choices = c("BigQuery", "Impala", "Netezza", "Oracle", "PDW", "PostgreSQL", "RedShift", "SQL Server", "SQLite", "Hive", "Spark", "Snowflake", "Synapse", "InterSystems IRIS" = "iris"), selected = "SQL Server"),
36 | h4("Temp emulation schema"),
37 | textInput("tempEmulationSchema", NULL),
38 | h4("Parameters"),
39 | uiOutput("parameterInputs"),
40 | textOutput("warnings")
41 | )
42 | )
43 | )
44 | )
45 | )
46 |
--------------------------------------------------------------------------------
/inst/shinyApps/SqlDeveloper/widgets.R:
--------------------------------------------------------------------------------
1 | menuItemFileInput <- function(inputId, text, icon = shiny::icon("file-text-o")) {
2 | script <- "document.getElementById('%id%').click(); return false;"
3 | script <- gsub("%id%", inputId, script)
4 | list(div(fileInput(inputId, ""), style = "display: none;"),
5 | tags$li(class = "treeview", a(href = "#", onclick = script, icon, text)))
6 | }
7 |
8 | menuItemDownloadLink <- function(inputId, label, icon = shiny::icon("floppy-o")) {
9 | tags$li(class = "treeview",
10 | tags$a(id = inputId,
11 | class = "shiny-download-link",
12 | href = "",
13 | target = "_blank",
14 | download = NA,
15 | icon,
16 | label))
17 | }
18 |
19 | menuItemCopyTextAreaToClipboard <- function(textAreaId, label, icon = shiny::icon("clipboard")) {
20 | script <- "
21 | element = $('
`).
76 | getTopLevel: function($scope) {
77 | for (var i = 1; i <= 6; i++) {
78 | var $headings = this.findOrFilter($scope, 'h' + i);
79 | if ($headings.length > 1) {
80 | return i;
81 | }
82 | }
83 |
84 | return 1;
85 | },
86 |
87 | // returns the elements for the top level, and the next below it
88 | getHeadings: function($scope, topLevel) {
89 | var topSelector = 'h' + topLevel;
90 |
91 | var secondaryLevel = topLevel + 1;
92 | var secondarySelector = 'h' + secondaryLevel;
93 |
94 | return this.findOrFilter($scope, topSelector + ',' + secondarySelector);
95 | },
96 |
97 | getNavLevel: function(el) {
98 | return parseInt(el.tagName.charAt(1), 10);
99 | },
100 |
101 | populateNav: function($topContext, topLevel, $headings) {
102 | var $context = $topContext;
103 | var $prevNav;
104 |
105 | var helpers = this;
106 | $headings.each(function(i, el) {
107 | var $newNav = helpers.generateNavItem(el);
108 | var navLevel = helpers.getNavLevel(el);
109 |
110 | // determine the proper $context
111 | if (navLevel === topLevel) {
112 | // use top level
113 | $context = $topContext;
114 | } else if ($prevNav && $context === $topContext) {
115 | // create a new level of the tree and switch to it
116 | $context = helpers.createChildNavList($prevNav);
117 | } // else use the current $context
118 |
119 | $context.append($newNav);
120 |
121 | $prevNav = $newNav;
122 | });
123 | },
124 |
125 | parseOps: function(arg) {
126 | var opts;
127 | if (arg.jquery) {
128 | opts = {
129 | $nav: arg
130 | };
131 | } else {
132 | opts = arg;
133 | }
134 | opts.$scope = opts.$scope || $(document.body);
135 | return opts;
136 | }
137 | },
138 |
139 | // accepts a jQuery object, or an options object
140 | init: function(opts) {
141 | opts = this.helpers.parseOps(opts);
142 |
143 | // ensure that the data attribute is in place for styling
144 | opts.$nav.attr('data-toggle', 'toc');
145 |
146 | var $topContext = this.helpers.createChildNavList(opts.$nav);
147 | var topLevel = this.helpers.getTopLevel(opts.$scope);
148 | var $headings = this.helpers.getHeadings(opts.$scope, topLevel);
149 | this.helpers.populateNav($topContext, topLevel, $headings);
150 | }
151 | };
152 |
153 | $(function() {
154 | $('nav[data-toggle="toc"]').each(function(i, el) {
155 | var $nav = $(el);
156 | Toc.init($nav);
157 | });
158 | });
159 | })();
160 |
--------------------------------------------------------------------------------
/docs/docsearch.js:
--------------------------------------------------------------------------------
1 | $(function() {
2 |
3 | // register a handler to move the focus to the search bar
4 | // upon pressing shift + "/" (i.e. "?")
5 | $(document).on('keydown', function(e) {
6 | if (e.shiftKey && e.keyCode == 191) {
7 | e.preventDefault();
8 | $("#search-input").focus();
9 | }
10 | });
11 |
12 | $(document).ready(function() {
13 | // do keyword highlighting
14 | /* modified from https://jsfiddle.net/julmot/bL6bb5oo/ */
15 | var mark = function() {
16 |
17 | var referrer = document.URL ;
18 | var paramKey = "q" ;
19 |
20 | if (referrer.indexOf("?") !== -1) {
21 | var qs = referrer.substr(referrer.indexOf('?') + 1);
22 | var qs_noanchor = qs.split('#')[0];
23 | var qsa = qs_noanchor.split('&');
24 | var keyword = "";
25 |
26 | for (var i = 0; i < qsa.length; i++) {
27 | var currentParam = qsa[i].split('=');
28 |
29 | if (currentParam.length !== 2) {
30 | continue;
31 | }
32 |
33 | if (currentParam[0] == paramKey) {
34 | keyword = decodeURIComponent(currentParam[1].replace(/\+/g, "%20"));
35 | }
36 | }
37 |
38 | if (keyword !== "") {
39 | $(".contents").unmark({
40 | done: function() {
41 | $(".contents").mark(keyword);
42 | }
43 | });
44 | }
45 | }
46 | };
47 |
48 | mark();
49 | });
50 | });
51 |
52 | /* Search term highlighting ------------------------------*/
53 |
54 | function matchedWords(hit) {
55 | var words = [];
56 |
57 | var hierarchy = hit._highlightResult.hierarchy;
58 | // loop to fetch from lvl0, lvl1, etc.
59 | for (var idx in hierarchy) {
60 | words = words.concat(hierarchy[idx].matchedWords);
61 | }
62 |
63 | var content = hit._highlightResult.content;
64 | if (content) {
65 | words = words.concat(content.matchedWords);
66 | }
67 |
68 | // return unique words
69 | var words_uniq = [...new Set(words)];
70 | return words_uniq;
71 | }
72 |
73 | function updateHitURL(hit) {
74 |
75 | var words = matchedWords(hit);
76 | var url = "";
77 |
78 | if (hit.anchor) {
79 | url = hit.url_without_anchor + '?q=' + escape(words.join(" ")) + '#' + hit.anchor;
80 | } else {
81 | url = hit.url + '?q=' + escape(words.join(" "));
82 | }
83 |
84 | return url;
85 | }
86 |
--------------------------------------------------------------------------------
/docs/jquery.sticky-kit.min.js:
--------------------------------------------------------------------------------
1 | /*
2 | Sticky-kit v1.1.2 | WTFPL | Leaf Corcoran 2015 | http://leafo.net
3 | */
4 | (function(){var b,f;b=this.jQuery||window.jQuery;f=b(window);b.fn.stick_in_parent=function(d){var A,w,J,n,B,K,p,q,k,E,t;null==d&&(d={});t=d.sticky_class;B=d.inner_scrolling;E=d.recalc_every;k=d.parent;q=d.offset_top;p=d.spacer;w=d.bottoming;null==q&&(q=0);null==k&&(k=void 0);null==B&&(B=!0);null==t&&(t="is_stuck");A=b(document);null==w&&(w=!0);J=function(a,d,n,C,F,u,r,G){var v,H,m,D,I,c,g,x,y,z,h,l;if(!a.data("sticky_kit")){a.data("sticky_kit",!0);I=A.height();g=a.parent();null!=k&&(g=g.closest(k));
5 | if(!g.length)throw"failed to find stick parent";v=m=!1;(h=null!=p?p&&a.closest(p):b(""))&&h.css("position",a.css("position"));x=function(){var c,f,e;if(!G&&(I=A.height(),c=parseInt(g.css("border-top-width"),10),f=parseInt(g.css("padding-top"),10),d=parseInt(g.css("padding-bottom"),10),n=g.offset().top+c+f,C=g.height(),m&&(v=m=!1,null==p&&(a.insertAfter(h),h.detach()),a.css({position:"",top:"",width:"",bottom:""}).removeClass(t),e=!0),F=a.offset().top-(parseInt(a.css("margin-top"),10)||0)-q,
6 | u=a.outerHeight(!0),r=a.css("float"),h&&h.css({width:a.outerWidth(!0),height:u,display:a.css("display"),"vertical-align":a.css("vertical-align"),"float":r}),e))return l()};x();if(u!==C)return D=void 0,c=q,z=E,l=function(){var b,l,e,k;if(!G&&(e=!1,null!=z&&(--z,0>=z&&(z=E,x(),e=!0)),e||A.height()===I||x(),e=f.scrollTop(),null!=D&&(l=e-D),D=e,m?(w&&(k=e+u+c>C+n,v&&!k&&(v=!1,a.css({position:"fixed",bottom:"",top:c}).trigger("sticky_kit:unbottom"))),eb&&!v&&(c-=l,c=Math.max(b-u,c),c=Math.min(q,c),m&&a.css({top:c+"px"})))):e>F&&(m=!0,b={position:"fixed",top:c},b.width="border-box"===a.css("box-sizing")?a.outerWidth()+"px":a.width()+"px",a.css(b).addClass(t),null==p&&(a.after(h),"left"!==r&&"right"!==r||h.append(a)),a.trigger("sticky_kit:stick")),m&&w&&(null==k&&(k=e+u+c>C+n),!v&&k)))return v=!0,"static"===g.css("position")&&g.css({position:"relative"}),
8 | a.css({position:"absolute",bottom:d,top:"auto"}).trigger("sticky_kit:bottom")},y=function(){x();return l()},H=function(){G=!0;f.off("touchmove",l);f.off("scroll",l);f.off("resize",y);b(document.body).off("sticky_kit:recalc",y);a.off("sticky_kit:detach",H);a.removeData("sticky_kit");a.css({position:"",bottom:"",top:"",width:""});g.position("position","");if(m)return null==p&&("left"!==r&&"right"!==r||a.insertAfter(h),h.remove()),a.removeClass(t)},f.on("touchmove",l),f.on("scroll",l),f.on("resize",
9 | y),b(document.body).on("sticky_kit:recalc",y),a.on("sticky_kit:detach",H),setTimeout(l,0)}};n=0;for(K=this.length;n
2 |
3 |
13 |
--------------------------------------------------------------------------------
/docs/pkgdown.js:
--------------------------------------------------------------------------------
1 | /* http://gregfranko.com/blog/jquery-best-practices/ */
2 | (function($) {
3 | $(function() {
4 |
5 | $('.navbar-fixed-top').headroom();
6 |
7 | $('body').css('padding-top', $('.navbar').height() + 10);
8 | $(window).resize(function(){
9 | $('body').css('padding-top', $('.navbar').height() + 10);
10 | });
11 |
12 | $('[data-toggle="tooltip"]').tooltip();
13 |
14 | var cur_path = paths(location.pathname);
15 | var links = $("#navbar ul li a");
16 | var max_length = -1;
17 | var pos = -1;
18 | for (var i = 0; i < links.length; i++) {
19 | if (links[i].getAttribute("href") === "#")
20 | continue;
21 | // Ignore external links
22 | if (links[i].host !== location.host)
23 | continue;
24 |
25 | var nav_path = paths(links[i].pathname);
26 |
27 | var length = prefix_length(nav_path, cur_path);
28 | if (length > max_length) {
29 | max_length = length;
30 | pos = i;
31 | }
32 | }
33 |
34 | // Add class to parent , and enclosing if in dropdown
35 | if (pos >= 0) {
36 | var menu_anchor = $(links[pos]);
37 | menu_anchor.parent().addClass("active");
38 | menu_anchor.closest("li.dropdown").addClass("active");
39 | }
40 | });
41 |
42 | function paths(pathname) {
43 | var pieces = pathname.split("/");
44 | pieces.shift(); // always starts with /
45 |
46 | var end = pieces[pieces.length - 1];
47 | if (end === "index.html" || end === "")
48 | pieces.pop();
49 | return(pieces);
50 | }
51 |
52 | // Returns -1 if not found
53 | function prefix_length(needle, haystack) {
54 | if (needle.length > haystack.length)
55 | return(-1);
56 |
57 | // Special case for length-0 haystack, since for loop won't run
58 | if (haystack.length === 0) {
59 | return(needle.length === 0 ? 0 : -1);
60 | }
61 |
62 | for (var i = 0; i < haystack.length; i++) {
63 | if (needle[i] != haystack[i])
64 | return(i);
65 | }
66 |
67 | return(haystack.length);
68 | }
69 |
70 | /* Clipboard --------------------------*/
71 |
72 | function changeTooltipMessage(element, msg) {
73 | var tooltipOriginalTitle=element.getAttribute('data-original-title');
74 | element.setAttribute('data-original-title', msg);
75 | $(element).tooltip('show');
76 | element.setAttribute('data-original-title', tooltipOriginalTitle);
77 | }
78 |
79 | if(ClipboardJS.isSupported()) {
80 | $(document).ready(function() {
81 | var copyButton = "";
82 |
83 | $("div.sourceCode").addClass("hasCopyButton");
84 |
85 | // Insert copy buttons:
86 | $(copyButton).prependTo(".hasCopyButton");
87 |
88 | // Initialize tooltips:
89 | $('.btn-copy-ex').tooltip({container: 'body'});
90 |
91 | // Initialize clipboard:
92 | var clipboardBtnCopies = new ClipboardJS('[data-clipboard-copy]', {
93 | text: function(trigger) {
94 | return trigger.parentNode.textContent.replace(/\n#>[^\n]*/g, "");
95 | }
96 | });
97 |
98 | clipboardBtnCopies.on('success', function(e) {
99 | changeTooltipMessage(e.trigger, 'Copied!');
100 | e.clearSelection();
101 | });
102 |
103 | clipboardBtnCopies.on('error', function() {
104 | changeTooltipMessage(e.trigger,'Press Ctrl+C or Command+C to copy');
105 | });
106 | });
107 | }
108 | })(window.jQuery || window.$)
109 |
--------------------------------------------------------------------------------
/docs/pkgdown.yml:
--------------------------------------------------------------------------------
1 | pandoc: '3.2'
2 | pkgdown: 2.1.3
3 | pkgdown_sha: ~
4 | articles:
5 | UsingSqlRender: UsingSqlRender.html
6 | last_built: 2025-09-26T13:47Z
7 |
--------------------------------------------------------------------------------
/docs/pull_request_template.html:
--------------------------------------------------------------------------------
1 |
2 | NA • SqlRender
6 |
7 |
8 |
9 |
10 |
11 |
23 |
24 |
25 | -
45 |
46 |
47 | -
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 | NA
63 |
64 |
65 |
66 | Before you do a pull request, you should always file an issue and make sure the package maintainer agrees that it’s a problem, and is happy with your basic proposal for fixing it. We don’t want you to spend a bunch of time on something that we don’t think is a good idea.
67 | Additional requirements for pull requests:
68 | Adhere to the Developer Guidelines as well as the OHDSI Code Style.
If possible, add unit tests for new functionality you add.
Restrict your pull request to solving the issue at hand. Do not try to ‘improve’ parts of the code that are not related to the issue. If you feel other parts of the code need better organization, create a separate issue for that.
Make sure you pass R check without errors and warnings before submitting.
Always target the develop branch, and make sure you are up-to-date with the develop branch.
74 |
75 |
78 |
79 |
80 |
81 |
82 |
83 |
92 |
93 |
94 |
95 |
96 |
97 |
98 |
99 |
100 |
--------------------------------------------------------------------------------
/docs/reference/Rplot001.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/OHDSI/SqlRender/97eb3b441bb98fa51676c54eca20b296fdcfbf21/docs/reference/Rplot001.png
--------------------------------------------------------------------------------
/docs/reference/SqlRender.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 | SqlRender — SqlRender • SqlRender
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 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
115 |
116 |
117 |
118 |
119 |
120 |
121 |
122 |
127 |
128 |
129 | SqlRender
130 |
131 |
132 |
133 |
134 |
135 |
136 |
142 |
143 |
144 |
145 |
155 |
156 |
157 |
158 |
159 |
160 |
161 |
162 |
163 |
164 |
--------------------------------------------------------------------------------
/docs/reference/camelCaseToSnakeCase.html:
--------------------------------------------------------------------------------
1 |
2 | Convert a camel case string to snake case — camelCaseToSnakeCase • SqlRender
6 |
7 |
8 |
9 |
10 |
11 |
23 |
24 |
25 | -
45 |
46 |
47 | -
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 | Convert a camel case string to snake case
63 | Source: R/HelperFunctions.R
64 | camelCaseToSnakeCase.Rd
65 |
66 |
67 |
68 | Convert a camel case string to snake case
69 |
70 |
71 |
72 | camelCaseToSnakeCase(string)
73 |
74 |
75 |
83 |
84 | Value
85 | A string
86 |
87 |
88 |
89 | Examples
90 | camelCaseToSnakeCase("exposureConceptId1")
91 | #> [1] "exposure_concept_id_1"
92 |
93 |
94 |
95 |
96 |
99 |
100 |
101 |
102 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
--------------------------------------------------------------------------------
/docs/reference/camelCaseToTitleCase.html:
--------------------------------------------------------------------------------
1 |
2 | Convert a camel case string to title case — camelCaseToTitleCase • SqlRender
6 |
7 |
8 |
9 |
10 |
11 |
23 |
24 |
25 | -
45 |
46 |
47 | -
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 | Convert a camel case string to title case
63 | Source: R/HelperFunctions.R
64 | camelCaseToTitleCase.Rd
65 |
66 |
67 |
68 | Convert a camel case string to title case
69 |
70 |
71 |
72 | camelCaseToTitleCase(string)
73 |
74 |
75 |
83 |
84 | Value
85 | A string
86 |
87 |
88 |
89 | Examples
90 | camelCaseToTitleCase("exposureConceptId1")
91 | #> [1] "Exposure Concept Id 1"
92 |
93 |
94 |
95 |
96 |
99 |
100 |
101 |
102 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
--------------------------------------------------------------------------------
/docs/reference/getTempTablePrefix.html:
--------------------------------------------------------------------------------
1 |
2 | Get the prefix used for emulated temp tables for DBMSs that do not support temp tables (e.g. Oracle, BigQuery). — getTempTablePrefix • SqlRender
7 |
8 |
9 |
10 |
11 |
12 |
24 |
25 |
26 | -
46 |
47 |
48 | -
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 |
63 | Get the prefix used for emulated temp tables for DBMSs that do not support temp tables (e.g. Oracle, BigQuery).
64 | Source: R/RenderSql.R
65 | getTempTablePrefix.Rd
66 |
67 |
68 |
69 | Get the prefix used for emulated temp tables for DBMSs that do not support temp tables (e.g. Oracle,
70 | BigQuery).
71 |
72 |
73 |
74 | getTempTablePrefix()
75 |
76 |
77 |
78 | Value
79 | The prefix string.
80 |
81 |
82 |
83 | Examples
84 | getTempTablePrefix()
85 | #> [1] "l3470uc6"
86 |
87 |
88 |
89 |
92 |
93 |
94 |
95 |
104 |
105 |
106 |
107 |
108 |
109 |
110 |
111 |
112 |
--------------------------------------------------------------------------------
/docs/reference/launchSqlRenderDeveloper.html:
--------------------------------------------------------------------------------
1 |
2 | Launch the SqlRender Developer Shiny app — launchSqlRenderDeveloper • SqlRender
6 |
7 |
8 |
9 |
10 |
11 |
23 |
24 |
25 | -
45 |
46 |
47 | -
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 | Launch the SqlRender Developer Shiny app
63 | Source: R/ShinyApps.R
64 | launchSqlRenderDeveloper.Rd
65 |
66 |
67 |
68 | Launch the SqlRender Developer Shiny app
69 |
70 |
71 |
72 | launchSqlRenderDeveloper(launch.browser = TRUE)
73 |
74 |
75 |
76 | Arguments
77 |
78 |
79 |
84 |
85 | Details
86 | Launches a Shiny app that allows the user to develop SQL and see how it translates to the supported
87 | dialects.
88 |
89 |
90 |
91 |
94 |
95 |
96 |
97 |
106 |
107 |
108 |
109 |
110 |
111 |
112 |
113 |
114 |
--------------------------------------------------------------------------------
/docs/reference/snakeCaseToCamelCase.html:
--------------------------------------------------------------------------------
1 |
2 | Convert a snake case string to camel case — snakeCaseToCamelCase • SqlRender
6 |
7 |
8 |
9 |
10 |
11 |
23 |
24 |
25 | -
45 |
46 |
47 | -
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 | Convert a snake case string to camel case
63 | Source: R/HelperFunctions.R
64 | snakeCaseToCamelCase.Rd
65 |
66 |
67 |
68 | Convert a snake case string to camel case
69 |
70 |
71 |
72 | snakeCaseToCamelCase(string)
73 |
74 |
75 |
83 |
84 | Value
85 | A string
86 |
87 |
88 |
89 | Examples
90 | snakeCaseToCamelCase("exposure_concept_id_1")
91 | #> [1] "exposureConceptId1"
92 |
93 |
94 |
95 |
96 |
99 |
100 |
101 |
102 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
--------------------------------------------------------------------------------
/docs/reference/sparkHandleInsert.html:
--------------------------------------------------------------------------------
1 |
2 | Handles Spark Inserts — sparkHandleInsert • SqlRender
7 |
8 |
9 |
10 |
11 |
12 |
24 |
25 |
26 | -
46 |
47 |
48 | -
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 |
67 |
68 |
69 | This function is for Spark connections only,
70 | it handles insert commands, as Spark cannot handle inserts with aliased or subset columns.
71 |
72 |
73 |
74 | sparkHandleInsert(sql, connection)
75 |
76 |
77 |
78 | Arguments
79 |
80 |
81 |
89 |
90 | Value
91 | A sql string with INSERT command modified to contain the full column list, padded with NULLS as needed.
92 |
93 |
94 |
95 |
98 |
99 |
100 |
101 |
110 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
--------------------------------------------------------------------------------
/docs/reference/supportsJava8.html:
--------------------------------------------------------------------------------
1 |
2 | Determine if Java virtual machine supports Java — supportsJava8 • SqlRender
6 |
7 |
8 |
9 |
10 |
11 |
23 |
24 |
25 | -
45 |
46 |
47 | -
48 |
49 |
50 |
51 |
52 |
53 |
54 |
55 |
56 |
57 |
58 |
59 |
60 |
61 |
62 | Determine if Java virtual machine supports Java
63 | Source: R/HelperFunctions.R
64 | supportsJava8.Rd
65 |
66 |
67 |
68 | Tests Java virtual machine (JVM) java.version system property to check if version >= 8.
69 |
70 |
71 |
72 | supportsJava8()
73 |
74 |
75 |
76 | Value
77 | Returns TRUE if JVM supports Java >= 8.
78 |
79 |
80 |
81 | Examples
82 | supportsJava8()
83 | #> [1] TRUE
84 |
85 |
86 |
87 |
90 |
91 |
92 |
93 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
109 |
110 |
--------------------------------------------------------------------------------
/docs/sitemap.xml:
--------------------------------------------------------------------------------
1 |
2 | /404.html /articles/UsingSqlRender.html /articles/index.html /authors.html /index.html /news/index.html /pull_request_template.html /reference/SqlRender-package.html /reference/camelCaseToSnakeCase.html /reference/camelCaseToSnakeCaseNames.html /reference/camelCaseToTitleCase.html /reference/createRWrapperForSql.html /reference/getTempTablePrefix.html /reference/index.html /reference/launchSqlRenderDeveloper.html /reference/listSupportedDialects.html /reference/loadRenderTranslateSql.html /reference/readSql.html /reference/render.html /reference/renderSql.html /reference/renderSqlFile.html /reference/snakeCaseToCamelCase.html /reference/snakeCaseToCamelCaseNames.html /reference/sparkHandleInsert.html /reference/splitSql.html /reference/supportsJava8.html /reference/translate.html /reference/translateSingleStatement.html /reference/translateSql.html /reference/translateSqlFile.html /reference/writeSql.html
34 |
35 |
--------------------------------------------------------------------------------
/extras/PackageMaintenance.R:
--------------------------------------------------------------------------------
1 | # Copyright 2025 Observational Health Data Sciences and Informatics
2 | #
3 | # This file is part of SqlRender
4 | #
5 | # Licensed under the Apache License, Version 2.0 (the "License");
6 | # you may not use this file except in compliance with the License.
7 | # You may obtain a copy of the License at
8 | #
9 | # http://www.apache.org/licenses/LICENSE-2.0
10 | #
11 | # Unless required by applicable law or agreed to in writing, software
12 | # distributed under the License is distributed on an "AS IS" BASIS,
13 | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 | # See the License for the specific language governing permissions and
15 | # limitations under the License.
16 |
17 | # Format and check code --------------------------------------------------------
18 | styler::style_pkg()
19 | OhdsiRTools::checkUsagePackage("SqlRender")
20 | OhdsiRTools::updateCopyrightYearFolder()
21 | devtools::spell_check()
22 |
23 | # Create manual and vignettes --------------------------------------------------
24 | unlink("extras/SqlRender.pdf")
25 | system("R CMD Rd2pdf ./ --output=extras/SqlRender.pdf")
26 |
27 | dir.create("inst/doc")
28 | rmarkdown::render("vignettes/UsingSqlRender.Rmd",
29 | output_file = "../inst/doc/UsingSqlRender.pdf",
30 | rmarkdown::pdf_document(latex_engine = "pdflatex",
31 | toc = TRUE,
32 | number_sections = TRUE))
33 |
34 | pkgdown::build_site()
35 | OhdsiRTools::fixHadesLogo()
36 |
37 | # Store JAR checksum -----------------------------------------------------------
38 | checksum <- rJava::J("org.ohdsi.sql.JarChecksum", "computeJarChecksum")
39 | write(checksum, file.path("inst", "csv", "jarChecksum.txt"))
40 |
41 | # Release package --------------------------------------------------------------
42 | # Check if DESCRIPTION version matches POM version:
43 | descriptionVersion <- stringr::str_extract(readLines("DESCRIPTION")[grepl("^Version:", readLines("DESCRIPTION"))], "(?<=Version: ).*$")
44 | pomVersion <- stringr::str_extract(readLines("pom.xml")[grepl("SNAPSHOT", readLines("pom.xml"))], "(?<=).*(?=-SNAPSHOT )")
45 | if (descriptionVersion != pomVersion) stop("DESCRIPTION version does not match POM version")
46 |
47 | revdepcheck::revdep_check(num_workers = 4)
48 |
49 | devtools::check_win_devel()
50 |
51 | rhub::rc_submit(platforms = "atlas")
52 |
53 | devtools::release()
54 |
--------------------------------------------------------------------------------
/extras/SqlRender.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/OHDSI/SqlRender/97eb3b441bb98fa51676c54eca20b296fdcfbf21/extras/SqlRender.pdf
--------------------------------------------------------------------------------
/inst/csv/jarChecksum.txt:
--------------------------------------------------------------------------------
1 | dc152542636e6f48d689a17b71cce31ce2d77160b76ce599b76f1e06a7e4d211
2 |
--------------------------------------------------------------------------------
/inst/csv/supportedDialects.csv:
--------------------------------------------------------------------------------
1 | dialect,description
2 | sql server,Microsoft SQL Server
3 | oracle,Oracle
4 | postgresql,PostgreSQL
5 | pdw,Microsoft Parallel Data Warehouse
6 | impala,Apache Impala
7 | netezza,IBM Netezza
8 | bigquery,Google BigQuery
9 | spark,Apache Spark
10 | sqlite,SQLite
11 | redshift,Amazon RedShift
12 | hive,Apache Hive
13 | sqlite extended,SQLite Extended Syntax
14 | duckdb,DuckDB
15 | snowflake,Snowflake
16 | synapse,Azure Synapse Analytics Dedicated
17 | iris,InterSystems IRIS
18 |
--------------------------------------------------------------------------------
/inst/doc/UsingSqlRender.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/OHDSI/SqlRender/97eb3b441bb98fa51676c54eca20b296fdcfbf21/inst/doc/UsingSqlRender.pdf
--------------------------------------------------------------------------------
/inst/java/SqlRender.jar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/OHDSI/SqlRender/97eb3b441bb98fa51676c54eca20b296fdcfbf21/inst/java/SqlRender.jar
--------------------------------------------------------------------------------
/inst/shinyApps/SqlDeveloper/SqlDeveloper.Rproj:
--------------------------------------------------------------------------------
1 | Version: 1.0
2 |
3 | RestoreWorkspace: Default
4 | SaveWorkspace: Default
5 | AlwaysSaveHistory: Default
6 |
7 | EnableCodeIndexing: Yes
8 | UseSpacesForTab: Yes
9 | NumSpacesForTab: 2
10 | Encoding: UTF-8
11 |
12 | RnwWeave: Sweave
13 | LaTeX: pdfLaTeX
14 |
--------------------------------------------------------------------------------
/inst/shinyApps/SqlDeveloper/server.R:
--------------------------------------------------------------------------------
1 | library(shiny)
2 | library(SqlRender)
3 |
4 | shinyServer(function(input, output, session) {
5 |
6 | # cache <- reactiveValues(target = '', clicks = 0, parameters = NULL)
7 |
8 | parameters <- reactive({
9 | params <- regmatches(input$source, gregexpr("@[a-zA-Z0-9_]+", input$source))[[1]]
10 | params <- unique(params)
11 | params <- params[order(params)]
12 | params <- substr(params, 2, nchar(params))
13 | return(params)
14 | })
15 |
16 | output$target <- renderText({
17 | parameterValues <- list()
18 | for (param in parameters()) {
19 | value <- input[[param]]
20 | if (!is.null(value)) {
21 | parameterValues[[param]] <- value
22 | }
23 | }
24 | sql <- do.call("render", append(input$source, parameterValues))
25 | warningString <- c()
26 | handleWarning <- function(e) {
27 | output$warnings <- e$message
28 | }
29 | tempEmulationSchema <- input$tempEmulationSchema
30 | if (tempEmulationSchema == "")
31 | tempEmulationSchema <- NULL
32 | sql <- withCallingHandlers(suppressWarnings(translate(sql,
33 | targetDialect = tolower(input$dialect),
34 | tempEmulationSchema = tempEmulationSchema)), warning = handleWarning)
35 | if (!is.null(warningString))
36 | output$warnings <- warningString
37 | return(sql)
38 | })
39 |
40 | output$parameterInputs <- renderUI({
41 | params <- parameters()
42 | sourceSql <- input$source
43 |
44 | createRow <- function(param, sourceSql) {
45 | # Get current values if already exists:
46 | value <- isolate(input[[param]])
47 |
48 | if (is.null(value)) {
49 | # Get default values:
50 | value <- regmatches(sourceSql,
51 | regexpr(paste0("\\{\\s*DEFAULT\\s*@", param, "\\s=[^}]+}"), sourceSql))
52 | if (length(value) == 1) {
53 | value <- sub(paste0("\\{\\s*DEFAULT\\s*@", param, "\\s=\\s*"), "", sub("\\}$", "", value))
54 | } else {
55 | value <- ""
56 | }
57 | }
58 | textInput(param, param, value = value)
59 | }
60 | lapply(params, createRow, sourceSql = sourceSql)
61 | })
62 |
63 | observeEvent(input$open, {
64 | sql <- SqlRender::readSql(input$open$datapath)
65 | updateTextAreaInput(session, "source", value = sql)
66 | })
67 |
68 | output$save <- downloadHandler(filename = function() {
69 | paste("query-", Sys.Date(), ".sql", sep = "")
70 | }, content = function(con) {
71 | SqlRender::writeSql(sql = input$source, targetFile = con)
72 | })
73 | })
74 |
75 |
--------------------------------------------------------------------------------
/inst/shinyApps/SqlDeveloper/ui.R:
--------------------------------------------------------------------------------
1 | library(shiny)
2 | library(shinydashboard)
3 | source("widgets.R")
4 |
5 | dashboardPage(
6 | dashboardHeader(title = "SqlRender Developer"),
7 | dashboardSidebar(
8 | sidebarMenu(
9 | menuItemFileInput("open", "Open file", icon = shiny::icon("folder-open")),
10 | menuItemDownloadLink("save", "Save", icon = shiny::icon("save")),
11 | menuItem("Open new tab", href = "", icon = shiny::icon("plus-square")),
12 | menuItemCopyTextAreaToClipboard("source", "Copy source to clipboard"),
13 | menuItemCopyDivToClipboard("target", "Copy target to clipboard")
14 | )
15 | ),
16 | dashboardBody(
17 | fluidRow(
18 | column(width = 9,
19 | box(
20 | title = "Source: OHDSI SQL", width = NULL, status = "primary",
21 | textAreaInput("source", NULL, width = "100%", height = "300px")
22 | ),
23 | box(
24 | title = "Target: Rendered translation", width = NULL,
25 | # tags$table(width = "100%",
26 | # tags$tr(
27 | # tags$td(align = "left", actionButton("renderTranslate", "Render and translate")),
28 | # tags$td(align = "right", checkboxInput("continuous", "Auto render and translate")))),
29 | pre(textOutput("target"))
30 | )
31 | ),
32 | column(width = 3,
33 | box(background = "light-blue",
34 | h4("Target dialect"), width = NULL,
35 | selectInput("dialect", NULL, choices = c("BigQuery", "Impala", "Netezza", "Oracle", "PDW", "PostgreSQL", "RedShift", "SQL Server", "SQLite", "Hive", "Spark", "Snowflake", "Synapse", "InterSystems IRIS" = "iris"), selected = "SQL Server"),
36 | h4("Temp emulation schema"),
37 | textInput("tempEmulationSchema", NULL),
38 | h4("Parameters"),
39 | uiOutput("parameterInputs"),
40 | textOutput("warnings")
41 | )
42 | )
43 | )
44 | )
45 | )
46 |
--------------------------------------------------------------------------------
/inst/shinyApps/SqlDeveloper/widgets.R:
--------------------------------------------------------------------------------
1 | menuItemFileInput <- function(inputId, text, icon = shiny::icon("file-text-o")) {
2 | script <- "document.getElementById('%id%').click(); return false;"
3 | script <- gsub("%id%", inputId, script)
4 | list(div(fileInput(inputId, ""), style = "display: none;"),
5 | tags$li(class = "treeview", a(href = "#", onclick = script, icon, text)))
6 | }
7 |
8 | menuItemDownloadLink <- function(inputId, label, icon = shiny::icon("floppy-o")) {
9 | tags$li(class = "treeview",
10 | tags$a(id = inputId,
11 | class = "shiny-download-link",
12 | href = "",
13 | target = "_blank",
14 | download = NA,
15 | icon,
16 | label))
17 | }
18 |
19 | menuItemCopyTextAreaToClipboard <- function(textAreaId, label, icon = shiny::icon("clipboard")) {
20 | script <- "
21 | element = $('
9 |
92 |
93 |
94 |
95 |
96 |
97 |
98 |
99 |
100 |
--------------------------------------------------------------------------------
/docs/reference/Rplot001.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/OHDSI/SqlRender/97eb3b441bb98fa51676c54eca20b296fdcfbf21/docs/reference/Rplot001.png
--------------------------------------------------------------------------------
/docs/reference/SqlRender.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
56 |
57 |
58 |
59 |
11 |
23 |
24 |
55 |
25 |
54 | -
45 |
46 |
47 |
- 48 | 49 | 50 | 51 | 52 | 53 |
60 |
80 |
81 |
82 |
83 |
61 |
74 |
75 |
78 |
79 |
62 |
64 |
65 |
66 | NA
63 |Before you do a pull request, you should always file an issue and make sure the package maintainer agrees that it’s a problem, and is happy with your basic proposal for fixing it. We don’t want you to spend a bunch of time on something that we don’t think is a good idea.
67 |Additional requirements for pull requests:
68 |Adhere to the Developer Guidelines as well as the OHDSI Code Style.
69 | If possible, add unit tests for new functionality you add.
70 | Restrict your pull request to solving the issue at hand. Do not try to ‘improve’ parts of the code that are not related to the issue. If you feel other parts of the code need better organization, create a separate issue for that.
71 | Make sure you pass R check without errors and warnings before submitting.
72 | Always target the
developbranch, and make sure you are up-to-date with the develop branch.
73 |
60 |
61 |
115 |
116 |
117 |
118 |
119 |
120 |
156 |
157 |
158 |
159 |
160 |
161 |
162 |
163 |
164 |
--------------------------------------------------------------------------------
/docs/reference/camelCaseToSnakeCase.html:
--------------------------------------------------------------------------------
1 |
2 |
121 |
143 |
144 |
145 |
155 |
122 |
127 |
128 |
136 |
142 |
129 |
131 |
132 |
133 |
134 |
135 | SqlRender
130 |
9 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
--------------------------------------------------------------------------------
/docs/reference/camelCaseToTitleCase.html:
--------------------------------------------------------------------------------
1 |
2 |
10 |
56 |
57 |
58 |
59 |
11 |
23 |
24 |
55 |
25 |
54 | -
45 |
46 |
47 |
- 48 | 49 | 50 | 51 | 52 | 53 |
60 |
100 |
101 |
102 |
61 |
96 |
99 |
62 |
65 |
66 |
67 | Convert a camel case string to snake case
63 | Source:R/HelperFunctions.R
64 | camelCaseToSnakeCase.Rd
68 |
70 |
71 | Convert a camel case string to snake case
69 |
72 |
73 |
74 |
75 |
83 | camelCaseToSnakeCase(string)
84 |
87 |
88 | Value
85 |A string
86 |
89 |
94 |
95 | Examples
90 |camelCaseToSnakeCase("exposureConceptId1")
91 | #> [1] "exposure_concept_id_1"
92 |
93 |
9 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
--------------------------------------------------------------------------------
/docs/reference/getTempTablePrefix.html:
--------------------------------------------------------------------------------
1 |
2 |
10 |
56 |
57 |
58 |
59 |
11 |
23 |
24 |
55 |
25 |
54 | -
45 |
46 |
47 |
- 48 | 49 | 50 | 51 | 52 | 53 |
60 |
100 |
101 |
102 |
61 |
96 |
99 |
62 |
65 |
66 |
67 | Convert a camel case string to title case
63 | Source:R/HelperFunctions.R
64 | camelCaseToTitleCase.Rd
68 |
70 |
71 | Convert a camel case string to title case
69 |
72 |
73 |
74 |
75 |
83 | camelCaseToTitleCase(string)
84 |
87 |
88 | Value
85 |A string
86 |
89 |
94 |
95 | Examples
90 |camelCaseToTitleCase("exposureConceptId1")
91 | #> [1] "Exposure Concept Id 1"
92 |
93 |
10 |
104 |
105 |
106 |
107 |
108 |
109 |
110 |
111 |
112 |
--------------------------------------------------------------------------------
/docs/reference/launchSqlRenderDeveloper.html:
--------------------------------------------------------------------------------
1 |
2 |
11 |
57 |
58 |
59 |
60 |
12 |
24 |
25 |
56 |
26 |
55 | -
46 |
47 |
48 |
- 49 | 50 | 51 | 52 | 53 | 54 |
61 |
93 |
94 |
95 |
62 |
89 |
92 |
63 |
66 |
67 |
68 | Get the prefix used for emulated temp tables for DBMSs that do not support temp tables (e.g. Oracle, BigQuery).
64 | Source:R/RenderSql.R
65 | getTempTablePrefix.Rd
69 |
72 |
73 | Get the prefix used for emulated temp tables for DBMSs that do not support temp tables (e.g. Oracle, 70 | BigQuery).
71 |
74 |
75 |
76 |
77 | getTempTablePrefix()
78 |
81 |
82 | Value
79 |The prefix string.
80 |
83 |
87 |
88 | Examples
84 |getTempTablePrefix()
85 | #> [1] "l3470uc6"
86 |
9 |
106 |
107 |
108 |
109 |
110 |
111 |
112 |
113 |
114 |
--------------------------------------------------------------------------------
/docs/reference/snakeCaseToCamelCase.html:
--------------------------------------------------------------------------------
1 |
2 |
10 |
56 |
57 |
58 |
59 |
11 |
23 |
24 |
55 |
25 |
54 | -
45 |
46 |
47 |
- 48 | 49 | 50 | 51 | 52 | 53 |
60 |
95 |
96 |
97 |
61 |
91 |
94 |
62 |
65 |
66 |
67 | Launch the SqlRender Developer Shiny app
63 | Source:R/ShinyApps.R
64 | launchSqlRenderDeveloper.Rd
68 |
70 |
71 | Launch the SqlRender Developer Shiny app
69 |
72 |
73 |
74 |
75 | launchSqlRenderDeveloper(launch.browser = TRUE)
76 |
84 | Arguments
77 | 78 | 79 |
85 |
89 |
90 | Details
86 |Launches a Shiny app that allows the user to develop SQL and see how it translates to the supported 87 | dialects.
88 |
9 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
119 |
--------------------------------------------------------------------------------
/docs/reference/sparkHandleInsert.html:
--------------------------------------------------------------------------------
1 |
2 |
10 |
56 |
57 |
58 |
59 |
11 |
23 |
24 |
55 |
25 |
54 | -
45 |
46 |
47 |
- 48 | 49 | 50 | 51 | 52 | 53 |
60 |
100 |
101 |
102 |
61 |
96 |
99 |
62 |
65 |
66 |
67 | Convert a snake case string to camel case
63 | Source:R/HelperFunctions.R
64 | snakeCaseToCamelCase.Rd
68 |
70 |
71 | Convert a snake case string to camel case
69 |
72 |
73 |
74 |
75 |
83 | snakeCaseToCamelCase(string)
84 |
87 |
88 | Value
85 |A string
86 |
89 |
94 |
95 | Examples
90 |snakeCaseToCamelCase("exposure_concept_id_1")
91 | #> [1] "exposureConceptId1"
92 |
93 |
10 |
110 |
111 |
112 |
113 |
114 |
115 |
116 |
117 |
118 |
--------------------------------------------------------------------------------
/docs/reference/supportsJava8.html:
--------------------------------------------------------------------------------
1 |
2 |
11 |
57 |
58 |
59 |
60 |
12 |
24 |
25 |
56 |
26 |
55 | -
46 |
47 |
48 |
- 49 | 50 | 51 | 52 | 53 | 54 |
61 |
99 |
100 |
101 |
62 |
67 |
68 |
95 |
98 |
69 |
72 |
73 | This function is for Spark connections only, 70 | it handles insert commands, as Spark cannot handle inserts with aliased or subset columns.
71 |
74 |
75 |
76 |
77 | sparkHandleInsert(sql, connection)
78 |
89 | Arguments
79 | 80 | 81 |
90 |
93 |
94 | Value
91 |A sql string with INSERT command modified to contain the full column list, padded with NULLS as needed.
92 |
9 |
102 |
103 |
104 |
105 |
106 |
107 |
108 |
109 |
110 |
--------------------------------------------------------------------------------
/docs/sitemap.xml:
--------------------------------------------------------------------------------
1 |
10 |
56 |
57 |
58 |
59 |
11 |
23 |
24 |
55 |
25 |
54 | -
45 |
46 |
47 |
- 48 | 49 | 50 | 51 | 52 | 53 |
60 |
91 |
92 |
93 |
61 |
87 |
90 |
62 |
65 |
66 |
67 | Determine if Java virtual machine supports Java
63 | Source:R/HelperFunctions.R
64 | supportsJava8.Rd
68 |
70 |
71 | Tests Java virtual machine (JVM) java.version system property to check if version >= 8.
69 |
72 |
73 |
74 |
75 | supportsJava8()
76 |
79 |
80 | Value
77 |Returns TRUE if JVM supports Java >= 8.
78 |
81 |
85 |
86 | Examples
82 |supportsJava8()
83 | #> [1] TRUE
84 |