Skip to main content

Functions - SQL Server

 Functions

In SQL Server, a function is a pre-written piece of code that performs a specific task and returns a value. Functions can be used to encapsulate complex calculations, to improve performance by reducing network traffic, and to enforce security by restricting direct access to database tables.

There are two types of functions in SQL Server:

1.     Scalar Functions: These functions return a single value based on input parameters. Examples include LEN, which returns the length of a string, and SUM, which returns the sum of a set of values.

2.     Table-Valued Functions: These functions return a table or a set of rows based on input parameters. Examples include fnSplit, which splits a string into rows based on a delimiter, and fnGetSalesByMonth, which returns sales data grouped by month.

To create a function in SQL Server, you can use the CREATE FUNCTION statement. Here's an example of creating a scalar function:

CREATE FUNCTION GetTotalOrders

(

    @CustomerID int

)

RETURNS int

AS

BEGIN

    DECLARE @TotalOrders int;

    SELECT @TotalOrders = COUNT(*) FROM Orders WHERE CustomerID = @CustomerID;

    RETURN @TotalOrders;

END

In this example, we're creating a scalar function called GetTotalOrders that takes an input parameter called @CustomerID and returns an integer value. The function uses a SELECT statement to count the number of orders for the specified customer ID and stores the result in a variable called @TotalOrders. Finally, the function returns the value of @TotalOrders.

Here's an example of creating a table-valued function:

CREATE FUNCTION fnGetSalesByMonth

(

    @Year int

)

RETURNS TABLE

AS

RETURN

(

    SELECT MONTH(OrderDate) AS Month, SUM(TotalAmount) AS TotalSales

    FROM Orders

    WHERE YEAR(OrderDate) = @Year

    GROUP BY MONTH(OrderDate)

)

 

In this example, we're creating a table-valued function called fnGetSalesByMonth that takes an input parameter called @Year and returns a table with two columns: Month and TotalSales. The function uses a SELECT statement to retrieve sales data for the specified year, grouping the data by month and calculating the total sales for each month.

Once you've created the function, you can call it like any other function. For example:

SELECT dbo.GetTotalOrders(12345);

 In this example, we're calling the GetTotalOrders function with an input parameter of 12345. The function will return the total number of orders for the

specified customer ID.

Reference :

            https://learn.microsoft.com/en-us/sql/t-sql/statements/create-function-transact-sql?view=sql-server-ver16

Comments

Popular posts from this blog

SFTP Integration in SSIS package Using WinSCP DLL

  In this blog, I am planning to write about SSIS SFTP Task details and reference sites, upload and download the files from SFTP server using SSIS package with help of the winscp library. Steps to configure the winscp DLL and Download Files 1.        Please download the DLL and required files from below path https://winscp.net/eng/downloads.php#additional 2.        Once Downloaded, use the below comments to add in Local GAC "Path to the gacutil exe \gacutil.exe" /i WinSCPnet.dll 3.        Please use the below URL as guide to implement the SSIS script task to download the files from SFTP using winscp as library https://winscp.net/eng/docs/library_ssis 4.        I am just briefing the steps based on the above URL what we can try in SSIS package. 5.        Please create the below variables in SSIS package which we need ...

Data type precedence - SQL Server

       In SQL Server, data type precedence determines which data type takes precedence over others when two or more data types are combined or compared. It is important to understand data type precedence to ensure that the correct data type is used and that data is not lost or truncated during operations. In this blog, we will discuss data type precedence in SQL Server with examples. Data type precedence levels SQL Server has 16 data type precedence levels, with the highest level being 1 and the lowest level being 16. The data type with the lowest precedence is considered to be the "weakest" data type and is most likely to be converted to a higher precedence data type during operations. Here is the list of data types in SQL Server, ordered by their precedence levels: user-defined data types (highest precedence) sql_variant xml datetimeoffset datetime2 datetime smalldatetime date time float real decimal/numeric money/smallmoney bigint/i...

Exception Handling RAISEERROR, TRY- CATCH

Exception handling is an essential aspect of any programming language, including T-SQL, the language used in Microsoft SQL Server. In this blog, we will discuss the basics of exception handling in T-SQL, including how to raise and catch exceptions, and best practices for handling errors in SQL Server. What is an Exception in T-SQL? An exception is an error condition that occurs during the execution of a T-SQL statement. When an exception occurs, the SQL Server engine raises an error message that provides details about the error, including the error number, severity, and message text. These error messages can be viewed in the SQL Server error log, or they can be returned to the client application that issued the T-SQL statement. How to Raise an Exception in T-SQL In T-SQL, you can raise an exception by using the RAISERROR statement. The RAISERROR statement allows you to specify an error message, error number, severity level, and state. For example, the following code raises an e...