チュートリアル: Snowflake ServiceNow®データインジェクションコネクタのインストール¶

概要¶

このチュートリアルを使用して、Snowsightウィザードを使用してSnowflake Connector for ServiceNow ®を構成して理解し、いくつかのテーブルを選択してデータをインジェストし、クエリの例を実行します。

このチュートリアルは網羅的なものではありません。全機能と制限については、 Snowflake Connector for ServiceNow®V2 について をご確認ください。

ServiceNow®開発者インスタンスの設定¶

ServiceNow®アカウントでこのコネクタをテストしたくない場合は、開発者インスタンスを使用できます。このセクションでは、開発者インスタンスを設定する方法について説明します。

1. ServiceNow®開発者ウェブサイト にアクセスし、開発者ユーザーを作成します。

2. 新しく作成したユーザーで開発者ウェブサイトにログオンし、 Create an Instance を選択します。

3. インスタンスタイプを選択します。インスタンス URL、ユーザーとパスワードが記載されたメールを受け取ります。

デプロイは通常5分程度と、かなり迅速です。しかし、待っている間に、次のステップに進んでSnowflakeを構成しましょう！

Snowflakeアカウントの作成と設定¶

すべての前提条件を完了¶

Data Products -> Apps -> Snowflake Connector for ServiceNow からSnowflake Connector for ServiceNow®を起動します。コネクタがデータインジェスチョンを開始する前に完了する必要があるタスクのリストが表示されます。以下の説明をよくお読みになり、それぞれご記入ください。

最後のステップでは、OAuth2 認証を有効にする場合、アプリケーションレジストリを作成するよう求められます。次のいくつかのステップでは、これに焦点を当てます。

次のセクションでは、Snowflakeから ServiceNow®に特定のデータをコピーできるように、2つのブラウザタブを開くことをお勧めします。

• Snowflakeからコネクタを使用して、アプリケーションレジストリに貼り付けるリダイレクト URL を生成します。

• ServiceNow®から、クライアント ID とシークレットを提供するためにアプリケーションレジストリが必要になります。これらをSnowflakeに貼り付けます。

コネクタを構成する¶

1. Start configuration を選択します。この構成画面が表示されます。デフォルトで、フィールドはコネクタの構成時に作成されたオブジェクトの名前に設定されます。また、既存のオブジェクトを使用することもできます。選択された仮想ウェアハウスは、コネクタによってバックグラウンドでのデータインジェスチョンに使用されます。

2. 詳細については、 Snowflake Connector for ServiceNow®V2 の構成 をご確認ください。

3. Configure を選択します。

構成プロセスが完了するまでに数分かかる場合があることに注意してください。

ServiceNow® OAuth2 ハンドシェイクのためにSnowflakeを設定¶

1. 認証方法として OAuth2 を選択します。

2. ServiceNow®インスタンスの詳細を入力します。これは、ServiceNow®アカウントの ServiceNow® URL の最初の部分であり、 https://* プロトコルと後続の service-now.com は 含まれません。

3. ServiceNow®から Client id と Client secret をSnowflakeウィザードに貼り付けます。

4. Connect を選択します。ServiceNow®アカウントがポップアップ表示され、Snowflakeへの接続を要求します。

5. Allow を選択します。2つのシステム間で接続が確立されます。

接続を確認するには、3点リーダー [...] を選択し、 View Details を選択します。ポップアップの上部には、 ServiceNow が認証された日付が表示されます。

構成削除の同期¶

挿入と更新だけでなく、削除もSnowflakeに同期させたい場合は、ジャーナルテーブルの名前を指定する必要があります。デフォルトでは、ServiceNow®は削除された記録に関する情報を保存するために sys_audit_delete テーブルを使用します。削除を気にしないのであれば、このフィールドは空欄のままにしておいてもかまいません。

Validate を選択して、コネクタがソースシステムに接続でき、必要なすべてのテーブルにアクセスできるかどうかを確認します。プロセスが完了するまでに数分かかる場合があります。完了したら、 Define data to sync を選択し、インジェスチョンするテーブルを選択します。

ServiceNow®テーブルの選択¶

1. Snowflake Connector for ServiceNow ウィンドウの上部バーで、 Data Sync を選択します。

2. 後でテストクエリを実行できるように、いくつかのテーブルをインジェストする必要があります。検索ウィンドウから incident と入力し、その横にあるボックスにチェックを入れて、30分の同期時間を選択します。

3. 他のテーブルを選択するには、検索をクリアし、テーブル名を入力して’、チェックボックスを選択します。少なくとも task テーブルに対してこれを行います。

注釈

ヒント: 検索フィールドをクリアし、タイトル Status を選択すると、選択したすべてのテーブルがソートされ表示されます。

4. Start Sync を選択します。選択ウィンドウが閉じ、メインのコネクタウィンドウから Syncing Data というメッセージが表示されます。選択したテーブルに加え、3つのシステムテーブルもロードされます。 sys_dictionary、 sys_db_object、および sys_glide_object は生データの表示を構築するために必要です。

成功を示すメッセージが表示されます。このメッセージは、少なくとも1つのテーブルが完全にインジェストされると表示されます。

コネクタのモニタリング¶

ワークシートを開いてコネクタのステータスを調べます。以下は、モニタリング情報を得るために実行できる SQL クエリの例です。

// Return general information about all ingestions
SELECT * FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_stats;
// Search for information about particular table ingestions
SELECT * FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_stats WHERE table_name = '<table_name>';
// Examine connector configuration
SELECT * FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_configuration;
// Calculate ingested data volume
SELECT
    table_name,
    sum(ingested_rows) AS row_count
FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_stats
GROUP BY table_name
ORDER BY table_name;
// General connector statistics
SELECT * FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_overview;

インジェストしたデータへのアクセス設定¶

コネクタは、 DATA_READER アプリケーションロールを公開します。このロールには、宛先スキーマ内のすべてのインジェストされたデータへの読み取りアクセスがあります。インストールプロセスの 構成 ステップで提供されたロールに自動的に付与されます。このガイドの前半のスクリーンショットで、 SERVICE_NOW_RESOURCES_PROVIDER という名前を付けました。必要に応じて、アプリケーションロールまたはアカウントロールのいずれかをさらに付与することができます。

データのクエリ¶

コネクタが宛先データベースの宛先スキーマの下に作成したテーブルを調べます。同期用に構成された ServiceNow®内のテーブルごとに、コネクタは次のテーブルとビューを作成します。

• 各記録が単一の VARIANT 列に含まれる、生のデータを含む同じ名前のテーブル。

• フラット化された形式のデータを含む table_name__view という名前のビュー。このビューには、元のテーブルにある各列の列と、元のテーブルに存在する各記録の行が含まれています。

• table_name__view と同じデータと、ServiceNow®で削除された記録の行を含む table_name__view_with_deleted という名前のビュー。

• ServiceNow からコネクタが取得した変更の履歴を含むテーブル table_name__event_log。

生データからのクエリは、 生データへのアクセス をご確認ください。ビューをクエリするには（推奨）、 フラット化されたデータへのアクセス をご確認ください。

USE ROLE SERVICE_NOW_RESOURCES_PROVIDER;
USE DATABASE SERVICENOW_DEST_DB;
USE SCHEMA DEST_SCHEMA;
WITH T1 AS (
    SELECT
    DISTINCT
        T.NUMBER AS TICKET_NUMBER,
        T.SHORT_DESCRIPTION,
        T.DESCRIPTION,
        T.PRIORITY,
        T.SYS_CREATED_ON AS CREATED_ON,
        T.SYS_UPDATED_ON AS UPDATED_ON,
        T.CLOSED_AT
    FROM TASK__VIEW T
    LEFT JOIN INCIDENT__VIEW I
        ON I.SYS_ID = T.SYS_ID -- ADDITIONAL INCIDENT DETAIL
   WHERE I.SYS_ID IS NOT NULL -- THIS CONDITION HELPS KEEP JUST THE INCIDENT TICKETS
)
SELECT
 YEAR(CREATED_ON) AS YEAR_CREATED,
 MONTH(CREATED_ON) AS MONTH_CREATED,
 PRIORITY,
 COUNT(DISTINCT TICKET_NUMBER) AS NUM_INCIDENTS
FROM T1
GROUP BY
    YEAR_CREATED,
    MONTH_CREATED,
    PRIORITY
ORDER BY
    YEAR_CREATED,
    MONTH_CREATED,
    PRIORITY
;

コネクタへのアクセス許可¶

コネクタは、宛先データベースのデータにアクセスするために使用されるロールの他に、2つのアプリケーションロールを公開します。

• VIEWER ロールには、コネクタの構成と状態への読み取り専用アクセスがあります。

• コネクタの設定を変更し、インジェストを有効/無効にできる ADMIN。

エラーをモニターし、統計を実行し、コネクタの統計を調べ、有効化されたテーブルを調べるために、コネクタデータベースのビューと読み取り専用プロシージャへのアクセスを許可する ServiceNow®モニタリングロールを設定できます。

たとえば、ワークシートで以下を実行します（その後、ロールを使用します）。

USE ROLE accountadmin;
CREATE ROLE IF NOT EXISTS servicenow_monitor_role;
GRANT APPLICATION ROLE SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.viewer TO ROLE servicenow_monitor_role;
GRANT USAGE ON WAREHOUSE SERVICENOW_WAREHOUSE TO ROLE servicenow_monitor_role;

インジェスチョンの停止¶

このチュートリアルでは、データをインジェストしているだけであるため、その初期ロードの後にインジェスチョンを停止することは理にかなっています。しかし、本番環境では、コネクタを停止することはないでしょう。

1. Snowsightで、 Snowflake Connector for ServiceNow タイルを選択します。

2. Snowflake Connector for ServiceNow ウィンドウで、 Pause Connector を選択します。

コネクタのアンインストール（データはアンインストールしません）。¶

チュートリアルを完了した場合、または何らかの理由でコネクタが不要になった場合は、Snowflake Marketplaceから簡単にアンインストールできます。

1. データ製品 を選択し、次に アプリ を選択します。

2. コネクタアプリを表すリスト上の項目で、3つのドットのアイコンを選択します。

3. アンインストール を選択します。

4. アプリケーションによって所有されているオブジェクト（宛先スキーマでインジェストされたデータを含むテーブルとビュー）を削除するか、それらの所有権を別のロールに譲渡するかを決定します。

5. アンインストール を選択します。

結論とリソース¶

おめでとうございます。Snowflake Connector for ServiceNow®を正常にインストールおよび構成し、データをインジェストしてクエリを実行し、インシデントと優先度に関する洞察を収集しました。

学習した内容

• Snowflake Connector for ServiceNow®を設定する方法。

• ServiceNow®データをSnowflakeにインジェストする方法。

• 開発環境で不要なコストを回避するためにコネクタを停止する方法。