Snowflake Connector for ServiceNow® V2 リリースノート¶

動作の変更¶

• The connector no longer has a 128 MB memory limit for uncompressed responses from the ServiceNow API.

新機能¶

該当なし

バグ修正¶

該当なし

動作の変更¶

• Custom journal tables are currently disabled. They'll be restored with new functionality in a future release.

• When you pause the connector, only worker tasks are forcefully canceled. Other tasks keep running until they finish, so pausing might take a bit longer.

新機能¶

• The connector now lets you use NOT LIKE and NOT IN operators for row filtering, so you can filter your data more flexibly during ingestion.

バグ修正¶

• The connector now retries curl errors more times, making it more resilient to network issues in Azure deployments.

動作の変更¶

該当なし

新機能¶

• HTML 応答のログを改善しました。

• 外部アクセスのエラー処理を改善しました。

バグ修正¶

該当なし

動作の変更¶

該当なし

新機能¶

• 必要に応じてページサイズを縮小することにより、データ解凍中の大きな応答サイズの処理を改善しました。

バグ修正¶

該当なし

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

• 状態のインポート中にスキーマテーブルが誤って作成される問題を修正しました。

• フィルター済みのリロードモードにおいて、一部の状態イベントが間違った順序で保存され、更新が欠落する問題を修正しました。

• ServiceNow からの大きな応答の処理を改善しました。

• ServiceNow 応答プロパティのより詳細なログを追加しました。

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

• コネクタが表示値を取得するようにグローバルに構成されている場合に、リロード時にメタデータテーブルが誤ってインジェストされる問題を修正しました。この問題の結果、一部のテーブルではフラット化されたビューが作成されませんでした。この問題が発生した場合は、次のメタデータテーブルを再ロードする必要がありました。

  • sys_dictionary

  • sys_db_object

  • sys_glide_object

動作の変更¶

• sys_created_on または sys_updated_on 列の記録でnull値の場合、コネクタは最後のインジェスチョン以降に記録が変更された場合にのみ更新イベントを挿入します。以前は、記録が変更されたかどうかに関係なく、コネクタは各インジェスチョンサイクル中にイベントログテーブルに更新イベントを挿入していました。この動作により、テーブルに変更が見つからなかった場合でも、イベントログテーブルが無期限に拡大する可能性があります。

新機能¶

該当なし

バグ修正¶

• フィルターインジェスチョン中にコネクタが試行するページサイズの範囲を増やしました。データをフェッチするときに、ServiceNow® API から発生するタイムアウトエラーに対するコネクタの回復力を高めました。

• インジェストを実行するために必要な内部コネクタ情報を保持するように、内部クリーンアップジョブを修正しました。以前は、この情報が削除されると、インジェスチョンが失敗する可能性がありました。

• フラット化されたビューの作成中に発生したエラーを修正しました。このエラーは、内部コネクタテーブルの 列が欠落しているために発生しました。

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

• テーブルの再読み込み時のページサイズの永続性に関する問題を修正しました。

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

• 文字列値に対して行フィルター式を使用すると、コネクタの状態のエクスポートに失敗することがある問題を修正しました。

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

• HTTPレスポンスの解析に失敗することがあった問題を修正しました。場合によっては、この問題が原因でServiceNow®からのデータの取り込みに失敗することがありました。

動作の変更¶

該当なし

新機能¶

• 連続スケジュールのサポートを追加しました。この機能を使用して、1分ごとに実行される最大20テーブルの取り込みスケジュールをセットできます。Snowflakeでは、連続スケジュールの使用には慎重を期し、また、Snowflakeでリアルタイムに近いデータを必要とするテーブルに限定して使用することをお勧めしています。この機能を有効にするには、 ENABLE_TABLE または CONFIGURE_TABLES_SCHEDULE プロシージャを使用します。詳しくは、 同期スケジュールの指定 をご覧ください。

