Referência do conector do Shopify
Beta
Esse recurso está em Beta. Para usá-lo, o administrador de um workspace deve ativar o Lakeflow Connect for Shopify na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.
Esta página contém informações de referência para o conector gerenciado do Shopify, incluindo tabelas de origem compatíveis e esquemas de tabelas de destino.
Tabelas de origem suportadas
O conector do Shopify oferece suporte às seguintes tabelas de origem, todas sob o esquema de origem default:
Tabela de origem | Chave primária | Descrição | Modo de sincronização | Campo do cursor |
|---|---|---|---|---|
|
| Produtos em sua loja, incluindo título, status, fornecedor e estoque total. | Incremental |
|
|
| Pedidos feitos na sua loja, incluindo status financeiro, status de atendimento e moeda. | Incremental |
|
|
| Perfis de clientes, incluindo nome, detalhes de contato e contagem de pedidos. | Incremental |
|
|
| Pedidos de rascunho criados em sua loja, incluindo status e horário de conclusão. | Incremental |
|
|
| Coleções de produtos em sua loja, incluindo título, identificador e ordem de classificação. | Incremental |
|
|
| Coleções de produtos curadas manualmente. | Incremental |
|
|
| Coleções de produtos automatizadas, incluindo o conjunto de regras que determina a associação. | Incremental |
|
|
| Artigos de blog no armazenamento online, incluindo o status de publicação. | Incremental |
|
|
| Páginas de armazenamento online, incluindo o status de publicação. | Incremental |
|
|
| Variantes de produto, incluindo SKU, preço, código de barras e quantidade de estoque. | Incremental |
|
|
| Blogs no seu armazenamento online. | Incremental |
|
|
| Itens de estoque, incluindo SKU e se o item é rastreado. | Incremental |
|
|
| Descontos baseados em código, incluindo a configuração do desconto. | Incremental |
|
|
| Descontos automáticos, incluindo a configuração de desconto. | Incremental |
|
|
| Locais de armazenamento, incluindo se cada um envia estoque e atende a pedidos online. | Apenas refresh completo | |
|
| Perfil da loja, incluindo domínio, moeda e fuso horário. | Apenas refresh completo | |
|
| Transações de pagamentos, incluindo método de pagamento e valor. | Incremental |
|
|
| Associações entre produtos e coleções personalizadas. | Apenas refresh completo | |
|
| Disputas de pagamento e estornos, incluindo status e prazos para envio de evidências. | Apenas refresh completo | |
|
| Checkouts abandonados, incluindo os totais e a URL de recuperação. | Incremental |
|
|
| Pedidos de atendimento, incluindo status e local atribuído. | Incremental |
|
|
| Arquivos de imagem na biblioteca de mídia da sua loja. | Incremental |
|
|
| Todos os arquivos de mídia na biblioteca de mídia da sua loja, incluindo imagens, vídeos e modelos 3D. | Incremental |
|
|
| Países configurados para frete e impostos, incluindo províncias. | Apenas refresh completo | |
|
| Transações de saldo do Shopify Payments, incluindo valor, taxa e valor líquido. | Incremental |
|
|
| Transações de pagamento de pedidos, incluindo tipo, gateway, status e valor. | Incremental |
|
|
| Reembolsos emitidos em pedidos, incluindo detalhes de reabastecimento e itens de linha. | Incremental |
|
|
| Atendimentos de pedidos, incluindo status de acompanhamento e remessa. | Incremental |
|
|
| Itens de linha incluídos em reembolsos de pedidos, incluindo quantidade e tipo de reabastecimento. | Incremental |
|
|
| Ajustes aplicados a reembolsos de pedidos, incluindo valor e motivo. | Incremental |
|
|
| Mídia anexada a variantes de produto, incluindo imagens, vídeos e modelos 3D. | Incremental |
|
|
| Linhas de envio em pedidos, incluindo transportadora e preços. | Incremental |
|
|
| Contratos de ventas em pedidos, incluindo tipo e motivo. | Incremental |
|
|
| Avaliações de risco de fraude para pedidos, incluindo a recomendação. | Incremental |
|
|
| Endereços de clientes, incluindo cidade, província, país e código postal. | Incremental |
|
|
| Itens de linha em pedidos de atendimento, incluindo quantidade total e restante. | Incremental |
|
|
| Resgatar códigos para descontos baseados em código, incluindo a contagem de uso. | Incremental |
|
|
| Associações entre coleções e os produtos que elas contêm. | Apenas refresh completo | |
|
| Níveis de estoque por item e local, incluindo quantidades disponíveis, em mãos e comprometidas. | Apenas refresh completo |
Opções do conector
Consulte Exemplos para ver o uso.
Opção | Tipo | Escopo | Obrigatório | Aplica-se a | Descrição |
|---|---|---|---|---|---|
| String ( | Pipeline | Não | Todas as tabelas incrementais | Data e hora mais antigas a partir das quais ingerir dados. default 365 dias antes da primeira sincronização. Aplica-se apenas à primeira sincronização de cada tabela; as sincronizações posteriores são retomadas a partir do cursor armazenado. |
Esquemas da tabela de destino
products
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
orders
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
customers
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
draft_orders
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
collections
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
custom_collections
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
smart_collections
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
articles
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
pages
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
product_variants
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
blogs
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
inventory_items
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
discount_codes
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
discount_automatic
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
locations
Chave primária: id
Modo de sincronização: Apenas refresh completo
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
shop
Chave primária: id
Modo de sincronização: Apenas refresh completo
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
tender_transactions
key primária: id
Campo de cursor: processedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
collects
Chave primária: id
Modo de sincronização: Apenas refresh completo
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
disputes
Chave primária: id
Modo de sincronização: Apenas refresh completo
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
abandoned_checkouts
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
fulfillment_orders
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
media_image
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
media
key primária: id
Campo de cursor: updatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
countries
Chave primária: id
Modo de sincronização: Apenas refresh completo
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
balance_transactions
key primária: id
Campo de cursor: transactionDate
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
transactions
key primária: id
Campo de cursor: created_at
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
order_refunds
key primária: id
Campo de cursor: created_at
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
fulfillments
key primária: id
Campo de cursor: updated_at
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
order_line_refund
key primária: id
Campo de cursor: parentUpdatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
order_adjustment
key primária: id
Campo de cursor: parentUpdatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
product_variant_media
key primária: id
Campo de cursor: parentUpdatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
order_shipping_line
key primária: id
Campo de cursor: parentUpdatedAt
As linhas de envio removidas são capturadas por meio da coluna isRemoved.
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
order_agreements
key primária: id
Campo de cursor: parentUpdatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
order_risks
key primária: order_id
Campo de cursor: parentUpdatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
customer_address
key primária: id
Campo de cursor: parentUpdatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
fulfillment_order_line_item
key primária: id
Campo de cursor: parentUpdatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
discount_redeem_code
key primária: id
Campo de cursor: parentUpdatedAt
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Esta tabela não oferece suporte ao SCD tipo 2 porque possui colunas VARIANT.
collection_product
Chave primária: collection_id, product_id
Modo de sincronização: Apenas full refresh
campo | Tipo de dados |
|---|---|
|
|
|
|
inventory_level
Chave primária: id
Modo de sincronização: Apenas refresh completo
campo | Tipo de dados |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Escopos de acesso necessários
O aplicativo do Shopify deve estar autorizado para os seguintes escopos de acesso da API de Administração. Os escopos que o conector exige dependem de quais tabelas você ingere. Para obter mais informações, consulte a referência de escopos de acesso do Shopify.
Escopo de acesso | Obrigatório para |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Para ingerir pedidos e tabelas derivadas de pedidos (como
orders,transactions,order_refundsefulfillments) com mais de 60 dias, o aplicativo também precisa do escoporead_all_orders, combinado comread_orders. O Shopify concederead_all_ordersmediante aprovação. Sem ele,read_ordersretorna apenas pedidos dos últimos 60 dias. - As tabelas
balance_transactionsedisputesexigem o Shopify Payments na loja. - Alguns campos de
customers,customer_addresse de pedidos são dados do cliente protegidos. O Shopify retorna esses campos de lojas que não são de desenvolvimento somente após o aplicativo atender aos requisitos de dados do cliente protegidos. Consulte a referência de escopos de acesso do Shopify.