Xero コネクタの制限事項

備考

ベータ版

この機能はベータ版です。使用するには、ワークスペース管理者は プレビュー ページから Lakeflow Connect for Xero を有効にする必要があります。Databricksのプレビューを管理するを参照してください。

Lakeflow Connectの管理されたXeroコネクタは、パイプラインごとに1つのXero組織を取り込み、一部のテーブルで削除のみを検出し、ランのたびに11のテーブルを完全に再取り込みします。

一般的な ソフトウェア as a サービス（SaaS）コネクタの制限事項

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

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

コネクタ固有の制限事項

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

組織

• Xero組織ごとに1つのパイプラインを作成します。各パイプラインは、tenant_idオプションで名前が指定された組織のみを取り込みます。

ヒストリカルデータ

• 古いレコードを取り込むには、start_datetimeを設定します。defaultでは、各増分テーブルの最初の同期は、過去730日間に変更されたレコードのみを取り込みます。コネクタ オプションをご覧ください。

削除されたレコード

• Xero で削除されたレコードは、accounts、bank_transactions、credit_notes、invoices、manual_journals、payments、および purchase_orders の場合のみ、変換先テーブルから削除されます。コネクタはこれらの行を保持するのではなく削除するため、これらのテーブルに残る行には IsDeleted が false に設定されています。
• 完全更新をランして、宛先テーブルから削除された items を削除します。Xero はアイテムの削除を報告しないため、増分同期では削除されたアイテムが保持されます。
• 無効化されたドキュメントは、Status が VOIDED に設定されたまま保存先のテーブルに残ります。アーカイブされた連絡先と削除されたユーザーも、それぞれのテーブルに残ります。

フル更新テーブル

• bank_transfers、branding_themes、budgets、contact_groups、currencies、linked_transactions、organisation、projects、repeating_invoices、tax_rates、およびtracking_categoriesの各テーブルは、ランのたびにすべてのレコードを再取り込みします。これらのテーブルはすべてのレコードを再読み取りするため、各ランは増分同期よりも多くのXero API呼び出しを使用します。