Workday Reports コネクタの制限事項

このページでは、 Databricks LakeFlow Connectを使用して Workday レポートを取り込む場合の制限と考慮事項について説明します。

一般的な SaaS コネクタの制限事項

このセクションの制限事項は、Lakeflowコネクト のすべてのSaaS コネクタに適用されます。

• スケジュールされたパイプラインを実行しても、アラートはすぐにはトリガーされません。代わりに、次の更新が実行されたときにトリガーされます。
• ソース テーブルを削除しても、宛先テーブルは自動的に削除されません。宛先テーブルを手動で削除する必要があります。この動作は、 Lakeflow Spark宣言型パイプラインの動作と一致しません。
• ソースのメンテナンス期間中は、Databricks がデータにアクセスできない場合があります。
• ソース テーブル名が既存の宛先テーブル名と競合する場合、パイプラインの更新は失敗します。
• マルチデスティネーションパイプラインのサポートはAPIのみです。
• オプションで、取り込むテーブルの名前を変更できます。パイプライン内のテーブルの名前を変更すると、そのテーブルは API のみのパイプラインになり、UI でパイプラインを編集できなくなります。
• パイプラインがすでに開始された後に列を選択した場合、コネクタは新しい列のデータを自動的にバックフィルしません。ヒストリカルデータを取り込むには、テーブルで完全な更新を手動で実行します。
• Databricks では、同じパイプライン内で同じ名前の 2 つ以上のテーブルを取り込むことはできません (それらが異なるソース スキーマから来ている場合でも)。
• ソース・システムは、カーソル列が単調に増加していると想定しています。
• コネクタは、変換せずに生データを取り込みます。変換にはダウンストリームのLakeFlow Spark宣言型パイプライン パイプラインを使用します。

認証

• Databricks では、Workday 統合システム ユーザー (ISU) を使用することをお勧めしますが、これは必須ではありません。
• 通常、更新トークンは ISU の代わりに作成されます。更新トークンの有効期限を許可するかどうかを選択できます。
  • 有効期限を設定した場合は、その日付に達したときに接続を編集する必要があります。
  • 有効期限を設定しない場合、更新トークンの有効期限が切れるのは、トークンに関連付けられている ISU のアクセス レベルを組織が下げた場合のみです。

パイプライン

• コネクタは、データが 2 GB 未満または 1M 未満のレコードのレポートのみを取り込むことができます。組織の Workday API の制限は、これよりも低い場合があります。
• 増分取り込みは ベータ版 であり、主キーが必要です。レポートにプライマリキーを設定した場合、コネクタは前回のパイプライン実行以降に変更された行のみを取り込みます。主キーを設定しない場合、パイプラインが実行されるたびにコネクタはレポートを完全に更新します。
• コネクタは、主キーが重複するレポートを取り込むことはできません。

増分取り込み

以下の制限が、ベータ版である増分インジェストに適用されます。

• カーソル列は、新しい行または更新された行ごとに単調に増加する必要があります。カーソル値が最後にインジェストされたカーソル値よりも大きい行が取り込まれます（挿入とカーソルを進行させる更新）。削除された行は取り込まれません。
• カーソル列は日付列である必要があります。他のカーソルタイプはサポートされていません。
• 増分取り込みに使用されるWorkdayレポートプロンプトは、包括的（「以上」/「以下」）である必要があります。排他的なプロンプト（「超」/「未満」）を使用すると、データが欠落する可能性があります。これは、レポート作成者がWorkdayでレポートとそのプロンプトを作成する際に選択する設定です。
• プロンプト値でcurrent_date()を使用すると、Databricks はパイプラインが実行を開始する時点のUTC日付として評価します。ただし、Workday は、Workday アカウントの設定のタイムゾーンに基づいて日付を解釈します。