Référence de connecteur carré

info

Bêta

Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.

Cette page contient des informations de référence pour le connecteur Square géré, y compris les tables sources prises en charge et les schémas de table de destination.

Tables sources prises en charge

Le connecteur Square prend en charge les tables sources suivantes, toutes sous le schéma source default :

Table source	Clé principale	Description	Mode de synchronisation	Champ du curseur
`locations`	`id`	Emplacements commerciaux configurés dans votre compte Square, y compris la devise, le fuseau horaire et les capacités.	Full refresh uniquement
`customers`	`id`	Profils clients de votre compte Square, y compris les coordonnées et la source de création.	Full refresh uniquement
`team_member_wages`	`id`	Paramètres de rémunération pour les membres de l'équipe, y compris le titre de Job et l'éligibilité aux pourboires.	Full refresh uniquement
`bank_accounts`	`id`	Comptes bancaires liés à votre compte Square, y compris le statut et le type de compte.	Full refresh uniquement
`shifts`	`id`	Quarts de travail effectués par les membres de l'équipe, y compris les heures de start et de fin et les salaires.	Full refresh uniquement
`team_members`	`id`	Les membres de l'équipe dans votre compte Square, y compris le statut, les emplacements attribués et les paramètres de salaire.	Full refresh uniquement
`inventory`	`catalog_object_id`	Comptes d'inventaire pour les objets de catalogue à chaque emplacement.	Full refresh uniquement
`loyalty`	`id`	Comptes de programme de fidélité, y compris les soldes de points et les dates d'inscription.	Full refresh uniquement
`payments`	`id`	Paiements effectués via Square, y compris les montants, le statut et les commandes associées.	Incrémentiel	`created_at`
`refunds`	`id`	Remboursements traités via Square, y compris les montants, le statut et les paiements associés.	Incrémentiel	`created_at`
`items`	`id`	Éléments de catalogue dans votre compte Square, y compris les détails des articles et le versioning.	Incrémentiel	`updated_at`
`categories`	`id`	Catégories de catalogue utilisées pour organiser les éléments.	Incrémentiel	`updated_at`
`discounts`	`id`	Remises sur catalogue disponibles dans votre compte Square.	Incrémentiel	`updated_at`
`taxes`	`id`	Taxes du catalogue configurées dans votre compte Square.	Incrémentiel	`updated_at`
`modifier_lists`	`id`	Listes de modification de catalogue appliquées aux éléments.	Incrémentiel	`updated_at`
`cash_drawers`	`id`	Mouvements de tiroir-caisse pour chaque emplacement, y compris les montants d’ouverture et de fermeture de caisse.	Full refresh uniquement
`orders`	`id`	Commandes passées sur vos sites Square, y compris les postes, les totaux et les exécutions.	Incrémentiel	`updated_at`

