Gestion, mise à jour et désinstallation du Snowflake Connector for ServiceNow®V2¶

Mise en pause et reprise de Snowflake Connector for ServiceNow®V2¶

Les sections suivantes expliquent comment mettre en pause et reprendre le connecteur.

CALL PAUSE_CONNECTOR();

CALL RESUME_CONNECTOR();

Modification de l’entrepôt utilisé par le connecteur¶

Si vous souhaitez modifier l’entrepôt utilisé par le connecteur ou ajouter un entrepôt dédié, vous pouvez le faire en appelant :

CALL UPDATE_WAREHOUSE('<warehouse_name>');

Copy

Où :

warehouse_name

Spécifie le nom de l’entrepôt que le connecteur doit utiliser.

Suppression de tables¶

Pour supprimer une table (par exemple activée involontairement) et ne pas l’afficher dans les vues pour la surveillance du connecteur, utilisez la procédure suivante :

CALL DELETE_TABLE('<table_name>');

Copy

Où :

table_name

Spécifie le nom de la table à supprimer. Cette table doit être désactivée et ne pas être en cours de rechargement.

USE ROLE ACCOUNTADMIN;
GRANT OWNERSHIP ON TABLE <destination_database>.<destination_schema>.<table_name> TO ROLE <account_role> REVOKE CURRENT GRANTS;
USE ROLE <account_role>;
DROP TABLE <destination_database>.<destination_schema>.<table_name>;

Mise à jour du jeton d’actualisation utilisé par le connecteur¶

Si vous configurez le connecteur avec l’authentification OAuth, vous devez mettre à jour le jeton d’actualisation régulièrement. Sinon, une fois le jeton expiré, le connecteur ne peut plus accéder à ServiceNow®. Par défaut, le jeton expire 90 jours après sa génération.

Si vous configurez des alertes e-mail pour le connecteur, vous recevrez un rappel pour mettre à jour le jeton d’actualisation le premier jour de chaque mois. Si le jeton expire, vous recevez un e-mail dès que le connecteur rencontre des problèmes d’accès à ServiceNow®.

Mise à jour du mot de passe ServiceNow® pour l’authentification de base¶

Pour mettre à jour le mot de passe, vous devez trouver un secret existant et le modifier à l’aide de la commande ALTER SECRET.

1. Déterminez le nom complet de l’objet secret à l’aide d’une commande Snowsight ou SQL.

   1. Pour obtenir un secret en utilisant Snowsight, procédez comme suit :

      1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le rôle ACCOUNTADMIN.

      2. Dans la navigation de gauche, sélectionnez Data Products » Apps.

      3. Recherchez le Snowflake Connector for ServiceNow, puis sélectionnez la vignette du connecteur.

      4. Dans le menu de navigation supérieur, sélectionnez Settings » Authentication.

         La section Authentication indique l’objet secret, par exemple : CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD.SECRET.

   2. Pour obtenir le nom complet de l’objet secret à l’aide de la commande SQL, interrogez la vue CONNECTOR_CONFIGURATION :

      SELECT value FROM connector_configuration WHERE config_key = 'secret';
      

      Copy

2. Interrompez le connecteur.

3. Mettez à jour l’objet secret en exécutant la commande ALTER SECRET en modifiant le paramètre PASSWORD.

4. Reprenez le connecteur.

   Le mot de passe est maintenant mis à jour et utilisé par le connecteur.

Mise à jour de la connexion à l’instance ServiceNow®¶

Il est possible de mettre à jour la connexion à l’instance ServiceNow®. Cela permet de modifier l’intégration d’accès externe et le secret utilisés par le connecteur. Cela permet également de résoudre le problème de détachement du secret de l’UDF d’accès externe dans le connecteur.

La configuration de la connexion peut être mise à jour à l’aide de la procédure suivante :

CALL UPDATE_CONNECTION_CONFIGURATION({
  'service_now_url': '<servicenow_base_url>',
  'secret': '<secret_name>',
  'external_access_integration': '<external_access_integration_name>'
});

Où :

servicenow_base_url

Spécifie l’URL de l’instance ServiceNow® que le connecteur doit utiliser. L’URL doit être définie sur la même valeur que lors de l’installation du connecteur et doit se présenter au format suivant :

https://<servicenow_instance_name>.service-now.com

Copy

La modification de l’URL de l’instance ServiceNow® n’est pas prise en charge.

secret_name

Spécifie le nom complet de l”objet secret contenant les identifiants de connexion pour s’authentifier auprès de ServiceNow®.

Vous devez spécifier le nom complet de l’objet secret au format suivant :

<database_name>.<schema_name>.<secret_name>

Copy

Les noms de la base de données, du schéma et du secret doivent être des identificateurs d’objets valides.

external_access_integration_name

Spécifie le nom de l”intégration d’accès externe de ServiceNow®.

Le nom de l’intégration doit être un identificateur d’objet valide.

Par exemple, pour mettre à jour la connexion à une instance ServiceNow® qui :

• Possède l’URL https://myinstance.service-now.com.

• Utilise le secret stocké dans secretsdb.apiauth.servicenow_creds_oauth_code.

• Utilise l’intégration d’accès externe nommée servicenow_external_access_integration.

Exécutez la commande suivante :

CALL UPDATE_CONNECTION_CONFIGURATION({
  'service_now_url': 'https://myinstance.service-now.com',
  'secret': 'SECRETSDB.APIAUTH.SERVICENOW_CREDS_OAUTH_CODE',
  'external_access_integration': 'SERVICENOW_API_INTEGRATION'
});

