Funciones de metadatos (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed Instance

En este artículo se describen las funciones escalares que devuelven información sobre la base de datos y los objetos de base de datos.

Todas las funciones de metadatos no son deterministas. No siempre devuelven los mismos resultados cada vez que se les llama, incluso con el mismo conjunto de valores de entrada.

Metadatos de contexto de servidor, base de datos, sesión y entidad de seguridad

Averigüe dónde se está ejecutando (instancia y base de datos) y quién está ejecutando como o a través de (aplicación cliente, entidad de seguridad de base de datos). Use esta información para los scripts y diagnósticos compatibles con el entorno.

Función	Description
SERVERPROPERTY	Devuelve propiedades de la instancia de SQL Server, como edición, intercalación o nivel de producto.
DB_ID	Devuelve el identificador de una base de datos.
DB_NAME	Devuelve el nombre de una base de datos según el identificador.
DATABASEPROPERTYEX	Devuelve valores de propiedad de nivel de base de datos, como intercalación y estado.
ORIGINAL_DB_NAME	Devuelve el nombre de la base de datos original antes de una secuencia de restauración.
APP_NAME	Devuelve el nombre de la aplicación para la sesión actual.
DATABASE_PRINCIPAL_ID	Devuelve el identificador de entidad de seguridad de una base de datos.
VERSION	Devuelve la cadena de versión de Azure Synapse Analytics and Analytics Platform System (PDW).

¹Solo se aplica a: Azure Synapse Analytics and Analytics Platform System (PDW)

Identificación de objetos y resolución de nombres

Resuelva los identificadores en nombres entre objetos y esquemas y analice los identificadores de varias partes. Estas funciones proporcionan compatibilidad básica para la introspección y SQL dinámico.

Función	Description
OBJECT_ID	Devuelve el identificador de un objeto con ámbito de esquema.
OBJECT_NAME	Devuelve el nombre de objeto de un identificador de objeto.
OBJECT_SCHEMA_NAME	Devuelve el nombre de esquema de un objeto .
SCHEMA_ID	Devuelve el identificador de un esquema.
SCHEMA_NAME	Devuelve el nombre de un esquema por identificador.
PARSENAME	Devuelve una parte de un nombre de objeto de varias partes (servidor, base de datos, esquema, objeto).
@@PROCID	Devuelve el identificador del procedimiento almacenado que se está ejecutando actualmente.

Funcionalidades de objetos y metadatos de programación

Inspeccione qué es un objeto, cómo se comporta y cómo se implementa. Esta inspección incluye la definición y las propiedades, y los metadatos del ensamblado CLR.

Función	Description
OBJECT_DEFINITION	Devuelve la definición (texto de origen) de objetos programables.
OBJECTPROPERTY	Devuelve una propiedad para un objeto (por ejemplo, si es una vista, una tabla, etc.).
OBJECTPROPERTYEX	Devuelve información de propiedad de objeto extendida.
ASSEMBLYPROPERTY	Devuelve un valor de propiedad especificado de un ensamblado CLR de SQL.

Metadatos del modelo de datos (tipos y columnas)

Comprenda la identidad y las propiedades de tipo, así como la identidad y las propiedades de columna. Use estos metadatos para la validación de esquemas, la generación de código, ETL y las comprobaciones de compatibilidad.

Función	Description
TYPE_ID	Devuelve el identificador de un tipo de datos.
TYPE_NAME	Devuelve un nombre de tipo de datos por identificador.
TYPEPROPERTY	Devuelve una propiedad de un tipo de datos, como precisión o que acepta valores NULL.
COL_NAME	Devuelve el nombre de columna de un identificador de columna determinado.
COL_LENGTH	Devuelve la longitud de una columna en bytes.
COLUMNPROPERTY	Devuelve una propiedad de una columna, como si es una identidad o una columna calculada.

Metadatos de ruta de acceso (índices y estadísticas)

Inspeccione las estructuras de indexación y la actualización de estadísticas. Use estos metadatos en el ajuste de flujos de trabajo y el mantenimiento controlado por metadatos.

Función	Description
INDEX_COL	Devuelve el nombre de una columna indizada.
INDEXKEY_PROPERTY	Devuelve una propiedad de una clave de índice.
INDEXPROPERTY	Devuelve una propiedad de un índice, como agrupado o deshabilitado.
STATS_DATE	Devuelve las estadísticas de fecha que se actualizaron por última vez para una tabla o índice.

Almacenamiento físico y metadatos de texto completo

Inspeccione el diseño físico (archivos y grupos de archivos) y los componentes de texto completo. Use esta información para la administración de almacenamiento, la solución de problemas y la auditoría de configuración.

Función	Description
FILE_ID	Devuelve el identificador de archivo.
FILE_IDEX	Devuelve el identificador de archivo basado en el nombre de archivo.
FILE_NAME	Devuelve el nombre de archivo de un identificador de archivo.
FILEGROUP_ID	Devuelve el identificador de un grupo de archivos.
FILEGROUP_NAME	Devuelve el nombre de un grupo de archivos.
FILEGROUPPROPERTY	Devuelve una propiedad de un grupo de archivos.
FILEPROPERTY	Devuelve una propiedad de archivo, como el tamaño o el estado.
FULLTEXTCATALOGPROPERTY	Devuelve una propiedad de un catálogo de texto completo.
FULLTEXTSERVICEPROPERTY	Devuelve las propiedades del servicio de texto completo, como el estado de carga.

Coordinación en tiempo de ejecución y metadatos de valor generados

Coordinar el trabajo entre sesiones mediante bloqueos de aplicación. Recupere los valores numéricos generados para los objetos de identidad y secuencia.

Función	Description
APPLOCK_MODE	Devuelve el modo de bloqueo mantenido por la sesión actual.
APPLOCK_TEST	Comprueba si se puede adquirir un bloqueo sin adquirirlo realmente.
SCOPE_IDENTITY	Devuelve el último valor de identidad generado en el ámbito actual.
NEXT VALUE FOR	Devuelve el siguiente valor de un objeto de secuencia.