Snowflake Connector for ServiceNow®V2 の管理、更新、およびアンインストール¶

Snowflake Connector for ServiceNow®V2 の一時停止と再開¶

次のセクションでは、コネクタを一時停止および再開する方法について説明します。

CALL PAUSE_CONNECTOR();

CALL RESUME_CONNECTOR();

コネクタが使用するウェアハウスの変更¶

コネクタが使用するウェアハウスを変更するか、専用のウェアハウスを追加するには、次を呼び出します。

CALL UPDATE_WAREHOUSE('<warehouse_name>');

Copy

条件:

warehouse_name

コネクタが使用するウェアハウスの名前を指定します。

テーブルの削除¶

テーブルを削除して（例: 意図せずに有効になった場合）、 コネクタをモニターするためのビュー に表示しないようにするには、次のプロシージャを使用します。

CALL DELETE_TABLE('<table_name>');

Copy

条件:

table_name

削除するテーブルの名前を指定します。このテーブルは、 無効 になっており、 リロード 中であってはなりません。

USE ROLE ACCOUNTADMIN;
GRANT OWNERSHIP ON TABLE <destination_database>.<destination_schema>.<table_name> TO ROLE <account_role> REVOKE CURRENT GRANTS;
USE ROLE <account_role>;
DROP TABLE <destination_database>.<destination_schema>.<table_name>;

コネクタが使用するリフレッシュトークンのリフレッシュ¶

OAuth 認証コードでコネクタを設定した場合は、更新トークンを定期的に更新する必要があります。それ例外の場合は、トークンの有効期限が切れた後にコネクタは ServiceNow®にアクセスできなくなります。デフォルトでは、トークンの有効期限は生成から90日です。

コネクタに メールアラート を構成すると、毎月1日に更新トークンを更新するリマインダーが表示されます。トークンの有効期限が切れると、コネクタが ServiceNow®にアクセスする際に問題が発生した場合に、メールが届きます。

基本認証コード ServiceNow®パスワードの更新¶

パスワードを更新するには、既存のシークレットを見つけて ALTER SECRET コマンドを使用して変更する必要があります。

1. Snowsightまたは SQL コマンドのいずれかを使用して、シークレットオブジェクトの完全修飾名を確認します。

   1. Snowsight を使用してシークレットを取得するには、次を行います。

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

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

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

      4. トップナビゲーションメニューで Settings » Authentication を選択します。

         Authentication セクションにはシークレットオブジェクトが表示されます（例: CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD.SECRET）。

   2. SQL コマンドを使用してシークレットオブジェクトの完全修飾名を取得するには、 CONNECTOR_CONFIGURATIONビュー をクエリします。

      SELECT value FROM connector_configuration WHERE config_key = 'secret';
      

      Copy

2. コネクタを 一時停止 します。

3. ALTER SECRET コマンドを実行し、以下の PASSWORD パラメーターを変更して、シークレットオブジェクトを更新します。

4. コネクタを 再開 します。

   パスワードが更新され、コネクタにより使用されます。

ServiceNow®インスタンスへの接続の更新¶

ServiceNow®インスタンスへの接続を更新できます。コネクタで使用される外部アクセス統合とシークレットを変更できます。コネクタ内の外部アクセス UDF からシークレットが切り離された場合の問題を修正することもできます。

接続構成は次の手順で更新できます。

CALL UPDATE_CONNECTION_CONFIGURATION({
  'service_now_url': '<servicenow_base_url>',
  'secret': '<secret_name>',
  'external_access_integration': '<external_access_integration_name>'
});

条件:

servicenow_base_url

コネクタが使用する ServiceNow®インスタンスの URL を指定します。URL は、コネクタのインストール時と同じ値に設定する必要があり、次の形式にする必要があります。

https://<servicenow_instance_name>.service-now.com

Copy

ServiceNow®インスタンス URL の変更はサポートされていません。

secret_name

ServiceNow®への認証用の認証情報を含むシークレットオブジェクト の完全修飾名を指定します。

シークレットオブジェクトの完全修飾名を次の形式で指定する必要があります。

<database_name>.<schema_name>.<secret_name>

Copy

データベース、スキーマ、シークレットの名前は、有効な オブジェクト識別子 である必要があります。

external_access_integration_name

ServiceNow®外部アクセス統合 の名前を指定します。

統合の名前は、有効な オブジェクト識別子 である必要があります。

たとえば、 ServiceNow®インスタンスへの接続を更新するには、次を満たしている必要があります。

• URL https://myinstance.service-now.com がある。

• secretsdb.apiauth.servicenow_creds_oauth_code に格納されているシークレットを使用する。

• servicenow_external_access_integration という外部アクセス統合を使用している。

次のコマンドを実行します。

CALL UPDATE_CONNECTION_CONFIGURATION({
  'service_now_url': 'https://myinstance.service-now.com',
  'secret': 'SECRETSDB.APIAUTH.SERVICENOW_CREDS_OAUTH_CODE',
  'external_access_integration': 'SERVICENOW_API_INTEGRATION'
});

