[On-Premise/hybride uniquement]{class="badge yellow" title="S’applique uniquement aux déploiements on-premise et hybrides"}

Spécificités par SGBDR rdbms-specific-recommendations

Pour vous aider à configurer des plans de maintenance, cette section répertorie quelques recommandations et bonnes pratiques adaptées aux différents moteurs SGBDR pris en charge par Adobe Campaign. Il ne s'agit toutefois que de recommandations. C'est à vous de les adapter à vos besoins, conformément à votre procédure interne et vos contraintes. L'administrateur de la base de données a la responsabilité de créer et d'exécuter ces plans.

PostgreSQL postgresql

Détecter les grandes tables detecting-large-tables

  1. Ajoutez la vue suivante à votre base de données :

    code language-none
    create or replace view uvSpace
     as
     SELECT c1.relname AS tablename, c2.relname AS indexname, c2.relpages * 8  / 1024 AS size_mbytes, c2.relfilenode AS filename, cast(0 AS bigint) AS row_count
     FROM pg_class c1, pg_class c2, pg_index i
     WHERE c1.oid = i.indrelid AND i.indexrelid = c2.oid
     UNION
     SELECT pg_class.relname AS tablename, NULL::"unknown" AS indexname, pg_class.relpages * 8  /1024  AS size_mbytes, pg_class.relfilenode AS filename, cast(pg_class.reltuples as bigint) AS row_count
     FROM pg_class
     WHERE pg_class.relkind = 'r'::"char"
     ORDER BY 3 DESC, 1, 2 DESC;
    
  2. Vous pouvez exécuter cette requête pour repérer les tables et index volumineux :

    code language-none
    SELECT * FROM uvSpace;
    

    Vous pouvez également exécuter cette requête, par exemple, pour afficher l'ensemble des tailles d'index :

    code language-none
    SELECT
       tablename,
       sum(size_mbytes) AS "sizeMB_all",
       (
          SELECT sum(size_mbytes)
          FROM uvspace
          AS uv2
          WHERE
             INDEXNAME IS NULL
             AND uv1.tablename = uv2.tablename
       ) AS "sizeMB_data",
       (
          SELECT sum(size_mbytes)
          FROM uvspace
          AS uv2
          WHERE
             INDEXNAME IS NOT NULL
             AND uv1.tablename = uv2.tablename
       ) AS "sizeMB_index",
       (
          SELECT ROW_COUNT
          FROM uvspace
          AS uv2
          WHERE
             INDEXNAME IS NULL
             AND uv1.tablename = uv2.tablename
       ) AS ROWS FROM uvspace AS uv1
       GROUP BY tablename
       ORDER BY 2 DESC
    

Maintenance simple simple-maintenance

IMPORTANT
Adobe recommande vivement de ne pas exécuter VACUUM FULL sur les configurations de base de données hébergées par Adobe Campaign. La maintenance proposée est un guide pour les installations On-Premise uniquement. Pour les mises en œuvre et schémas de table personnalisés, utilisez VACUUM FULL à vos risques et périls, car VACUUM sans surveillance peut verrouiller exclusivement les tables à l’origine de requêtes bloquées et, dans certains cas, verrouiller la base de données entière.

Dans PostgreSQL, vous pouvez utiliser les mots-clés habituels suivants :

  • VACUUM (FULL, ANALYZE, VERBOSE)

Pour exécuter l'opération VACUUM, l'analyser et l'horodater, vous pouvez utiliser la syntaxe suivante :

\timing on
VACUUM (FULL, ANALYZE, VERBOSE) <table>;

Nous vous recommandons vivement de ne pas omettre l'instruction ANALYZE. Dans le cas contraire, la table vide est laissée sans statistiques. La raison est qu'un nouveau tableau est construit, puis l'ancien est supprimé. Par conséquent, l'identifiant d'objet (OID) de la table change, mais aucune statistique n'est calculée. C'est pourquoi vous rencontrerez immédiatement des problèmes de performances.

Voici un exemple classique de plan de maintenance SQL qui doit être exécuté régulièrement :

\timing on
VACUUM (FULL, ANALYZE, VERBOSE) nmsdelivery;

\timing on
VACUUM (FULL, ANALYZE, VERBOSE) nmsdeliverystat;

\timing on
VACUUM (FULL, ANALYZE, VERBOSE) xtkworkflow;

