Acesso aos dados do ServiceNow® no Snowflake¶

Concessão de privilégios para acessar os dados do ServiceNow no Snowflake¶

Depois que o Snowflake Connector for ServiceNow® sincronizar os dados com o Snowflake, qualquer função com os seguintes privilégios pode acessar os dados do ServiceNow:

• Privilégio USAGE no banco de dados e esquema que contém os dados do ServiceNow no Snowflake, e

• Privilégio SELECT em tabelas ou exibições dentro deste esquema

Snowflake recomenda a criação de uma função dedicada com estes privilégios que podem ser concedidos aos usuários que precisam ter acesso aos dados ingeridos do ServiceNow.

Por exemplo, se você tiver configurado o conector para armazenar os dados do ServiceNow no banco de dados dest_db e o esquema dest_schema, você pode criar uma função chamada servicenow_data_reader_role e conceder os privilégios de acesso aos dados para essa função.

O exemplo a seguir mostra como conceder esses privilégios:

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

Acesso aos dados brutos¶

Para cada tabela do ServiceNow que você sincroniza, o Snowflake Connector for ServiceNow® cria uma nova tabela com o mesmo nome no banco de dados e esquema para os dados do ServiceNow no Snowflake.

Por exemplo, se você tiver configurado o conector para armazenar os dados do ServiceNow no banco de dados dest_db e esquema dest_schema, e se você tiver configurado o conector para sincronizar a tabela incident no ServiceNow, o conector criará a tabela chamada dest_db.dest_schema.incident.

Esta tabela contém dados brutos ingeridos do ServiceNow. Esta tabela contém as seguintes colunas:

O seguinte é um exemplo da saída para uma instrução SELECT que recupera os dados para a tabela 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

Acesso aos dados nivelados¶

Para cada tabela que contém dados, o conector cria duas exibições niveladas sobre os dados brutos. Os nomes das exibições são os nomes da tabela com os sufixos __view e __view_with_deleted. Por exemplo, para a tabela ServiceNow chamada incident, o conector cria as seguintes exibições:

• dest_db.dest_schema.incident__view

• dest_db.dest_schema.incident__view_with_deleted

A exibição com o sufixo __view contém os registros que estão na tabela ServiceNow. A exibição com o sufixo __view_with_deleted inclui esses mesmos registros, assim como os registros que foram excluídos da tabela ServiceNow.

Observe o seguinte:

• Os nomes das colunas nestas exibições estão em maiúsculas. Você não pode usar nomes em minúsculas para acessar estas colunas.

• Colunas com hora e carimbos de data/hora são sempre salvas usando o fuso horário UTC, independentemente do fuso horário definido na instância ServiceNow. Como resultado, dependendo da configuração da instância ServiceNow, os valores exibidos podem diferir dos valores exibidos na instância ServiceNow. A diferença está relacionada apenas aos valores exibidos, os carimbos de data/hora em ServiceNow e Snowflake referem-se ao mesmo momento.

• Não há exibições para tabelas vazias. Depois que os dados aparecem na tabela no ServiceNow, a exibição é criada.

• Embora o conector trate de alterações no esquema, o conector não recarrega os dados.

  Como resultado, no caso de alterações de esquema, os registros do esquema antigo não são atualizados.

O seguinte é um exemplo da saída para uma instrução SELECT que recupera os dados da exibição dest_db.dest_schema.incident_view. Neste exemplo, a tabela incident no ServiceNow tem colunas chamadas ACTIVE, APPROVAL, CATEGORY e 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

Visualização dos logs de eventos de uma tabela¶

O Snowflake Connector for ServiceNow® pode rastrear as alterações feitas nos registros no ServiceNow. Estas informações de rastreamento são armazenadas em tabelas chamadas logs de eventos.

Para cada tabela do ServiceNow habilitada para sincronização, o conector cria uma tabela de log de eventos dentro do Snowflake chamada <destination_db>.<destination_schema>.<table_name>__event_log.

Cada tabela de log de eventos tem as seguintes colunas:

O log de eventos reflete o histórico de alterações de dados na tabela correspondente do ServiceNow. Por exemplo, se um novo registro for inserido na tabela u_ip_port no ServiceNow, um registro com event_type definido como tipo de evento INSERT é adicionado à tabela dest_db.dest_schema.u_ip_port__event_log no Snowflake.

Da mesma forma, se um registro for atualizado ou excluído em uma tabela no ServiceNow, um registro com event_type definido como UPDATE ou DELETE é adicionado à tabela de dest_db.dest_schema.u_ip_port__event_log.

As tabelas no Snowflake que contêm os dados brutos (dest_db.dest_schema.table_name) são derivadas das tabelas de log de eventos correspondentes (dest_db.dest_schema.table_name__event_log). Por exemplo:

• Se um registro para um evento INSERT for adicionado ao table_name__event_log, o conector adiciona um registro correspondente à tabela table_name.

• Se um evento UPDATE para o sys_id dado for adicionado à tabela de registro de eventos, o conector atualiza o registro correspondente com o sys_id na tabela table_name com novos dados.

• Se um evento DELETE ocorrer, o sinalizador is_deleted do registro correspondente em table_name é definido como true.

Como obter o valor de exibição de um campo de referência¶

Nas tabelas do ServiceNow, alguns campos são campos de referência, que contêm referências a registros em outras tabelas.

No exemplo abaixo, o campo opened_by na tabela incident é um campo de referência que contém uma referência ao registro com o sys_id <sys_id> em outra tabela (sys_user):

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

Copy

Para mostrar os campos de referência na tabela, chame o procedimento armazenado SHOW_REFERENCES_OF_TABLE com o seguinte argumento:

CALL SHOW_REFERENCES_OF_TABLE('<table_name>');

Copy

Onde:

table_name

Especifica o nome da tabela para a qual você deseja mostrar os campos de referência.

Este procedimento armazenado inspeciona o esquema da tabela e retorna uma lista de objetos JSON contendo as seguintes propriedades:

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               |
|           |   }                                |
|           | }                                  |
+-----------+------------------------------------+