ISNULL (Transact-SQL)
Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) Punto de conexión de análisis SQL en Microsoft Fabric Almacenamiento en Microsoft Fabric
NULL
Reemplaza por el valor de reemplazo especificado.
Convenciones de sintaxis de Transact-SQL
Sintaxis
ISNULL ( check_expression , replacement_value )
Nota:
Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.
Argumentos
check_expression
Expresión que se va a comprobar para NULL
. check_expression puede ser de cualquier tipo.
replacement_value
Expresión que se va a devolver si check_expression es NULL
. valor_de_reemplazo debe ser de un tipo que se pueda convertir implícitamente en el tipo de expresión_de_comprobación.
Tipos de valores devueltos
Devuelve el mismo tipo que check_expression. Si se proporciona un literal NULL
como check_expression, ISNULL
devuelve el tipo de datos del replacement_value. Si se proporciona un literal NULL
como check_expression y no se proporciona ningún replacement_value , ISNULL
devuelve un valor int.
Comentarios
El valor de check_expression se devuelve si no NULL
es . De lo contrario, se devuelve replacement_value después de convertir implícitamente al tipo de check_expression, si los tipos son diferentes. replacement_value se puede truncar si replacement_value es mayor que check_expression.
Nota:
Use COALESCE para devolver el primer valor distinto de NULL.
Ejemplos
Los ejemplos de código de Transact-SQL de este artículo utilizan la base de datos de ejemplo AdventureWorks2022
o AdventureWorksDW2022
, que se pueden descargar desde la página principal de Ejemplos y proyectos de la comunidad de Microsoft SQL Server.
A Uso de ISNULL con AVG
En el ejemplo siguiente se busca el promedio del peso de todos los productos. Sustituye el valor 50
de todas las NULL
entradas de la Weight
columna de la Product
tabla.
USE AdventureWorks2022;
GO
SELECT AVG(ISNULL(Weight, 50))
FROM Production.Product;
GO
El conjunto de resultados es el siguiente:
59.79
B. Uso de ISNULL
En el siguiente ejemplo se selecciona la descripción, el porcentaje de descuento, la cantidad mínima y la cantidad máxima de todas las ofertas especiales de AdventureWorks2022
. Si la cantidad máxima de una oferta especial determinada es NULL
, el MaxQty
que se muestra en el conjunto de resultados es 0.00
.
USE AdventureWorks2022;
GO
SELECT Description, DiscountPct, MinQty, ISNULL(MaxQty, 0.00) AS 'Max Quantity'
FROM Sales.SpecialOffer;
GO
El conjunto de resultados es el siguiente:
Descripción | DiscountPct | MinQty | Cantidad máxima |
---|---|---|---|
No Discount |
0.00 | 0 | 0 |
Volume Discount 11 to 14 |
0.02 | 11 | 14 |
Volume Discount 15 to 24 |
0,05 | 15 | 24 |
Volume Discount 25 to 40 |
0,10 | 25 | 40 |
Volume Discount 41 to 60 |
0,15 | 41 | 60 |
Volume Discount over 60 |
0,20 | 61 | 0 |
Mountain-100 Clearance Sale |
0.35 | 0 | 0 |
Sport Helmet Discount-2002 |
0,10 | 0 | 0 |
Road-650 Overstock |
0,30 | 0 | 0 |
Mountain Tire Sale |
0.50 | 0 | 0 |
Sport Helmet Discount-2003 |
0,15 | 0 | 0 |
LL Road Frame Sale |
0.35 | 0 | 0 |
Touring-3000 Promotion |
0,15 | 0 | 0 |
Touring-1000 Promotion |
0,20 | 0 | 0 |
Half-Price Pedal Sale |
0.50 | 0 | 0 |
Mountain-500 Silver Clearance Sale |
0.40 | 0 | 0 |
En el ejemplo siguiente se usa ISNULL
para reemplazar un NULL
valor para Color
, por la cadena None
.
USE AdventureWorks2022;
GO
SELECT ProductID,
Name,
ProductNumber,
ISNULL(Color, 'None') AS Color
FROM Production.Product;
A continuación se muestra un conjunto parcial de resultados.
ProductID | Nombre | ProductNumber | Color |
---|---|---|---|
1 | Adjustable Race |
AR-5381 | None |
2 | Bearing Ball |
BA-8327 | None |
3 | BB Ball Bearing |
BE-2349 | None |
4 | Headset Ball Bearings |
BE-2908 | None |
316 | Blade |
BL-2036 | None |
317 | LL Crankarm |
CA-5965 | Negro |
318 | ML Crankarm |
CA-6738 | Negro |
319 | HL Crankarm |
CA-7457 | Negro |
C. Prueba de NULL
en una cláusula WHERE
No use ISNULL
para buscar NULL
valores. Use IS NULL
en su lugar. En el ejemplo siguiente se buscan todos los productos que tienen NULL
en la columna de peso. Tenga en cuenta el espacio entre IS
y NULL
.
USE AdventureWorks2022;
GO
SELECT Name, Weight
FROM Production.Product
WHERE Weight IS NULL;
GO
Ejemplos: Azure Synapse Analytics y Sistema de la plataforma de análisis (PDW)
D. Uso de ISNULL con AVG
En el ejemplo siguiente se busca el promedio del peso de todos los productos en una tabla de ejemplo. Sustituye el valor 50
de todas las NULL
entradas de la Weight
columna de la Product
tabla.
-- Uses AdventureWorksDW
SELECT AVG(ISNULL(Weight, 50))
FROM dbo.DimProduct;
El conjunto de resultados es el siguiente:
52.88
E. Uso de ISNULL
En el ejemplo siguiente se usa ISNULL
para probar los NULL
valores de la columna MinPaymentAmount
y mostrar el valor 0.00
de esas filas.
-- Uses AdventureWorks
SELECT ResellerName,
ISNULL(MinPaymentAmount,0) AS MinimumPayment
FROM dbo.DimReseller
ORDER BY ResellerName;
A continuación se muestra un conjunto parcial de resultados.
ResellerName | MinimumPayment |
---|---|
Una asociación de bicicleta | 0.0000 |
Una tienda de bicicletas | 0.0000 |
Una tienda de bicis | 0.0000 |
Una gran empresa de bicicletas | 0.0000 |
La típica tienda de bicicletas | 200.0000 |
Servicio y ventas aceptables | 0.0000 |
F. Uso de IS NULL para probar NULL en una cláusula WHERE
En el ejemplo siguiente se buscan todos los productos que tienen NULL
en la columna Weight
. Tenga en cuenta el espacio entre IS
y NULL
.
-- Uses AdventureWorksDW
SELECT EnglishProductName, Weight
FROM dbo.DimProduct
WHERE Weight IS NULL;