\timing on
VACUUM (FULL, ANALYZE, VERBOSE) xtkworkflowevent;

\timing on
VACUUM (FULL, ANALYZE, VERBOSE) xtkworkflowjob;

\timing on
VACUUM (FULL, ANALYZE, VERBOSE) xtkworkflowlog;

\timing on
VACUUM (FULL, ANALYZE, VERBOSE) xtkworkflowtask;

\timing on
VACUUM (FULL, ANALYZE, VERBOSE) xtkjoblog;

\timing on
VACUUM (FULL, ANALYZE, VERBOSE) xtkjob;

\timing on
VACUUM (FULL, ANALYZE, VERBOSE) nmsaddress;

\timing on
VACUUM (FULL, ANALYZE, VERBOSE) nmsdeliverypart;

\timing on
VACUUM (FULL, ANALYZE, VERBOSE) nmsmirrorpageinfo;
NOTE
  • Adobe conseille de commencer par les tables de petite taille. Si l'opération de maintenance devait échouer sur les tables volumineuses (ce qui est davantage le cas que sur les petites tables), une partie de la maintenance serait déjà assurée.
  • Adobe vous recommande d'ajouter les tables spécifiques à votre modèle de données, qui peuvent faire l'objet de mises à jour importantes. Cela peut être le cas pour NmsRecipient si vous disposez de flux de réplication de données quotidiens volumineux.
  • L’instruction VACUUM verrouille la table, ce qui met certains processus en attente pendant toute la durée de la maintenance.
  • Pour les très grandes tables (généralement au-dessus de 5 Go), la commande VACUUM FULL peut devenir assez inefficace et nécessiter beaucoup de temps. Adobe déconseille de l'utiliser pour la table YyyNmsBroadLogXxx.
  • Cette opération de maintenance peut être implémentée par un workflow Adobe Campaign, à l'aide d'une activité SQL. Pour plus d’informations, consultez cette section. Assurez-vous de planifier la maintenance pendant une période de faible activité qui n'entrera pas en conflit avec votre période de sauvegarde.

Reconstruire une base rebuilding-a-database

PostgreSQL ne propose pas de moyen efficace pour effectuer une reconstruction de table en ligne, car l'instruction VACUUM FULL verrouille la table, empêchant ainsi une production régulière. La maintenance doit donc être effectuée lorsque la table n'est pas utilisée. Vous pouvez, au choix :

  • effectuer la maintenance lorsque la plateforme Adobe Campaign est arrêtée,
  • arrêter les différents sous-services Adobe Campaign susceptibles d'écrire dans la table qui est en cours de reconstruction (par exemple nlserver stop wfserver@nom_de_l'instance pour arrêter le processus de workflow).

