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.

SQL Server 2022 UTF-8 Support Enhancements in Collation

In SQL Server 2022, UTF-8 support has been enhanced, offering more efficient storage and better performance for text data. This blog will explore these enhancements using the JBDB database and provide a detailed business use case to illustrate the benefits of adopting UTF-8 collation.

🌍Business Use Case: International E-commerce Platform 🌍

Imagine an international e-commerce platform that serves customers worldwide, offering products in multiple languages. The database needs to handle diverse character sets efficiently, from English to Japanese, Arabic, and more. Previously, using Unicode (UTF-16) required more storage space, leading to increased costs and slower performance. With SQL Server 2022’s improved UTF-8 support, the platform can now store multilingual text data more compactly, reducing storage costs and enhancing query performance.

UTF-8 Support in SQL Server 2022

SQL Server 2019 introduced UTF-8 as a new encoding option, allowing for more efficient storage of character data. SQL Server 2022 builds on this foundation by enhancing collation support, making it easier to work with UTF-8 encoded data. Let’s explore these enhancements using the JBDB database.

Setting Up the JBDB Database

First, we’ll set up the JBDB database and create a table to store product information in multiple languages.

CREATE DATABASE JBDB;
GO

USE JBDB;
GO

CREATE TABLE Products (
    ProductID INT PRIMARY KEY,
    ProductName NVARCHAR(100),
    ProductDescription NVARCHAR(1000),
    ProductDescription_UTF8 VARCHAR(1000) COLLATE Latin1_General_100_BIN2_UTF8
);
GO

In this example, ProductDescription uses the traditional NVARCHAR data type with UTF-16 encoding, while ProductDescription_UTF8 uses VARCHAR with the Latin1_General_100_BIN2_UTF8 collation for UTF-8 encoding.

Inserting Data with UTF-8 Collation 🚀

Let’s insert some sample data into the Products table, showcasing different languages.

INSERT INTO Products (ProductID, ProductName, ProductDescription, ProductDescription_UTF8)
VALUES
(1, 'Laptop', N'高性能ノートパソコン', '高性能ノートパソコン'), -- Japanese
(2, 'Smartphone', N'الهاتف الذكي الأكثر تقدمًا', 'الهاتف الذكي الأكثر تقدمًا'), -- Arabic
(3, 'Tablet', N'Nueva tableta con características avanzadas', 'Nueva tableta con características avanzadas'); -- Spanish
GO

Here, we use N'...' to denote Unicode literals for the NVARCHAR column and regular string literals for the VARCHAR column with UTF-8 encoding.

Querying and Comparing Storage Size 📊

To see the benefits of UTF-8 encoding, we’ll compare the storage size of the ProductDescription and ProductDescription_UTF8 columns.

SELECT
    ProductID,
    DATALENGTH(ProductDescription) AS UnicodeStorage,
    DATALENGTH(ProductDescription_UTF8) AS UTF8Storage
FROM Products;
GO

This query returns the number of bytes used to store each product description, illustrating the storage savings with UTF-8.

Working with UTF-8 Data 🔍

Let’s perform some queries and operations on the UTF-8 encoded data.

Searching for Products in Japanese:

SELECT ProductID, ProductName, ProductDescription_UTF8
FROM Products
WHERE ProductDescription_UTF8 LIKE '%ノートパソコン%';
GO

Updating UTF-8 Data:

UPDATE Products
SET ProductDescription_UTF8 = '高性能なノートパソコン'
WHERE ProductID = 1;
GO

Ordering Data with UTF-8 Collation:

SELECT ProductID, ProductName, ProductDescription_UTF8
FROM Products
ORDER BY ProductDescription_UTF8 COLLATE Latin1_General_100_BIN2_UTF8;
GO

Advantages of UTF-8 in SQL Server 2022 🏆

  1. Reduced Storage Costs: UTF-8 encoding is more space-efficient than UTF-16, especially for languages using the Latin alphabet.
  2. Improved Performance: Smaller data size leads to faster reads and writes, enhancing overall performance.
  3. Enhanced Compatibility: UTF-8 is a widely-used encoding standard, making it easier to integrate with other systems and technologies.

Conclusion ✨

SQL Server 2022’s enhanced UTF-8 support in collation offers significant advantages for businesses dealing with multilingual data. By leveraging these enhancements, the international e-commerce platform in our use case can optimize storage, improve performance, and provide a seamless user experience across diverse languages.

Whether you’re dealing with global customer data or localized content, adopting UTF-8 collation in SQL Server 2022 can be a game-changer for your database management strategy.

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.

Comprehensive Guide to Monitoring SQL Server: Optimizing Max Server Memory

Monitoring a SQL Server database is essential to maintain its performance, stability, and overall health. One crucial aspect of SQL Server configuration is setting the max server memory value appropriately. This blog provides an in-depth look at how to monitor SQL Server and how to determine the best value for the max server memory setting, using various tools and methods.


