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

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.

   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 le menu de navigation, sélectionnez Data Products » Marketplace.

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

   4. Dans Connections, sélectionnez le symbole ellipses à droite de l’étiquette ServiceNow, puis sélectionnez View details.

      La boîte de dialogue ServiceNow Connection Configuration affiche l’objet secret, par exemple : CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD.SECRET.

   Pour obtenir un secret à l’aide de la commande SQL, interrogez la vue GLOBAL_CONFIG :

   SELECT VALUE:secret FROM GLOBAL_CONFIG WHERE KEY = 'connection_config';
   

   Copy

2. Arrêtez le connecteur.

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

   Par exemple, pour mettre à jour le secret secretsdb.apiauth.servicenow_basic_auth , exécutez la commande suivante :

   ALTER SECRET secretsdb.apiauth.servicenow_basic_auth SET PASSWORD = 'W3dr@fg*7B1c4j';
   

   Copy

4. Reprenez le connecteur.

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

Suppression des objets créés lors de l’installation à l’aide de Snowsight¶

La suppression de la base de données du connecteur ne supprime pas les données ingérées qui sont stockées dans une base de données distincte ni les objets qui ont été créés lors de l’installation effectuée avec Snowsight.

Pour voir les objets créés lors de l’installation, procédez comme suit :

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

2. Dans le menu de navigation, sélectionnez Data Products » Marketplace.

3. Recherchez le connecteur Snowflake pour ServiceNow®, puis sélectionnez-le.

4. Dans la page du Snowflake Connector for ServiceNow®, localisez la zone Connector Objects.

Pour supprimer ces objets, exécutez la commande DROP .

Par exemple, pour supprimer le secret, exécutez l’instruction DROP SECRET.

Désinstallation et suppression manuelles des objets créés lors de l’installation¶

La suppression de la base de données du connecteur ne supprime pas les données ingérées qui sont stockées dans une base de données distincte, ni les objets que vous avez créés lors de l’installation du connecteur. Il s’agit notamment des éléments suivants :

• L’objet d’intégration de sécurité requis par OAuth.

• L’objet secret qui contient les identifiants de connexion permettant d’accéder à ServiceNow.

• Les autres objets créés lors de l’installation du connecteur.

Pour supprimer ces objets, exécutez l’instruction DROP . Par exemple, pour supprimer le secret, exécutez l’instruction DROP SECRET.

Pour supprimer le Snowflake Connector for ServiceNow®, utilisez DROP DATABASE :

DROP DATABASE <database_name>;

Where

database_name

Spécifie le nom de la base de données créée lors de l’installation du connecteur.

Par exemple, pour supprimer un connecteur installé dans la base de données nommée my_connector_servicenow, exécutez la commande suivante :

DROP DATABASE my_connector_servicenow;

Copy

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.

Mise à niveau du connecteur¶

Cette section décrit comment mettre à niveau le connecteur à partir de votre compte Snowflake.

Actuellement, le connecteur n’est pas mis à niveau automatiquement. Pour mettre à niveau votre connecteur vers la version la plus récente, appelez la procédure nommée RUN_UPGRADE :

CALL RUN_UPGRADE();

Copy

Vous pouvez effectuer cette mise à niveau à tout moment (à condition que personne d’autre ne configure le connecteur en même temps).

La mise à niveau devrait s’effectuer rapidement. La mise à niveau désactive temporairement l’ingestion des données ServiceNow. Lorsque la mise à niveau est terminée, le connecteur reprend l’ingestion des données.

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

Si vous avez supprimé le connecteur, mais laissé intacts la base de données et le schéma contenant les données ingérées, vous pouvez réinstaller ultérieurement le connecteur et reprendre l’ingestion de données à partir du point où le connecteur a été exécuté pour la dernière fois.

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

   SELECT * FROM TABLES_STATE;
   

   Copy

2. Si le connecteur est en train d’ingérer des données, attendez que l’ingestion soit terminée. Ceci est important pour assurer la cohérence totale des données.

3. Si aucune ingestion n’est en cours, arrêtez le connecteur en appelant la procédure stockée suivante :

CALL STOP_CONNECTOR();

Copy

Après avoir retiré le connecteur, vous pouvez réinstaller le connecteur de la manière suivante :

• 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.

• Fournissez la même URL 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.

Si vous créez de nouveaux objets ou si vous créez un nouveau rôle personnalisé pour le connecteur, vous devez vous assurer que le rôle dispose des privilèges requis. Voir les sections suivantes pour plus de détails :

• Réutilisation du même rôle personnalisé pour le nouveau connecteur

• Utilisation d’un nouveau rôle personnalisé pour le nouveau connecteur

Réutilisation du même rôle personnalisé pour le nouveau connecteur¶

Si vous utilisez le même rôle personnalisé pour le connecteur que celui utilisé lors de l’installation précédente du connecteur, il vous suffit d’accorder les privilèges requis sur tous les nouveaux objets que vous avez créés lors de l’installation initiale du connecteur. Le rôle doit déjà disposer des privilèges requis sur tous les autres objets que vous réutilisez, y compris les tables et les vues de la base de données et du schéma contenant les données ingérées.

Vous devez également attribuer le rôle personnalisé au connecteur dans le cadre d’une nouvelle installation.

Utilisation d’un nouveau rôle personnalisé pour le nouveau connecteur¶

Si vous prévoyez d’utiliser un nouveau rôle personnalisé pour le connecteur réinstallé, vous devez lui accorder tous les privilèges énumérés sous Création d’un rôle personnalisé pour le connecteur et vous assurer que le nouveau rôle dispose des privilèges requis sur les tables et les vues de la base de données et du schéma contenant les données ingérées.

Pour accorder les privilèges requis, accordez au nouveau rôle personnalisé le privilège OWNERSHIP sur les tables et les vues de ce schéma.