Aller au contenu

Service SQL IBM i (AS/400) · Fonction table

QSYS2.MIRROR_COMPARE_OBJECT

Comparer un objet entre les nœuds Mirror

Fonction Db2 Mirror qui liste les attributs d'un objet dont la valeur diffère entre le système principal et le système secondaire.

À quoi ça sert

Cette fonction de table compare un objet précis entre les deux nœuds d'une paire Db2 Mirror for i. Elle renvoie, pour chaque attribut, son nom (ATTRIBUTE_NAME), sa valeur sur le système principal (VALUE_ON_PRIMARY) et sur le système secondaire (VALUE_ON_SECONDARY). Elle ne sert qu'avec Db2 Mirror for i (option 48 de 5770SS1), configuré.

On désigne l'objet avec OBJECT_TYPE, LIBRARY_NAME et OBJECT_NAME, et on choisit ce qui est comparé avec COMPARE_ATTRIBUTES et COMPARE_DATA. Le SQL permet de trier ou de filtrer les écarts, ce que ne fait pas un simple affichage.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * FROM TABLE(QSYS2.MIRROR_COMPARE_OBJECT(OBJECT_TYPE => '*OUTQ',                       
                                                    LIBRARY_NAME => 'APPLIB1',                    
                                                    OBJECT_NAME => 'MYOUTQ',                      
                                                    COMPARE_ATTRIBUTES => 'YES',                  
                                                    COMPARE_DATA => 'NO'))                        
     ORDER BY ATTRIBUTE_NAME

Db2 Mirror for i n'est pas installé sur notre IBM i de test : ce service n'a rien à montrer.

L'exemple d'IBM

Lister tous les attributs réplicables qui diffèrent entre les deux nœuds pour la file d'attente de sortie MYOUTQ de la bibliothèque APPLIB1.

-- Description: List all the replication-eligible attributes that are different                    
-- between the two nodes for output queue MYOUTQ in library APPLIB1.                                
    SELECT * FROM TABLE(QSYS2.MIRROR_COMPARE_OBJECT(OBJECT_TYPE => '*OUTQ',                       
                                                    LIBRARY_NAME => 'APPLIB1',                    
                                                    OBJECT_NAME => 'MYOUTQ',                      
                                                    COMPARE_ATTRIBUTES => 'YES',                  
                                                    COMPARE_DATA => 'NO'))                        
     ORDER BY ATTRIBUTE_NAME;

Paramètres

ParamètreTypePar défautSignification
OBJECT_TYPE VARCHAR(8) obligatoire Type de l'objet
LIBRARY_NAME VARCHAR(10) NULL Nom de la bibliothèque
OBJECT_NAME VARCHAR(128) NULL Nom de l'objet
COMPARE_ATTRIBUTES VARCHAR(5) NULL Comparaison des attributs
COMPARE_DATA VARCHAR(5) NULL Comparaison des données
PARALLEL_DEGREE VARCHAR(4) NULL Degré de parallélisme

Colonnes renvoyées (3)

Afficher les 3 colonnes
ColonneTypeSignification
ATTRIBUTE_NAME GRAPHIC VARYING Nom de l'attribut
VALUE_ON_PRIMARY GRAPHIC VARYING Valeur sur le système principal
VALUE_ON_SECONDARY GRAPHIC VARYING Valeur sur le système secondaire