DATABASEPROPERTYEX (Transact-SQL)

Se aplica a: síSQL Server (todas las versiones admitidas) SíAzure SQL Database SíInstancia administrada de Azure SQL síAzure Synapse Analytics síAlmacenamiento de datos paralelos

Para una base de datos especificada en SQL Server, esta función devuelve la configuración actual de la opción o propiedad de base de datos especificada.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQL

Sintaxis

DATABASEPROPERTYEX ( database , property )  

Nota

Para ver la sintaxis de Transact-SQL para SQL Server 2014 y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

database
Una expresión que especifica el nombre de la base de datos para la que DATABASEPROPERTYEX devolverá la información de la propiedad con nombre. database tiene un tipo de datos nvarchar(128) .

Para SQL Database, DATABASEPROPERTYEX necesita el nombre de la base de datos actual. Devuelve NULL para todas las propiedades si se proporciona un nombre de base de datos diferente.

property
Una expresión que especifica el nombre de la propiedad de base de datos que se va a devolver. property tiene un tipo de datos varchar(128) y admite uno de los valores de esta tabla:

Nota

Si la base de datos aún no se ha iniciado, las llamadas a DATABASEPROPERTYEX devolverán NULL si DATABASEPROPERTYEX recupera esos valores mediante el acceso directo de la base de datos, en lugar de hacerlo mediante la recuperación a partir de los metadatos. Si hay una base de datos con AUTO_CLOSE establecido en ON (o, de lo contrario, sin conexión), se definirá como "no iniciada".

Propiedad Descripción Valor devuelto
Intercalación Nombre de intercalación predeterminado para la base de datos. Nombre de intercalación

NULL: La base de datos no se ha iniciado.

Tipo de datos base: nvarchar(128)
ComparisonStyle El estilo de comparación de Windows de la intercalación. Use los siguientes valores de estilo para generar un mapa de bits para el valor ComparisonStyle terminado:

Omitir mayúsculas y minúsculas: 1

Omitir acento: 2

Omitir Kana: 65536

Omitir ancho: 131 072



Por ejemplo, el valor predeterminado 196609 es el resultado de combinar las opciones de omitir mayúsculas y minúsculas, omitir Kana y omitir ancho.
Devuelve el estilo de comparación.

Devuelve 0 para todas las intercalaciones binarias.

Tipo de datos base: int
Edición El nivel de servicio o edición de la base de datos. Se aplica a: Azure SQL Database, Azure Synapse Analytics.



De uso general

Crítico para la empresa

Básico

Estándar

Premium

System (de la base de datos maestra)

NULL: La base de datos no se ha iniciado.

Tipo de datos base: nvarchar(64)
IsAnsiNullDefault La base de datos sigue las reglas ISO para permitir los valores NULL. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsAnsiNullsEnabled Todas las comparaciones con un valor NULL tienen un resultado desconocido. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsAnsiPaddingEnabled Las cadenas se rellenan a la misma longitud antes de comparar o insertar. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsAnsiWarningsEnabled SQL Server emite mensajes de error o de advertencia cuando se producen condiciones de error estándar. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsArithmeticAbortEnabled Las consultas se finalizan cuando hay un error de desbordamiento o división por cero durante su ejecución. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsAutoClose La base de datos se cierra sin problemas y libera los recursos cuando sale el último usuario. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsAutoCreateStatistics El optimizador de consultas crea estadísticas de columna única, según sea necesario, para mejorar el rendimiento de las consultas. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsAutoCreateStatisticsIncremental Las estadísticas de columna única creadas automáticamente son incrementales siempre que sea posible. Válido para : SQL Server 2014 (12.x) y versiones posteriores.

1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsAutoShrink Los archivos de base de datos son candidatos para la reducción periódica automática. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsAutoUpdateStatistics Cuando una consulta usa estadísticas existentes potencialmente obsoletas, el optimizador de consultas actualiza dichas estadísticas. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsClone La base de datos es una copia de solo estadísticas y esquema de una base de datos de usuario creada con DBCC CLONEDATABASE. Vea este artículo de Soporte técnico de Microsoft para más información. Se aplica a: SQL Server 2014 (12.x) SP2 y versiones posteriores

1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsCloseCursorsOnCommitEnabled Cuando se confirme una transacción, se cerrarán todos los cursores abiertos. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsFulltextEnabled La base de datos está habilitada para la indización semántica y de texto completo. Válido para : SQL Server 2008 y versiones posteriores.



1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int

Nota: El valor de esta propiedad ya no tiene ningún efecto. En las bases de datos de usuario siempre está habilitada la búsqueda de texto completo. Una versión futura de SQL Server quitará esta propiedad. No use esta propiedad en nuevos trabajos de desarrollo, y modifique lo antes posible las aplicaciones que la usen actualmente.
IsInStandBy La base de datos está en línea como de solo lectura con el registro de restauración permitido. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsLocalCursorsDefault El valor predeterminado de las declaraciones de cursores es LOCAL. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsMemoryOptimizedElevateToSnapshotEnabled Se obtiene acceso a las tablas optimizadas para memoria mediante el aislamiento de SNAPSHOT cuando el valor de configuración de sesión TRANSACTION ISOLATION LEVEL se establece en READ COMMITTED, READ UNCOMMITTED o en un nivel de aislamiento inferior. Válido para : SQL Server 2014 (12.x) y versiones posteriores.



