The Bit Bucket - Page 2 of 124 - Thoughts from Data Platform MVP and Microsoft RD

SDU Tools: Weekday Across Years in SQL Server T-SQL

Another request that I received a while back, for a new function to our free SDU Tools for developers and DBAs, was to be able to find the day of the week, for the same day and month, over a range of years. A simple example would be to find what day Christmas will be each year for the next ten years. So we've added a new function WeekdayAcrossYears.

It takes four parameters:

@DayNumber int – day number in the target month
@MonthNumber int – target month number
@FromYear int – starting year
@ToYear int – ending year

The function returns a rowset with YearNumber and WeekDay (in English).

Find out more

You can see it in action in the main image above, and in the video here. The full current version of the code is also shown below:

You can use our tools as a set or as a great example of how to write functions like these.

Access to SDU Tools is one of the benefits of being an SDU Insider, along with access to our other free tools and eBooks. Please just visit here for more info:

http://sdutools.sqldownunder.com

Latest version of the code

Note: the code might wrap when displayed below.

CREATE OR ALTER FUNCTION SDU_Tools.WeekdayAcrossYears
(
    @DayNumber int,
    @MonthNumber int,
    @FromYear int,
    @ToYear int
)
RETURNS TABLE
AS
-- Function:      Returns a table of days of the week for a given day 
--                over a set of years
-- Parameters:    @DayNumber => day number of the target month
--                @MonthNumber => target month number
--                @FromYear => starting year number
--                @ToYear => ending year number
-- Action:        For a particular day and month, returns the day of 
--                the week for a range of years
-- Return:        Rowset with YearNumber as an integer, and WeekDay 
--                as a string
-- Refer to this video: https://youtu.be/k4wY1isY1G0
--
-- Test examples: 
/*

SELECT * FROM SDU_Tools.WeekdayAcrossYears(20, 11, 2021, 2030);

*/
RETURN 
(
    WITH Years
    AS
    (
        SELECT TOP(@ToYear - @FromYear + 1) 
               ROW_NUMBER() OVER(ORDER BY (SELECT 1)) + @FromYear - 1 
               AS YearNumber 
        FROM sys.all_columns AS ac1
        CROSS JOIN sys.all_columns AS ac2
    )   
    SELECT YearNumber,
           DATENAME
           (
               weekday, 
               DATEFROMPARTS(YearNumber, @MonthNumber, @DayNumber)
           ) AS [WeekDay]
    FROM Years
);
GO

CREATE OR ALTER FUNCTION SDU_Tools.WeekdayAcrossYears

(

@DayNumber int,

@MonthNumber int,

@FromYear int,

@ToYear int

)

RETURNS TABLE

-- Function: Returns a table of days of the week for a given day

-- over a set of years

-- Parameters: @DayNumber => day number of the target month

-- @MonthNumber => target month number

-- @FromYear => starting year number

-- @ToYear => ending year number

-- Action: For a particular day and month, returns the day of

-- the week for a range of years

-- Return: Rowset with YearNumber as an integer, and WeekDay

-- as a string

-- Refer to this video: https://youtu.be/k4wY1isY1G0

-- Test examples:

SELECT * FROM SDU_Tools.WeekdayAcrossYears(20, 11, 2021, 2030);

RETURN

(

WITH Years

(

SELECT TOP(@ToYear - @FromYear + 1)

ROW_NUMBER() OVER(ORDER BY (SELECT 1)) + @FromYear - 1

AS YearNumber

FROM sys.all_columns AS ac1

CROSS JOIN sys.all_columns AS ac2

)

SELECT YearNumber,

DATENAME

(

weekday,

DATEFROMPARTS(YearNumber, @MonthNumber, @DayNumber)

) AS [WeekDay]

FROM Years

);

SQL Interview: #12: Using UNION vs UNION ALL

This is a post in the SQL Interview series. These aren't trick or gotcha questions, they're just questions designed to scope out a candidate's knowledge around SQL Server and Azure SQL Database.

Section: Development
Level: Intro

Question:

Consider the following code:

SELECT CustomerID, CustomerName 
FROM Sales.Customers
WHERE BusinessCategory = 'Cafe'

UNION

SELECT CustomerID, CustomerName
FROM Sales.Customers
WHERE City = 'Toronto';

SELECT CustomerID, CustomerName

FROM Sales.Customers

WHERE BusinessCategory = 'Cafe'

UNION

SELECT CustomerID, CustomerName