Voici un exemple de défragmentation de table à l'aide de fonctions spécifiques pour le langage de définition de données (DDL) voulu. La requête SQL suivante permet de créer deux nouvelles fonctions : GenRebuildTablePart1 et GenRebuildTablePart2 qui peuvent être utilisées pour générer le DDL destiné à recréer une table.

  • La première fonction permet de créer une table de travail (** _tmp** dans notre exemple) qui est une copie de la table d'origine.
  • La deuxième fonction supprime la table d'origine et renomme la table de travail et ses index comme celle d'origine.
  • L'utilisation de deux fonctions au lieu d'une permet d'éviter de supprimer définitivement la table d'origine au cas où la première fonction échouerait.
 -- --------------------------------------------------------------------------
 -- Generate the CREATE TABLE DDL for a table
 -- --------------------------------------------------------------------------
 create or replace function GenTableDDL(text) returns text as $$
 declare
 vstrTable text;
 vrecFld RECORD;
 vstrDDL text;
 vstrFields text;
 vstrNsTable text;
 vstrTableSpace text;
 begin
 vstrTable = lower($1);

 vstrDDL = ;

 SELECT
 pg_catalog.quote_ident(n.nspname) || '.' || pg_catalog.quote_ident(c.relname),
 pg_catalog.quote_ident(t.spcname)
 INTO
 vstrNsTable, vstrTableSpace
 FROM
 pg_namespace n, pg_class c left outer join pg_tablespace t on c.reltablespace = t.oid
 WHERE
 n.oid = c.relnamespace AND
 c.relname = vstrTable;

 vstrDDL = 'CREATE TABLE ' || vstrNsTable || '_tmp(';

 vstrFields = ;
 FOR vrecFld IN
 SELECT
 pg_catalog.quote_ident(a.attname) ||
 ' ' || t.typname ||
 case when t.typname='varchar' then '(' || cast(a.atttypmod-4 as text) || ')'
 when t.typname='numeric' then '(' || cast((a.atttypmod-4)/65536 as text) || ',' || cast((a.atttypmod-4)%65536 as text) || ')'
 else end ||
 case when a.attnotnull then ' not null' else end ||
 case when a.atthasdef then ' default '|| d.adsrc else end as DDL
 FROM
 pg_type t, pg_class c, pg_attribute a LEFT OUTER JOIN pg_attrdef d ON d.adrelid=a.attrelid and d.adnum=a.attnum
 WHERE
 a.attnum > 0 AND
 a.attrelid = c.oid AND
 t.oid = a.atttypid AND
 c.relname = vstrTable
 ORDER BY
 a.attnum
 LOOP
 IF vstrFields <> THEN
 vstrFields = vstrFields || ',' || chr(10) || ' ';
 ELSE
 vstrFields = vstrFields || chr(10) || ' ';
 END IF;
 vstrFields = vstrFields || vrecFld.DDL;
 END LOOP;

 vstrDDL = vstrDDL || vstrFields || chr(10) || ')';
 if vstrTableSpace <> then
 vstrDDL = vstrDDL || ' TABLESPACE ' || vstrTableSpace;
 end if;
 vstrDDL = vstrDDL || ';' || chr(10);

 return vstrDDL;
 END;
 $$ LANGUAGE plpgsql;

 -- --------------------------------------------------------------------------
 -- Generate the CREATE INDEX DDL for a table
 -- --------------------------------------------------------------------------
 create or replace function GenIndexDDL(text) returns text as $$
 declare
 vstrTable text;
 vrecIndex RECORD;
 vstrDDL text;
 viFld integer;
 vstrFld text;
 begin
 vstrTable = lower($1);

 vstrDDL = ;

 FOR vrecIndex IN
 SELECT
 i.indkey, i.indisunique,
 pg_catalog.quote_ident(c.relname) as tablename,
 pg_catalog.quote_ident(ic.relname) as indexname,
 pg_catalog.quote_ident(t.spcname) as tablespace
 FROM
 pg_class c, pg_index i, pg_class ic left outer join pg_tablespace t on ic.reltablespace = t.oid
 WHERE
 i.indexrelid = ic.oid AND
 i.indrelid = c.oid AND
 c.relname = vstrTable
 LOOP

  vstrDDL = vstrDDL || 'CREATE ';
  if vrecIndex.indisunique then
  vstrDDL = vstrDDL || 'UNIQUE ';
  end if;
  vstrDDL = vstrDDL ||
   'INDEX ' ||vrecIndex.indexname || '_tmp ON ' ||
   vrecIndex.tablename || '_tmp(';

  FOR viFld IN array_lower(vrecIndex.indkey, 1) .. array_upper(vrecIndex.indkey, 1) LOOP
  SELECT pg_catalog.quote_ident(a.attname) INTO vstrFld
  FROM
   pg_attribute a, pg_class c
  WHERE
   a.attnum = vrecIndex.indkey[viFld] AND
   a.attrelid = c.oid AND c.relname=vstrTable;

  vstrDDL = vstrDDL || vstrFld;
  if viFld <> array_upper(vrecIndex.indkey, 1) then
   vstrDDL = vstrDDL || ', ';
  end if;
  END LOOP;
  vstrDDL = vstrDDL || ')';

  if vrecIndex.tablespace <> then
  vstrDDL = vstrDDL || 'TABLESPACE ' || vrecIndex.tablespace;
  end if;
  vstrDDL = vstrDDL || ';' || chr(10);

 END LOOP;

 return vstrDDL;
 END;
 $$ LANGUAGE plpgsql;

 -- --------------------------------------------------------------------------
 -- Generate the ALTER INDEX RENAME for a table
 -- --------------------------------------------------------------------------
 create or replace function GenRenameIndexDDL(text) returns text as $$
 declare
 vstrTable text;
 vrecIndex RECORD;
 vstrDDL text;
 begin
 vstrTable = lower($1);

 vstrDDL = ;

 FOR vrecIndex IN
  SELECT
  pg_catalog.quote_ident(n.nspname) as namespace,
  pg_catalog.quote_ident(ic.relname) as indexname
  FROM
  pg_namespace n, pg_class c, pg_index i, pg_class ic
  WHERE
  i.indexrelid = ic.oid AND
  n.oid = ic.relnamespace AND
  i.indrelid = c.oid AND
  c.relname = vstrTable
 LOOP

  vstrDDL = vstrDDL || 'ALTER INDEX ' || vrecIndex.namespace || '.' || vrecIndex.indexname ||
    '_tmp RENAME TO ' || vrecIndex.indexname ||
    ';' || chr(10);
 END LOOP;

 return vstrDDL;
 END;
 $$ LANGUAGE plpgsql;

 -- --------------------------------------------------------------------------
 -- Build a copy of a table, with index
 -- --------------------------------------------------------------------------
 create or replace function GenRebuildTablePart1(text) returns text as $$
 declare
 vstrTable text;
 vstrTmp text;
 vstrDDL text;
 begin
 vstrTable = lower($1);

 vstrDDL = ;

 SELECT GenTableDDL(vstrTable) INTO vstrTmp;
 vstrDDL = vstrDDL|| vstrTmp || chr(10);

 vstrDDL = vstrDDL|| 'INSERT INTO ' || vstrTable || '_tmp SELECT * FROM ' || vstrTable || ';'||chr(10);
 SELECT GenIndexDDL(vstrTable) INTO vstrTmp;

 vstrDDL = vstrDDL|| vstrTmp || chr(10);
 vstrDDL = vstrDDL|| 'VACUUM ANALYSE '|| vstrTable || '_tmp;' ||chr(10);

 return vstrDDL;
 end;
 $$ LANGUAGE plpgsql;

 -- --------------------------------------------------------------------------
 -- Drop the original table and rename the copy
 -- --------------------------------------------------------------------------
 create or replace function GenRebuildTablePart2(text) returns text as $$
 declare
 vstrTable text;
 vstrTmp text;
 vstrDDL text;
 begin
 vstrTable = lower($1);

 vstrDDL = 'DROP TABLE ' || vstrTable||';'|| chr(10);
 vstrDDL = vstrDDL|| 'ALTER TABLE ' || vstrTable || '_tmp RENAME TO ' || vstrTable ||';'|| chr(10);

 SELECT GenRenameIndexDDL(vstrTable) INTO vstrTmp;
 vstrDDL = vstrDDL|| vstrTmp || chr(10);

 return vstrDDL;
 end;
 $$ LANGUAGE plpgsql;

