Creating JobSchedule Failed on Azure SQL Managed Instance

Introduction

Azure SQL Managed Instance (MI) is a powerful cloud-based database service that provides near-complete compatibility with SQL Server, along with the benefits of a managed platform. However, while working with SQL Managed Instances, you may occasionally encounter errors due to differences between on-premises SQL Server and Azure SQL environments.

In this blog post, we’ll explore a specific error encountered when attempting to create a JobSchedule in SQL Server Management Studio (SSMS) on an Azure SQL Managed Instance. We’ll break down the error, identify the root cause, and guide you through the steps to resolve it. Additionally, we’ll discuss important lessons learned to prevent similar issues in the future.

Issue

When trying to create a new JobSchedule named ‘DBA – Database Copy Only backup’ in SSMS on an Azure SQL Managed Instance, the following error message was encountered:

TITLE: Microsoft SQL Server Management Studio

Create failed for JobSchedule ‘DBA – Database Copy Only backup’. (Microsoft.SqlServer.Smo)

For help, click: http://go.microsoft.com/fwlink?ProdName=Microsoft+SQL+Server&ProdVer=14.0.17289.0+((SSMS_Rel_17_4).181117-0805)&EvtSrc=Microsoft.SqlServer.Management.Smo.ExceptionTemplates.FailedOperationExceptionText&EvtID=Create+JobSchedule&LinkId=20476


ADDITIONAL INFORMATION:

An exception occurred while executing a Transact-SQL statement or batch. (Microsoft.SqlServer.ConnectionInfo)


SQL Server Agent feature Schedule job ONIDLE is not supported in SQL Database Managed Instance. Review the documentation for supported options. (Microsoft SQL Server, Error: 41914)

For help, click: http://go.microsoft.com/fwlink?ProdName=Microsoft%20SQL%20Server&ProdVer=12.00.2000&EvtSrc=MSSQLServer&EvtID=41914&LinkId=20476


BUTTONS:
OK

Understanding the Error:

The error message indicates that the JobSchedule creation failed because the ONIDLE scheduling feature is not supported in Azure SQL Managed Instances.

Key points from the error message:

  • The failure occurred during the execution of a Transact-SQL statement.
  • The ONIDLE feature, which may be supported in on-premises SQL Server instances, is not available in Azure SQL Managed Instances.
  • The version of SSMS used might not be fully compatible with Azure SQL Managed Instance features.

Possible Causes:

  1. Outdated SSMS Version: Using an older version of SSMS that lacks the necessary updates for working with Azure SQL Managed Instances.
  2. Unsupported Feature Usage: Attempting to use a scheduling feature (ONIDLE) that isn’t supported in the Azure SQL environment.
  3. Compatibility Issues: Mismatch between the SSMS client version and the Azure SQL Managed Instance, leading to unsupported operations.

Resolution

To resolve this issue, the primary solution is to update SSMS to the latest version. This ensures compatibility with Azure SQL Managed Instance and the supported feature set.

Step-by-Step Guide to Resolve the Issue:

Step 1: Verify Current SSMS Version

Before updating, check the current version of SSMS installed.

How to Check:

  1. Open SSMS.
  2. Click on “Help” in the top menu.
  3. Select “About”.
  4. Note the version number displayed.

Step 2: Download the Latest SSMS Version

Download the latest version of SSMS from the official Microsoft link.

Download Link: Download SQL Server Management Studio (SSMS)

Instructions:

  1. Click on the above link or paste it into your web browser.
  2. The download should start automatically. If not, click on the provided download button on the page.
  3. Save the installer (SSMS-Setup-ENU.exe) to a convenient location on your computer.

Step 3: Install the Latest SSMS Version

Proceed with installing the downloaded SSMS setup file.

Installation Steps:

  1. Close any running instances of SSMS.
  2. Locate the downloaded installer and double-click to run it.
  3. Follow the on-screen prompts:
    • Accept the license agreement.
    • Choose the installation directory (default is recommended).
    • Click “Install” to begin the installation process.
  4. Wait for the installation to complete. This may take several minutes.
  5. Once installed, click “Close” to exit the installer.

Note: The latest SSMS version as of now supports all recent features and ensures better compatibility with Azure SQL Managed Instances.