構成の更新は、 ADMIN アプリケーションロールに付与されたユーザーのみが実行できます。さらに、プロシージャを実行するには、コネクタは paused 状態である必要があります。 コネクターの一時停止 をご参照ください。

コネクタの状態のエクスポート¶

現在のコネクタの状態と構成のスナップショットをエクスポートできます。エクスポートされたコネクタ状態のスナップショットは、コネクタを再インストールして既に有効になっているテーブルとインジェスチョンの状態を保持する場合や、障害復旧を支援するために宛先スキーマのフェールオーバー地域への複製を構成する場合に便利です。

状態は以下の手順でエクスポートできます。

CALL EXPORT_CONNECTOR_STATE();

Copy

プロシージャは、エクスポートされた状態で宛先スキーマに新しい __CONNECTOR_STATE_EXPORT テーブルを作成します。エクスポートを実行するには、以下の条件を満たす必要があります。

• エクスポートは、 ADMIN アプリケーションロールに付与されたユーザーのみが実行できます。

• 進行中のテーブル リロード はありません。

構成は、 構成されたスケジュール に従ってコネクタがインジェスチョンをトリガーするたびに、次の条件が満たされていれば自動的にエクスポートされます。

• 少なくとも1つのテーブルがインジェスチョンに有効になっています。

• 継続的なテーブルのリロードはありません。

アプリケーションのアンインストール¶

このセクションでは、Snowsightおよびワークシート付きのアプリケーションをアンインストールする方法、およびコネクタによって作成されたオブジェクトを削除する方法について説明しますが、ユーザーによって意図的に削除される必要があります。

コネクタのアップグレード¶

コネクタは自動的にアップグレードされるため、ユーザーは最新のアプリケーションを使用するために何もする必要がありません。

コネクタのスケーリング¶

インジェストされる ServiceNow®テーブルの数が多く、同時にインジェストされるテーブルの数を増やしたい場合は、以下のようにパラメーターを変更します。

CALL CONFIGURE_CONCURRENCY(<number>);

Copy

条件:

number

同時にテーブルをインジェストできるワーカーの最大数を指定します。デフォルトでは、この値は10に設定されています。

データインジェスチョンに使用するウェアハウスのサイズを変更するのと同時に、同時並行を増やすことも検討する必要があります。動作が遅くなる場合は、ウェアハウスのサイズを変更してみてください。詳細については、 ウェアハウスでの作業 をご参照ください。

ServiceNow®データに同じデータベースとスキーマを使用したコネクタの再インストール¶

コネクタを再インストールするには、以下の手順に従ってください。

1. TABLES_STATE ビューをクエリして、現在 RELOADING ステータスのテーブルがないことを確認します。

   SELECT TABLE_NAME FROM TABLES_STATE WHERE STATUS = 'RELOADING';
   

   Copy

2. 現在リロード中のテーブルがある場合は、リロードが完了するまで待つか、 キャンセルしてください。

3. 次のストアドプロシージャを呼び出してコネクタを停止します。

   CALL PAUSE_CONNECTOR();
   

   Copy

4. コネクタの状態と構成をエクスポートします。詳しくは、 このセクション をご参照ください。

   重要

   コネクタアプリケーションを削除する 前 に、コネクタの状態と構成をエクスポートすることをお勧めします。これにより、すべてのカスタムオプション（たとえば、同期が有効になっているテーブルやそのスケジュール）と、新しいインストールで最も新しく変更された状態が保持されます。

   インジェストされたデータを含むデータベースとスキーマをそのまま残してコネクタを既に削除した場合でも、自動的にエクスポートされた状態に基づいてコネクタを再インストールできますが、再インストールされたコネクタは一部の記録のインジェストを繰り返す可能性があります。

5. コネクタを削除 し、 宛先スキーマのテーブルとビューの所有権を譲渡します。

6. 次によりコネクタを再インストールします。

   • Snowsightを使用してコネクタを再インストールします （推奨）。

   • SQL を使用してコネクタを再インストールします。

インストールのプロセス中、

• 以前に使用したデータベースとスキーマを提供します。

  インストール後、コネクタはデータベースとスキーマにインジェストされたデータが含まれていることを検出し、再インストール前の場所からインジェスチョンを続行します。コネクタの状態をエクスポートし、インストール中に正常にインポートされると、以前にインジェストされたテーブルは同じスケジュールと構成で自動的に有効になります。それ以外の場合は、手動ですべてのテーブルを有効にし、スケジュールを設定するなどして、インジェスチョンを復元する必要があります。

  SQL コマンドを使用して再インストールする場合は、SQL インストールガイドに記載されているように、宛先スキーマのビューとテーブルの所有権をコネクタに譲渡することを忘れないでください。そうしないと、コネクタはこれらのテーブルやビュー表示にアクセスできず、インジェスチョンを再開できません。

• 同じ ServiceNow®インスタンス名を提供してください。

• 他の引数については、 コネクタのインストール時に作成したオブジェクト を再利用するか、新しいオブジェクトを使用できます。