Snowflakeでの ServiceNow®データへのアクセス¶

Snowflakeでの ServiceNow®データにアクセスする権限の付与¶

Snowflake Connector for ServiceNow®V2 がSnowflakeとデータを同期した後、ロールが ServiceNow® データにアクセスするには次が必要です。

• Snowflakeで ServiceNow® データを含むデータベースとスキーマに対する USAGE 権限、 および

• DATA_READER アプリケーションロール。

Snowflakeは、インジェストされた ServiceNow® データへのアクセスが必要なユーザーに付与できる、これらの権限を持つ専用のロールを作成することをお勧めします。コネクタが Snowsightと一緒にインストール されている場合、 構成 ステップ中に提供されたロールには必要な権限が既にあります。

たとえば、 ServiceNow® データを dest_db データベースと dest_schema スキーマに格納するように my_connector_servicenow と呼ばれるコネクタアプリケーションを構成した場合は、 servicenow_data_reader_role という名前のロールを作成し、データにアクセスする権限をそのロールに付与できます。

次の例は、これらの権限を付与する方法を示しています。

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 APPLICATION ROLE my_connector_servicenow.DATA_READER to role servicenow_data_reader_role;

Copy

生データへのアクセス¶

同期する ServiceNow® テーブルごとに、 Snowflake Connector for ServiceNow®V2 はデータベースに同じ名前の新しいテーブルを作成し、Snowflakeで ServiceNow® データのスキーマを作成します。

たとえば、 ServiceNow® データを dest_db データベースと dest_schema スキーマに格納するようにコネクタを構成し、 ServiceNow® の incident テーブルを同期するようにコネクタを構成した場合、コネクタは dest_db.dest_schema.incident という名前のテーブルを作成します。

このテーブルには、 ServiceNow® から取り込まれた生データが含まれています。このテーブルには次の列が含まれます。

以下は、 dest_db.dest_schema.incident テーブルのデータを取得する SELECT ステートメントの出力例です。

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

フラット化されたデータへのアクセス¶

データを含むテーブルごとに、コネクタは生データに対して2つのフラット化されたビューを作成します。ビューの名前は、サフィックス __view と __view_with_deleted が付いたテーブルの名前です。たとえば、 incident という名前の ServiceNow® テーブルの場合、コネクタは次のビューを作成します。

• dest_db.dest_schema.incident__view

• dest_db.dest_schema.incident__view_with_deleted

__view サフィックスを持つビューには、 ServiceNow® テーブルにある記録が含まれています。 __view_with_deleted サフィックスを持つビューには、これらの同じ記録と、 ServiceNow® テーブルから削除された記録が含まれています。

次の点に注意してください。

• これらのビューにある列の名前は大文字です。小文字の名前を使用してこれらの列にアクセスすることはできません。

• 時刻とタイムスタンプを持つ列は、ServiceNow インスタンスで設定されたタイムゾーンに関係なく、常に UTC タイムゾーンを使用して保存されます。その結果、 ServiceNow インスタンスの構成によっては、表示される値が ServiceNow インスタンスで表示される値と異なる場合があります。違いは表示された値に対してのみ関連しています。ServiceNow とSnowflakeのタイムスタンプは同じ時点を参照しています。

• 空のテーブルのビューはありません。 ServiceNow® のテーブルにデータが表示された後、ビューが作成されます。

• コネクタはスキーマの変更を処理しますが、コネクタはデータをリロードしません。

  その結果、スキーマが変更された場合、古いスキーマの記録は更新されません。

以下は、 dest_db.dest_schema.incident_view ビューからデータを取得する SELECT ステートメントの出力例です。この例では、 ServiceNow® の incident テーブルに、 ACTIVE、 APPROVAL、 CATEGORY、および 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

テーブルのイベントログの表示¶

Snowflake Connector for ServiceNow®V2 は、 ServiceNow® の記録に加えられた変更を追跡できます。この追跡情報は、イベントログと呼ばれるテーブルに格納されます。

同期が有効になっている ServiceNow® テーブルごとに、コネクタは <destination_db>.<destination_schema>.<table_name>__event_log という名前のイベントログテーブルをSnowflake内に作成します。

各イベントログテーブルには、次の列があります。

イベントログには、対応する ServiceNow® テーブルのデータ変更の履歴が反映されます。たとえば、新しい記録が ServiceNow® の u_ip_port テーブルに挿入された場合、 INSERT イベント型に設定された event_type を待つ記録が、Snowflakeの dest_db.dest_schema.u_ip_port__event_log テーブルに追加されます。

同様に、 ServiceNow® のテーブルで記録が更新または削除されると 、 UPDATE または DELETE に設定された event_type を持つ記録が dest_db.dest_schema.u_ip_port__event_log テーブルに追加されます。

生データ（dest_db.dest_schema.table_name）を含む Snowflakeのテーブルは、対応するイベントログテーブル（dest_db.dest_schema.table_name__event_log）から派生します。例:

• INSERT イベントの記録が table_name__event_log に追加されると、コネクタは対応する記録を table_name テーブルに追加します。

• 特定の sys_id の UPDATE イベントがイベントログテーブルに追加された場合、コネクタは table_name テーブルの sys_id に対応する記録を新しいデータで更新します。

• DELETE イベントが発生すると、 table_name 内の対応する記録の is_deleted フラグが true に設定されます。

参照フィールドの表示値の取得¶

ServiceNow® テーブルの一部のフィールドは、他のテーブルの記録への参照を含む 参照フィールド です。

以下の例では、 incident テーブルのフィールド opened_by は、別のテーブル（sys_user）の sys_id <sys_id> を持つ記録への参照を含む参照フィールドです。

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

Copy

テーブルの参照フィールドを表示するには、次の引数を指定して SHOW_REFERENCES_OF_TABLE ストアドプロシージャを呼び出します。

CALL SHOW_REFERENCES_OF_TABLE('<table_name>');

Copy

条件:

table_name

参照フィールドを表示するテーブルの名前を指定します。

このストアドプロシージャは、テーブルのスキーマこの保存された検査し、次のプロパティを含むオブジェクトの JSON リストを返します。

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