Step 4: Reattempt Creating the JobSchedule

After updating SSMS, retry creating the JobSchedule.

Steps:

  1. Open the newly installed SSMS.
  2. Connect to your Azure SQL Managed Instance.
  3. Navigate to SQL Server Agent > Jobs.
  4. Right-click on Jobs and select “New Job…”.
  5. Configure the job properties as required.
  6. Navigate to the Schedules page and create a new schedule without using unsupported features like ONIDLE.
  7. Click “OK” to save and create the JobSchedule.

Expected Outcome: The JobSchedule should now be created successfully without encountering the previous error.

Step 5: Validate the JobSchedule

Ensure that the JobSchedule is functioning as intended.

Validation Steps:

  1. Verify that the job appears under the Jobs section in SSMS.
  2. Check the job’s history after execution to confirm it runs without errors.
  3. Monitor the job over a period to ensure consistent performance.

Additional Considerations:

  • If the error persists, review the job’s configuration to ensure no unsupported features are being used.
  • Consult the official Microsoft documentation for any environment-specific limitations or additional updates required.

Points Learned

  1. Importance of Keeping Software Updated:
    • Regularly updating tools like SSMS ensures compatibility with the latest features and prevents unexpected errors.
    • Updates often include bug fixes, performance improvements, and support for new functionalities.
  2. Understanding Environment Compatibility:
    • Azure SQL Managed Instance differs from on-premises SQL Server in terms of supported features. Always verify feature support based on the specific environment to prevent configuration issues.
  3. Effective Error Analysis:
    • Carefully reading and understanding error messages can quickly point to the root cause and appropriate solutions.
    • Utilizing provided help links and official documentation aids in resolving issues efficiently.
  4. Proactive Maintenance Practices:
    • Regularly auditing and updating database management tools is a best practice to maintain smooth operations.
    • Implementing monitoring and validation steps post-configuration changes ensures system reliability.
  5. Utilizing Official Resources:
    • Relying on official download links and documentation ensures the authenticity and security of the tools being used.
    • Community forums and support channels can provide additional assistance when facing uncommon issues.

Conclusion

Encountering errors in Azure SQL Managed Instances can be challenging, but with a systematic approach to diagnosing and resolving issues, such obstacles can be efficiently overcome. In this case, updating SSMS to the latest version resolved the compatibility issue causing the JobSchedule creation error. This experience underscores the critical importance of maintaining up-to-date software and understanding the specific features supported by different SQL Server environments, especially when working with cloud-based services like Azure SQL Managed Instance.

By adhering to best practices in software maintenance and error resolution, database administrators and developers can ensure robust and uninterrupted database operations, thereby supporting the critical applications and services that rely on them.

Thank You,
Vivek Janakiraman

Disclaimer:
The views expressed on this blog are mine alone and do not reflect the views of my company or anyone else. All postings on this blog are provided โ€œAS ISโ€ with no warranties, and confers no rights.

Unleashing SQL Server 2022: Enhancements to sys.dm_exec_query_statistics_xml

In the world of data management and analysis, SQL Server 2022 has brought numerous improvements and enhancements, one of the most notable being the advancements to the dynamic management view (DMV) sys.dm_exec_query_statistics_xml. This DMV provides detailed runtime statistics about query execution, which is invaluable for performance tuning and query optimization.

In this blog, we will explore the enhancements to sys.dm_exec_query_statistics_xml in SQL Server 2022 using the JBDB database. We’ll walk through a comprehensive business use case, demonstrate these enhancements with T-SQL queries, and show how these can be leveraged for better performance insights.

Business Use Case: Optimizing an E-commerce Database ๐Ÿ›’

Imagine you are a database administrator for JBDB, an e-commerce platform with millions of users and transactions. Ensuring optimal query performance is crucial for providing a seamless user experience. You need to monitor query performance, identify slow-running queries, and understand execution patterns to make informed optimization decisions.

The JBDB Database Schema

For this demo, we’ll use a simplified version of the JBDB database with the following schema:

  • Customers: Stores customer information.
  • Orders: Stores order details.
  • OrderItems: Stores items within an order.
  • Products: Stores product details.

