Snowsightを使用したコネクタのインストールと構成

このトピックでは、Snowsightを介して ServiceNow 用Snowflakeコネクタをインストールおよび構成する方法について説明します。

このトピックの内容:

ServiceNow 用Snowflakeコネクタのインストール

次の手順では、コネクタをインストールする方法について説明します。

  1. ACCOUNTADMIN ロールを持つユーザーとして Snowsight にサインインします。

  2. 左側のナビゲーションで Marketplace を選択します。

  3. ServiceNow 用Snowflakeコネクタを検索し、コネクタのタイルを選択します。

  4. Snowflake Connector for ServiceNow のページで、 Get を選択します。

    これにより、インストールプロセスの最初の部分を開始するために使用するダイアログが表示されます。

    ダイアログで、次のように構成します。

    1. Database name フィールドに、コネクタインスタンスのデータベースとして使用するデータベースの名前を入力します。このデータベースは自動的に作成されます。

    2. Warehouse used for installation フィールドで、コネクタのインストールに使用するウェアハウスを選択します。

      注釈

      これは、コネクタが ServiceNow からのデータを同期するために使用するウェアハウスとは異なります。後のステップで、この目的のために別のウェアハウスを作成します。

    3. Which roles, in addition to ACCOUNTADMIN, can access this database? フィールドに、データベースへのアクセスを許可するその他のロールを追加します。

    4. Get を選択します。

  5. ダイアログが通知とともに表示されます。 <データベース名> is now ready to use in your account.。構成を続行するには、 Manage を選択します。

    ダイアログが閉じ、 Snowflake Connector for ServiceNow ページに、コネクタを構成および管理するための UI が表示されます。

ServiceNow への接続の設定

次の手順では、 ServiceNow への接続を設定する方法について説明します。

  1. Connections セクションで、 Connect を選択して、 ServiceNow インスタンスに接続するための設定を構成します。

    これにより、 Connect to ServiceNow ダイアログが表示されます。

  2. ServiceNow Instance フィールドに、 ServiceNow インスタンスの名前を入力します。

    これは、 ServiceNow インスタンスホスト名の最初の部分です。たとえば、 ServiceNow インスタンスへの URL が次の場合、

    https://myinstance.service-now.com
    
    Copy

    インスタンスの名前は myinstance になります。

  3. Authentication Method フィールドで、コネクタが ServiceNow インスタンスに接続できるようにするために使用する認証方法を選択します。

    基本認証(ユーザー名とパスワード)または OAuth のいずれかを選択できます。

  4. Basic authentication を選択した場合は、 ServiceNow アカウントの認証情報を ServiceNow username フィールドと ServiceNow password フィールドに入力します。

  5. OAuth を選択した場合は、 ServiceNow にアプリケーションレジストリを作成し、それを使用してコネクタを構成します。

    アプリケーションレジストリを作成するには、次を実行します。

    1. ServiceNow インスタンスにログインし、 Homepage を選択します。

    2. OAuth を検索し、 Application Registry を選択します。

    3. New, を選択してから、 Create an OAuth API endpoint for external clients を選択します。

      次の画像に示すように、アプリケーションレジストリの構成ページが表示されます。

      Displays the Application Registry page in ServiceNow on the left.
    4. ServiceNow で、 Name フィールドに OAuth アプリケーションレジストリの名前を入力します。

    5. コネクタ UI で、 Redirect URL フィールドの値をコピーします。

      この値は、コネクタによって生成されました。

    6. ServiceNow で、この値を Redirect URL フィールドに貼り付けます。

    7. 必要に応じて、 ServiceNow で、 Refresh Token Lifespan フィールドと Access Token Lifespan フィールドの値を更新します。

      • Snowflakeは、アクセストークンの有効期間を少なくとも600秒に設定することをお勧めします。

      • 更新トークンの有効期間には、7776000(90日)の値を指定します。

    8. ServiceNow で、 Submit を選択します。

      OAuth アプリケーションレジストリがアプリケーションレジストリのリストに表示されます。

    9. ServiceNow で、作成したばかりのアプリケーションレジストリを選択します。

      ServiceNow が Client ID フィールドと Client Secret フィールドの値を作成したことに注意してください。

    10. ServiceNow で、 Client ID の値をコピーします。

    11. この値をコネクタ UI の Client ID フィールドに貼り付けます。

    12. ServiceNow で、 Client Secret の値をコピーします。

    13. この値をコネクタ UI の Client Secret フィールドに貼り付けます。

      コネクタは、 シークレット (スキーマレベルオブジェクトの一種)を使用して、 ServiceNow インスタンスへの認証に使用されるアクセストークンを格納します。コネクタは、このシークレットオブジェクトをセキュリティ統合および API 統合と共に使用して、 ServiceNow インスタンスに接続します。

      コネクタをインストールすると、シークレット、セキュリティ統合、および API 統合が自動的に作成されます。

    14. シークレットオブジェクト、セキュリティ統合、および API 統合の構成方法を指定するには、 Advanced Settings を選択し、次のフィールドに入力します。

      フィールド

      説明

      Secret Name

      シークレットの名前。コネクタはこの値を生成します。この値は変更できません。

      Authorization URL

      ServiceNow インスタンスへの認証用 URL。この URL は次の形式にする必要があります。

      https://<instance_name>.service-now.com/oauth_token.do
      
      Copy

      instance_name は ServiceNow インスタンスの名前です。

      Token URL

      ServiceNow インスタンスの更新トークンをリクエストするための URL。この URL は次の形式にする必要があります。

      https://<instance_name>.service-now.com/oauth_token.do
      
      Copy

      instance_name は ServiceNow インスタンスの名前です。

      Allowed Prefix

      ServiceNow インスタンスへの URL。

      これにより、これらの接続設定の使用が制限されます。この設定は、指定されたプレフィックスを持つ URLs に接続するためにのみ使用できます。

  6. コネクタ UI で、 Connect を選択します。

    ユーザー名とパスワードを使用して ServiceNow インスタンスにログインするよう求めるダイアログが表示されます。コネクタに認証させたいユーザーの認証情報を入力します。 ServiceNow インスタンスの準備 にリストされている権限を持っている必要があります。

  7. ログインすると、コネクタに ServiceNow アカウントへの接続を許可することを確認するダイアログが表示されます。 Allow を選択します。

    注釈

    認証情報を入力することなくこのダイアログに直接リダイレクトされた場合、 ServiceNow インスタンスに既にログインしています。コネクタが使用するユーザーと同じユーザーとしてログインし、そのユーザーに必要な権限があることを確認します。注意: 現在ログインしているユーザーはダイアログの右上隅に表示されます。

    新しい ServiceNow 接続が Connection 領域に表示されます。

