Aller au contenu principal
Dernière mise à jour le

FAQ du connecteur ServiceNow

Cette page répond aux questions fréquemment posées sur le connecteur ServiceNow dans Databricks Lakeflow Connect.

FAQ générales sur les connecteurs gérés​

Les réponses dans les FAQ sur les connecteurs gérés s'appliquent à tous les connecteurs gérés dans Lakeflow Connect. Continuez à lire pour les FAQ spécifiques à ServiceNow.

FAQ spécifiques au connecteur​

Les réponses de cette section sont spécifiques au connecteur ServiceNow.

Comment le connecteur extrait-il les données de ServiceNow ?​

Le connecteur ServiceNow utilise l'API de table ServiceNow v2.

L'utilisation de l'API Table pourrait-elle avoir un impact sur l'instance ServiceNow ?​

Oui. Cependant, l'impact dépend de la quantité de données importées. Par exemple, il est généralement plus perceptible dans l'instantané initial que lors d'une lecture incrémentale.

Comment le connecteur extrait-il les données de manière incrémentielle ?​

Pour ingérer une table de manière incrémentielle, la table doit avoir l'une des colonnes suivantes. Si aucune de ces colonnes n'existe, alors le connecteur capture la table source et écrase la table de destination.

  • sys_updated_on
  • sys_created_on
  • sys_archived

Pourquoi les performances d'ingestion de mon ServiceNow sont-elles lentes ?​

Databricks recommande de travailler avec votre administrateur ServiceNow pour activer l'indexation côté ServiceNow sur le champ curseur. La colonne du curseur est sélectionnée dans la liste suivante, par ordre de disponibilité et de préférence : sys_updated_on (premier choix), sys_created_on (deuxième choix), sys_archived (troisième choix). C'est une approche standard pour améliorer les performances lors de l'ingestion à l'aide des ServiceNow APIs. La configuration de l'index permet à Databricks d'éviter d'analyser entièrement la colonne sys_updated_on, ce qui peut créer un goulot d'étranglement pour les mises à jour importantes. Pour obtenir des instructions, consultez Créer un index de table dans la documentation ServiceNow.

Databricks recommande également d'augmenter le délai d'expiration des requêtes de l'API REST Table à plus de 60 secondes. Cela permet d'éviter de dépasser la limite de transactions, ce qui peut entraîner l'expiration de la query. Si le problème persiste, créez un ticket d'assistance.

Le connecteur requiert-il des autorisations d'administrateur ?​

Non. Le connecteur prend en charge les options suivantes :

  • Rôles d'administrateur (recommandé) : Utilisez le rôle admin et, en option, le rôle snc_read_only. Cette approche renvoie le schéma complet de la table en un seul appel API par table.
  • Rôles à privilège minimum : utilisez des ACL au niveau de la table. Cette approche nécessite davantage d'appels d'API pour la découverte des schémas. Choisissez-le seulement si la restriction des autorisations est plus importante que la minimisation de l'utilisation de l'API.

Pour obtenir la liste complète des autorisations requises, consultez la configuration de la source.

Pourquoi l'accès de moindre privilège nécessite-t-il davantage d'utilisation de l'API ?​

Avec des rôles d'administrateur, ServiceNow peut renvoyer le schéma complet de la table, y compris les champs hérités, en un seul appel d'API.

Sans rôles d'administrateur, le connecteur doit effectuer plusieurs appels API pour découvrir le schéma. Comme les tables ServiceNow utilisent l’héritage, le connecteur doit :

  1. Rechercher le parent de la table.
  2. Répétez pour chaque table parente jusqu'à ce que la racine de la hiérarchie soit atteinte.
  3. Récupérez les définitions de champ pour chaque table de la chaîne.

Le nombre d'appels API augmente en fonction de la profondeur de la hiérarchie d'héritage de la table. Par exemple, si une table possède une hiérarchie à trois niveaux, le connecteur nécessite au moins trois appels API pour résoudre les tables parentes, plus des appels supplémentaires pour récupérer les définitions de champs, comparativement à un seul appel avec un accès administrateur. La découverte de schémas avec un accès à moindre privilège se produit à chaque exécution de pipeline, et pas seulement lors de la configuration initiale.

Sur cette page