CREATE TABLE Customers (
    CustomerID INT PRIMARY KEY,
    Name NVARCHAR(100),
    Email NVARCHAR(100),
    CreatedAt DATETIME
);

CREATE TABLE Products (
    ProductID INT PRIMARY KEY,
    ProductName NVARCHAR(100),
    Price DECIMAL(10, 2),
    Stock INT
);

CREATE TABLE Orders (
    OrderID INT PRIMARY KEY,
    CustomerID INT FOREIGN KEY REFERENCES Customers(CustomerID),
    OrderDate DATETIME
);

CREATE TABLE OrderItems (
    OrderItemID INT PRIMARY KEY,
    OrderID INT FOREIGN KEY REFERENCES Orders(OrderID),
    ProductID INT FOREIGN KEY REFERENCES Products(ProductID),
    Quantity INT,
    Price DECIMAL(10, 2)
);
INSERT INTO Customers (CustomerID, Name, Email, CreatedAt)
VALUES 
(1, 'John Doe', 'john.doe@example.com', '2023-01-10'),
(2, 'Jane Smith', 'jane.smith@example.com', '2023-02-15'),
(3, 'Emily Johnson', 'emily.johnson@example.com', '2023-03-22'),
(4, 'Michael Brown', 'michael.brown@example.com', '2023-04-05'),
(5, 'Sarah Davis', 'sarah.davis@example.com', '2023-05-30');


INSERT INTO Products (ProductID, ProductName, Price, Stock)
VALUES 
(1, 'Laptop', 999.99, 50),
(2, 'Smartphone', 499.99, 150),
(3, 'Tablet', 299.99, 75),
(4, 'Headphones', 149.99, 200),
(5, 'Smartwatch', 199.99, 100);

INSERT INTO Orders (OrderID, CustomerID, OrderDate)
VALUES 
(1, 1, '2023-06-15'),
(2, 2, '2023-07-20'),
(3, 3, '2023-08-25'),
(4, 4, '2023-09-10'),
(5, 5, '2023-10-05');

INSERT INTO OrderItems (OrderItemID, OrderID, ProductID, Quantity, Price)
VALUES 
(1, 1, 1, 1, 999.99),
(2, 1, 4, 2, 149.99),
(3, 2, 2, 1, 499.99),
(4, 2, 5, 1, 199.99),
(5, 3, 3, 2, 299.99),
(6, 4, 1, 1, 999.99),
(7, 4, 2, 1, 499.99),
(8, 5, 5, 2, 199.99),
(9, 5, 3, 1, 299.99);

Enhancements to sys.dm_exec_query_statistics_xml ๐Ÿ†•

SQL Server 2022 introduces several key enhancements to sys.dm_exec_query_statistics_xml, including:

  1. Enhanced Plan Information: More detailed execution plan information is now available.
  2. Wait Statistics: Comprehensive wait statistics are included to identify bottlenecks.
  3. Query Store Integration: Better integration with the Query Store for historical analysis.

Demonstrating Enhancements with T-SQL Queries ๐Ÿ“Š

Let’s dive into some T-SQL queries to see these enhancements in action.

Step 1: Capture a Sample Query Execution

First, we’ll execute a sample query to fetch order details along with customer and product information.

SELECT o.OrderID, o.OrderDate, c.Name AS CustomerName, p.ProductName, oi.Quantity, oi.Price
FROM
Orders o
JOIN
Customers c ON o.CustomerID = c.CustomerID
JOIN
OrderItems oi ON o.OrderID = oi.OrderID
JOIN
Products p ON oi.ProductID = p.ProductID
WHERE
o.OrderDate BETWEEN '2023-01-01' AND '2023-12-31';

Step 2: Retrieve Query Statistics XML

Next, we’ll use sys.dm_exec_query_statistics_xml to retrieve detailed execution statistics for the above query.

