Notes de version de Snowflake Connector for ServiceNow® V2¶

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Changed the column used for API request length validation.

Changements de comportement¶

• Le connecteur ne possède plus de limite de 128 MB de mémoire pour les réponses non compressées à partir de l’API ServiceNow.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

Sans objet.

Changements de comportement¶

• Les tables de journal personnalisées sont actuellement désactivées. Elles seront restaurées avec de nouvelles fonctionnalités dans une prochaine version.

• Lorsque vous mettez le connecteur en pause, seules les tâches worker sont annulées de force. Les autres tâches continuent de s’exécuter jusqu’à ce qu’elles se terminent, donc la mise en pause peut prendre un peu plus de temps.

Nouvelles fonctionnalités¶

• Le connecteur vous permet désormais d’utiliser les opérateurs NOT LIKE et NOT IN pour le filtrage de lignes, afin que vous puissiez filtrer vos données avec plus de flexibilité lors de l’ingestion.

Corrections de bogues¶

• Le connecteur réessaie maintenant les erreurs curl plusieurs de fois, ce qui le rend plus résistant aux problèmes de réseau dans les déploiements Azure.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

• Amélioration de la journalisation des réponses HTML.

• Amélioration de la gestion des erreurs pour l’accès externe.

Corrections de bogues¶

Sans objet.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

• Amélioration de la gestion des réponses de grande taille lors de la décompression des données en réduisant la taille des pages si nécessaire.

Corrections de bogues¶

Sans objet.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Correction d’un problème qui entraînait une création incorrecte de la table du schéma lors de l’importation de l’état.

• Correction d’un problème dans le mode de rechargement filtré où certains événements d’état pouvaient être enregistrés dans le mauvais ordre, ce qui pouvait entraîner des mises à jour manquantes.

• Amélioration de la gestion des réponses volumineuses de ServiceNow.

• Ajout d’une journalisation plus détaillée pour les propriété de réponses ServiceNow..

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Correction d’un problème pouvant entraîner une ingestion incorrecte des tables de métadonnées lors du rechargement lorsque le connecteur est configuré globalement pour extraire des valeurs d’affichage. En raison de ce problème, les vues aplaties n’étaient pas créées pour certaines tables. Si ce problème se produisait, les tables de métadonnées suivantes devaient être rechargées :

  • sys_dictionary

  • sys_db_object

  • sys_glide_object

Changements de comportement¶

• Pour les enregistrements dans les colonnes sys_created_on ou sys_updated_on contenant des valeurs nulles, le connecteur insère un événement de mise à jour uniquement lorsque l’enregistrement a changé depuis la dernière ingestion. Auparavant, le connecteur insérait un événement de mise à jour dans la table du journal des événements à chaque cycle d’ingestion, que l’enregistrement soit modifié ou non. Ce comportement pouvait entraîner une augmentation indéfinie de la table du journal des événements, même si aucune modification n’a été trouvée dans la table.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Augmentation de la plage de tailles de page que le connecteur tente lors de l’ingestion filtrée. Lors de la récupération des données, le connecteur devrait désormais être plus résistant aux erreurs de délai d’attente qui proviennent de l’API ServiceNow®.

• Correction de la tâche de nettoyage interne pour conserver les informations du connecteur interne qui sont nécessaires pour effectuer l’ingestion. Auparavant, lorsque ces informations étaient supprimées, elles pouvaient entraîner des échecs d’ingestion.

• Correction d’une erreur lors de la création de vues aplaties. Cette erreur est due à l’absence de colonne dans la table des connecteurs internes.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Correction d’un problème de persistance de la taille des pages lors du rechargement d’une table.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Correction d’un problème pouvant entraîner l’échec de l’exportation de l’état du connecteur lorsque des expressions de filtre de ligne sont utilisées sur des valeurs de chaîne.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Correction d’un problème pouvant entraîner l’échec de l’analyse de la réponse HTTP. Dans certains cas, ce problème pourrait empêcher le connecteur d’ingérer des données provenant de ServiceNow®.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