L'exemple qui suit peut être utilisé dans un workflow pour reconstruire les tables requises plutôt que d'utiliser la commande vacuum/rebuild  :

function sqlGetMemo(strSql)
 {
 var res = sqlSelect("s, m:memo", strSql);
 return res.s.m.toString();
 }

 function RebuildTable(strTable)
 {
 // Rebuild a table_tmp
 var strSql = sqlGetMemo("select GenRebuildTablePart1('"+strTable+"')");
 logInfo("Rebuilding table '"+strTable+"'...");
 // logInfo(strSql);
 sqlExec(strSql);

 // If fails, there is an exception thrown and so we do not delete the original table
 strSql = sqlGetMemo("select GenRebuildTablePart2('"+strTable+"')");
 logInfo("Swapping table '"+strTable+"'...");
 //logInfo(strSql);
 sqlExec(strSql);
 }

 RebuildTable('nmsrecipient');
 RebuildTable('nmsrcpgrlrel');
 // ... other tables here

Oracle oracle

Veuillez consulter votre administrateur de base de données pour connaître les procédures les mieux adaptées à votre version d'Oracle.

Microsoft SQL Server microsoft-sql-server

NOTE
Pour Microsoft SQL Server, vous pouvez utiliser le plan de maintenance décrit sur cette page.

