Pular para o conteúdo principal

Limitações do conector do QuickBooks

info

Beta

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

Esta página contém informações sobre as limitações conhecidas do conector gerenciado do QuickBooks no Lakeflow Connect.

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 ser capaz de acessar seus dados.
  • Se um nome de tabela de origem entrar em conflito com um nome de tabela de destino existente, a atualização do pipeline falhará.
  • O suporte para pipeline de destino múltiplo é apenas para API.
  • Opcionalmente, você pode renomear uma tabela que ingerir. 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 de dados para a nova coluna. Para ingerir data histórica, execute manualmente um refresh completo na tabela.
  • O Databricks não consegue ingerir duas ou mais tabelas com o mesmo nome no mesmo pipeline, mesmo que elas venham de diferentes esquemas de origem.
  • O sistema de origem assume que as colunas do cursor são monotonicamente crescentes.
  • 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 QuickBooks.

Agenda de refresh completa​

  • O conector usa o endpoint de captura de dados de alterações (CDC) do QuickBooks para buscar alterações incrementais. Esse endpoint retorna alterações apenas dos últimos 30 dias, portanto, programe a execução do pipeline com frequência. Se o pipeline não tiver uma execução por mais de 30 dias, faça uma execução de um refresh completo para ingerir alterações que o Endpoint não retorna mais.

Registros excluídos​

  • As exclusões das tabelas time_activity e tax_agency são aplicadas somente na execução de um refresh completo.
  • Nas tabelas account, class, customer, customer_type, department, employee, item, payment_method, term, vendor, company_currency e tax_rate, os registros tornados inativos no QuickBooks são excluídos da tabela de destino.

Ingestão incremental​

  • As tabelas tax_code, company_info, preferences e tax_classification não oferecem suporte à ingestão incremental. Cada execução de pipeline ingere novamente todos os registros dessas tabelas.

Limitações impostas pelo QuickBooks​

  • O QuickBooks oferece suporte a no máximo três campos personalizados em transações e apenas nas tabelas invoice, estimate, credit_memo, sales_receipt, refund_receipt e purchase_order.
  • Depois de ativar multicurrency no QuickBooks, você não pode desativá-lo.