• 同時にインジェストできるテーブルの最大数が30から50に増えました。このアップデートにより、ウェアハウスの利用率が向上し、全体的なパフォーマンスが向上します。詳しくは、 コネクタのスケーリング をご覧ください。

バグ修正¶

• コネクタがより安定し、複数のテーブルを並行して取り込む際のパフォーマンスも向上しています。

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

• コネクタの状態のエクスポートに失敗するバグを修正しました。

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

• ServiceNow®からのAPIレスポンスの解析処理で、レスポンス中のヘッダー名が期待された形式に一致しない場合に失敗するバグを修正しました。

• テーブルに対してフィルターリロードを実行した場合に、コネクタの状態と構成のエクスポートに失敗するバグを修正しました。

動作の変更¶

該当なし

新機能¶

• DELETE_TABLE プロシージャがオプションの drop_related_objects （boolean）パラメーターを受け取るようになります。このパラメーターが true にセットされている場合、プロシージャはフラット化されたビュー、イベントログテーブル、シンクテーブルなど、テーブルに関連するすべてのオブジェクトを削除します。

• RELOAD_TABLE プロシージャで sys_ids パラメーターを使用する場合、フィルターされたリロード機能が削除の検出に対応し、これらの記録をフィルターできるようになります。このリリース以前は、フィルターリロード機能はデータの更新と挿入のみを検出していました。

バグ修正¶

• フィルターリロードの実行時に、CONNECTOR_STATS ビューの取り込まれた行統計のエラーを修正しました。

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

• ウェアハウスの消費量が増加する可能性のあるパフォーマンスの最適化を元に戻しました。

動作の変更¶

• リロードしたテーブルの構成詳細を見るには、 CONFIGURED_TABLES ビューではなく、新しい RELOADED_TABLES ビューを使用します。この新しいビューには、 CONFIGURED_TABLES ビューのテーブルの構成値に加え、テーブルに使用されたリロード構成とテーブルのリロードステータスに関する情報を提供する新しい列が含まれます。詳細については、 コネクタの監視について をご覧ください。

新機能¶

• OAuth クライアント認証情報の付与フローのサポートを追加しました。OAuthをセットアップする場合は、OAuth認証コード付与フローではなく、このフローを使用することをお勧めします。詳細については、 OAuthのセットアップ方法 をご覧ください。コネクタがすでに別のOAuthフローで構成されていて、その後クライアント認証情報の付与フローを使用するように構成する場合は、可能であれば以下のタスクを実行することをお勧めします。

  • クライアント認証情報を使用するように、シークレットオブジェクトとセキュリティ統合オブジェクトを再作成します。手順については、 セキュリティ統合の作成とシークレットオブジェクトの作成 をご覧ください。

  • 新しい認証情報を使用するように、ServiceNowインスタンスへの接続を更新します。詳細については、 ServiceNow®インスタンスへの接続の更新 をご覧ください。

• RELOAD_TABLE プロシージャに新しい設定パラメーターを追加しました。このパラメーターを使用すると、テーブル全体ではなく、テーブル内の特定の記録をリロードすることができます。詳しくは フィルターリロード をご覧ください。

• リファレンスフィールドを含むビューで、リファレンスフィールドのデータを含む接尾辞 __DISPLAY_VALUE の列が最新のデータを表示するようになります。以前は、これらの列は常に同じテーブルから取り込まれた生の値の表示値を返していました。既存のビューを含めてこの機能を有効にするには、 CREATE_VIEW_WITH_DISPLAY_VALUES ストアドプロシージャを呼び出します。詳細については、 リファレンスフィールドを含むビューの作成 をご覧ください。

バグ修正¶

• 新しいテーブルが取り込み可能になっている場合の最初のテストリクエストのパフォーマンスを改善しました。

• 返されたエラーコードが予想と異なる形式であった場合のエラー処理を改善しました。

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

fetch_display_values が有効なテーブルのデータがビューに含まれる場合に、フラット化されたビューのリファレンス列が不完全なデータを表示する問題を修正しました。