Table source	Clé principale	Description	Mode de synchronisation	Champ du curseur
`locations`	`id`	Emplacements commerciaux configurés dans votre compte Square, y compris la devise, le fuseau horaire et les capacités.	Full refresh uniquement
`customers`	`id`	Profils clients de votre compte Square, y compris les coordonnées et la source de création.	Full refresh uniquement
`team_member_wages`	`id`	Paramètres de rémunération pour les membres de l'équipe, y compris le titre de Job et l'éligibilité aux pourboires.	Full refresh uniquement
`bank_accounts`	`id`	Comptes bancaires liés à votre compte Square, y compris le statut et le type de compte.	Full refresh uniquement
`shifts`	`id`	Quarts de travail effectués par les membres de l'équipe, y compris les heures de start et de fin et les salaires.	Full refresh uniquement
`team_members`	`id`	Les membres de l'équipe dans votre compte Square, y compris le statut, les emplacements attribués et les paramètres de salaire.	Full refresh uniquement
`inventory`	`catalog_object_id`	Comptes d'inventaire pour les objets de catalogue à chaque emplacement.	Full refresh uniquement
`loyalty`	`id`	Comptes de programme de fidélité, y compris les soldes de points et les dates d'inscription.	Full refresh uniquement
`payments`	`id`	Paiements effectués via Square, y compris les montants, le statut et les commandes associées.	Incrémentiel	`created_at`
`refunds`	`id`	Remboursements traités via Square, y compris les montants, le statut et les paiements associés.	Incrémentiel	`created_at`
`items`	`id`	Éléments de catalogue dans votre compte Square, y compris les détails des articles et le versioning.	Incrémentiel	`updated_at`
`categories`	`id`	Catégories de catalogue utilisées pour organiser les éléments.	Incrémentiel	`updated_at`
`discounts`	`id`	Remises sur catalogue disponibles dans votre compte Square.	Incrémentiel	`updated_at`
`taxes`	`id`	Taxes du catalogue configurées dans votre compte Square.	Incrémentiel	`updated_at`
`modifier_lists`	`id`	Listes de modification de catalogue appliquées aux éléments.	Incrémentiel	`updated_at`
`cash_drawers`	`id`	Mouvements de tiroir-caisse pour chaque emplacement, y compris les montants d’ouverture et de fermeture de caisse.	Full refresh uniquement
`orders`	`id`	Commandes passées sur vos sites Square, y compris les postes, les totaux et les exécutions.	Incrémentiel	`updated_at`

Options du connecteur

Le connecteur Square ne dispose pas d'options de configuration supplémentaires au-delà des paramètres de pipeline disponibles pour tous les connecteurs gérés. Consultez Ingérer des données depuis Square.

Schémas de table de destination

`locations`

Clé principale : id Mode de synchronisation : Full refresh only

Champ	Type de données
`id`	`STRING`
`name`	`STRING`
`timezone`	`STRING`
`capabilities`	`STRING`
`status`	`STRING`
`created_at`	`STRING`
`merchant_id`	`STRING`
`country`	`STRING`
`language_code`	`STRING`
`currency`	`STRING`
`business_name`	`STRING`
`type`	`STRING`
`business_hours`	`STRING`
`mcc`	`STRING`

Champ	Type de données
`id`	`STRING`
`name`	`STRING`
`timezone`	`STRING`
`capabilities`	`STRING`
`status`	`STRING`
`created_at`	`STRING`
`merchant_id`	`STRING`
`country`	`STRING`
`language_code`	`STRING`
`currency`	`STRING`
`business_name`	`STRING`
`type`	`STRING`
`business_hours`	`STRING`
`mcc`	`STRING`

`customers`

Clé principale : id Mode de synchronisation : Full refresh only

Champ	Type de données
`id`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`given_name`	`STRING`
`family_name`	`STRING`
`email_address`	`STRING`
`phone_number`	`STRING`
`company_name`	`STRING`
`reference_id`	`STRING`
`note`	`STRING`
`creation_source`	`STRING`
`version`	`BIGINT`

Champ	Type de données
`id`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`given_name`	`STRING`
`family_name`	`STRING`
`email_address`	`STRING`
`phone_number`	`STRING`
`company_name`	`STRING`
`reference_id`	`STRING`
`note`	`STRING`
`creation_source`	`STRING`
`version`	`BIGINT`

`team_member_wages`

Clé principale : id Mode de synchronisation : Full refresh only

Champ	Type de données
`id`	`STRING`
`team_member_id`	`STRING`
`title`	`STRING`
`job_id`	`STRING`
`tip_eligible`	`BOOLEAN`

`bank_accounts`

Clé principale : id Mode de synchronisation : Full refresh only

Champ	Type de données
`id`	`STRING`
`account_number_suffix`	`STRING`
`country`	`STRING`
`currency`	`STRING`
`account_type`	`STRING`
`holder_name`	`STRING`
`primary_bank_identification_number`	`STRING`
`status`	`STRING`
`creditable`	`BOOLEAN`
`debitable`	`BOOLEAN`
`location_id`	`STRING`

