Merge pull request #71 from Azure-Samples/sqlextension

Matt Usher · web-flow · commit f9dae0733e70 · 2020-12-15T14:05:15.000-08:00
Adding the FirstDayOf* functions to the toolkit
diff --git a/SQL/Extension/Readme.md b/SQL/Extension/Readme.md
@@ -29,8 +29,20 @@ The Azure Synapse SQL Extension will install a collection of vies to your Synaps
 .\deploy.bat demo.database.windows.net DemoDW cloudsa very_secure_password
 `
 
+### Clean up Example
+
+`
+.\clean.bat demo.database.windows.net DemoDW cloudsa very_secure_password
+`
 ## Version History
 
+### December 15, 2020
+What's new:
+- [Function]: The `microsoft.firstdayofmonth` script installs a function that returns the first day of the specified month as DATETIME2.
+- [Function]: The `microsoft.firstdayofquarter` script installs a function that returns the first day of the specified quarter as DATETIME2.
+- [Function]: The `microsoft.firstdayofyear` script installs a function that returns the first day of the specified year as DATETIME2.
+- [Schema]: Added the `dbc` schema to support the `dbc.databases` and `dbc.tables` views.
+
 ### December 7, 2020
 What's new:
 - [Function]: The `microsoft.random` script installs a function that emulates the `RANDOM(expression, expression)` Teradata function.
diff --git a/SQL/Extension/clean.bat b/SQL/Extension/clean.bat
@@ -0,0 +1,46 @@
+@ECHO off
+
+cls
+setlocal
+
+set _secure_password=**********
+
+ECHO.
+ECHO Azure Synapse SQL Extension toolkit v0.11.0.0 clean script
+
+IF NOT "%~4"=="" IF "%~5"=="" GOTO Deploy
+ECHO The deploy script requires the following parameters:
+ECHO - server name
+ECHO - database name
+ECHO - username
+ECHO - password
+ECHO.
+ECHO Examples:
+ECHO "%~nx0" demo.database.windows.net demodb user secure_password
+exit /b
+
+:Deploy
+SET _server=%~1
+SET _database=%~2
+SET _username=%~3
+SET _password=%~4
+
+ECHO.
+ECHO *****************************************************************************
+ECHO OPTIONS
+ECHO.
+ECHO Server:      %_server%
+ECHO Database:    %_database%
+ECHO Username:    %_username%
+ECHO Password:    %_secure_password%
+ECHO *****************************************************************************
+ECHO.
+
+
+ECHO Removing objects
+
+sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\clean.sql
+
+ECHO.
+ECHO Finished
+ECHO.
diff --git a/SQL/Extension/clean.sql b/SQL/Extension/clean.sql
@@ -0,0 +1,50 @@
+/*SELECT
+	'IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('''+ SCHEMA_NAME(schema_id) +''') AND name = N'''+ name +''') DROP ' + 
+	CASE type
+		WHEN 'FN' THEN 'FUNCTION'
+		WHEN 'V' THEN 'VIEW'
+	END + ' [' + SCHEMA_NAME(schema_id) + '].[' + name + '];'
+FROM
+	sys.objects
+ORDER BY
+	type,
+	schema_id,
+	name;
+	*/
+
+-- Functions
+PRINT 'Removing functions';
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'acosh') DROP FUNCTION [microsoft].[acosh];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'asinh') DROP FUNCTION [microsoft].[asinh];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'btrim') DROP FUNCTION [microsoft].[btrim];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'dayoccurrence_of_month') DROP FUNCTION [microsoft].[dayoccurrence_of_month];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'firstdayofmonth') DROP FUNCTION [microsoft].[firstdayofmonth];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'firstdayofquarter') DROP FUNCTION [microsoft].[firstdayofquarter];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'firstdayofyear') DROP FUNCTION [microsoft].[firstdayofyear];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'getbit') DROP FUNCTION [microsoft].[getbit];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'initcap') DROP FUNCTION [microsoft].[initcap];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'instr') DROP FUNCTION [microsoft].[instr];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'lpad') DROP FUNCTION [microsoft].[lpad];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'ltrim') DROP FUNCTION [microsoft].[ltrim];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'months_between') DROP FUNCTION [microsoft].[months_between];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'next_day') DROP FUNCTION [microsoft].[next_day];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'random') DROP FUNCTION [microsoft].[random];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'rpad') DROP FUNCTION [microsoft].[rpad];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'rtrim') DROP FUNCTION [microsoft].[rtrim];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'to_char') DROP FUNCTION [microsoft].[to_char];
+
+-- Views
+PRINT 'Removing views';
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'dw_active_queries') DROP VIEW [microsoft].[dw_active_queries];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'dw_active_queue') DROP VIEW [microsoft].[dw_active_queue];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'dw_configuration') DROP VIEW [microsoft].[dw_configuration];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'dw_extension_version') DROP VIEW [microsoft].[dw_extension_version];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'dw_statistics_information') DROP VIEW [microsoft].[dw_statistics_information];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('dbc') AND name = N'databases') DROP VIEW [dbc].[databases];
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('dbc') AND name = N'tables') DROP VIEW [dbc].[tables];
+
+-- Schemas
+PRINT 'Removing schemas';
+IF EXISTS(SELECT * FROM sys.schemas WHERE name = N'dbc') DROP SCHEMA [dbc];
+IF EXISTS(SELECT * FROM sys.schemas WHERE name = N'microsoft') DROP SCHEMA [microsoft];
+GO
diff --git a/SQL/Extension/deploy.bat b/SQL/Extension/deploy.bat
@@ -6,7 +6,7 @@ setlocal
 set _secure_password=**********
 
 ECHO.
-ECHO Azure Synapse SQL Extension toolkit v0.9.0.0 deployment script
+ECHO Azure Synapse SQL Extension toolkit v0.11.0.0 deployment script
 
 IF NOT "%~4"=="" IF "%~5"=="" GOTO Deploy
 ECHO The deploy script requires the following parameters:
@@ -17,7 +17,6 @@ ECHO - password
 ECHO.
 ECHO Examples:
 ECHO "%~nx0" demo.database.windows.net demodb user secure_password
-REM TIMEOUT -1 1>NUL
 exit /b
 
 :Deploy
@@ -40,16 +39,19 @@ ECHO.
 
 ECHO Deploying schemas
 
-REM Schema
+REM Schemas
+sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\schemas\dbc.sql
 sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\schemas\microsoft.sql
 
 ECHO Deploying functions
 
 REM Functions
 sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functions\microsoft.acosh.sql
 sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functions\microsoft.asinh.sql
-sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functions\microsoft.btrim.sql
 sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functions\microsoft.dayoccurrence_of_month.sql
+sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functions\microsoft.firstdayofmonth.sql
+sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functions\microsoft.firstdayofquarter.sql
+sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functions\microsoft.firstdayofyear.sql
 sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functions\microsoft.getbit.sql
 sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functions\microsoft.initcap.sql
 sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functions\microsoft.instr.sql
@@ -62,6 +64,9 @@ sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functio
 sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functions\microsoft.rtrim.sql
 sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functions\microsoft.to_char.sql
 
+REM Note: Dependent on microsoft.LTRIM and microsoft.RTRIM functions.
+sqlcmd -S %_server% -d %_database% -U %_username% -P %_password% -I -i .\functions\microsoft.btrim.sql
+
 ECHO Deploying views
 
 REM Views
diff --git a/SQL/Extension/functions/Readme.md b/SQL/Extension/functions/Readme.md
@@ -12,6 +12,18 @@ The `microsoft.btrim` script installs a function that emulates the `TRIM(BOTH 't
 ## microsoft.dayoccurrence_of_month
 The `microsoft.dayoccurrence_of_month` script installs a function that emulates the `DAYOCCURRENCE_OF_MONTH(expression)` Teradata function.
 
+## microsoft.firstdayofmonth
+The `microsoft.firstdayofmonth` script installs a function that returns the first day of the specified month as DATETIME2.
+
+## microsoft.firstdayofquarter
+The `microsoft.firstdayofquarter` script installs a function that returns the first day of the specified quarter as DATETIME2.
+
+## microsoft.firstdayofyear
+The `microsoft.firstdayofyear` script installs a function that returns the first day of the specified year as DATETIME2.
+
+## microsoft.firstdayofquarter
+The `microsoft.firstdayofquarter` script installs a function that returns the first day of the specified quarter as DATETIME2.
+
 ## microsoft.getbit
 The `microsoft.getbit` script installs a function that emulates the `TD_SYSFNLIB.GETBIT(argument, bit)` Teradata function.
 
diff --git a/SQL/Extension/functions/microsoft.firstdayofmonth.sql b/SQL/Extension/functions/microsoft.firstdayofmonth.sql
@@ -0,0 +1,13 @@
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'firstdayofmonth')
+    DROP FUNCTION microsoft.firstdayofmonth;
+GO
+
+CREATE FUNCTION microsoft.firstdayofmonth(@expression VARCHAR(8000))
+RETURNS DATETIME2
+WITH SCHEMABINDING
+AS
+BEGIN
+
+	RETURN DATEADD(DAY, 1, EOMONTH(@expression, -1))	
+END
+GO
diff --git a/SQL/Extension/functions/microsoft.firstdayofquarter.sql b/SQL/Extension/functions/microsoft.firstdayofquarter.sql
@@ -0,0 +1,13 @@
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'firstdayofquarter')
+    DROP FUNCTION microsoft.firstdayofquarter;
+GO
+
+CREATE FUNCTION microsoft.firstdayofquarter(@expression VARCHAR(8000))
+RETURNS DATETIME2
+WITH SCHEMABINDING
+AS
+BEGIN
+
+	RETURN DATEADD(QUARTER, DATEDIFF(QUARTER, 0, @expression), 0)
+END
+GO
diff --git a/SQL/Extension/functions/microsoft.firstdayofyear.sql b/SQL/Extension/functions/microsoft.firstdayofyear.sql
@@ -0,0 +1,13 @@
+IF EXISTS (SELECT * FROM sys.objects WHERE schema_id=SCHEMA_ID('microsoft') AND name = N'firstdayofyear')
+    DROP FUNCTION microsoft.firstdayofyear;
+GO
+
+CREATE FUNCTION microsoft.firstdayofyear(@expression VARCHAR(8000))
+RETURNS DATETIME2
+WITH SCHEMABINDING
+AS
+BEGIN
+
+	RETURN DATEADD(YEAR, DATEDIFF(YEAR, 0, @expression), 0)
+END
+GO