• Added support for continuous schedules. You can use this feature to set an ingestion schedule for up to 20 tables that will be executed every one minute. Snowflake recommends using continuous schedules carefully and only for tables that require near-real-time data in Snowflake. To enable this feature, you can use the ENABLE_TABLE or CONFIGURE_TABLES_SCHEDULE procedures. To learn more, see Specifying the Synchronization Schedule.

• Le nombre maximum de tables pouvant être ingérées simultanément est passé de 30 à 50. Cette mise à jour permet une meilleure utilisation des entrepôts et améliore les performances globales. Pour en savoir plus, consultez Mise à l’échelle du connecteur.

Corrections de bogues¶

• Le connecteur est plus stable et plus performant lors de l’ingestion de plusieurs tables en parallèle.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Correction d’un bogue qui provoquait l’échec de l’exportation de l’état du connecteur.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Correction d’un bogue qui provoquait l’échec du processus d’analyse de la réponse API de ServiceNow® lorsqu’un nom d’en-tête dans la réponse ne correspondait pas au format attendu.

• Correction d’un bogue qui provoquait l’échec de l’exportation de l’état et de la configuration du connecteur lorsqu’un rechargement filtré était exécuté sur une table.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

• The DELETE_TABLE procedure now accepts an optional drop_related_objects boolean parameter. When this parameter is set to true, the procedure drops all the objects related to the table, such as the flattened views, the event log table, and the sink table.

• The filtered reload feature now supports detection of deletes and can filter out these records when using the sys_ids parameter in the RELOAD_TABLE procedure. Prior to this release, the filtered reload feature only detected data updates and insertion.

Corrections de bogues¶

• Corrected error in CONNECTOR_STATS view ingested row statistics when running filtered reload.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Annulation d’une optimisation des performances qui pouvait entraîner une augmentation de la consommation de l’entrepôt.

Changements de comportement¶

• Pour voir les détails de la configuration des tables que vous rechargez, utilisez la nouvelle vue RELOADED_TABLES au lieu de la vue CONFIGURED_TABLES. Cette nouvelle vue inclut les valeurs de configuration de la table de la vue CONFIGURED_TABLES ainsi que de nouvelles colonnes qui fournissent des informations sur la configuration de rechargement utilisée pour la table et le statut de rechargement de la table. Pour plus d’informations, voir À propos de la surveillance du connecteur.

Nouvelles fonctionnalités¶

• Ajout de la prise en charge du flux par identifiants clients OAuth. Lorsque vous paramétrez OAuth, nous vous recommandons d’utiliser ce flux au lieu du flux d’octroi de code d’authentification OAuth. Pour plus d’informations, voir Paramétrage de OAuth. Si le connecteur est déjà configuré avec un autre flux OAuth et que vous le configurez ensuite pour utiliser le flux d’octroi des identifiants clients, nous vous recommandons d’effectuer les tâches suivantes, si possible :

  • Recréez les objets d’intégration de sécurité et de secret pour utiliser les identifiants clients. Pour les instructions, voir Création d’une intégration de sécurité et Création d’un objet secret.

  • Mettez à jour la connexion à l’instance ServiceNow pour utiliser les nouveaux identifiants. Pour plus d’informations, voir Mise à jour de la connexion sur l’instance ServiceNow®.

• Ajout d’un nouveau paramètre de configuration à la procédure RELOAD_TABLE. Ce paramètre vous permet de recharger des enregistrements spécifiques d’une table au lieu de la table entière. Pour plus de détails, voir Recharge filtrée.

• Dans les vues contenant des champs de référence, les colonnes avec le suffixe __DISPLAY_VALUE qui contiennent des données pour des champs de référence affichent désormais les données les plus récentes. Auparavant, ces colonnes renvoyaient toujours la valeur d’affichage de la valeur brute ingérée de la même table. Pour activer cette fonction, y compris dans les vues existantes, appelez la procédure stockée CREATE_VIEW_WITH_DISPLAY_VALUES. Pour plus d’informations, voir Création d’une vue contenant des champs de référence.

Corrections de bogues¶

• Amélioration des performances de la requête de test initiale lorsqu’une nouvelle table est activée pour l’ingestion.