La mise à jour de la configuration ne peut être effectuée que par un utilisateur ayant le rôle d’application ADMIN. En outre, pour que la procédure puisse être exécutée, il faut que le connecteur soit à l’état paused. Voir Mise en pause du connecteur.

Exportation de l’état du connecteur¶

Il est possible d’exporter un instantané de l’état et de la configuration actuels du connecteur. L’instantané avec l’état de connecteur exporté est utile lors de la réinstallation du connecteur pour préserver les tables déjà activées et l’état d’ingestion, ou lorsque la réplication du schéma de destination vers la région de basculement est configurée pour faciliter la reprise après sinistre.

L’état peut être exporté à l’aide de la procédure suivante :

CALL EXPORT_CONNECTOR_STATE();

Copy

La procédure crée une nouvelle table __CONNECTOR_STATE_EXPORT dans le schéma de destination avec un état exporté. Pour effectuer une exportation, il faut que les conditions suivantes soient remplies :

• L’exportation ne peut être effectuée que par un utilisateur ayant le rôle d’application ADMIN.

• Il n’existe pas de rechargement de table en cours.

La configuration est également automatiquement exportée chaque fois que le connecteur déclenche l’ingestion en fonction de la planification configurée, à condition que les conditions suivantes soient remplies :

• Au moins une table est activée pour l’ingestion.

• Il n’existe pas de rechargement de table en cours.

Désinstallation de l’application¶

Cette section explique comment désinstaller l’application avec Snowsight et avec des feuilles de calcul et comment retirer les objets créés par le connecteur, mais qui doivent être retirés intentionnellement par l’utilisateur.

Mise à niveau du connecteur¶

Le connecteur est automatiquement mis à niveau, ce qui signifie que l’utilisateur n’a pas besoin d’effectuer quoi que ce soit pour mettre une application à jour.

Adaptation de la taille du connecteur¶

S’il existe un grand nombre de tables ServiceNow® à ingérer et si vous souhaitez augmenter le nombre de tables ingérées simultanément, vous pouvez remplacer le paramètre par :

CALL CONFIGURE_CONCURRENCY(<number>);

Copy

Où :

number

Spécifie le nombre maximal de travailleurs pouvant ingérer des tables simultanément. Par défaut, cette valeur est définie sur 10.

L’augmentation de la simultanéité doit être envisagée en même temps que la modification de la taille de l’entrepôt utilisé pour l’ingestion de données. Si vous constatez des ralentissements, tentez de redimensionner l’entrepôt. Pour plus d’informations, voir Utilisation d’entrepôts.

Réinstallation du connecteur avec la même base de données et le même schéma pour les données ServiceNow®¶

Pour réinstaller le connecteur, procédez comme suit :

1. Interrogez la vue TABLES_STATE et vérifiez qu’aucune des tables n’est actuellement à l’état RELOADING :

   SELECT TABLE_NAME FROM TABLES_STATE WHERE STATUS = 'RELOADING';
   

   Copy

2. Si des tables sont en cours de rechargement, attendez la fin des rechargements ou annulez-les.

3. Arrêtez le connecteur en appelant la procédure stockée suivante :

   CALL PAUSE_CONNECTOR();
   

   Copy

4. Exportez l’état et la configuration du connecteur. Voir cette section pour des informations détaillées.

   Important

   Il est recommandé d’exporter l’état et la configuration d’un connecteur avant de supprimer l’application de connecteur. Cela permettra de conserver toutes les options personnalisées (par exemple, les tables activées à des fins de synchronisation et leurs planifications) et l’état avec les changements les plus récents dans la nouvelle installation.

   Si vous avez déjà retiré le connecteur, mais laissé intacts la base de données et le schéma contenant les données ingérées, vous pouvez toujours réinstaller le connecteur en vous basant sur l’état automatiquement exporté, mais le connecteur réinstallé risque de répéter l’ingestion de certains enregistrements.

5. Retirez le connecteur, en transférant la possession des tables et des vues dans le schéma de destination.

6. Réinstallez le connecteur comme suit :

   • réinstaller le connecteur en utilisant Snowsight (de préférence).

   • réinstaller le connecteur en utilisant SQL.

Pendant le processus d’installation :

• Fournir la base de données et le schéma précédemment utilisés.

  Après l’installation, le connecteur détectera que la base de données et le schéma contiennent des données ingérées et poursuivra l’ingestion à partir du point où elle avait été laissée avant la réinstallation. Si vous avez exporté l’état du connecteur et s’il est importé correctement lors de l’installation, les tables précédemment ingérées seront automatiquement activées avec les mêmes planifications et la même configuration. Sinon, vous devrez activer manuellement toutes les tables et, par exemple, configurer leurs planifications pour restaurer l’ingestion.

  Lors de la réinstallation à l’aide de commandes SQL, n’oubliez pas de transférer la possession des vues et des tables du schéma de destination au connecteur, comme décrit dans le guide d’installation SQL. Sinon, le connecteur n’aura pas accès à ces tables et ces vues, ce qui l’empêchera de reprendre l’ingestion.

• Fournissez le même nom d’instance ServiceNow®.

• Pour les autres arguments, vous pouvez réutiliser les objets que vous avez créés lors de l’installation du connecteur, ou utiliser de nouveaux objets.