動作の変更¶

フラット化されたビューでは、列が常にアルファベット順に表示されるようになりました。以前は、これらの表示では列がランダムな順序で表示されることがありました。

新機能¶

該当なし

バグ修正¶

• ビューに参照フィールドが含まれる場合に、ビューに含まれるデータが列間でずれる問題を修正しました。

• フラット化されたビューが正しく再作成されない問題を修正しました。

• fetch_display_values が有効なテーブルの場合、インジェスチョンプロセスが停止する前に、コネクタがテーブルの最大10,000件のレコードの単一ページのみを取得する問題を修正しました。ただし、グローバルコネクタ設定で fetch_display_values が有効になっているテーブルを含め、修正を適用するにはこれらのテーブルをリロードする必要があります。テーブルのリロード方法については、 テーブルのデータのリロード をご参照ください。

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

CONFIGURE_DISPLAY_VALUE_FETCHING ストアドプロシージャを呼び出すと、テーブルのデフォルト表示値の構成に失敗し、 Snowflake Connector for ServiceNow® V2 が応答しなくなる問題を修正しました。

動作の変更¶

該当なし

新機能¶

• 新しい CONFIGURE_DISPLAY_VALUE_FETCHING プロシージャが追加されました。これは、表示値を処理するためのグローバルなデフォルト構成を設定するために使用されます。表示値の同期は、 ENABLE_TABLE プロシージャを使用して、テーブルレベルで構成することもできます。

• 生データだけでなく、表示値が解決されたデータも取得できるようになりました。

バグ修正¶

• コネクタ状態のエクスポート処理の修正。

• DNS エラーの処理を改善しました。

• CREATE_VIEW_WITH_DISPLAY_VALUES および ENABLE_REFERENCED_TABLES プロシージャで、含まれる列の構成を処理できるようになりました。

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

• エクスポートされるテーブルに不完全な構成がある場合に、コネクタが例外を処理するようになりました。

• GET_TROUBLESHOOTING_DATA プロシージャが作成されなかった場合でも、アップグレード処理が失敗しなくなりました。

• 内部状態のスナップショットのサイズが原因で作成されなかった場合でも、コネクタが失敗しなくなりました。

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

• データエクスポートで古い同期状態をサポートするための移行を追加しました。

動作の変更¶

• コネクタの内部状態を保存するエクスポートプロセスが変更されました。

  メタデータは __CONNECTOR_STATE_EXPORT テーブルに保存されるだけでなく、データは _SFSDKEXPORT_V1 サフィックスを持つ複数のテーブルに分割されます。

新機能¶

• Snowflake Connector for ServiceNow® V2 は別のリージョンでの災害復旧をサポートするようになりました。

• ENABLE_TABLE プロシージャを使用したテーブルレベルでの削除同期構成のサポートを追加しました。

  ENABLE_TABLE プロシージャの使用に関する詳細情報については、 カスタム構成を使用した単一テーブルの有効化 をご参照ください。

バグ修正¶

• CHECK_ROW_COUNT などのプロシージャにおいて、 ServiceNow API からの予期せぬレスポンスが正しく処理されるようになりました。

動作の変更¶

• イベントの共有は、新規インストール時に必須となりました。

新機能¶

• デフォルトのコネクタ値を使用する代わりに、 RESET_PAGE_SIZE プロシージャで指定したテーブルのページサイズを設定できるようになりました。

• コネクタのデフォルトのページサイズが無効な値に設定されていた場合、コネクタは推奨値の10,000を使用します。

バグ修正¶

• ワーカータスクが初期テーブルページサイズを検出する際に API タイムアウトに達すると、インジェスチョンが失敗します。

動作の変更¶

該当なし

新機能¶

• http接続確立時のタイムアウトを追加しました。

バグ修正¶

該当なし

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

• インジェストされたテーブルの最新レコードのタイムスタンプをSnowflakeが受信しなくても、増分更新が失敗しなくなりました。

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