• Amélioration de la gestion des erreurs lorsque le code d’erreur renvoyé est dans un format différent de celui attendu.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

Correction d’un problème où les colonnes de référence dans les vues aplaties affichaient des données incomplètes lorsque la vue contenait des données d’une table avec fetch_display_values activé.

Changements de comportement¶

Les vues aplaties affichent désormais toujours les colonnes dans l’ordre alphabétique. Auparavant, ces vues affichaient parfois les colonnes dans un ordre aléatoire.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Correction d’un problème à cause duquel les données incluses dans une vue se déplaçaient d’une colonne à une autre lorsque la vue contenait des champs de référence.

• Correction d’un problème à cause duquel les vues aplaties n’étaient pas recréées correctement.

• Pour les tables avec fetch_display_values activé, correction d’un problème à cause duquel le connecteur ne récupérait qu’une seule page d’un maximum de 10 000 enregistrements pour une table avant que le processus d’ingestion ne s’arrête. Cependant, vous devez recharger ces tables pour leur appliquer la correction, y compris les tables avec fetch_display_values activé via les paramètres de connecteur globaux. Pour obtenir des instructions sur la manière de recharger une table, voir Rechargement de données dans une table.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

Correction d’un problème à cause duquel l’appel de la procédure stockée CONFIGURE_DISPLAY_VALUE_FETCHING échouait à configurer les valeurs par défaut d’affichage des tables et entraînait l’arrêt de la réponse de Snowflake Connector for ServiceNow® V2.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

• Une nouvelle procédure CONFIGURE_DISPLAY_VALUE_FETCHING a été ajoutée. Elle permet de définir une configuration par défaut globale pour le traitement des valeurs d’affichage. La synchronisation des valeurs d’affichage peut également être configurée au niveau de la table via la procédure ENABLE_TABLE.

• Les données avec des valeurs d’affichage résolues peuvent désormais être récupérées au lieu des seules données brutes.

Corrections de bogues¶

• Correctifs du processus d’export de l’état du connecteur.

• Amélioration du traitement des erreurs DNS.

• Les procédures CREATE_VIEW_WITH_DISPLAY_VALUES et ENABLE_REFERENCED_TABLES gèrent désormais la configuration des colonnes incluses.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Le connecteur gère désormais une exception lorsqu’une table en cours d’exportation a une configuration incomplète.

• Le processus de mise à niveau n’échoue plus si la procédure GET_TROUBLESHOOTING_DATA n’est pas créée.

• The connector no longer fails when an internal state snapshot isn’t created because of its size.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Ajout d’une migration pour prendre en charge les anciens états de synchronisation dans l’export de données.

Changements de comportement¶

• Le processus d’exportation pour stocker l’état interne du connecteur a changé.

  Outre le stockage des métadonnées dans la table __CONNECTOR_STATE_EXPORT, les données sont également réparties dans plusieurs tables portant le suffixe _SFSDKEXPORT_V1.

Nouvelles fonctionnalités¶

• Snowflake Connector for ServiceNow® V2 prend désormais en charge la reprise après sinistre dans une autre région.

• Ajout de la prise en charge de la configuration de la synchronisation des suppressions au niveau des tables à l’aide de la procédure ENABLE_TABLE.

  Pour plus d’informations sur l’utilisation de la procédure ENABLE_TABLE, voir Activation d’une seule table à l’aide d’une configuration personnalisée.

Corrections de bogues¶

• Les réponses imprévues de l’API ServiceNow sont désormais correctement traitées dans les procédures telles que CHECK_ROW_COUNT.

Changements de comportement¶

• Le partage d’événements est désormais obligatoire pour les nouvelles installations.

Nouvelles fonctionnalités¶

• Vous pouvez désormais définir une taille de page de table spécifique à l’aide de la procédure RESET_PAGE_SIZE au lieu d’utiliser la valeur du connecteur par défaut.

• Si la taille de page par défaut du connecteur a été définie sur une valeur non valide, le connecteur utilisera la valeur recommandée 10 000.

Corrections de bogues¶