これらのステップにより、コネクタが動作するために必要な、コネクタデータベースの外部に存在する次のオブジェクトをウィザードは作成します。

  • シークレットオブジェクトの保存に使用されるスキーマ SERVICENOW_GZSTZTP0KHD を持つデータベース CONNECTORS_UI

  • ServiceNow 認証情報を持つ SECRET という名前の CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD 内のシークレットオブジェクト、

  • 認証方法として OAuth 認証が選択された場合に、Snowflakeとサードパーティの OAuth 2.0サービスを統合するために使用される SERVICENOW_GZSTZTP0KHD_INTEGRATION という名前のセキュリティ統合、

  • ServiceNow との通信に使用される、 API 統合 SERVICENOW_GZSTZTP0KHD_API

これらのオブジェクトの名前は 絶対に変更しないでください。コネクタはオブジェクトを名前で参照します。オブジェクトの名前を変更またはドロップすると、参照が崩れ、コネクタが破損してしまいます。

ServiceNow 用Snowflakeコネクタの構成

  1. ACCOUNTADMIN ロールを持つユーザーとして Snowsight にサインインします。

  2. 左側のナビゲーションで Marketplace を選択します。

  3. ServiceNow 用Snowflakeコネクタを検索して選択します。

  4. コネクタのステータスで、 Configure を選択します。

    これにより、 Configure Connector ダイアログが表示されます。

    注釈

    デフォルトでは、フィールドはコネクタの構成時に作成されるオブジェクトの名前に設定されます。Snowflakeは、これらのフィールドに新しいオブジェクトを使用することをお勧めします。ただし、必要に応じて既存のオブジェクトの名前を指定できます(例: コネクタを再インストールする場合)。

    このダイアログで、次のフィールドに入力します。

    フィールド

    説明

    Warehouse

    コネクタ専用の新しい仮想ウェアハウスの識別子。

    アカウントに一意の名前を指定します。ウェアハウスの名前は、有効な オブジェクト識別子 である必要があります。

    注釈

    コネクタのインストールの開始時に選択したものと同じウェアハウスを指定しないでください。

    構成プロセスにより、指定された名前で新しい Large ウェアハウスが作成されます。

    Destination Database

    Snowflake内にある ServiceNow データのテーブルを含むスキーマを含む新しいデータベースの識別子。

    アカウントに一意の名前を指定します。データベースの名前は、有効な オブジェクト識別子 である必要があります。

    構成プロセスにより、指定された名前で新しいデータベースが作成されます。

    Destination Schema

    Snowflake内にある ServiceNow データを含む新しいスキーマの識別子。

    ServiceNow 用Snowflakeコネクタは、 ServiceNow データをこのスキーマのテーブルにインジェストします。

    アカウントに一意の名前を指定します。スキーマの名前は、有効な オブジェクト識別子 である必要があります。

    構成プロセスにより、指定された名前で新しいスキーマが作成されます。

    Role

    コネクタ用の新しいカスタムロールの識別子。このロールにより、コネクタは次を実行できるようになります。

    • データを取り込むためのタスクを作成し、管理する。

    • 専用のウェアハウスを使用する。

    • ServiceNow インスタンスに接続するために、シークレットと API 統合にアクセスする。

    このロールは、コネクタによってインジェストされた ServiceNow データを含むテーブルとビューの所有者でもあります。

    アカウントに一意の名前を指定します。ロールの名前は、有効な オブジェクト識別子 である必要があります。

    構成プロセスにより、指定された名前で新しいロールが作成されます。

    インジェスト開始後にインジェストされたデータにアクセスするためのより詳細に設定されたロールを別途作成することをお勧めしますが、このロールを使用してインジェストされたデータをクエリすることができ、さらに権限を追加してこのロールを拡張することができます。逆に、コネクタが必要とするオブジェクトに対するロール権限の取り消しや、取り込まれたデータを持つテーブルやビューのロール所有者の変更は許可されておらず、コネクタが破壊されます。

    Journal table

    (オプション)削除された記録の反映を有効にするには、削除された記録に関する情報のソースとして機能するテーブルにこれを設定します。

    削除された記録に関する情報のソースとして、 sys_audit_delete テーブルまたはカスタムジャーナルテーブルのいずれかを使用できます。

    削除された記録を ServiceNow からSnowflakeにインジェストしない場合は、このフィールドを空のままにします。

    注釈

    コネクタの ServiceNow ユーザーが、指定されたジャーナルテーブルにアクセスできることを確認してください。

  5. Configure を選択します。