WITH XMLNAMESPACES (DEFAULT 'http://schemas.microsoft.com/sqlserver/2004/07/showplan')
SELECT
qst.sql_handle,
qst.plan_handle,
qst.execution_count,
qst.total_worker_time,
qst.total_elapsed_time,
qst.total_logical_reads,
qst.total_physical_reads,
qst.creation_time,
qst.last_execution_time,
q.text AS query_text,
qpx.query_plan
FROM
sys.dm_exec_query_stats AS qst
CROSS APPLY
sys.dm_exec_sql_text(qst.sql_handle) AS q
CROSS APPLY
sys.dm_exec_query_plan(qst.plan_handle) AS qpx
WHERE
q.text LIKE '%SELECT o.OrderID, o.OrderDate, c.Name AS CustomerName, p.ProductName, oi.Quantity, oi.Price%';

Step 3: Analyzing Enhanced Plan Information ๐Ÿ”

With SQL Server 2022, the execution plan XML now includes more detailed information about the query execution. You can parse the XML to extract specific details.

WITH XMLNAMESPACES (DEFAULT 'http://schemas.microsoft.com/sqlserver/2004/07/showplan')
SELECT 
    query_plan.value('(//RelOp/LogicalOp)[1]', 'NVARCHAR(100)') AS LogicalOperation,
    query_plan.value('(//RelOp/PhysicalOp)[1]', 'NVARCHAR(100)') AS PhysicalOperation,
    query_plan.value('(//RelOp/RunTimeInformation/RunTimeCountersPerThread/ActualRows)[1]', 'INT') AS ActualRows,
    query_plan.value('(//RelOp/RunTimeInformation/RunTimeCountersPerThread/ActualEndOfScans)[1]', 'INT') AS ActualEndOfScans
FROM 
    (SELECT CAST(qpx.query_plan AS XML) AS query_plan
     FROM sys.dm_exec_query_stats qs
     CROSS APPLY sys.dm_exec_query_plan(qs.plan_handle) AS qpx
     WHERE qs.sql_handle = (SELECT sql_handle FROM sys.dm_exec_requests WHERE session_id = @@SPID)) AS x;

Step 4: Monitoring Wait Statistics โฑ๏ธ

Wait statistics help identify performance bottlenecks such as CPU, IO, or memory waits. SQL Server 2022 provides enhanced wait statistics in the query execution plans.

WITH XMLNAMESPACES (DEFAULT 'http://schemas.microsoft.com/sqlserver/2004/07/showplan')
SELECT 
    wait_type,
    wait_time_ms AS total_wait_time_ms,
    wait_time_ms - signal_wait_time_ms AS resource_wait_time_ms,
    signal_wait_time_ms
FROM 
    sys.dm_exec_session_wait_stats
WHERE 
    session_id = @@SPID;

Leveraging Query Store Integration ๐Ÿ“ˆ

SQL Server 2022’s improved integration with the Query Store allows for historical query performance analysis, helping you understand performance trends and regressions.

SELECT 
    qsp.plan_id,
    qsp.query_id,
    qsqt.query_sql_text AS query_text,
    qsrs.count_executions AS execution_count,
    qsrs.avg_duration,
    qsrs.avg_cpu_time,
    qsrs.avg_logical_io_reads
FROM 
    sys.query_store_runtime_stats qsrs
JOIN 
    sys.query_store_plan qsp ON qsrs.plan_id = qsp.plan_id
JOIN 
    sys.query_store_query qsq ON qsp.query_id = qsq.query_id
JOIN 
    sys.query_store_query_text qsqt ON qsq.query_text_id = qsqt.query_text_id
WHERE 
    qsqt.query_sql_text LIKE '%SELECT o.OrderID, o.OrderDate, c.Name AS CustomerName, p.ProductName, oi.Quantity, oi.Price%';

Conclusion ๐ŸŽ‰

The enhancements to sys.dm_exec_query_statistics_xml in SQL Server 2022 provide deeper insights into query performance, making it easier to identify and resolve performance issues. By leveraging these new capabilities, database administrators can ensure their SQL Server instances run more efficiently and effectively.

Feel free to experiment with the queries provided and explore the powerful new features SQL Server 2022 has to offer. Happy querying! ๐Ÿง‘โ€๐Ÿ’ป

Exploring SQL Server 2022’s Enhanced Support for Ordered Data in Window Functions