• L’ingestion échoue lorsqu’une tâche worker atteint le délai d’expiration de l’API lors de la découverte de la taille de page de table initiale.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

• Ajout d’un délai d’expiration à l’établissement de la connexion http.

Corrections de bogues¶

Sans objet.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Les mises à jour incrémentielles n’échouent plus si Snowflake ne reçoit pas l’horodatage de l’enregistrement le plus récent de la table ingérée.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Les mises à jour incrémentielles n’échouent plus lorsque la table du journal des événements est vide.

• L’ingestion incrémentielle n’échoue plus lorsqu’un lot récupéré est vide en raison de lignes obsolètes lors de mises à jour d’enregistrements à partir de la source.

Changements de comportement¶

Modification des règles de tri des requêtes API ServiceNow appliquées lors des mises à jour incrémentielles afin d’éliminer la perte de données lors de la lecture à partir de plusieurs réplicas en lecture.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

La taille de la page n’est plus réduite lorsque l’instance ServiceNow n’est pas accessible.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Validation de configuration fixe dans la procédure UPDATE_CONNECTION_CONFIGURATION.

Changements de comportement¶

• Une requête pour l’horodatage le plus récent est ajoutée au début des mises à jour et suppressions.

Nouvelles fonctionnalités¶

• La procédure UPDATE_CONNECTION_CONFIGURATION est ajoutée. Cette procédure permet de modifier les objets d’intégration d’accès externe et les objets secrets utilisés par le connecteur.

• L’en-tête User Agent dans les requêtes HTTP du connecteur est désormais défini sur snowflake-connector-for-service-now.

Corrections de bogues¶

• Gestion des erreurs de délai d’expiration du client HTTP de manière élégante.

  Réduction de la taille de la page sur une telle erreur.

• Les différences d’heure entre ServiceNow® et Snowflake ne provoquent plus de perte de données.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Correction du script de migration pour certains utilisateurs.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

• Correction de la procédure RELOAD_TABLE lorsque les deux row_filter et data_range_start_time sont définis. Auparavant, les états de synchronisation du filtrage des lignes n’étaient pas nettoyés correctement.

• Améliorez la gestion des erreurs dans le processus d’ingestion de données lorsque le connecteur n’est pas en mesure de surmonter les erreurs liées à l’authentification. Dans de tels cas, le connecteur devrait désormais être en mesure de détecter l’erreur plus tôt et d’arrêter le processus d’ingestion.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

• Le champ row_filter dans la procédure ENABLE_TABLE accepte désormais un nombre arbitraire de caractères d’espacement dans l’expression de filtrage plutôt que d’autoriser uniquement un seul espace entre les éléments de l’expression.

  Pour plus d’informations, voir Activation d’une table unique à l’aide d’une configuration personnalisée.

Corrections de bogues¶

• Lors du rechargement de la table, le filtrage des lignes et des colonnes est désormais pris en compte.

• Le filtre de ligne fonctionne désormais comme prévu pour les tables sans colonne sys_updated_on

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Les procédures CHECK_ROW_COUNT, ENABLE_TABLE (sans paramètres de configuration personnalisés) et SHOW_REFERENCES_OF_TABLE peuvent désormais être appelées dans une tâche appartenant à l’utilisateur.

Corrections de bogues¶

Sans objet.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Le filtrage des lignes est désormais disponible. Le filtrage des lignes prend en charge le filtrage des lignes de table ingérées en fonction des conditions évaluées par rapport aux colonnes de table. La condition de filtrage des lignes est définie à l’aide de la procédure ENABLE_TABLE.

Pour plus d’informations, voir Activation d’une table unique à l’aide d’une configuration personnalisée dans Configuration de l’ingestion de données pour vos données ServiceNow®.

Corrections de bogues¶

Améliorer les performances du script de migration de la version précédente.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

Améliorer les performances du script de migration de la version précédente.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Ajoute une méthode par défaut pour obtenir le schéma d’une table lors du démarrage de son ingestion. Cela devrait aider dans un scénario où le connecteur ne pouvait pas commencer à ingérer une table en raison d’ACLs rencontrés sur la première ligne ingérée.