ダイアログが閉じ、コネクタのステータスが Provisioning に変わります。構成プロセスが完了するまでに数分かかる場合があります。

Connector Objects セクションには、インストールおよび構成中に自動的に作成されたオブジェクトが表示されます。コネクタはこれらのオブジェクトを使用して、 ServiceNow インスタンスからデータをインジェストします。オブジェクトの詳細を表示するには、オブジェクトを選択します。

構成プロセスが正常に終了すると、表示されるステータスが Inactive に変わります。

コネクタは、ウェアハウス、宛先データベース、宛先スキーマ、ロールを名前で参照します。これらのオブジェクトの名前を変更または削除すると、参照が崩れ、結果としてコネクタが破損してしまいます。ウェアハウスの名前を変更する代わりに、 CONFIGURE_WAREHOUSE ストアドプロシージャを使用して、コネクタが使用するウェアハウスを変更します。

構成中のエラーのトラブルシューティング

構成プロセス中にエラーが発生した場合、コネクタのステータスは Incomplete に変わります。エラーを特定して対処するには、

  1. Retry Setup を選択して、構成ダイアログを再度表示します。

  2. いずれかのフィールドの下にあるエラーメッセージを確認します。

  3. フィールドの問題を修正し、 Configure を選択して構成プロセスを再度開始します。

データインジェスチョンの設定

コネクタをインストールして構成したら、 ServiceNow データのデータインジェスチョンの設定 で説明されているステップを実行します。