SASPAC/sqlinds
1
0
Fork 0
mirror of https://github.com/SASPAC/sqlinds.git synced 2025-12-11 02:14:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

The SQLinDS package [ver. 2.3.1]

Browse Source 
The SQLinDS package [ver. 2.3.1]

Package regenerated with SAS Packages Framework, version 20251122. No functional changes, documentation cleaned up.
This commit is contained in:
Bart Jablonski
2025-11-22 13:18:59 +01:00
parent bb1cd6cdc3
commit 64e0daa157
5 changed files with 393 additions and 61 deletions
Download Patch File Download Diff File Expand all files Collapse all files

191
sqlinds.md
View File

@@ -1,14 +1,30 @@
- [The SQLinDS package](#sqlinds-package)
- [Content description](#content-description)
* [library `dsSQL`](#library-dssql)
* [`%dsSQL_inner()` macro](#dssql-inner-macro)
* [`%SQL()` macro](#dssql-inner-macro)
* [`dsSQL()` function](#dssql-function)
* [License](#license)
# Documentation for the `SQLinDS` package.
----------------------------------------------------------------
*SQL queries in Data Step*
----------------------------------------------------------------
### Version information:
- Package: SQLinDS
- Version: 2.3.1
- Generated: 2025-11-22T12:47:32
- Author(s): Mike Rhoads (RhoadsM1@Westat.com), contributor Bartosz Jablonski
- Maintainer(s): Bartosz Jablonski (yabwon@gmail.com)
- License: MIT
- File SHA256: `F*606A24A2A6B06DAAD2D443FA9A9819D9564235A5CD8599FD15586F1EFFCB41BC` for this version
- Content SHA256: `C*4CCCF31DA9D94E0EE2DA612724D395056B7BA07CB593C93947835BB8319B33EB` for this version
---
# The `SQLinDS` package, version: `2.3.1`;
---
# The SQLinDS package [ver. 2.3.0] <a name="sqlinds-package"></a> ###############################################
### The SQLinDS package [ver. 2.3.1]
The **SQLinDS** package is an implementation of
the *macro-function-sandwich* concept introduced in the
@@ -20,13 +36,13 @@ The article is available at:
Copy of the article can also be found in *additional content* directory.
Package provides ability to *execute* SQL queries inside a data step, e.g.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
data class;
set %SQL(select * from sashelp.class);
set %SQL(select name, age from sashelp.class);
run;
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
See the help for the `%SQL()` macro to find more examples.
### Content ###################################################################
@@ -41,67 +57,96 @@ SQLinDS package contains the following components:
---
Package contains:
1. libname dssql
2. macro dssql_inner
3. macro sql
4. function dssql
5. kmfsnip sqlinds
Required SAS Components:
*Base SAS Software*
Package contains additional content, run: %loadPackageAddCnt(SQLinDS) to load it
or look for the sqlinds_AdditionalContent directory in the Packages fileref
localization (only if additional content was deployed during the installation process).
*SAS package generated by generatePackage, version 20231111*
The SHA256 hash digest for package SQLinDS:
`F*3C010734B76CA7459C4D35087C899121011CD4AA2932B56335FF11A805C8EF8D`
---
# Content description ############################################################################################
## >>> library `dsSQL`: <<< <a name="library-dssql"></a> ########################
---
Required SAS Components:
- Base SAS Software
---
---
Package contains additional content, run: `%loadPackageAddCnt(SQLinDS)` to load it
or look for the `sqlinds_AdditionalContent` directory in the `packages` fileref
localization (only if additional content was deployed during the installation process).
---------------------------------------------------------------------
*SAS package generated by SAS Package Framework, version `20251122`,*
*under `WIN`(`X64_10PRO`) operating system,*
*using SAS release: `9.04.01M9P06042025`.*
---------------------------------------------------------------------
# The `SQLinDS` package content
The `SQLinDS` package consists of the following content:
1. [`dssql` libname ](#dssql-libname-1 )
2. [`%dssql_inner()` macro ](#dssqlinner-macro-2 )
3. [`%sql()` macro ](#sql-macro-3 )
4. [`dssql()` function ](#dssql-function-4 )
5. [`sqlinds` kmfsnip ](#sqlinds-kmfsnip-5 )
6. [License note](#license)
---
## `dssql` libname <a name="dssql-libname-1"></a> ######
The `dsSQL` library stores temporary views
generated during the `%SQL()` macro execution.
If possible a subdirectory of the `WORK` location is created, like:
If possible a sub-directory of the `WORK` location is created, like:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
LIBNAME dsSQL BASE "%sysfunc(pathname(WORK))/dsSQLtmp";
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
if not possible, then redirects to the `WORK` location, like:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
LIBNAME dsSQL BASE "%sysfunc(pathname(WORK))";
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
---
---
## `%dssql_inner()` macro <a name="dssqlinner-macro-2"></a> ######
The `%dsSQL_Inner()` macro is an **internal**
macro called by `dsSQL()` function.
## >>> `%dsSQL_Inner()` macro: <<< <a name="dssql-inner-macro"></a> #############
**Internal** macro called by `dsSQL()` function.
The macro generates a uniquely named SQL view on the fly
which is then stored in the `dsSQL` library.
The `%dsSQL_Inner()` is *not* designed to be
called on its own.
Recommended for *SAS 9.3* and higher.
---
## >>> `%SQL()` macro: <<< <a name="dssql-macro"></a> ###########################
The **main** macro which allows to use
SQL queries in the data step.
---
## `%sql()` macro <a name="sql-macro-3"></a> ######
The `%SQL()` macro is the **main**
macro in the package. The macro allows
to use SQL queries in the data step.
Recommended for *SAS 9.3* and higher.
Based on the article *"Use the Full Power of SAS in Your Function-Style Macros"*
Implementation is based on the article:
*"Use the Full Power of SAS in Your Function-Style Macros"*
by *Mike Rhoads* (Westat, Rockville), available at:
[https://support.sas.com/resources/papers/proceedings12/004-2012.pdf](https://support.sas.com/resources/papers/proceedings12/004-2012.pdf)
@@ -109,10 +154,10 @@ Copy of the article can also be found in *additional content* directory.
### SYNTAX: ###################################################################
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
%sql(<nonempty sql querry code>)
%sql(<nonempty Proc SQL query code>)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The sql query code is limited to *32000* bytes.
The THE query code is limited to approximately *32000* bytes.
### EXAMPLES: #################################################################
@@ -126,26 +171,34 @@ run;
**EXAMPLE 2**: query with dataset options
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
data renamed;
set %SQL(select * from sashelp.class where sex = "F")(rename = (age=age2));
set %SQL(select name, age from sashelp.class
where sex = "F")(rename = (age=age2)
);
run;
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
**EXAMPLE 3**: dictionaries in the data step
**EXAMPLE 3**: Proc SQL dictionaries in the data step
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
data dictionary;
set %SQL(select * from dictionary.macros);
set %SQL(select dict.* from dictionary.macros as dict);
run;
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
---
---
## >>> `dsSQL()` function: <<< <a name="dssql-function"></a> ####################
## `dssql()` function <a name="dssql-function-4"></a> ######
The `dsSQL()` function is an **internal**
function called by the `%SQL()` macro.
**Internal** function called by the `%SQL()` macro.
The function pass a query code from the `%SQL()`
The function pass a query code from the `%SQL()`
macro to the `%dsSQL_Inner()` internal macro.
The `dsSQL()` is *not* designed to be
called on its own.
Recommended for *SAS 9.3* and higher.
### SYNTAX: ###################################################################
@@ -161,8 +214,27 @@ dsSQL(unique_index_2, query)
---
## License ####################################################################
---
## `sqlinds` kmfsnip <a name="sqlinds-kmfsnip-5"></a> ######
This is a help note for `sqlinds` KMF-abbreviation.
The snippet presents a template
for use of the `%SQL()` macro.
To read help info about the macro
run he following:
`%helpPackage(SQLinDS,'%sql()')`
---
---
# License <a name="license"></a> ######
Copyright (c) 2012 Mike Rhoads
Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -182,5 +254,6 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
---