Accès aux données ServiceNow dans Snowflake¶

Octroi de privilèges pour l’accès aux données ServiceNow dans Snowflake¶

Une fois que le connecteur Snowflake ServiceNow a synchronisé les données avec Snowflake, tout rôle disposant des privilèges suivants peut accéder aux données ServiceNow :

• Le privilège USAGE sur la base de données et le schéma qui contiennent les données ServiceNow dans Snowflake et

• Le privilège SELECT sur les tables ou les vues de ce schéma

Snowflake recommande de créer un rôle dédié avec ces privilèges qui peuvent être accordés aux utilisateurs qui ont besoin d’accéder aux données ServiceNow ingérées.

Par exemple, si vous avez configuré le connecteur pour stocker les données ServiceNow dans la base de données dest_db et le schéma dest_schema , vous pouvez créer un rôle nommé servicenow_data_reader_role et lui accorder les privilèges d’accès aux données.

L’exemple suivant montre comment accorder ces privilèges :

CREATE ROLE servicenow_data_reader_role;
GRANT USAGE ON DATABASE dest_db TO ROLE servicenow_data_reader_role;
GRANT USAGE ON SCHEMA dest_db.dest_schema TO ROLE servicenow_data_reader_role;
GRANT SELECT ON FUTURE TABLES IN SCHEMA dest_db.dest_schema TO ROLE servicenow_data_reader_role;
GRANT SELECT ON FUTURE VIEWS IN SCHEMA dest_db.dest_schema TO ROLE servicenow_data_reader_role;
GRANT SELECT ON ALL TABLES IN SCHEMA dest_db.dest_schema TO ROLE servicenow_data_reader_role;
GRANT SELECT ON ALL VIEWS IN SCHEMA dest_db.dest_schema TO ROLE servicenow_data_reader_role;

Copy

Accès aux données brutes¶

Pour chaque table ServiceNow que vous synchronisez, le connecteur Snowflake ServiceNow crée une nouvelle table portant le même nom dans la base de données et le schéma pour les données ServiceNow dans Snowflake.

Par exemple, si vous avez configuré le connecteur pour stocker les données ServiceNow dans la base de données dest_db et le schéma dest_schema , et si vous avez configuré le connecteur pour synchroniser la table incident dans ServiceNow, le connecteur crée la table nommée dest_db.dest_schema.incident.

Cette table contient des données brutes ingérées depuis ServiceNow. Cette table contient les colonnes suivantes :

Voici un exemple de la sortie d’une instruction SELECT qui récupère les données de la table dest_db.dest_schema.incident :

SELECT * FROM DEST_DB.DEST_SCHEMA.INCIDENT LIMIT 5;

+----------------------------------+-------------------------+-------------+--------------------------+
| SYS_ID                           | RAW:ACTIVE              |  IS_DELETED | LAST_UPDATE_DATE         |
+----------------------------------+-------------------------+-------------+--------------------------+
| caa04d36db8ba0106e9643c81396197b | {"active": "true", ...} |  FALSE      |  2021-08-24 12:59:23.932 |
| cea045be1b03e010eac562c4bd4bcbb2 | {"active": "true", ...} |  FALSE      |  2021-08-24 12:59:23.932 |
| caa0c9bedb8be010f9f19c41ba961934 | {"active": "true", ...} |  FALSE      |  2021-08-24 12:59:23.932 |
| caa0c9bedb8be010f9f19c41ba961969 | {"active": "true", ...} |  FALSE      |  2021-08-24 12:59:23.932 |
| b9a0c53adb436410d6fa2b691396190a | {"active": "true", ...} |  FALSE      |  2021-08-24 12:59:23.932 |
+----------------------------------+-------------------------+-------------+--------------------------+

Copy

Accès aux données aplaties¶

Pour chaque table contenant des données, le connecteur crée deux vues aplaties sur les données brutes. Les noms des vues sont les noms des tables avec les suffixes __view et __view_with_deleted. Par exemple, pour la table ServiceNow nommée incident, le connecteur crée les vues suivantes :

• dest_db.dest_schema.incident__view

• dest_db.dest_schema.incident__view_with_deleted

La vue avec le suffixe __view contient les enregistrements qui se trouvent dans la table ServiceNow. La vue avec le suffixe __view_with_deleted comprend ces mêmes enregistrements ainsi que les enregistrements qui ont été supprimés de la table ServiceNow.

Remarques :

• Les noms des colonnes de ces vues sont en majuscules. Vous ne pouvez pas utiliser de noms en minuscules pour accéder à ces colonnes.

• Il n’y a pas de vues pour les tables vides. Une fois que les données apparaissent dans la table ServiceNow, la vue est créée.

