Aller au contenu

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

QSYS2.INSPECT_REPLICATION_CRITERIA

Règles de réplication applicables à un objet

Liste les règles de critères de réplication actives qui déterminent l'état d'inclusion d'un objet, avec Db2 Mirror for i.

À quoi ça sert

Ce service concerne Db2 Mirror for i (option 48 de 5770SS1) : il n'est utile que si ce produit est configuré. Les critères de réplication déterminent quels objets d'une bibliothèque sont répliqués entre les deux nœuds du miroir ; plusieurs règles peuvent s'appliquer au même objet.

La fonction de table accepte des paramètres de filtrage : IASP_NAME, LIBRARY_NAME, OBJECT_TYPE, OBJECT_NAME, APPLY_STATE et APPLY_LABEL. Elle renvoie les règles qui concernent l'objet visé, avec leur identifiant, leur état d'application, leur état d'inclusion, leur ordre de préséance, leur source, et si elles sont amovibles ou restreintes.

Elle sert à comprendre pourquoi un objet est ou n'est pas répliqué. L'exemple d'IBM liste toutes les règles actives qui déterminent l'état d'inclusion de la table MYTABLE de la bibliothèque APPLIB1.

Résultat réel sur un IBM i 7.5

Ce que nous avons exécuté :

SELECT * FROM TABLE(QSYS2.INSPECT_REPLICATION_CRITERIA(IASP_NAME    => '*SYSBAS',             
                                                           LIBRARY_NAME => 'APPLIB1',             
                                                           OBJECT_TYPE  => '*FILE',               
                                                           OBJECT_NAME  => 'MYTABLE'))            
     ORDER BY PRECEDENCE_ORDER

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 toutes les règles de critères de réplication actives qui déterminent l'état d'inclusion de la table MYTABLE dans la bibliothèque APPLIB1.

-- Description: List all the active replication criteria rules that are used                       
-- to determine the inclusion state for table MYTABLE in library APPLIB1.                           
    SELECT * FROM TABLE(QSYS2.INSPECT_REPLICATION_CRITERIA(IASP_NAME    => '*SYSBAS',             
                                                           LIBRARY_NAME => 'APPLIB1',             
                                                           OBJECT_TYPE  => '*FILE',               
                                                           OBJECT_NAME  => 'MYTABLE'))            
     ORDER BY PRECEDENCE_ORDER;

Paramètres

ParamètreTypePar défautSignification
IASP_NAME VARCHAR(10) obligatoire Nom de l'ASP indépendant
LIBRARY_NAME VARCHAR(10) obligatoire Nom de la bibliothèque
OBJECT_TYPE VARCHAR(8) obligatoire Type de l'objet
OBJECT_NAME VARCHAR(128) NULL Nom de l'objet
APPLY_STATE VARCHAR(7) NULL État d'application
APPLY_LABEL VARCHAR(26) NULL Libellé d'application

Colonnes renvoyées (12)

Afficher les 12 colonnes
ColonneTypeSignification
RULE_IDENTIFIER BIGINT Identifiant de la règle
APPLY_STATE VARCHAR(14) État d'application
INCLUSION_STATE VARCHAR(10) État d'inclusion
PRECEDENCE_ORDER SMALLINT Ordre de priorité
APPLY_LABEL VARCHAR(26) Libellé d'application
IASP_NAME VARCHAR(10) Nom de l'ASP indépendant
LIBRARY_NAME VARCHAR(10) Nom de la bibliothèque
OBJECT_TYPE VARCHAR(8) Type de l'objet
OBJECT_NAME VARCHAR(128) Nom de l'objet
RULE_SOURCE VARCHAR(6) Source de la règle
REMOVABLE VARCHAR(3) Amovible
RESTRICTED VARCHAR(3) Restreint