• イベントログテーブルが空でも、増分アップデートに失敗しなくなりました。

• ソースからの記録更新時に古い行があるためにフェッチされたバッチが空であっても、増分インジェスチョンに失敗しなくなりました。

動作の変更¶

増分更新時に適用される ServiceNow API リクエストの並べ替えルールを変更し、複数の読み込みレプリカからデータを読み込む際のデータ損失をなくしました。

新機能¶

該当なし

バグ修正¶

ServiceNow インスタンスに到達できない場合は、ページサイズが圧縮されなくなりました。

動作の変更¶

該当なし

新機能¶

該当なし

バグ修正¶

• UPDATE_CONNECTION_CONFIGURATION プロシージャの構成検証を修正しました。

動作の変更¶

• 更新と削除の最初に、最新のタイムスタンプのリクエストが追加されました。

新機能¶

• UPDATE_CONNECTION_CONFIGURATION プロシージャが追加されました。このプロシージャにより、コネクタが使用する外部アクセス統合オブジェクトとシークレットオブジェクトを変更できるようになります。

• コネクタ HTTP リクエストのユーザーAgentヘッダーが snowflake-connector-for-service-now に設定されるようになりました。

バグ修正¶

• HTTP クライアントのタイムアウトエラーを正常に処理します。

  このようなエラーの場合は、ページサイズを圧縮します。

• ServiceNow®とSnowflakeの時差によってデータが失われることはなくなりました。

動作の変更¶

該当なし。

新機能¶

該当なし。

バグ修正¶

• 特定のユーザーに対する移行スクリプトの修正。

動作の変更¶

該当なし。

新機能¶

該当なし。

バグ修正¶

• row_filter と data_range_start_time の両方が設定されている場合の RELOAD_TABLE プロシージャを修正しました。これまでは、行フィルタリングの同期状態が正しくクリーンアップされていませんでした。

• コネクタが認証に関連するエラーを克服できない場合のデータインジェスチョンプロセスでのエラー処理を改善しました。このような場合に、コネクタは早期にエラーを検出し、インジェスチョンプロセスを停止できるようになりました。

動作の変更¶

該当なし。

新機能¶

• ENABLE_TABLE プロシージャにある row_filter フィールドは、フィルタリング式内で、式要素間の空白を1文字のみ許容するのではなく、任意の数の空白文字を許容するようになりました。

  詳細については、 カスタム構成を使用した単一テーブルの有効化 をご参照ください。

バグ修正¶

• テーブルのリロード時に、行フィルターと列フィルターが考慮されるようになりました。

• 行フィルターは、 sys_updated_on 列のないテーブルでも期待通りに動作するようになりました。

動作の変更¶

該当なし。

新機能¶

プロシージャ CHECK_ROW_COUNT、 ENABLE_TABLE （カスタム構成パラメーターなし）、および SHOW_REFERENCES_OF_TABLE が、ユーザー所有のタスクで呼び出せるようになりました。

バグ修正¶

該当なし。

動作の変更¶

該当なし。

新機能¶

行のフィルタリングができるようになりました。 行のフィルタリングは、テーブルの列に対して評価される条件に基づいて、インジェストされたテーブル行のフィルタリングをサポートします。行のフィルタリング条件は、 ENABLE_TABLE プロシージャを使用して設定されます。

詳細については、 ServiceNow®データのデータインジェスチョンの設定 にある カスタム構成を使用した単一テーブルの有効化 をご参照ください。

バグ修正¶

旧バージョンからの移行スクリプトのパフォーマンスを改善しました。

動作の変更¶

該当なし。

新機能¶

該当なし

バグ修正¶

旧バージョンからの移行スクリプトのパフォーマンスを改善しました。

動作の変更¶

該当なし。

新機能¶

インジェスチョン開始時にテーブルのスキーマを取得するデフォルトの方法を追加しました。最初にインジェストされる行で ACLs に直面したために、コネクタがテーブルのインジェストを開始できない場合に役立ちます。