FROM Sales.Customers

WHERE City = 'Toronto';

A: What would be the difference in results if the query was changed to use a UNION ALL instead of the UNION?

B: What are the performance differences between using a UNION ALL and a UNION in a SELECT statement?

C: How could this query be rewritten without the UNION?

Answer:

A: If the query was changed to use UNION ALL, a customer might be returned more than once. A UNION performs a DISTINCT operation on the results of the query. A UNION ALL does not perform the DISTINCT operation on the results.

B: A UNION invariably involves more work and is slower as it needs to perform a DISTINCT operation on the results.

C: One option would be to rewrite it as follows:

SELECT CustomerID, CustomerName 
FROM Sales.Customers 
WHERE BusinessCategory = 'Cafe' 
OR City = 'Toronto';

SELECT CustomerID, CustomerName

FROM Sales.Customers

WHERE BusinessCategory = 'Cafe'

OR City = 'Toronto';

SQL Interview: #11 Adding a column in the middle of a table's columns

This is a post in the SQL Interview series. These aren't trick or gotcha questions, they're just questions designed to scope out a candidate's knowledge around SQL Server and Azure SQL Database.

Section: Development
Level: Medium

Question:

When you add a column to an existing SQL Server table, the column is added to the end of the table. The column will end up with the highest column_id.

If a developer asks you how a column can be added to the middle of a table instead, what is your advice and how would you approach the request?

Answer:

The first part of the advice is that ideally you won't care what order the columns are in your table. However, I completely understand that a developer might like to see columns grouped appropriately in a list of columns for a table, rather than just a random list of columns.

Unfortunately, SQL Server does not have an option like MySQL (for example), where you can add "AFTER", "FIRST", or "LAST" when defining columns.

With SQL Server, the general approach is to:

Copy the data out to a temporary table
Drop any foreign key constraints that reference the table
Drop and recreate the table with the desired order
Copy the data back in from the temporary table
Recreate any foreign key constraints that reference the table
Drop the temporary table

SQL: Try the new Cascadia Code as a font in SSMS

The good news is that Visual Studio 2022 has been announced, and if you haven't read the announcements, the big deal is that it's finally a 64 bit tool. You can still build 32 bit apps with it, but the tool is now 64 bit. I hope SQL Server Management Server (SSMS) will also follow it to 64 bit but that's not likely to be known as yet.

However, one interesting part of the announcement is a new font designed to be used for development. It's called Cascadia Code. And even though Visual Studio 2022 isn't available yet, the font is. I've been trying it in SSMS and quite like it. Previously I was using Consolas.

Installing Cascadia Code

It's easy to install. Here are the steps:

