Prise en main d’Analytics 2.0

Par par défaut, l’ancienne interface de ligne de commande Analytics Cloud Connector importe uniquement utilisateur données d’activité dans une fenêtre glissante de 30 jours. La mise à niveau vers la dernière version supprime cette restriction, ce qui vous permet de remplir et d’importer l’intégralité des données historiques d’activité des utilisateurs de votre entreprise dans votre base de données de destination à partir du moment où la mise à niveau est terminée. Après la mise à niveau de l’interface de ligne de commande, la prochaine synchronisation des données d’activité historique des utilisateurs ne chargera que les nouvelles activités quotidiennes dans la table de destination.

Principaux avantages et caractéristiques de la mise à niveau

• Charge partitionnée : Les premières charges importent désormais une partition (un jour) à la fois au lieu d’exécuter une seule analyse volumineuse, ce qui évite les erreurs de mémoire insuffisante (OOM) et les délais d’expiration sur les tables ayant des années d’historique.

• Récupération en fonction de la destination : Si la table processing_log est effacée, si une partition est perdue ou si une exécution échoue à mi-chemin, le connecteur Analytics Cloud vérifie d’abord votre base de données de destination et ne charge que les partitions manquantes, ce qui rend la procédure de remplissage sécurisé et idempotente.

• Écrasement forcé plus sûr : Forcer un remplacement sur une table n’efface plus l’ensemble du processing_log global ; D’autres tables conservent leur cadence incrémentielle.
  Remarque : L’écrasement forcé (force_overwrite) est contourné pour la table user_activity et les autres tables APPEND.

• Gestion cohérente de l’UTC : Le jour UTC actuel qui mute est exclu de chaque charge d’ajout pour garantir que les réexécutions dans la même journée ne chargent pas les jeux de données incomplets.

• Nouvelle clé de configuration : Une nouvelle clé de configuration source_config.exclude_tables pour normaliser les exclusions de tables dans tous les jeux de données incrémentiels. L’ancienne clé process_user_activity est toujours prise en charge pour des raisons de rétrocompatibilité.

• Conditions préalables:

  • Téléchargez la dernière version de l’interface de ligne de commande Analytics Cloud Connector. Voir Télécharger l’interface de ligne de commande du connecteur Analytics Cloud.

1. Arrêtez toutes les tâches planifiées actives, les projets cron ou les scripts wrapper appelant votre ancienne version de l’interface de ligne de commande.

2. Créez une copie de sauvegarde de votre Annuaire d’installation existant. Stockez en toute sécurité vos fichiers de profil config.yaml et .share dans un dossier temporaire sécurisé.

3. Décompressez le nouveau fichier CLI dans votre annuaire d’installation existant ou placez-le dans un nouveau dossier et mettez à jour vos chemins d’accès au planificateur.

4. Restaurez vos fichiers de profil config.yaml et .share sauvegardés dans l’Annuaire récemment mis à jour.

5. Vérifiez la mise à jour en exécutant la commande suivante dans votre terminal :
   cat VERSION # should read 2.0.2.xxxx

   La sortie doit afficher 2.0.2.xxxx.

6. (Facultatif, recommandé) Effectuez d’abord un essai sur une petite table pour confirmer que la nouvelle interface de ligne de commande se connecte et écrit comme prévu.