バグ修正¶

• 特定のシナリオでコネクタのステータス送信に失敗することがあったため、 RUN_HEALTHCHECK を修正しました。

動作の変更¶

該当なし。

新機能¶

テーブルのスキーマをフェッチするためのエンドポイントを変更します。バージョン5.4.0以降では、 CREATE_VIEW_WITH_DISPLAY_VALUES、 SHOW_REFERENCES_OF_TABLE、 ENABLE_TABLE （列フィルタリングを使用する場合）プロシージャを使用するために、 ServiceNow®内の ADMIN ロールは必要なくなりました。

バグ修正¶

バージョン5.4.0以降、新しいイベントログテーブル DELETE イベントには、 RAW 列が含まれます。この列には、最初の挿入イベントではなく、最新の更新イベントの値が設定されます。既存のイベントログテーブルのイベントは変更されません。

動作の変更¶

該当なし。

新機能¶

該当なし。

バグ修正¶

FINALIZE_CONNECTOR_CONFIGURATION プロシージャに渡されたオブジェクトの journal_table プロパティのnull値の処理を修正しました。journal_table パラメーターも省略できるようになりました。

動作の変更¶

該当なし。

新機能¶

ジャーナルテーブルの検証に役立つオプションのtable_nameと sys_id 引数を FINALIZE_CONNECTOR_CONFIGURATION に追加しました。

バグ修正¶

• SET_CONNECTION_CONFIGURATION の URL 検証を改善し、カスタム ServiceNow® ドメインをサポートするようになりました。

動作の変更¶

該当なし。

新機能¶

CHECK_ROW_COUNT プロシージャの max_sys_created_on 引数のデフォルトが NULL になりました。

バグ修正¶

• 構成が正常に完了していない場合は、健全性チェックの報告を開始しないでください。

• 特定のテーブルの自己参照を戻り値に含めるように SHOW_REFERENCES_OF_TABLE を修正しました。

• テーブルが自己参照する場合の状況を処理できるように CREATE_VIEW_WITH_DISPLAY_VALUES を修正しました。

動作の変更¶

• ServiceNow® への API 呼び出しを行う外部関数が外部アクセスに置き換えられます。

• 多くのプロシージャの署名と動作が変更されました。責任分担は以下のテーブルで確認できます。

以前のプロシージャ	新しいプロシージャ
CONFIGURE_CONNECTOR	いくつかの特化したプロシージャ CONFIGURE_*。
CONFIGURE_WAREHOUSE	UPDATE_WAREHOUSE
STOP_CONNECTOR	PAUSE_CONNECTOR
START_CONNECTOR	ワークシート使用時にアプリをインストールするいくつかのプロシージャ。
PREFILL_CONFIG_TABLE	GET_AVAILABLE_TABLES
ENABLE_TABLE_WITH_COLUMNS	ENABLE_TABLE
ENABLE_TABLES(VARCHAR, BOOLEAN)	ENABLE_TABLES(ARRAY), DISABLE_TABLES(ARRAY)
TEST_SN_CONNECTION	TEST_CONNECTION
CHECK_SN_ROW_COUNT	CHECK_ROW_COUNT
GET_STATUS
GET_CONNECTION_STATUS
GET_VERSION
RUN_UPGRADE

• プロシージャは、 response_code プロパティを持つオブジェクトを返します。プロシージャの結果は、オプションのエラー理由とともに応答に直接表示されます。

• いくつかのビューの署名と動作が変更されました。責任分担は以下のテーブルで確認できます。

  以前のビュー	新しいビュー
  ENABLED_TABLES	CONFIGURED_TABLES, TABLES_STATE
  CONNECTOR_RUNS_STATE	GET_TROUBLESHOOTING_DATA プロシージャに含まれます。
  CONNECTOR_STATS	AGGREGATED_CONNECTOR_STATS
  	SYNC_STATUS

新機能¶

該当なし。

バグ修正¶

該当なし。