Corrections de bogues¶

• Correction de RUN_HEALTHCHECK qui pouvait parfois échouer à envoyer le statut du connecteur dans un scénario spécifique.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Modifier le point de terminaison pour la récupération du schéma de la table. À partir de la version 5.4.0 et ultérieure, le rôle ADMIN dans ServiceNow® n’est plus nécessaire pour utiliser des procédures CREATE_VIEW_WITH_DISPLAY_VALUES, SHOW_REFERENCES_OF_TABLE et ENABLE_TABLE (lors de l’utilisation du filtrage par colonnes).

Corrections de bogues¶

À partir de la version 5.4.0, les nouveaux événements DELETE dans la table des journaux d’événements incluent la colonne RAW, qui est définie sur une valeur provenant du dernier événement de mise à jour plutôt que du premier événement d’insertion. Les événements de la table du journal des événements précédemment existants restent inchangés.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

Correction de la gestion de la valeur nulle de la propriété journal_table dans l’objet transmis à la procédure FINALIZE_CONNECTOR_CONFIGURATION. Le paramètre journal_table peut désormais également être ignoré.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

Ajout des arguments optionnels table_name et sys_id à FINALIZE_CONNECTOR_CONFIGURATION pour faciliter la validation de la table du journal.

Corrections de bogues¶

• Améliorer la validation de l’URL dans SET_CONNECTION_CONFIGURATION pour prendre en charge les domaines personnalisés ServiceNow®.

Changements de comportement¶

Sans objet.

Nouvelles fonctionnalités¶

L’argument max_sys_created_on de la procédure CHECK_ROW_COUNT est désormais remplacé par défaut par NULL.

Corrections de bogues¶

• Ne lancez pas le rapport de contrôle de santé si la configuration ne s’est pas terminée avec succès.

• Correction de SHOW_REFERENCES_OF_TABLE pour inclure les autoréférences d’une table donnée dans la valeur retournée.

• Correction de CREATE_VIEW_WITH_DISPLAY_VALUES pour gérer la situation où la table se réfère à elle-même.

Changements de comportement¶

• La fonction externe permettant d’appeler des API dans ServiceNow® est remplacée par l’accès externe.

• Les signatures et le comportement de nombreuses procédures ont changé. La répartition des responsabilités peut être vérifiée dans le tableau ci-dessous :

Procédure d’avant	Nouvelle procédure
CONFIGURE_CONNECTOR	Plusieurs procédures spécialisées CONFIGURE_*.
CONFIGURE_WAREHOUSE	UPDATE_WAREHOUSE
STOP_CONNECTOR	PAUSE_CONNECTOR
START_CONNECTOR	Plusieurs procédures d’installation de l’appli lors de l’utilisation de feuilles de calcul.
PREFILL_CONFIG_TABLE	GET_AVAILABLE_TABLES
ENABLE_TABLE_WITH_COLUMNS	ENABLE_TABLE
ENABLE_TABLES(VARCHAR, BOOLEAN)	ENABLE_TABLES(ARRAY), DISABLE_TABLES(ARRAY)
TEST_SN_CONNECTION	TEST_CONNECTION
CHECK_SN_ROW_COUNT	CHECK_ROW_COUNT
GET_STATUS
GET_CONNECTION_STATUS
GET_VERSION
RUN_UPGRADE

• Les procédures renvoient un objet avec la propriété response_code. Le résultat de la procédure, accompagné d’un motif d’erreur facultatif, est affiché directement dans la réponse.

• Les signatures et le comportement de plusieurs vues ont changé. La répartition des responsabilités peut être vérifiée dans le tableau ci-dessous :

  Vue d’avant	Nouvelle vue
  ENABLED_TABLES	CONFIGURED_TABLES, TABLES_STATE
  CONNECTOR_RUNS_STATE	Inclus dans la procédure GET_TROUBLESHOOTING_DATA.
  CONNECTOR_STATS	AGGREGATED_CONNECTOR_STATS
  	SYNC_STATUS

Nouvelles fonctionnalités¶

Sans objet.

Corrections de bogues¶

Sans objet.