| title | Deprecated Database Engine Features | Microsoft Docs | |||
|---|---|---|---|---|
| titleSuffix | SQL Server 2019 | |||
| description | Find out about deprecated database engine features that are still available in SQL Server 2017 (14.x), but shouldn't be used in new applications. | |||
| ms.custom | seo-lt-2019 | |||
| ms.date | 03/30/2020 | |||
| ms.prod | sql | |||
| ms.prod_service | high-availability | |||
| ms.reviewer | ||||
| ms.technology | release-landing | |||
| ms.topic | conceptual | |||
| helpviewer_keywords |
|
|||
| ms.assetid | ||||
| author | MikeRayMSFT | |||
| ms.author | mikeray | |||
| monikerRange | >=sql-server-2017||=sqlallproducts-allversions||>=sql-server-linux-2017 |
[!INCLUDEtsql-appliesto-ss2017-xxxx-xxxx-xxx-md]
This topic describes the deprecated SQL Server Database Engine features that are still available in SQL Server 2017 (14.x). Deprecated features should not be used in new applications.
When a feature is marked deprecated, it means:
-
The feature is in maintenance mode only. No new changes will be done, including those related to inter-operability with new features.
-
We strive not to remove a deprecated feature from future releases to make upgrades easier. However, under rare situations, we may choose to permanently remove the feature from SQL Server if it limits future innovations.
-
For new development work, we do not recommend using deprecated features.
You can monitor the use of deprecated features by using the SQL Server Deprecated Features Object performance counter and trace events. For more information, see Use SQL Server Objects.
The value of these counters are also available by executing the following statement:
SELECT * FROM sys.dm_os_performance_counter
WHERE object_name = 'SQLServer:Deprecated Features';Note
This list is identical to the [!INCLUDEsssql15-md] list. There are no new deprecated or discontinued Database Engine features announced for [!INCLUDEsssqlv14-md].
The following SQL Server Database Engine features will be deprecated in the next version of SQL Server. Do not use these features in new development work, and modify applications that currently use these features as soon as possible. The Feature name value appears in trace events as the ObjectName and in performance counters and sys.dm_os_performance_counters as the instance name.
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| RESTORE { DATABASE | LOG } WITH [MEDIA]PASSWORD continues to be deprecated. BACKUP { DATABASE | LOG } WITH PASSWORD and BACKUP { DATABASE | LOG } WITH MEDIAPASSWORD are discontinued. | None. | BACKUP DATABASE or LOG WITH PASSWORD BACKUP DATABASE or LOG WITH MEDIAPASSWORD |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| Upgrade from version 100 (SQL Server 2008 and SQL Server 2008 R2). | When a SQL Server version goes out of support, the associated Database Compatibility Level will be marked deprecated. However, we will continue to support applications certified on any supported database compatibility level as long as possible, to make the upgrades easier. For more information about compatibility levels, see ALTER DATABASE Compatibility Level (Transact-SQL). | Database compatibility level 100 |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| Ability to return result sets from triggers | None | Returning results from trigger |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| Encryption using RC4 or RC4_128 is deprecated and is scheduled to be removed in the next version. Decrypting RC4 and RC4_128 is not deprecated. | Use another encryption algorithm such as AES. | Deprecated encryption algorithm |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| Hash algorithms | Using the MD2, MD4, MD5, SHA, and SHA1 is deprecated. | Use SHA2_256 or SHA2_512 instead. Older algorithms will continue working, but they will raise a deprecation event. |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| Remote servers | sp_addremotelogin sp_addserver sp_dropremotelogin sp_helpremotelogin sp_remoteoption |
Replace remote servers by using linked servers. sp_addserver can only be used with the local option. |
| Remote servers | @@remserver | Replace remote servers by using linked servers. |
| Remote servers | SET REMOTE_PROC_TRANSACTIONS | Replace remote servers by using linked servers. |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| Set options | SET ROWCOUNT for INSERT, UPDATE, and DELETE statements | TOP keyword |
| Category | Deprecated feature | Replacement | Feature name |
|---|---|---|---|
| HOLDLOCK table hint without parenthesis. | Use HOLDLOCK with parenthesis. | HOLDLOCK table hint without parenthesis |
The following SQL Server Database Engine features are supported in the next version of SQL Server, but will be deprecated in a later version. The specific version of SQL Server has not been determined.
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| sp_dbcmptlevel | ALTER DATABASE ... SET COMPATIBILITY_LEVEL. For more information, see ALTER DATABASE Compatibility Level (Transact-SQL). | sp_dbcmptlevel |
| Database compatibility level 110 and 120. | Plan to upgrade the database and application for a future release. However, we will continue to support applications certified on any supported database compatibility level as long as possible, to make the upgrades easier. For more information about compatibility levels, see ALTER DATABASE Compatibility Level (Transact-SQL). | Database compatibility level 110 Database compatibility level 120 |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| BACKUP { DATABASE | LOG } TO TAPE BACKUP { DATABASE | LOG } TO device_that_is_a_tape |
BACKUP { DATABASE | LOG } TO DISK BACKUP { DATABASE | LOG } TO device_that_is_a_disk |
BACKUP DATABASE or LOG TO TAPE |
| sp_addumpdevice 'tape' | sp_addumpdevice 'disk' | ADDING TAPE DEVICE |
| sp_helpdevice | sys.backup_devices | sp_helpdevice |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| Korean_Wansung_Unicode Lithuanian_Classic SQL_AltDiction_CP1253_CS_AS |
None. These collations exist in SQL Server 2005 (9.x), but are not visible through fn_helpcollations. | Korean_Wansung_Unicode Lithuanian_Classic SQL_AltDiction_CP1253_CS_AS |
| Hindi Macedonian |
These collations exist in SQL Server 2005 (9.x) and higher, but are not visible through fn_helpcollations. Use Macedonian_FYROM_90 and Indic_General_90 instead. | Hindi Macedonian |
| Azeri_Latin_90 Azeri_Cyrilllic_90 |
Azeri_Latin_100 Azeri_Cyrilllic_100 |
Azeri_Latin_90 Azeri_Cyrilllic_90 |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| SET ANSI_NULLS OFF and ANSI_NULLS OFF database option SET ANSI_PADDING OFF and ANSI_PADDING OFF database option SET CONCAT_NULL_YIELDS_NULL OFF and CONCAT_NULL_YIELDS_NULL OFF database option SET OFFSETS |
None. ANSI_NULLS, ANSI_PADDING and CONCAT_NULLS_YIELDS_NULL will always be set to ON. SET OFFSETS will be unavailable. |
SET ANSI_NULLS OFF SET ANSI_PADDING OFF SET CONCAT_NULL_YIELDS_NULL OFF SET OFFSETS ALTER DATABASE SET ANSI_NULLS OFF ALTER DATABASE SET ANSI_PADDING OFF ALTER DATABASE SET CONCAT_NULL_YIELDS_NULL OFF |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| Data types | sp_addtype sp_droptype |
CREATE TYPE DROP TYPE |
| Data types | timestamp syntax for rowversion data type | rowversion data type syntax |
| Data types | Ability to insert null values into timestamp columns. | Use a DEFAULT instead. |
| Data types | 'text in row' table option | Use varchar(max), nvarchar(max), and varbinary(max) data types. For more information, see sp_tableoption (Transact-SQL). |
| Data types | Data types: text ntext image |
Use varchar(max), nvarchar(max), and varbinary(max) data types. |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| sp_attach_db sp_attach_single_file_db |
CREATE DATABASE statement with the FOR ATTACH option. To rebuild multiple log files, when one or more have a new location, use the FOR ATTACH_REBUILD_LOG option. | sp_attach_db sp_attach_single_file_db |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| CREATE DEFAULT DROP DEFAULT sp_bindefault sp_unbindefault |
DEFAULT keyword in CREATE TABLE and ALTER TABLE | CREATE_DROP_DEFAULT sp_bindefault sp_unbindefault |
| CREATE RULE DROP RULE sp_bindrule sp_unbindrule |
CHECK keyword in CREATE TABLE and ALTER TABLE | CREATE_DROP_RULE sp_bindrule sp_unbindrule |
| sp_change_users_login | Use ALTER USER. | sp_change_users_login |
| sp_depends | sys.dm_sql_referencing_entities and sys.dm_sql_referenced_entities | sp_depends |
| sp_renamedb | MODIFY NAME in ALTER DATABASE | sp_renamedb |
| sp_getbindtoken | Use MARS or distributed transactions. | sp_getbindtoken |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| sp_bindsession | Use MARS or distributed transactions. | sp_bindsession |
| sp_resetstatus | ALTER DATABASE SET { ONLINE | EMERGENCY } | sp_resetstatus |
| TORN_PAGE_DETECTION option of ALTER DATABASE | PAGE_VERIFY TORN_PAGE_DETECTION option of ALTER DATABASE | ALTER DATABASE WITH TORN_PAGE_DETECTION |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| DBCC DBREINDEX | REBUILD option of ALTER INDEX. | DBCC DBREINDEX |
| DBCC INDEXDEFRAG | REORGANIZE option of ALTER INDEX | DBCC INDEXDEFRAG |
| DBCC SHOWCONTIG | sys.dm_db_index_physical_stats | DBCC SHOWCONTIG |
| DBCC PINTABLE DBCC UNPINTABLE |
Has no effect. | DBCC [UN]PINTABLE |
| Level0type = 'type' and Level0type = 'USER' to add extended properties to level-1 or level-2 type objects.|Use Level0type = 'USER' only to add an extended property directly to a user or role.
Use Level0type = 'SCHEMA' to add an extended property to level-1 types such as TABLE or VIEW, or level-2 types such as COLUMN or TRIGGER. For more information, see sp_addextendedproperty (Transact-SQL). | EXTPROP_LEVEL0TYPE
EXTPROP_LEVEL0USER |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| xp_grantlogin xp_revokelogin xp_loginConfig |
Use CREATE LOGIN Use DROP LOGIN IsIntegratedSecurityOnly argument of SERVERPROPERTY |
xp_grantlogin |
| xp_revokelogin xp_loginconfig |
||
| srv_alloc srv_convert srv_describe srv_getbindtoken srv_got_attention srv_message_handler srv_paramdata srv_paraminfo srv_paramlen srv_parammaxlen srv_paramname srv_paramnumber srv_paramset srv_paramsetoutput srv_paramstatus srv_paramtype srv_pfield srv_pfieldex srv_rpcdb srv_rpcname srv_rpcnumber srv_rpcoptions srv_rpcowner srv_rpcparams srv_senddone srv_sendmsg srv_sendrow srv_setcoldata srv_setcollen srv_setutype srv_willconvert srv_wsendmsg |
Use CLR Integration instead. | XP_API |
| sp_addextendedproc sp_dropextendedproc sp_helpextendedproc |
Use CLR Integration instead. | sp_addextendedproc sp_dropextendedproc sp_helpextendedproc |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| fn_get_sql | sys.dm_exec_sql_text | fn_get_sql |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| database mirroring | Always On availability groups If your edition of SQL Server does not support Always On availability groups, use log shipping. |
DATABASE_MIRRORING |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| sp_indexoption | ALTER INDEX | sp_indexoption |
| CREATE TABLE, ALTER TABLE, or CREATE INDEX syntax without parentheses around the options. | Rewrite the statement to use the current syntax. | INDEX_OPTION |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| sp_configure option 'allow updates' | System tables are no longer updatable. Setting has no effect. | sp_configure 'allow updates' |
| sp_configure options: 'locks' 'open objects' 'set working set size' |
Now automatically configured. Setting has no effect. | sp_configure 'locks' sp_configure 'open objects' sp_configure 'set working set size' |
| sp_configure option 'priority boost' | System tables are no longer updatable. Setting has no effect. Use the Windows start /high ... program.exe option instead. | sp_configure 'priority boost' |
| sp_configure option 'remote proc trans' | System tables are no longer updatable. Setting has no effect. | sp_configure 'remote proc trans' |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| Specifying the SQLOLEDB provider for linked servers. | SQL Server Native Client (SQLNCLI) | SQLOLEDDB for linked servers |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| sp_lock | sys.dm_tran_locks | sp_lock |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| FILE_ID INDEXKEY_PROPERTY |
FILE_IDEX sys.index_columns |
FILE_ID INDEXKEY_PROPERTY |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| Native XML Web Services | The CREATE ENDPOINT or ALTER ENDPOINT statement with the FOR SOAP option. sys.endpoint_webmethods sys.soap_endpoints |
Use Windows Communications Foundation (WCF) or ASP.NET instead. |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| Removable databases | sp_certify_removable sp_create_removable |
sp_detach_db |
| Removable databases | sp_dbremove | DROP DATABASE |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| Security | The ALTER LOGIN WITH SET CREDENTIAL syntax | Replaced by the new ALTER LOGIN ADD and DROP CREDENTIAL syntax |
| Security | sp_addapprole sp_dropapprole |
CREATE APPLICATION ROLE DROP APPLICATION ROLE |
| Security | sp_addlogin sp_droplogin |
CREATE LOGIN DROP LOGIN |
| Security | sp_adduser sp_dropuser |
CREATE USER DROP USER |
| Security | sp_grantdbaccess sp_revokedbaccess |
CREATE USER DROP USER |
| Security | sp_addrole sp_droprole |
CREATE ROLE DROP ROLE |
| Security | sp_approlepassword sp_password |
ALTER APPLICATION ROLE ALTER LOGIN |
| Security | sp_changedbowner | ALTER AUTHORIZATION |
| Security | sp_changeobjectowner | ALTER SCHEMA or ALTER AUTHORIZATION |
| Security | sp_control_dbmasterkey_password | A master key must exist and password must be correct. |
| Security | sp_defaultdb sp_defaultlanguage |
ALTER LOGIN |
| Security | sp_denylogin sp_grantlogin sp_revokelogin |
ALTER LOGIN DISABLE CREATE LOGIN DROP LOGIN |
| Security | USER_ID | DATABASE_PRINCIPAL_ID |
| Security | sp_srvrolepermission sp_dbfixedrolepermission |
These stored procedures return information that was correct in [!INCLUDEssVersion2000]. The output does not reflect changes to the permissions hierarchy implemented in SQL Server 2008. For more information, see Permissions of Fixed Server Roles. |
| Security | GRANT ALL DENY ALL REVOKE ALL |
GRANT, DENY, and REVOKE specific permissions. |
| Security | PERMISSIONS intrinsic function | Query sys.fn_my_permissions instead. |
| Security | SETUSER | EXECUTE AS |
| Security | RC4 and DESX encryption algorithms | Use another algorithm such as AES. |
| Deprecated feature | Replacement | Feature name |
|---|---|---|
| Inline XDR Schema Generation | The XMLDATA directive to the FOR XML option is deprecated. Use XSD generation in the case of RAW and AUTO modes. There is no replacement for the XMLDATA directive in EXPLICT mode. | XMLDATA |
Note
The cookie OUTPUT parameter for sp_setapprole is currently documented as varbinary(8000) which is the correct maximum length. However the current implementation returns varbinary(50). If developers have allocated varbinary(50) the application might require changes if the cookie return size increases in a future release. Though not a deprecation issue this is mentioned in this topic because the application adjustments are similar. For more information, see sp_setapprole (Transact-SQL).
Discontinued Database Engine Functionality in SQL Server 2016