Champ	Type de données
`id`	`STRING`
`account_number_suffix`	`STRING`
`country`	`STRING`
`currency`	`STRING`
`account_type`	`STRING`
`holder_name`	`STRING`
`primary_bank_identification_number`	`STRING`
`status`	`STRING`
`creditable`	`BOOLEAN`
`debitable`	`BOOLEAN`
`location_id`	`STRING`

`shifts`

Clé principale : id Mode de synchronisation : Full refresh only

Champ	Type de données
`id`	`STRING`
`employee_id`	`STRING`
`team_member_id`	`STRING`
`location_id`	`STRING`
`timezone`	`STRING`
`start_at`	`STRING`
`end_at`	`STRING`
`wage`	`STRING`
`status`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`

`team_members`

Clé principale : id Mode de synchronisation : Full refresh only

Champ	Type de données
`id`	`STRING`
`is_owner`	`BOOLEAN`
`status`	`STRING`
`given_name`	`STRING`
`family_name`	`STRING`
`email_address`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`assigned_locations`	`STRING`
`merchant_id`	`STRING`
`wage_setting`	`STRING`

Champ	Type de données
`id`	`STRING`
`is_owner`	`BOOLEAN`
`status`	`STRING`
`given_name`	`STRING`
`family_name`	`STRING`
`email_address`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`assigned_locations`	`STRING`
`merchant_id`	`STRING`
`wage_setting`	`STRING`

`inventory`

Clé principale : catalog_object_id Mode de synchronisation : Full refresh only

Champ	Type de données
`catalog_object_id`	`STRING`
`catalog_object_type`	`STRING`
`state`	`STRING`
`location_id`	`STRING`
`quantity`	`STRING`
`calculated_at`	`STRING`

`loyalty`

Clé principale : id Mode de synchronisation : Full refresh only

Champ	Type de données
`id`	`STRING`
`program_id`	`STRING`
`balance`	`BIGINT`
`lifetime_points`	`BIGINT`
`customer_id`	`STRING`
`enrolled_at`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`

`payments`

Clé principale : id Champ du curseur : created_at

Champ	Type de données
`id`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`amount_money`	`STRING`
`total_money`	`STRING`
`status`	`STRING`
`source_type`	`STRING`
`location_id`	`STRING`
`order_id`	`STRING`
`receipt_number`	`STRING`
`receipt_url`	`STRING`

`refunds`

Clé principale : id Champ du curseur : created_at

Champ	Type de données
`id`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`amount_money`	`STRING`
`status`	`STRING`
`location_id`	`STRING`
`order_id`	`STRING`
`payment_id`	`STRING`
`reason`	`STRING`

`items`

Clé principale : id Champ du curseur : updated_at

Champ	Type de données
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`item_data`	`STRING`

`categories`

Clé principale : id Champ du curseur : updated_at

Champ	Type de données
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`category_data`	`STRING`

`discounts`

Clé principale : id Champ du curseur : updated_at

Champ	Type de données
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`discount_data`	`STRING`

`taxes`

Clé principale : id Champ du curseur : updated_at

Champ	Type de données
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`tax_data`	`STRING`

`modifier_lists`

Clé principale : id Champ du curseur : updated_at

Champ	Type de données
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`modifier_list_data`	`STRING`

`cash_drawers`

Clé principale : id Mode de synchronisation : Full refresh only

Champ	Type de données
`id`	`STRING`
`location_id`	`STRING`
`opened_at`	`STRING`
`ended_at`	`STRING`
`closed_at`	`STRING`
`state`	`STRING`
`description`	`STRING`
`opened_cash_money`	`STRING`
`cash_payment_money`	`STRING`
`cash_refunds_money`	`STRING`
`cash_paid_in_money`	`STRING`
`cash_paid_out_money`	`STRING`
`expected_cash_money`	`STRING`
`closed_cash_money`	`STRING`
`opening_employee_id`	`STRING`
`ending_employee_id`	`STRING`
`closing_employee_id`	`STRING`
`device`	`STRING`

