Limitações do conector Xero

info

Beta

Esse recurso está em Beta. Para usá-lo, um administrador do workspace deve ativar o Lakeflow Connect para Xero na página Prévias . Consulte Gerenciar prévias do Databricks.

O conector Xero gerenciado no Lakeflow Connect ingere uma organização Xero por pipeline, detecta exclusões em apenas algumas tabelas e reingere 11 tabelas na íntegra a cada execução.

Limitações gerais do conector de software como serviço (SaaS)

As limitações nesta seção se aplicam a todos os conectores SaaS no Lakeflow Connect.

• Quando você executa um pipeline agendado, os alertas não Trigger imediatamente. Em vez disso, eles fazem Trigger quando ocorre a execução da próxima atualização.
• Quando uma tabela de origem é excluída, a tabela de destino não é excluída automaticamente. Você deve excluir a tabela de destino manualmente. Esse comportamento não é consistente com o comportamento do Spark Declarative Pipelines no Lakeflow.
• Durante os períodos de manutenção da fonte, o Databricks pode não conseguir acessar seus dados.
• Se o nome de uma tabela de origem entrar em conflito com o nome de uma tabela de destino existente, a atualização do pipeline falhará.
• O suporte a pipeline com vários destinos está disponível somente por API.
• Opcionalmente, você pode renomear uma tabela que você ingere. Se você renomear uma tabela em seu pipeline, ele se tornará um pipeline somente de API e você não poderá mais editar o pipeline na IU.
• Se você selecionar uma coluna depois que um pipeline já tiver começado, o conector não fará o backfill automático dos dados para a nova coluna. Para ingerir data histórica, execute manualmente um refresh completo na tabela.
• O Databricks não pode ingerir duas ou mais tabelas com o mesmo nome no mesmo pipeline, mesmo que elas venham de esquemas de origem diferentes.
• O sistema de origem assume que as colunas de cursor aumentam monotonicamente.
• O conector ingere dados brutos sem transformações. Use Spark Declarative Pipelines downstream em LakeFlow Pipelines para transformações.

Limitações específicas do conector

As limitações nesta seção se aplicam ao conector Xero.

Organizações

• Crie um pipeline para cada organização do Xero. Cada pipeline ingere apenas a organização que sua opção tenant_id nomeia.

Data histórica

• Defina start_datetime para ingerir registros mais antigos. Por default, a primeira sincronização de cada tabela incremental ingere apenas registros modificados nos últimos 730 dias. Consulte Opções de conector.

Registros excluídos

• Registros excluídos no Xero são excluídos da tabela de destino apenas para accounts, bank_transactions, credit_notes, invoices, manual_journals, payments e purchase_orders. O connector remove essas linhas em vez de mantê-las, portanto, as linhas que permanecem nessas tabelas têm IsDeleted definido como false.
• Faça uma execução de um refresh completo para remover items excluído da tabela de destino. O Xero não relata exclusões de itens, portanto, as sincronizações incrementais mantêm os itens excluídos.
• Documentos anulados permanecem na tabela de destino com Status definido como VOIDED. Contatos arquivados e usuários removidos também permanecem em suas tabelas.

Tabelas de refresh completo

• As tabelas bank_transfers, branding_themes, budgets, contact_groups, currencies, linked_transactions, organisation, projects, repeating_invoices, tax_rates e tracking_categories reingestam todos os registros em cada execução. Como essas tabelas releem cada registro, cada execução usa mais chamadas de API do Xero do que uma sincronização incremental.