LIST DATABASE DIRECTORY (commande)

La commande LIST DATABASE DIRECTORY répertorie le contenu du répertoire de base de données du système . Si un chemin est spécifié, le contenu du répertoire de base de données local est répertorié.

Etendue

Si cette commande est émise sans le paramètre ON path , le répertoire de base de données système est renvoyé. Ces informations sont identiques sur toutes les partitions de base de données.

Si le paramètre ON path est spécifié, le répertoire de base de données local de ce chemin est renvoyé. Ces informations ne sont pas identiques sur toutes les partitions de base de données.

Autorisation

Aucun

Connexion requise

Néant. Les opérations de répertoire affectent uniquement le répertoire local.

Syntaxe de la commande

Paramètres de commande

ON path | drive: Indique le répertoire de base de données local à partir duquel les informations doivent être répertoriées. S'il n'est pas spécifié, le contenu du répertoire de base de données système est répertorié. Notez que le nom d'instance est implicite dans le chemin. Ne pas spécifier le nom de l'instance dans le chemin d'accès.

Exemples

Voici un exemple de sortie pour un répertoire de base de données système:

     System Database Directory 
         
     Number of entries in the directory = 2
         
     Database 1 entry:          
       Database alias                       = SAMPLE     
       Database name                        = SAMPLE     
       Local database directory             = /home/smith     
       Database release level               = 8.00     
       Comment                              =     
       Directory entry type                 = Indirect     
       Catalog database partition number    = 0      
       Alternate server hostname            = montero
       Alternate server port number         = 29384
   
     Database 2 entry:          
       Database alias                       = TC004000
       Database name                        = TC004000
       Node name                            = PRINODE
       Database release level               = a.00
       Comment                              =
       Directory entry type                 = LDAP
       Catalog database partition number    = -1
       Gateway node name                    = PRIGW
       Alternate server node name           = 
       Alternate server gateway node name   = ALTGW

Voici un exemple de sortie pour un répertoire de base de données local:

     Local Database Directory on /u/smith

     Number of entries in the directory = 1

     Database 1 entry:

       Database alias                      = SAMPLE
       Database name                       = SAMPLE
       Database directory                  = SQL00001
       Database release level              = 8.00
       Comment                             =
       Directory entry type                = Home
       Catalog database partition number   = 0    
       Database partition number           = 0

Ces zones sont identifiées comme suit:

Database alias

Valeur du paramètre alias lors de la création ou du catalogage de la base de données. Si aucun alias n'a été entré lors du catalogage de la base de données, le gestionnaire de base de données utilise la valeur du paramètre database-name lors du catalogage de la base de données.

Database name

Valeur du paramètre database-name lors du catalogage de la base de données. Il s'agit généralement du nom sous lequel la base de données a été créée.

Local database directory

Chemin d'accès à la base de données. Ce champ n'est rempli que si le répertoire de la base de données du système a été analysé.

Database directory

Le nom du répertoire dans lequel la base de données existe. Ce champ n'est rempli que si le répertoire de la base de données locale a été analysé.

Node name

Nom du noeud distant. Ce nom correspond à la valeur entrée pour le paramètre nodename lorsque la base de données et le noeud ont été catalogués.

Database release level

Niveau d'édition du gestionnaire de base de données pouvant fonctionner sur la base de données.

Comment

Tous les commentaires associés à la base de données qui ont été entrés lors de son catalogage.

Directory entry type

Emplacement de la base de données:

Une entrée à distance décrit une base de données située sur un autre nœud.
Une entrée indirecte décrit une base de données locale. Les bases de données qui existent sur le même nœud que le répertoire de la base de données du système sont considérées comme faisant indirectement référence à l'entrée d'origine (vers un répertoire de base de données local ) et sont considérées comme des entrées indirectes.
Une entrée Accueil indique que le répertoire de base de données se trouve dans le même chemin que le répertoire de base de données local.
Une entrée LDAP indique que les informations d'emplacement de la base de données sont stockées sur un serveur LDAP.

Toutes les entrées du répertoire système des bases de données sont distantes ou indirectes. Toutes les entrées des répertoires de bases de données locales sont identifiées dans lerépertoire système des bases de données en tant qu'entrées indirectes.

Authentication

Type d'authentification catalogué sur le client.

Principal name

Indique un nom de principal Kerberos qualifié complet.

Catalog database partition number

Indique le noeud correspondant à la partition de base de données de catalogue. Cette partition est la partition de la base de données sur laquelle la commande CREATE DATABASE a été émise.

Database partition number

Indique le numéro affecté dans db2nodes.cfg au noeud sur lequel la commande a été émise.

Alternate server hostname

Spécifie le nom d'hôte ou l'adresse IP du serveur alternatif à utiliser en cas d'échec de la communication avec la base de données. Cette zone s'affiche uniquement pour le répertoire système des bases de données.

Alternate server port number

Spécifie le numéro de port du serveur alternatif à utiliser en cas d'échec de la communication avec la base de données. Cette zone s'affiche uniquement pour le répertoire système des bases de données.

Alternate server node name

Si le type d'entrée d'annuaire est LDAP, ce champ indique le nom du nœud du serveur alternatif à utiliser en cas d'échec de la communication avec la base de données.

Alternate server gateway node name

Si le type d'entrée de l'annuaire est LDAP, ce champ indique le nom du nœud de la passerelle à utiliser en cas d'échec de la communication avec la base de données.

Notes d'utilisation

Quel que soit le paramètre de variable DB2LDAPCACHE , si vous utilisez la commande LIST DATABASE DIRECTORY ou LIST NODE DIRECTORY , la liste des entrées de base de données et de noeud locales est lue à partir du serveur LDAP.

Il peut y avoir jusqu'à huit analyses de répertoire de base de données ouvertes par processus. Pour contourner cette restriction pour un fichier de traitement par lots qui émet plus de huit commandes LIST DATABASE DIRECTORY dans une même session Db2® , convertissez le fichier de traitement par lots en un script shell. Le préfixe "db2" génère une nouvelle session Db2 pour chaque commande.