SQL Server 2022 has brought several exciting enhancements, especially for window functions. These improvements make it easier to work with ordered data, a common requirement in many business scenarios. In this blog, we will explore these new features using the JBDB database. We’ll start with a detailed business use case and demonstrate the improvements with practical T-SQL queries. Let’s dive in! ๐ŸŒŠ

Business Use Case: Sales Performance Analysis ๐Ÿ“Š

Imagine a company, JB Enterprises, which needs to analyze the sales performance of its sales representatives over time. The goal is to:

  1. Rank sales representatives based on their monthly sales.
  2. Calculate the running total of sales for each representative.
  3. Determine the difference in sales between the current month and the previous month.

To achieve this, we’ll use SQL Server 2022’s enhanced window functions.

Setting Up the JBDB Database ๐Ÿ› ๏ธ

First, let’s set up our JBDB database and create the necessary tables:

-- Create the JBDB database
CREATE DATABASE JBDB;
GO

-- Use the JBDB database
USE JBDB;
GO

-- Create the Sales table
CREATE TABLE Sales (
    SalesID INT PRIMARY KEY IDENTITY,
    SalesRepID INT,
    SalesRepName NVARCHAR(100),
    SaleDate DATE,
    SaleAmount DECIMAL(10, 2)
);
GO

Now, let’s populate the Sales table with some sample data:

-- Insert sample data into the Sales table
INSERT INTO Sales (SalesRepID, SalesRepName, SaleDate, SaleAmount) VALUES
(1, 'Alice', '2023-01-15', 1000.00),
(1, 'Alice', '2023-02-15', 1500.00),
(1, 'Alice', '2023-03-15', 1200.00),
(2, 'Bob', '2023-01-20', 800.00),
(2, 'Bob', '2023-02-20', 1600.00),
(2, 'Bob', '2023-03-20', 1100.00),
(3, 'Charlie', '2023-01-25', 1300.00),
(3, 'Charlie', '2023-02-25', 1700.00),
(3, 'Charlie', '2023-03-25', 1800.00);
GO

Improved Support for Ordered Data in Window Functions ๐ŸŒŸ

SQL Server 2022 introduces several enhancements to window functions, making it easier to work with ordered data. Let’s explore these improvements with our use case.

1. Ranking Sales Representatives ๐Ÿ†

To rank sales representatives based on their monthly sales, we can use the RANK() function:

-- Rank sales representatives based on monthly sales
SELECT 
    SalesRepName,
    SaleDate,
    SaleAmount,
    RANK() OVER (PARTITION BY DATEPART(YEAR, SaleDate), DATEPART(MONTH, SaleDate) 
                 ORDER BY SaleAmount DESC) AS SalesRank
FROM 
    Sales
ORDER BY 
    SaleDate, SalesRank;

This query partitions the data by year and month and ranks the sales representatives within each partition based on their sales amount.

2. Calculating Running Total ๐Ÿงฎ

To calculate the running total of sales for each representative, we can use the SUM() function with the ROWS BETWEEN clause:

-- Calculate running total of sales for each representative
SELECT 
    SalesRepName,
    SaleDate,
    SaleAmount,
    SUM(SaleAmount) OVER (PARTITION BY SalesRepID ORDER BY SaleDate 
                          ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) AS RunningTotal
FROM 
    Sales
ORDER BY 
    SalesRepName, SaleDate;

This query calculates the running total of sales for each representative, ordered by the sale date.

3. Calculating Month-over-Month Difference ๐Ÿ“‰๐Ÿ“ˆ

To determine the difference in sales between the current month and the previous month, we can use the LAG() function:

-- Calculate month-over-month difference in sales
SELECT 
    SalesRepName,
    SaleDate,
    SaleAmount,
    SaleAmount - LAG(SaleAmount, 1, 0) OVER (PARTITION BY SalesRepID ORDER BY SaleDate) AS MonthOverMonthDifference
FROM 
    Sales
ORDER BY 
    SalesRepName, SaleDate;

This query calculates the difference in sales between the current month and the previous month for each sales representative.

4. Average Monthly Sales per Representative ๐Ÿ“Š

To calculate the average monthly sales for each representative:

