Fonctions de métadonnées (Transact-SQL)

S’applique à :SQL ServerAzure SQL Managed Instance

Cet article décrit les fonctions scalaires qui retournent des informations sur la base de données et les objets de base de données.

Toutes les fonctions de métadonnées ne sont pas déterministes. Ils ne retournent pas toujours les mêmes résultats chaque fois qu’ils sont appelés, même avec le même ensemble de valeurs d’entrée.

Métadonnées de contexte de serveur, de base de données, de session et de principal

Découvrez où vous exécutez (instance et base de données) et qui vous exécutez en tant qu’application cliente, principal de base de données. Utilisez ces informations pour les scripts et diagnostics prenant en charge l’environnement.

Fonction	Descriptif
SERVERPROPERTY	Retourne les propriétés de l’instance SQL Server, telles que l’édition, le classement ou le niveau de produit.
DB_ID	Retourne l’ID d’une base de données.
DB_NAME	Retourne le nom d’une base de données en fonction de l’ID.
DATABASEPROPERTYEX	Retourne des valeurs de propriété au niveau de la base de données, telles que le classement et l’état.
ORIGINAL_DB_NAME	Retourne le nom de la base de données d’origine avant une séquence de restauration.
APP_NAME	Retourne le nom de l’application pour la session active.
DATABASE_PRINCIPAL_ID	Retourne l’ID de principal d’un principal de sécurité de base de données.
VERSION	Retourne la chaîne de version pour Azure Synapse Analytics and Analytics Platform System (PDW).

¹S’applique uniquement à : Azure Synapse Analytics and Analytics Platform System (PDW)

Identification de l’objet et résolution de noms

Résolvez les ID en noms entre les objets et les schémas, et analysez des identificateurs multipart. Ces fonctions fournissent une prise en charge principale de l’introspection et de sql dynamique.

Fonction	Descriptif
OBJECT_ID	Retourne l’ID d’un objet délimité par un schéma.
OBJECT_NAME	Retourne le nom de l’objet d’un ID d’objet.
OBJECT_SCHEMA_NAME	Retourne le nom de schéma d’un objet.
SCHEMA_ID	Retourne l’ID d’un schéma.
SCHEMA_NAME	Retourne le nom d’un schéma par ID.
PARSENAME	Retourne une partie d’un nom d’objet multipart (serveur, base de données, schéma, objet).
@@PROCID	Retourne l’ID de la procédure stockée en cours d’exécution.

Fonctionnalités d’objet et métadonnées de programmabilité

Examinez ce qu’est un objet, comment il se comporte et comment il est implémenté. Cette inspection inclut la définition et les propriétés, ainsi que les métadonnées d’assembly CLR.

Fonction	Descriptif
OBJECT_DEFINITION	Retourne la définition (texte source) d’objets programmables.
OBJECTPROPERTY	Retourne une propriété pour un objet (par exemple, s’il s’agit d’une vue, d’une table, etc.).
OBJECTPROPERTYEX	Retourne les informations de propriété d’objet étendue.
ASSEMBLYPROPERTY	Retourne une valeur de propriété spécifiée d’un assembly SQL CLR.

Métadonnées du modèle de données (types et colonnes)

Comprendre l’identité de type et les propriétés, ainsi que l’identité et les propriétés de colonne. Utilisez ces métadonnées pour la validation de schéma, la génération de code, ETL et les vérifications de compatibilité.

Fonction	Descriptif
TYPE_ID	Retourne l’ID d’un type de données.
TYPE_NAME	Retourne un nom de type de données par ID.
TYPEPROPERTY	Retourne une propriété d’un type de données, telle que la précision ou la valeur Nullable.
COL_NAME	Retourne le nom de colonne d’un ID de colonne donné.
COL_LENGTH	Retourne la longueur d’une colonne en octets.
COLUMNPROPERTY	Retourne une propriété d’une colonne, par exemple s’il s’agit d’une identité ou d’une colonne calculée.

Métadonnées de chemin d’accès (index et statistiques)

Inspectez les structures d’indexation et l’actualisation des statistiques. Utilisez ces métadonnées dans le paramétrage des flux de travail et la maintenance pilotée par les métadonnées.

Fonction	Descriptif
INDEX_COL	Retourne le nom d’une colonne indexée.
INDEXKEY_PROPERTY	Retourne une propriété d’une clé d’index.
INDEXPROPERTY	Retourne une propriété d’un index, tel que cluster ou désactivé.
STATS_DATE	Retourne les statistiques de date qui ont été mises à jour pour une table ou un index.

Stockage physique et métadonnées de texte intégral

Inspectez la disposition physique (fichiers et groupes de fichiers) et les composants de texte intégral. Utilisez ces informations pour la gestion du stockage, la résolution des problèmes et l’audit de configuration.

Fonction	Descriptif
FILE_ID	Retourne l’ID de fichier.
FILE_IDEX	Retourne l’ID de fichier en fonction du nom de fichier.
FILE_NAME	Retourne le nom de fichier d’un ID de fichier.
FILEGROUP_ID	Retourne l’ID d’un groupe de fichiers.
FILEGROUP_NAME	Retourne le nom d’un groupe de fichiers.
FILEGROUPPROPERTY	Retourne une propriété d’un groupe de fichiers.
FILEPROPERTY	Retourne une propriété de fichier, telle que la taille ou l’état.
FULLTEXTCATALOGPROPERTY	Renvoie une propriété d’un catalogue de texte intégral.
FULLTEXTSERVICEPROPERTY	Retourne les propriétés du service de recherche en texte intégral, telles que l’état de chargement.

Coordination du runtime et métadonnées de valeur générées

Coordonnez le travail entre les sessions à l’aide de verrous d’application. Récupérez les valeurs numériques générées pour les objets d’identité et de séquence.

Fonction	Descriptif
APPLOCK_MODE	Retourne le mode de verrouillage conservé par la session active.
APPLOCK_TEST	Teste si un verrou peut être acquis sans l’acquérir réellement.
SCOPE_IDENTITY	Retourne la dernière valeur d’identité générée dans l’étendue actuelle.
NEXT VALUE FOR	Retourne la valeur suivante dans un objet séquence.