🔍 Key Tools and Techniques for Monitoring SQL Server

Effective monitoring of a SQL Server environment involves multiple tools and techniques, each offering unique insights.

1. SQL Server Management Studio (SSMS)

SSMS provides built-in features for monitoring SQL Server:

  • Activity Monitor: A real-time interface that displays CPU usage, I/O statistics, recent expensive queries, and more.
  • Performance Dashboard Reports: Pre-defined reports that provide details on CPU, memory, and I/O usage.
2. Dynamic Management Views (DMVs)

DMVs allow querying internal SQL Server metrics:

  • sys.dm_os_performance_counters: Retrieves various performance counters, including memory usage.
  • sys.dm_exec_query_stats: Provides statistics on query performance.
  • sys.dm_os_sys_memory: Displays the amount of memory in use and available.
3. Extended Events

Extended Events provide a lightweight, flexible way to collect data on SQL Server events:

  • Configure sessions to capture specific data points, such as long-running queries or memory usage spikes.
4. SQL Server Profiler & Trace

Although deprecated, SQL Server Profiler can still be used for tracing events and diagnosing issues.

5. Performance Monitor (PerfMon)

PerfMon is a Windows utility that provides detailed insights into system and SQL Server performance. It allows tracking various counters, essential for understanding SQL Server’s memory usage.


📈 Key Performance Monitor (PerfMon) Counters for SQL Server

Using PerfMon, you can monitor several critical counters that provide insight into SQL Server’s memory management and overall performance:

  1. Memory: Available MBytes
    • What it measures: The amount of physical memory available on the system.
    • Why it matters: Helps determine if the system has enough memory to support both SQL Server and other applications.
  2. SQLServer: Memory Manager – Total Server Memory (KB)
    • What it measures: The total amount of dynamic memory the SQL Server is using.
    • Why it matters: Indicates how much memory SQL Server is consuming and helps in understanding if the configured memory is adequate.
  3. SQLServer: Memory Manager – Target Server Memory (KB)
    • What it measures: The ideal amount of memory SQL Server aims to use.
    • Why it matters: Helps in determining if SQL Server is using less memory than needed, which could lead to performance issues.
  4. SQLServer: Buffer Manager – Buffer Cache Hit Ratio
    • What it measures: The percentage of pages found in the buffer cache without requiring a read from disk.
    • Why it matters: A high buffer cache hit ratio generally indicates that the SQL Server has sufficient memory allocated for caching.
  5. SQLServer: Buffer Manager – Page Life Expectancy
    • What it measures: The number of seconds a page will stay in the buffer cache.
    • Why it matters: A lower value indicates that pages are being flushed out too quickly, which may suggest the need for more memory.

🧮 Calculating the Optimal Max Server Memory Setting

To determine the optimal max server memory setting, consider the following steps:

1. Identify Total Physical Memory

Determine the total physical memory available on your server. For example, if your server has 64 GB of RAM, this is your baseline.

2. Reserve Memory for the OS and Other Applications

It’s crucial to leave enough memory for the OS and other applications. A common practice is to reserve around 20% of the total memory for the OS. For example, with 64 GB of RAM, you might reserve 12-16 GB for the OS, leaving 48-52 GB for SQL Server.

3. Use PerfMon Data to Fine-Tune

Using PerfMon, monitor the following:

  • Memory: Available MBytes: Ensure that this value does not drop too low, indicating a lack of available memory.
  • SQLServer: Memory Manager – Total Server Memory (KB) and Target Server Memory (KB): If Total Server Memory consistently meets or exceeds Target Server Memory, it may indicate a need for more memory.
  • SQLServer: Buffer Manager – Buffer Cache Hit Ratio: Aim for a ratio above 90%.
  • SQLServer: Buffer Manager – Page Life Expectancy: Aim for a value greater than 300 seconds.
4. Adjust Max Server Memory

After analyzing the data, adjust the max server memory setting using the following SQL command:

EXEC sp_configure 'max server memory', 49152; -- Example: Set to 48 GB
RECONFIGURE;
5. Regular Review and Adjustment

Regularly review your settings, especially after significant workload changes. As workloads evolve, memory requirements may change, necessitating adjustments to the max server memory setting.


🚀 Conclusion

Effective monitoring and optimal memory configuration are key to maintaining SQL Server performance. By leveraging tools like SSMS, DMVs, Extended Events, and PerfMon, you can gain valuable insights into your SQL Server’s memory usage and overall performance. Setting the correct max server memory is crucial to ensure your SQL Server runs efficiently without starving the OS or other applications of necessary resources.

For more detailed tutorials and insights, be sure to check out our YouTube channel, JBSWiki YouTube channel, where we cover SQL Server and Azure SQL topics in depth.

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.