commande .show database

Changer de service à l’aide de la liste déroulante Version . En savoir plus sur la navigation.
S’applique à : ✅ Microsoft Fabric ✅ Azure Data Explorer

Retourne une table montrant les propriétés de la base de données contextuelle.

Pour renvoyer une table dans laquelle chaque enregistrement correspond à une base de données du cluster auquel l’utilisateur a accès, consultez .show databases.

Pour renvoyer une table dans laquelle chaque enregistrement correspond à une base de données dans la maison d’événements auquel l’utilisateur a accès, consultez .show databases.

autorisations

Vous devez disposer au moins des autorisations Utilisateur de base de données, Visionneuse de base de données ou Moniteur de base de données pour exécuter cette commande. Pour plus d’informations, consultez Contrôle d’accès en fonction du rôle.

Syntaxe

.show database[details | identity | policies | datastats]

L’appel par défaut sans aucune option spécifiée est égal à l’option « identité ».

En savoir plus sur les conventions de syntaxe.

Retours

Cette commande retourne une table avec les colonnes suivantes pour chaque option :

Sortie de l’option identity

Paramètre de sortie Type Description
nom_base_de_données string Nom de la base de données. Les noms de base de données respectent la casse.
Stockagepersistant string URI de stockage persistant dans lequel la base de données est stockée. (Ce champ est vide pour les bases de données éphémères.)
Version string Numéro de version de la base de données. Ce nombre est mis à jour pour chaque opération de modification dans la base de données (par exemple, l’ajout de données et la modification du schéma).
IsCurrent bool True si la base de données est celle vers laquelle pointe la connexion actuelle.
DatabaseAccessMode string Mode d’accès à la base de données. Par exemple, si le mode d’accès à la base de données est ReadOnly, toutes les demandes de modification de la base de données échouent.
PrettyName string Nom de la base de données.
CurrentUserIsUnrestrictedViewer bool Spécifie si l’utilisateur actuel est une visionneuse illimitée sur la base de données.
DatabaseId guid ID unique de la base de données.
InTransitionTo string Décrit la base de données dans un état de transition. Par exemple, modification du mode d’accès, détachement de la base de données, modification de l’emplacement physique de la base de données, modification des clés de stockage ou modification du nom de la base de données.
SuspensionState string Lorsque la base de données a été suspendue et la raison de la suspension.

Sortie de l’option details

Paramètre de sortie Type Description
nom_base_de_données string Nom de la base de données. Les noms de base de données respectent la casse.
Stockagepersistant string URI de stockage persistant dans lequel la base de données est stockée. (Ce champ est vide pour les bases de données éphémères.)
Version string Numéro de version de la base de données. Ce nombre est mis à jour pour chaque opération de modification dans la base de données (par exemple, l’ajout de données et la modification du schéma).
IsCurrent bool True si la base de données est celle vers laquelle pointe la connexion actuelle.
DatabaseAccessMode string Comment la base de données est attachée. Par exemple, si la base de données est attachée en mode ReadOnly, toutes les demandes de modification de la base de données de quelque manière que ce soit échouent. Les options incluent ReadWrite, , ReadOnlyReadOnlyFollowingou ReadWriteEphemeral.
PrettyName string Nom de la base de données, le cas échéant.
AuthorizedPrincipals string Collection de principaux autorisés pour la base de données, sérialisée au format JSON.
RetentionPolicy string Stratégie de rétention de base de données sérialisée au format JSON.
MergePolicy string Stratégie de fusion des étendues de base de données, sérialisée au format JSON.
CachingPolicy string Stratégie de mise en cache de base de données sérialisée au format JSON.
ShardingPolicy string Stratégie de partitionnement de base de données sérialisée au format JSON.
StreamingIngestionPolicy string Stratégie d’ingestion de streaming de base de données, sérialisée au format JSON.
IngestionBatchingPolicy string Stratégie d’ingestion de base de données Par lot, sérialisée au format JSON.
TotalSize real La taille totale de la base de données est en octets.
DatabaseId guid ID unique de la base de données.
InTransitionTo string Décrit la base de données dans un état de transition. Par exemple, modification du mode d’accès, détachement de la base de données, modification de l’emplacement physique de la base de données, modification des clés de stockage ou modification du nom de la base de données.
NumberOfTables int Nombre de tables dans la base de données.
NumberOfExternalTables int Nombre de tables externes.
NumberOfMaterializedViews int Nombre de vues matérialisées.
EncryptionScope int Étendue de chiffrement.
SuspensionState string Lorsque la base de données a été suspendue et la raison.

Sortie de l’option policies

Paramètre de sortie Type Description
nom_base_de_données string Nom de la base de données. Les noms de base de données respectent la casse.
Stockagepersistant string URI de stockage persistant dans lequel la base de données est stockée. (Ce champ est vide pour les bases de données éphémères.)
Version string Numéro de version de la base de données. Ce nombre est mis à jour pour chaque opération de modification dans la base de données (par exemple, l’ajout de données et la modification du schéma).
IsCurrent bool True si la base de données est celle vers laquelle pointe la connexion actuelle.
DatabaseAccessMode string Comment la base de données est attachée. Par exemple, si la base de données est attachée en mode ReadOnly, toutes les demandes de modification de la base de données échouent de quelque manière que ce soit. Les options incluent ReadWrite, , ReadOnlyReadOnlyFollowingou ReadWriteEphemeral.
PrettyName string Nom de la base de données, le cas échéant.
DatabaseId guid ID unique de la base de données.
AuthorizedPrincipals string Collection de principaux autorisés pour la base de données, sérialisée au format JSON.
RetentionPolicy string Stratégie de rétention de base de données sérialisée au format JSON.
MergePolicy string Stratégie de fusion des étendues de base de données, sérialisée au format JSON.
CachingPolicy string Stratégie de mise en cache de base de données sérialisée au format JSON.
ShardingPolicy string Stratégie de partitionnement de base de données sérialisée au format JSON.
StreamingIngestionPolicy string Stratégie d’ingestion de streaming de base de données, sérialisée au format JSON.
IngestionBatchingPolicy string Stratégie d’ingestion de base de données Par lot, sérialisée au format JSON.