1: TRUE

0: FALSE

Tipo de datos base: int
IsMergePublished SQL Server admite la publicación de tablas de base de datos para la replicación de mezcla, en el caso de que la replicación esté instalada. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsNullConcat La concatenación con un operando NULL da como resultado NULL. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsNumericRoundAbortEnabled Se generan errores cuando se produce una pérdida de precisión en expresiones. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsParameterizationForced La opción de base de datos PARAMETERIZATION es FORCED por medio del comando SET. 1: TRUE

0: FALSE

NULL: Entrada no válida
IsQuotedIdentifiersEnabled Se pueden usar comillas dobles en los identificadores. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsPublished Si la replicación está instalada, SQL Server admite la publicación de tablas de base de datos para la replicación transaccional o de instantáneas. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsRecursiveTriggersEnabled Se habilita la activación recursiva de desencadenadores. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsSubscribed La base de datos está suscrita a una publicación. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsSyncWithBackup La base de datos es una base de datos publicada o una base de datos de distribución y admite una restauración que no interrumpirá la replicación transaccional. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsTornPageDetectionEnabled Motor de base de datos de SQL Server detecta operaciones de E/S incompletas debido a problemas con el suministro eléctrico u otros errores del sistema. 1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsVerifiedClone La base de datos es una copia de solo estadísticas y esquema de una base de datos de usuario, creada con la opción WITH VERIFY_CLONEDB de DBCC CLONEDATABASE. Vea este artículo de Soporte técnico de Microsoft para más información. Se aplica a: A partir de SQL Server 2016 (13.x) SP2.



1: TRUE

0: FALSE

NULL: Entrada no válida

Tipo de datos base: int
IsXTPSupported Indica si la base de datos es compatible con OLTP en memoria; es decir, si permite crear y usar tablas optimizadas para memoria y módulos compilados de forma nativa.

Específica de SQL Server:

IsXTPSupported es independiente de la existencia de algún grupo de archivos MEMORY_OPTIMIZED_DATA, necesario para crear objetos de OLTP en memoria.
Se aplica a: SQL Server (SQL Server 2016 (13.x) y versiones posteriores) y Azure SQL Database

1: TRUE

0: FALSE

NULL: Entrada no válida, error o no aplicable

Tipo de datos base: int
LastGoodCheckDbTime La fecha y hora de la última operación DBCC CHECKDB que se ejecutó correctamente en la base de datos especificada. 1 Si DBCC CHECKDB no se ha ejecutado en una base de datos, se devuelve 01-01-1900 00:00:00.000. Se aplica a: SQL Server 2016 (13.x) a partir de SP2.
SQL Server 2017 (14.x) a partir de CU9.
SQL Server 2019 (15.x) o una versión posterior
Azure SQL Database.

Un valor de fecha y hora

NULL: Entrada no válida

Tipo de datos base: datetime
LCID El identificador de configuración regional (LCID) de Windows para la intercalación. Valor de LCID (en formato decimal).

Tipo de datos base: int
MaxSizeInBytes Tamaño máximo de la base de datos (en bytes). Se aplica a: Azure SQL Database, Azure Synapse Analytics.

Azure SQL Database y Azure Synapse Analytics: el valor se basa en SLO, a menos que se haya adquirido almacenamiento adicional.

núcleo virtual: el valor está en incrementos de 1 GB hasta el tamaño máximo.

NULL: La base de datos no se ha iniciado.

Tipo de base de datos: bigint
Recuperación Modelo de recuperación de base de datos FULL: Modelo de recuperación completa

BULK_LOGGED: Modelo optimizado para cargas masivas de registros

SIMPLE: Modelo de recuperación simple

Tipo de datos base: nvarchar(128)
ServiceObjective Describe el nivel de rendimiento de la base de datos en SQL Database o Azure Synapse Analytics. Uno de los siguientes:

NULL = La base de datos no se ha iniciado

Compartido (para las ediciones Web o Business)

Básico

S0

S1

S2

S3

P1

P2

P3

ElasticPool

Sistema (para la base de datos maestra)

Tipo de datos base: nvarchar(32)
ServiceObjectiveId El identificador del objetivo del servicio en SQL Database. uniqueidentifier que identifica el objetivo del servicio.
SQLSortOrder Id. de orden de SQL Server compatible con versiones anteriores de SQL Server. 0: La base de datos usa intercalación de Windows

>0: Identificador de criterio de ordenación de SQL Server

NULL: Entrada no válida o la base de datos no se ha iniciado