• Bien que le connecteur gère les modifications du schéma, il ne recharge pas les données.

  Par conséquent, en cas de modification du schéma, les enregistrements de l’ancien schéma ne sont pas mis à jour.

Voici un exemple de la sortie d’une instruction SELECT qui récupère les données de la vue dest_db.dest_schema.incident_view. Dans cet exemple, la table incident dans ServiceNow comporte des colonnes nommées ACTIVE, APPROVAL, CATEGORY, et ESCALATION.

SELECT ACTIVE, APPROVAL, CATEGORY, ESCALATION
FROM DEST_DB.DEST_SCHEMA.INCIDENT__VIEW LIMIT 5;

+--------+----------------+------------------+------------+
| ACTIVE | APPROVAL       | CATEGORY         | ESCALATION |
+--------+----------------+------------------+------------+
| TRUE   | not requested  | software         | 0          |
| TRUE   | not requested  | Cloud Management | 0          |
| TRUE   | not requested  | software         | 0          |
| TRUE   | not requested  | network          | 0          |
| TRUE   | not requested  | database         | 0          |
+--------+----------------+------------------+------------+

Copy

Visualisation des journaux d’événements d’une table¶

Le connecteur ServiceNow Snowflake peut suivre les modifications apportées aux enregistrements dans ServiceNow. Ces informations de suivi sont stockées dans des tables appelées journaux d’événements.

Pour chaque table ServiceNow pour lesquelles la synchronisation est activée, le connecteur crée une table de journal d’événements dans Snowflake nommée <destination_db>.<destination_schema>.<table_name>__event_log.

Chaque table du journal d’événements comporte les colonnes suivantes :

Le journal des événements reflète l’historique des changements de données dans la table ServiceNow correspondante. Par exemple, si un nouvel enregistrement est inséré dans la table u_ip_port dans ServiceNow, un enregistrement dont le type d’événement event_type est défini sur INSERT est ajouté à la table dest_db.dest_schema.u_ip_port__event_log dans Snowflake.

De même, si un enregistrement est mis à jour ou supprimé dans une table dans ServiceNow, un enregistrement dont event_type est défini comme UPDATE ou DELETE est ajouté à la table dest_db.dest_schema.u_ip_port__event_log.

Les tables dans Snowflake qui contiennent les données brutes (dest_db.dest_schema.table_name) sont dérivées des tables correspondantes du journal des événements (dest_db.dest_schema.table_name__event_log). Par exemple :

• Si un enregistrement pour un événement INSERT est ajouté à table_name__event_log, le connecteur ajoute un enregistrement correspondant à la table table_name.

• Si un événement UPDATE pour le sys_id donné est ajouté à la table du journal d’événements, le connecteur met à jour l’enregistrement correspondant avec le sys_id dans la table table_name avec de nouvelles données.

• Si un événement DELETE se produit, l’indicateur is_deleted de l’enregistrement correspondant dans table_name est défini sur true.

Obtention de la valeur d’affichage d’un champ de référence¶

Dans les tables ServiceNow, certains champs sont des champs de référence, qui contiennent des références à des enregistrements d’autres tables.

Dans l’exemple ci-dessous, le champ opened_by de la table incident est un champ de référence qui contient une référence à l’enregistrement avec le sys_id <sys_id> dans une autre table (sys_user) :

{
  "link": "https://testingatt1.service-now.com/api/now/table/sys_user/<sys_id>",
  "value": "<sys_id>"
}

Copy

Pour afficher les champs de référence dans la table, appelez la procédure stockée SHOW_REFERENCES_OF_TABLE avec l’argument suivant :

CALL SHOW_REFERENCES_OF_TABLE('<table_name>');

Copy

Où :

table_name

Indique le nom de la table pour laquelle vous souhaitez afficher les champs de référence.

Cette procédure stockée inspecte le schéma de la table et renvoie une liste d’objets JSON contenant les propriétés suivantes :

CALL CREATE_VIEW_WITH_DISPLAY_VALUES('<table_name>');

SELECT OPENED_BY, OPENED_BY__METADATA
  FROM DEST_DB.DEST_SCHEMA.INCIDENT__VIEW_WITH_REFERENCES;

+-----------+------------------------------------+
| OPENED_BY | OPENED_BY__METADATA                |
+-----------+------------------------------------+
| "JOHN"    | {                                  |
|           |   "reference_field": {             |
|           |     "display_value": "JOHN",       |
|           |     "key": "b177...",              |
|           |     "link": "https://...",         |
|           |     "reference_table": "sys_user", |
|           |     "resolved": true               |
|           |   }                                |
|           | }                                  |
+-----------+------------------------------------+