L'exemple ci-dessous concerne Microsoft SQL Server 2005. Si vous utilisez une autre version, contactez l'administrateur de base de données pour connaître les procédures de maintenance de cette version.

  1. Connectez-vous à Microsoft SQL Server Management Studio avec un identifiant auquel ont été attribués des droits administrateur.

  2. Cliquez avec le bouton droit de la souris sur le dossier Gestion > Plans de maintenance et sélectionnez Assistant Plan de maintenance.

  3. Cliquez sur Suivant lorsque la page d'accueil s'affiche.

  4. Choisissez le type de plan de maintenance que vous souhaitez créer (exécution de la maintenance en une fois ou création d'un plan pour chaque tâche de maintenance), puis cliquez sur Modifier.

  5. Dans la fenêtre Propriétés de la planification du traitement, choisissez les paramètres d'exécution voulus et cliquez sur OK puis sur Suivant.

  6. Sélectionnez les tâches de maintenance à effectuer comme illustré ci-dessous puis cliquez sur Suivant.

    note note
    NOTE
    Nous vous conseillons d'effectuer au moins les tâches de maintenance comme illustré ci-dessus. Vous pouvez également sélectionner la tâche de mise à jour des statistiques si vous le souhaitez, sachant que cette tâche est déjà effectuée par le workflow de nettoyage de la base.
  7. Dans la liste déroulante, sélectionnez la base de données sur laquelle vous souhaitez effectuer la tâche Vérifier l'intégrité de la base de données.

  8. Sélectionnez la base concernée et cliquez sur OK puis Suivant.

  9. Configurez la taille maximale allouée à votre base de données puis cliquez sur Suivant.

    note note
    NOTE
    Si la taille de la base devait dépasser la limite fixée, le système de maintenance essaiera de détruire les données non-utilisées pour libérer de l'espace-disque.
  10. Effectuez une réorganisation ou une reconstruction de l'index :

    • Si le taux de fragmentation de l'index est compris entre 10% et 40%, il est recommandé d'effectuer une réorganisation :

      Choisissez la base de données et les objets (tables ou vues) dont vous voulez réorganiser l'index puis cliquez sur Suivant.

      note note
      NOTE
      Selon votre configuration vous ne pourrez sélectionner que les tables sélectionnées précédemment ou la totalité des tables de votre base de données.
    • Si le taux de fragmentation de l'index est supérieur à 40%, il est recommandé d'effectuer une reconstruction :

      Choisissez les options de la tâche de reconstruction de l'index puis cliquez sur Suivant.

      note note
      NOTE
      Le processus de reconstruction de l'index est plus contraignant en termes d'utilisation du processeur et verrouille les ressources de la base de données. Sélectionnez l'option Conserver l'index en ligne lors de la réindexation si vous souhaitez que l'index soit disponible pendant la reconstruction.
  11. Choisissez les options du rapport d'activité des tâches de maintenance puis cliquez sur Suivant.

  12. Vérifiez la liste des tâches du plan de maintenance puis cliquez sur Terminer.

    L'état d'avancement du plan de maintenance et le statut des différentes étapes s'affiche à l'écran.

  13. Lorsque le plan de maintenance est arrivé à son terme, cliquez sur Fermer.

  14. Dans l'explorateur de Microsoft SQL Server, double-cliquez sur le dossier Gestion > Plans de maintenance.

  15. Sélectionnez le plan de maintenance d'Adobe Campaign : les différentes étapes sont présentées sous la forme d'un workflow.

    Vous remarquerez qu'un objet a été créé dans le dossier SQL Server Agent > Traitements. Cet objet permet de lancer le plan de maintenance. Dans notre exemple il n'y a qu'un seul objet car toutes les tâches de maintenance font partie du même plan de maintenance.

    note important
    IMPORTANT
    Pour que cet objet puisse s'exécuter, l'agent Microsoft SQL Server doit être activé.

Configuration d'une base de données distincte pour les tables de travail

NOTE
Ce paramétrage est facultatif.

L'option WdbcOptions_TempDbName permet de configurer une base de données distincte pour les tables de travail de Microsoft SQL Server. Cette configuration permet d'optimiser les sauvegardes et la réplication.

Cette option peut être utilisée si vous souhaitez que les tables de travail (par exemple, les tables créées pendant l'exécution d'un workflow) soient créées dans une autre base de données.

Lorsque vous définissez l'option sur "tempdb.dbo.", les tables de travail sont créées dans la base de données temporaire par défaut de Microsoft SQL Server. L'administrateur de la base de données doit autoriser l'accès en écriture à la base de données tempdb.

Si cette option est définie, elle est utilisée sur toutes les bases de données Microsoft SQL Server configurées dans Adobe Campaign (base de données principale et comptes externes). Veuillez noter que si deux comptes externes partagent le même serveur, des conflits peuvent survenir (car tempdb est unique). De même, si deux instances Campaign utilisent le même serveur MSSQL, il peut y avoir des conflits si elles utilisent la même tempdb.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1