Tipo de datos base: tinyint
Estado Estado de la base de datos. ONLINE: La base de datos está disponible para consultas.

Nota: La función puede devolver el estado ONLINE mientras se abre la base de datos y aún no se haya recuperado. Para saber si una base de datos ONLINE puede aceptar conexiones, consulte la propiedad Collation de DATABASEPROPERTYEX. La base de datos ONLINE puede aceptar conexiones cuando la intercalación de base de datos devuelve un valor distinto de NULL. En el caso de las bases de datos Always On, consulte las columnas database_state o database_state_desc de sys.dm_hadr_database_replica_states.

OFFLINE: La base de datos está explícitamente sin conexión.

RESTORING: Se ha iniciado la restauración de la base de datos.

RECOVERING: Se ha iniciado la recuperación de la base de datos, que aún no está lista para consultas.

SUSPECT: La base de datos no se ha recuperado.

EMERGENCY: La base de datos está en un estado de emergencia de solo lectura. El acceso se restringe a los miembros del rol sysadmin

Tipo de datos base: nvarchar(128)
Updateability Indica si los datos se pueden modificar. READ_ONLY: La base de datos admite lecturas de datos, pero no modificaciones de datos.

READ_WRITE: La base de datos admite lecturas y modificaciones de datos.

Tipo de datos base: nvarchar(128)
UserAccess Indica qué usuarios pueden tener acceso a la base de datos. SINGLE_USER: Solo un usuario db_owner, dbcreator o sysadmin a la vez

RESTRICTED_USER: Solo miembros de los roles db_owner, dbcreator o sysadmin

MULTI_USER: Todos los usuarios

Tipo de datos base: nvarchar(128)
Versión Número interno de versión del código de SQL Server con el que se creó la base de datos. Solamente se identifica con fines informativos. No se admite. La compatibilidad con versiones posteriores no está garantizada. Número de versión: La base de datos está abierta.

NULL: La base de datos no se ha iniciado.

Tipo de datos base: int

Nota

1 Para las bases de datos que forman parte de un grupo de disponibilidad, LastGoodCheckDbTime devolverá la fecha y hora de la última operación DBCC CHECKDB que se ejecutó correctamente en la réplica principal, con independencia de la réplica desde la que se ejecute el comando.

Tipos de valores devueltos

sql_variant

Excepciones

Devuelve NULL si se produce un error o si el autor de la llamada no tiene permiso para ver el objeto.

En SQL Server, un usuario solo puede ver los metadatos de elementos protegibles que posea o para los que se le haya concedido permiso. Esto significa que las funciones integradas de emisión de metadatos, como OBJECT_ID, podrían devolver NULL si el usuario no tiene permisos en el objeto. Vea Configuración de visibilidad de los metadatos para obtener más información.

Observaciones

DATABASEPROPERTYEX devuelve un único valor de propiedad cada vez. Para ver varios valores de propiedad, use la vista de catálogo sys.databases.

Ejemplos

A. Recuperar el estado de la opción de base de datos AUTO_SHRINK

Este ejemplo devuelve el estado de la opción de base de datos AUTO_SHRINK para la base de datos AdventureWorks.

SELECT DATABASEPROPERTYEX('AdventureWorks2014', 'IsAutoShrink');  

El conjunto de resultados es el siguiente: Esto indica que AUTO_SHRINK está desactivado.

------------------  
0  

B. Recuperar la intercalación predeterminada de una base de datos

Este ejemplo devuelve varios atributos de la base de datos AdventureWorks.

SELECT   
    DATABASEPROPERTYEX('AdventureWorks2014', 'Collation') AS Collation,  
    DATABASEPROPERTYEX('AdventureWorks2014', 'Edition') AS Edition,  
    DATABASEPROPERTYEX('AdventureWorks2014', 'ServiceObjective') AS ServiceObjective,  
    DATABASEPROPERTYEX('AdventureWorks2014', 'MaxSizeInBytes') AS MaxSizeInBytes  

El conjunto de resultados es el siguiente:

Collation                     Edition        ServiceObjective  MaxSizeInBytes  
----------------------------  -------------  ----------------  --------------  
SQL_Latin1_General_CP1_CI_AS  DataWarehouse  DW1000            5368709120  

C. Usar DATABASEPROPERTYEX para comprobar la conexión a la réplica

Al usar la característica de escalado horizontal de lectura de Azure SQL Database, puede ejecutar la siguiente consulta en el contexto de la base de datos para comprobar si está conectado a una réplica de solo lectura. Si está conectado a una réplica de solo lectura, se devolverá READ_ONLY. De este modo, también puede identificar cuándo se ejecuta una consulta en una réplica de solo lectura.

SELECT DATABASEPROPERTYEX(DB_NAME(), 'Updateability'); 

Consulte también

ALTER DATABASE (Transact-SQL)
Estados de base de datos
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)
SERVERPROPERTY (Transact-SQL)