Download the latest release from here: https://github.com/microsoft/cascadia-code/releases
Unzip the downloaded file and from the ttf folder (presuming you're running Windows), copy the files CascadiaCode.ttf, CascadiaCodePL.ttf, CascadiaMono.ttf, and CascadiaMonoPL.ttf.
Right click each one and click Install for all users.

Using Cascadia Code in SSMS

Using the fonts in SSMS is easy. From the Tools menu, click Options.

From the Environment section, click Fonts and Colors.

Now the fonts will be available in the drop-down list for Font.

You'll then see a list similar to what's in the main image above. Note that fonts that are shown bold are fonts with fixed spacing (i.e. not proportional fonts), and that's usually what I want when doing development.

T-SQL 101: #95 Choosing options with CASE in T-SQL

You often need to choose from many outcomes, based upon a specific value. You might want to say if the value is 3 then choose Red, but if the value is 4 then choose Blue, and if the value is 5, then choose Green, etc. The way that you apply this type of logic in T-SQL is by using the CASE statement.

There are several ways you can write CASE statements. In the main image above, I have said that if the value is greater than or equal to 25, then say "Large". If the value was between 20 and 24, then "Medium". Otherwise (for all other values), choose "Small".

The output is as follows:

It's important to understand that the CASE statement checks each condition, before moving to the next condition, and the conditions do not have to be based on the same value. For example, I could say:

CASE WHEN OuterQuantity >= 25 THEN 'Large'
     WHEN Size = '370ml' THEN 'Can'

1 2	CASE WHEN OuterQuantity >= 25 THEN 'Large' WHEN Size = '370ml' THEN 'Can'

The CASE statement stops checking once a condition has been satisfied. In the example above, even if the Size is 370ml, that will not be checked if the OuterQuantity was at or above 25.

Alternate Structure

Another format for CASE can be used when a single value is being checked:

CASE Size WHEN '370ml' THEN 'Standard Can'
          WHEN '740ml' THEN 'Large Bottle'
          WHEN '180ml' THEN 'Small Can'
          ELSE 'Unknown'
END

CASE Size WHEN '370ml' THEN 'Standard Can'

WHEN '740ml' THEN 'Large Bottle'

WHEN '180ml' THEN 'Small Can'

ELSE 'Unknown'

END

That only works for a simple list of values.

ELSE

You will notice in the example above that an ELSE clause was provided. This says "if none of the conditions above applies, then choose this".

The ELSE clause is optional. If you do not have an ELSE clause, and none of the conditions apply, the return value will be NULL.

SQL Clauses

The most common use of CASE statements is in SELECT clauses but it's important to understand that it can be used in many other places in queries. WHERE clauses commonly use CASE, even ORDER BY can use CASE.

Learning T-SQL

It's worth your while becoming proficient in SQL. If you'd like to learn a lot about T-SQL in a hurry, our Writing T-SQL Queries for SQL Server course is online, on-demand, and low cost.

SQL Day 2021 is on, and I'd love to see you in my Power BI pre-con

One of my favourite conferences each year is SQL Day. It's run by an enthusiastic group from Poland, and when I've attended in person, I loved it. This year it's virtual, and the upside of that, is you can attend from anywhere.

As part of the conference, I'm running a pre-con workshop. It's a low cost one day course on How I Implement Power BI in Enterprises. You'll find info on it here. The course is running on Poland time, but it looks to me like the times will suit a pretty wide variety of people, including from here in Australia.

More info here:

I'd love to see you there.

SQL Interview: #10 System-defined default names

This is a post in the SQL Interview series. These aren't trick or gotcha questions, they're just questions designed to scope out a candidate's knowledge around SQL Server and Azure SQL Database.

Section: Development
Level: Medium

Question:

When you define a column default with code like below:

USE tempdb;
GO

DROP TABLE IF EXISTS dbo.Customers;
GO

CREATE TABLE dbo.Customers
(
    CustomerID int IDENTITY(1,1)
        CONSTRAINT PK_dbo_Customers PRIMARY KEY,
    TradingName nvarchar(100) NOT NULL,
    CreatedDate datetime2(3) NOT NULL DEFAULT (SYSDATETIME())
);
GO

USE tempdb;

DROP TABLE IF EXISTS dbo.Customers;

CREATE TABLE dbo.Customers

(

CustomerID int IDENTITY(1,1)

CONSTRAINT PK_dbo_Customers PRIMARY KEY,

TradingName nvarchar(100) NOT NULL,

CreatedDate datetime2(3) NOT NULL DEFAULT (SYSDATETIME())

);

the system will define the name of the default. Can you give examples of why specifying the name of the default instead of letting the system supply it would be a good practice?

Answer:

There are several reasons. Here are three:

If you ever need to change the default value, you will need to know the name of the default constraint to be able to remove it, before you add a new default. This is much easier if you already know the name of the default.

If you ever need to drop the column, in SQL Server, you must first drop any default on the column. Again, that is much easier if you already know the name of the default. (Note that other database engines like PostgreSQL do not allow you to name defaults, but they also automatically drop them when dropping columns).

If you have created the table in multiple databases and you are using database comparison tools to check for differences, having consistent names in the script avoids the potential detection of a difference. (Note that some comparison tools can ignore system names like these).

SDU Tools version 21 is now released for download

Version 21 of our free SDU Tools for developers and DBAs is now released and winging their way out to our SDU Insiders.

You can find details on the tools here.

If you haven't been using SDU Tools yet, I'd suggest downloading them and taking a look. At the very least, it can help when you're trying to work out how to code something in T-SQL.

Along with the normal updates to SQL Server versions and builds, we've added the following new functions:

CreateAnalyticView – this new tool helps to support automating the scripting of analytic views based upon existing data warehouse tables. It will be particularly of use to anyone following our methods in the Implementing Power BI in the Enterprise workshops or upcoming book.

WeekdayAcrossYears – this one was requested by Dave Dustin. It's a new function that returns the day name for a given day and month number for a range of years. (For example, which day of the week will my birthday be for the next ten years?)

SQLServerType – this new function returns the type of server that you are attached to. For example, it can help you to know if you are connected to a SQL Server database or an Azure SQL Database or an Azure SQL Managed Instance.

The following tools have been upgraded:

SplitDelimitedString – this tool now uses a much faster method. It works the same, just much faster.

ListUseOfDeprecatedDataTypes – this procedure has been updated and provides an additional output column that gives you an example of the T-SQL script that you might need to execute to correct the inappropriate data type. (Thanks to Michael Miller for the suggestion)

GREATER and LEAST have been added to the list of reserved words.

The list of exceptions in the ProperCase function has been expanded. (Thanks to John Reitter for the suggestions)

And of course, there are a few corrections included as well.

StartOfFinancialYear – we fixed a scenario where the wrong year could be returned.

ChineseYears – we fixed a typo in the year of the goat (Thanks again to Dave Dustin)

UnixTimeToDateTime2 and DateTime2ToUnixTime – now use bigint values to ensure they'll avoid the Unix 2038 problem. (Thanks to Bob Roberts for this one)

Scripting functions that output column lengths for nchar and nvarchar were corrected.

Check out all the available functions, procedures, and views here.

SQL Interview: #9: Computed columns in table definitions

This is a post in the SQL Interview series. These aren't trick or gotcha questions, they're just questions designed to scope out a candidate's knowledge around SQL Server and Azure SQL Database.

Section: Development
Level: Medium

Question:

Consider the following code:

USE tempdb;
GO

DROP TABLE IF EXISTS dbo.Customers;
GO

CREATE TABLE dbo.Customers
(
    CustomerID int IDENTITY(1,1)
        CONSTRAINT PK_dbo_Customers PRIMARY KEY,
    TradingName nvarchar(100) NOT NULL,
    CreatedDate AS SYSDATETIME()
);
GO

INSERT dbo.Customers (TradingName)
VALUES (N'Customer A');
GO

SELECT * FROM dbo.Customers;
GO
SELECT * FROM dbo.Customers;
GO

USE tempdb;

DROP TABLE IF EXISTS dbo.Customers;

CREATE TABLE dbo.Customers

(

CustomerID int IDENTITY(1,1)

CONSTRAINT PK_dbo_Customers PRIMARY KEY,

TradingName nvarchar(100) NOT NULL,

CreatedDate AS SYSDATETIME()

);

INSERT dbo.Customers (TradingName)

VALUES (N'Customer A');

SELECT * FROM dbo.Customers;

Will the CreatedDate column return the same value in both SELECT statements?

Answer:

When you define a computed column, the value is calculated when it is SELECTed. In this case, the two SELECT operations will occur at different times, and different values will be returned for that column.

It is possible with some computed columns to add the term PERSISTED. In that case, the value is calculated at INSERT or UPDATE but is then stored. The same value would be returned every time it is SELECTed.

However, in this case, you cannot apply PERSISTED to the computed column, as the expression SYSDATETIME() is not deterministic.

T-SQL 101: #94 Returning messages to the client by using PRINT and RAISERROR in T-SQL

There are times when you're writing in any programming language, that you want to output messages back to the client. In T-SQL, the statement provided for that is the PRINT statement.

PRINT is simple enough to use. You give it a string to return and it prints that string.

It's different to the SELECT statement, because the SELECT statement returns a rowset (i.e. a set of rows).

In the main image above, you can see a script with both a PRINT and a SELECT. When that script is executed, two things happen. The output of the SELECT statement is returned in the Results tab in SQL Server Management Studio as below:

But notice that the PRINT output isn't there. Instead, it's returned in the Messages tab as below:

Using RAISERROR instead of PRINT

PRINT is actually a specific instance of the RAISERROR statement. Instead of using PRINT, you could use RAISERROR like this:

Notice that the output is identical. The first parameter to RAISERROR is the message, the second is the severity, and the third is the state. In this case, any severity from 1 to 10 would have worked. You can just make the state be 1 and ignore it until we discuss RAISERROR in much more detail later.

RAISERROR and NOWAIT

So why would you ever use RAISERROR instead of PRINT? After all, PRINT is simpler.

The answer is related to when the messages are returned. For example, if you put PRINT statements in a stored procedure, it's only after the stored procedure completes that you'll see the output.

If however, you use the NOWAIT option in RAISERROR, the messages come back immediately.

This can be very useful when you are debugging code.

Learning T-SQL

It's worth your while becoming proficient in SQL. If you'd like to learn a lot about T-SQL in a hurry, our Writing T-SQL Queries for SQL Server course is online, on-demand, and low cost.