-- Calculate average monthly sales for each representative
SELECT 
    SalesRepName,
    DATEPART(YEAR, SaleDate) AS SaleYear,
    DATEPART(MONTH, SaleDate) AS SaleMonth,
    AVG(SaleAmount) OVER (PARTITION BY SalesRepID, DATEPART(YEAR, SaleDate), DATEPART(MONTH, SaleDate)) AS AvgMonthlySales
FROM 
    Sales
ORDER BY 
    SalesRepName, SaleYear, SaleMonth;

5. Cumulative Distribution of Sales ๐Ÿ“ˆ

To compute the cumulative distribution of sales amounts within each month:

-- Calculate cumulative distribution of sales within each month
SELECT 
    SalesRepName,
    SaleDate,
    SaleAmount,
    CUME_DIST() OVER (PARTITION BY DATEPART(YEAR, SaleDate), DATEPART(MONTH, SaleDate) 
                      ORDER BY SaleAmount) AS CumulativeDistribution
FROM 
    Sales
ORDER BY 
    SaleDate, SaleAmount;

6. Percentage Rank of Sales Representatives ๐ŸŽฏ

To assign a percentage rank to sales representatives based on their sales amounts:

-- Calculate percentage rank of sales representatives
SELECT 
    SalesRepName,
    SaleDate,
    SaleAmount,
    PERCENT_RANK() OVER (PARTITION BY DATEPART(YEAR, SaleDate), DATEPART(MONTH, SaleDate) 
                         ORDER BY SaleAmount) AS PercentageRank
FROM 
    Sales
ORDER BY 
    SaleDate, PercentageRank;

7. NTILE Function to Divide Sales into Quartiles ๐Ÿชœ

To divide sales amounts into quartiles for better distribution analysis:

-- Divide sales into quartiles
SELECT 
    SalesRepName,
    SaleDate,
    SaleAmount,
    NTILE(4) OVER (PARTITION BY DATEPART(YEAR, SaleDate), DATEPART(MONTH, SaleDate) 
                   ORDER BY SaleAmount) AS SalesQuartile
FROM 
    Sales
ORDER BY 
    SaleDate, SalesQuartile;

8. Median Sale Amount per Month ๐Ÿ“

To calculate the median sale amount for each month using the PERCENTILE_CONT function:

-- Calculate median sale amount per month
SELECT DISTINCT
    DATEPART(YEAR, SaleDate) AS SaleYear,
    DATEPART(MONTH, SaleDate) AS SaleMonth,
    PERCENTILE_CONT(0.5) WITHIN GROUP (ORDER BY SaleAmount) OVER (PARTITION BY DATEPART(YEAR, SaleDate), DATEPART(MONTH, SaleDate)) AS MedianSaleAmount
FROM 
    Sales
ORDER BY 
    SaleYear, SaleMonth;

9. Lead Function to Compare Next Month Sales ๐Ÿ“…

To compare the sales amount with the sales of the next month:

-- Compare sales amount with next month's sales
SELECT 
    SalesRepName,
    SaleDate,
    SaleAmount,
    LEAD(SaleAmount, 1, 0) OVER (PARTITION BY SalesRepID ORDER BY SaleDate) AS NextMonthSales,
    LEAD(SaleAmount, 1, 0) OVER (PARTITION BY SalesRepID ORDER BY SaleDate) - SaleAmount AS SalesDifference
FROM 
    Sales
ORDER BY 
    SalesRepName, SaleDate;

Conclusion ๐ŸŽ‰

SQL Server 2022’s enhanced support for ordered data in window functions provides powerful tools for analyzing and manipulating data. In this blog, we demonstrated how to use these improvements to rank sales representatives, calculate running totals, and determine month-over-month sales differences.

These enhancements simplify complex queries and improve performance, making it easier to gain insights from your data. Whether you’re analyzing sales performance or tackling other business challenges, SQL Server 2022’s window functions can help you achieve your goals more efficiently. ๐ŸŒŸ

Happy querying! ๐Ÿ’ป

For more tutorials and tips on  SQL Server, including performance tuning and  database management, be sure to check out our JBSWiki YouTube channel.

Thank You,
Vivek Janakiraman

Disclaimer:
The views expressed on this blog are mine alone and do not reflect the views of my company or anyone else. All postings on this blog are provided โ€œAS ISโ€ with no warranties, and confers no rights.