Champ	Type de données
`id`	`STRING`
`location_id`	`STRING`
`opened_at`	`STRING`
`ended_at`	`STRING`
`closed_at`	`STRING`
`state`	`STRING`
`description`	`STRING`
`opened_cash_money`	`STRING`
`cash_payment_money`	`STRING`
`cash_refunds_money`	`STRING`
`cash_paid_in_money`	`STRING`
`cash_paid_out_money`	`STRING`
`expected_cash_money`	`STRING`
`closed_cash_money`	`STRING`
`opening_employee_id`	`STRING`
`ending_employee_id`	`STRING`
`closing_employee_id`	`STRING`
`device`	`STRING`

`orders`

Clé principale : id Champ du curseur : updated_at

Champ	Type de données
`id`	`STRING`
`location_id`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`closed_at`	`STRING`
`state`	`STRING`
`version`	`BIGINT`
`total_money`	`STRING`
`total_tax_money`	`STRING`
`total_discount_money`	`STRING`
`total_tip_money`	`STRING`
`total_service_charge_money`	`STRING`
`net_amounts`	`STRING`
`source`	`STRING`
`line_items`	`STRING`
`fulfillments`	`STRING`
`returns`	`STRING`
`customer_id`	`STRING`
`reference_id`	`STRING`

Champ	Type de données
`id`	`STRING`
`location_id`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`closed_at`	`STRING`
`state`	`STRING`
`version`	`BIGINT`
`total_money`	`STRING`
`total_tax_money`	`STRING`
`total_discount_money`	`STRING`
`total_tip_money`	`STRING`
`total_service_charge_money`	`STRING`
`net_amounts`	`STRING`
`source`	`STRING`
`line_items`	`STRING`
`fulfillments`	`STRING`
`returns`	`STRING`
`customer_id`	`STRING`
`reference_id`	`STRING`

Autorisations OAuth requises

Le jeton d'accès Square doit disposer des autorisations OAuth suivantes. L'ensemble des autorisations requises par le connecteur dépend des tables que vous ingérez. Pour plus d'informations, consultez la référence des autorisations OAuth Square.

Autorisation	Requis pour
`MERCHANT_PROFILE_READ`	`locations`
`CUSTOMERS_READ`	`customers`
`EMPLOYEES_READ`	`team_members`, `team_member_wages`
`TIMECARDS_READ`	`shifts`
`BANK_ACCOUNTS_READ`	`bank_accounts`
`INVENTORY_READ`	`inventory`
`LOYALTY_READ`	`loyalty`
`PAYMENTS_READ`	`payments`, `refunds`
`ITEMS_READ`	`items`, `categories`, `discounts`, `taxes`, `modifier_lists`
`CASH_DRAWER_READ`	`cash_drawers`
`ORDERS_READ`	`orders`

Autorisation	Requis pour
`MERCHANT_PROFILE_READ`	`locations`
`CUSTOMERS_READ`	`customers`
`EMPLOYEES_READ`	`team_members`, `team_member_wages`
`TIMECARDS_READ`	`shifts`
`BANK_ACCOUNTS_READ`	`bank_accounts`
`INVENTORY_READ`	`inventory`
`LOYALTY_READ`	`loyalty`
`PAYMENTS_READ`	`payments`, `refunds`
`ITEMS_READ`	`items`, `categories`, `discounts`, `taxes`, `modifier_lists`
`CASH_DRAWER_READ`	`cash_drawers`
`ORDERS_READ`	`orders`

Tables sources prises en charge​

Options du connecteur​

Schémas de table de destination​

locations​

customers​

team_member_wages​

bank_accounts​

shifts​

team_members​

inventory​

loyalty​

payments​

refunds​

items​

categories​

discounts​

taxes​

modifier_lists​

cash_drawers​

orders​

Autorisations OAuth requises​

Tables sources prises en charge

Options du connecteur

Schémas de table de destination

`locations`

`customers`

`team_member_wages`

`bank_accounts`

`shifts`

`team_members`

`inventory`

`loyalty`

`payments`

`refunds`

`items`

`categories`

`discounts`

`taxes`

`modifier_lists`

`cash_drawers`

`orders`

Autorisations OAuth requises