Sortie de l’option datastats

Paramètre de sortie Type Description
nom_base_de_données string Nom de la base de données. Les noms de base de données respectent la casse.
Stockagepersistant string URI de stockage persistant dans lequel la base de données est stockée. (Ce champ est vide pour les bases de données éphémères.)
Version string Numéro de version de la base de données. Ce nombre est mis à jour pour chaque opération de modification dans la base de données (par exemple, l’ajout de données et la modification du schéma).
IsCurrent bool True si la base de données est celle vers laquelle pointe la connexion actuelle.
DatabaseAccessMode string Comment la base de données est attachée. Par exemple, si la base de données est attachée en mode ReadOnly, toutes les demandes de modification de la base de données échouent de quelque manière que ce soit. Les options incluent ReadWrite, , ReadOnlyReadOnlyFollowingou ReadWriteEphemeral.
PrettyName string Nom de la base de données, le cas échéant.
DatabaseId guid ID unique de la base de données.
OriginalSize real La taille* d’origine totale de la base de données est étendue.
ExtentSize real La taille totale des étendues de base de données (données + index)*.
CompressedSize real La taille* totale des données compressées dans la base de données est étendue.
IndexSize real La taille* totale de l’index de la base de données est étendue.
RowCount long Nombre total de lignes* dans l’étendue de la base de données.
HotOriginalSize real La taille* d’origine totale de la base de données est élevée.
HotExtentSize real Taille totale des étendues à chaud de la base de données (données + index)*.
HotCompressedSize real La taille* totale des données compressées dans la base de données est élevée.
HotIndexSize real La taille* totale de l’index de la base de données est élevée.
HotRowCount long Nombre total de lignes* dans les étendues chaudes de la base de données.
TotalExtents long Étendues totales* de la base de données.
HotExtents long Étendues chaudes totales* de la base de données.

* Les valeurs peuvent avoir jusqu’à 15 minutes, car elles sont extraites d’un résumé mis en cache des étendues de base de données.

Exemples

Afficher l’identité de la base de données

L’exemple suivant montre les propriétés associées à l’identité de base de données actuelle.

Exécuter la requête

.show database identity

Sortie

nom_base_de_données Stockagepersistant Version IsCurrent DatabaseAccessMode PrettyName CurrentUserIsUnrestrictedViewer DatabaseId InTransitionTo
SampleLogs https://storagelocation01/abcdefg1234567 v252.0 true Lecture/écriture false a1b2c3-1234-d4e5f7-8901234abc

Afficher les stratégies de base de données

L’exemple suivant montre les stratégies de base de données actuelles.

Exécuter la requête

.show database policies
nom_base_de_données Stockagepersistant Version IsCurrent DatabaseAccessMode PrettyName DatabaseId AuthorizedPrincipals RetentionPolicy MergePolicy CachingPolicy ShardingPolicy StreamingIngestionPolicy IngestionBatchingPolicy
SampleLogs https://storagelocation01/abcdefg1234567 v252.0 true Lecture/écriture a1b2c3-1234-d4e5f7-8901234ab [{ « Role » : « Admin », « PrincipalName » : « 1234abcd-ef56-789-0123456e » « PrincipalType » : « AadUser"}, { « Role » : « Admin », « PrincipalName » : « fghi1234-5678-9j12-3456 », « PrincipalType » : « AadUser"}, { « Role » : « User », « PrincipalName » : « kl1234-1234-56m7-89012 », « PrincipalType » : « AadApplication"}, { « Role » : « User », « PrincipalName » : « fghi1234-5678-9j12-3456 » « PrincipalType » : « AadApplication } , { « Role » : « Ingestor », « PrincipalName » : « fghi1234-5678-9j12-3456 », « PrincipalType » : « AadApplication » }, { » Role » : « Viewer », « PrincipalName » : « #everyone# », « PrincipalType » : « AadUser » }, {"Role » : « Viewer », « PrincipalName » : « #everyone# », « PrincipalType » : « MsaUser » }, { « Role » : « Admin » « PrincipalName » :"nop1234-1234-56qr-7890 », « PrincipalType » : « AadUser"}, { « Role » : « User », « PrincipalName » : « nop1234-1234-56qr-7890 », « PrincipalType » : « AadUser » }, { « Role » : « Viewer », « PrincipalName » : « nop1234-1234-56qr-7890 »,"PrincipalType » : « AadApplication"}, {"Role » : « Ingestor », « PrincipalName » : » nop1234-1234-56qr-7890 », « PrincipalType » : « AadApplication"}] null { « RowCountUpperBoundForMerge » : 160000000, « OriginalSizeMBUpperBoundForMerge » : 30000, « MaxExtentsToMerge » : 100, « MaxRangeInHours » : 24, « AllowRebuild » : true, « AllowMerge » : true, « Lookback » : { « Kind » : 0,"CustomPeriod » : null }, « Origin » : 2 } null {"MaxRowCount » : 750000, « MaxExtentSizeInMb » : 1024, « MaxOriginalSizeInMb » : 2048, « UseShardEngine » : true, « ShardEngineMaxRowCount » : 1048576, « ShardEngineMaxExtentSizeInMb » : 8192, « ShardEngineMaxOriginalSizeInMb » : 3072} null null
  • Last updated on