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ètre | Type | Par défaut | Signification |
|---|---|---|---|
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
| Colonne | Type | Signification |
|---|---|---|
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 |