DATABASEPROPERTYEX (Transact-SQL)

Actualizado: 17 de julio de 2006

Devuelve la configuración actual de una opción o propiedad de base de datos especificada.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

DATABASEPROPERTYEX ( database , property )

Argumentos

  • database
    Es una expresión que representa el nombre de la base de datos para la que se devuelve la información de la propiedad con nombre. database es de tipo nvarchar(128).
  • property
    Es una expresión que representa el nombre de la propiedad de base de datos que se va a devolver. property es de tipo varchar(128) y puede tener uno de los siguientes valores. El tipo devuelto es sql_variant. En la siguiente tabla se muestra el tipo de datos base para cada valor de propiedad.

    [!NOTA] Si no se inicia la base de datos, las propiedades que el SQL Server 2005 Database Engine (Motor de base de datos de SQL Server 2005) de Microsoft recupera mediante acceso directo a la base de datos en lugar de obtener el valor de los metadatos devolverán NULL. Es decir, si la base de datos tiene AUTO_CLOSE establecido en ON o si la base de datos está desconectada.

    Propiedad

Tipos de valor 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 2005, un usuario sólo puede ver los metadatos de asegurables 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, pueden devolver NULL si el usuario no tiene ningún permiso para el objeto. Para obtener más información, vea Configuración de visibilidad de los metadatos y Solucionar problemas de visibilidad de los metadatos.

Notas

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

Ejemplos

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

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

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

Éste es el conjunto de resultados. Esto indica que AUTO_SHRINK está desactivado.

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

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

Este ejemplo devuelve el nombre de la intercalación predeterminada de la base de datos AdventureWorks.

SELECT DATABASEPROPERTYEX('AdventureWorks', 'Collation');

Éste es el conjunto de resultados.

------------------------------
SQL_Latin1_General_CP1_CI_AI

Vea también

Referencia

ALTER DATABASE (Transact-SQL)
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)

Otros recursos

Estados de base de datos
Configurar las opciones de la base de datos
Usar datos sql_variant

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión Historial

17 de julio de 2006

Contenido nuevo:
  • Se ha agregado la sección Excepciones.

14 de abril de 2006

Contenido modificado:
  • Se han corregido y ampliado las descripciones de ComparisonStyle y LCID.