Quadratischer Verbinderverweis

Important

Dieses Feature befindet sich in der Betaversion. Arbeitsbereichsadministratoren können den Zugriff auf dieses Feature über die Vorschauseite steuern. Siehe Manage Azure Databricks Previews.

Diese Seite enthält Referenzinformationen für den verwalteten Quadratconnector, einschließlich der unterstützten Quelltabellen und Zieltabellenschemas.

Unterstützte Quelltabellen

Der quadratische Verbinder unterstützt die folgenden Quelltabellen, alle unter dem default Quellschema:

Quelltabelle Primärschlüssel Description Synchronisierungsmodus Cursorfeld
locations id Geschäftsstandorte, die in Ihrem Square-Konto konfiguriert sind, einschließlich Währung, Zeitzone und Funktionen. Nur vollständige Aktualisierung
customers id Kundenprofile in Ihrem Square-Konto, einschließlich Kontaktdetails und Erstellungsquelle. Nur vollständige Aktualisierung
team_member_wages id Lohneinstellungen für Teammitglieder, einschließlich Position und Tippberechtigung. Nur vollständige Aktualisierung
bank_accounts id Bankkonten, die mit Ihrem Square-Konto verknüpft sind, einschließlich Status und Kontotyp. Nur vollständige Aktualisierung
shifts id Arbeitsschichten, die von Teammitgliedern gearbeitet wurden, einschließlich Start- und Endzeiten und Löhne. Nur vollständige Aktualisierung
team_members id Teammitglieder in Ihrem Square-Konto, einschließlich Status, zugewiesenen Standorten und Lohneinstellungen. Nur vollständige Aktualisierung
inventory catalog_object_id Die Bestandsanzahl für Katalogobjekte an jedem Speicherort. Nur vollständige Aktualisierung
loyalty id Treueprogrammkonten, einschließlich Punktesaldos und Registrierungsdaten. Nur vollständige Aktualisierung
payments id Zahlungen, die über Square übernommen wurden, einschließlich Beträgen, Status und zugeordneten Aufträgen. Inkrementell created_at
refunds id Erstattungen, die über Square verarbeitet werden, einschließlich Beträgen, Status und zugehörigen Zahlungen. Inkrementell created_at
items id Katalogelemente in Ihrem Quadrat-Konto, einschließlich Elementdetails und Versionsverwaltung. Inkrementell updated_at
categories id Katalogkategorien, die zum Organisieren von Elementen verwendet werden. Inkrementell updated_at
discounts id Katalograbatte, die in Ihrem Square-Konto verfügbar sind. Inkrementell updated_at
taxes id Katalogsteuern, die in Ihrem Square-Konto konfiguriert sind. Inkrementell updated_at
modifier_lists id Katalogmodifiziererlisten, die auf Elemente angewendet wurden. Inkrementell updated_at
cash_drawers id Bargeldschubladeverschiebungen für jeden Standort, einschließlich Eröffnungs- und Schließen von Barbeträgen. Nur vollständige Aktualisierung
orders id Bestellungen, die an Ihren Quadratstandorten platziert werden, einschließlich Positionen, Summen und Erfüllungen. Inkrementell updated_at

Connectoroptionen

Siehe Beispiele für die Verwendung.

Option Typ Geltungsbereich Erforderlich Gilt für: Description
start_datetime Saite (yyyy-MM-ddTHH:mm:ss.SSSSSSZ) Rohrleitung No Alle inkrementellen Tabellen (payments, refunds, , items, discountscategories, taxes, , modifier_lists, ) orders Das früheste Datum und die früheste Zeit, von der Daten erfasst werden müssen. Standardmäßig steht 365 Tage vor der ersten Synchronisierung. Gilt nur für die erste Synchronisation jeder Tabelle; spätere Synchronisationen werden vom gespeicherten Cursor fortgesetzt.

Zieltabellenschemas

locations

Primärschlüssel:idSynchronisierungsmodus: Nur vollständige Aktualisierung

Feld Datentyp
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

Primärschlüssel:idSynchronisierungsmodus: Nur vollständige Aktualisierung

Feld Datentyp
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

Primärschlüssel:idSynchronisierungsmodus: Nur vollständige Aktualisierung

Feld Datentyp
id STRING
team_member_id STRING
title STRING
job_id STRING
tip_eligible BOOLEAN

bank_accounts

Primärschlüssel:idSynchronisierungsmodus: Nur vollständige Aktualisierung

Feld Datentyp
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

Primärschlüssel:idSynchronisierungsmodus: Nur vollständige Aktualisierung

Feld Datentyp
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

Primärschlüssel:idSynchronisierungsmodus: Nur vollständige Aktualisierung

Feld Datentyp
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

Primärschlüssel:catalog_object_idSynchronisierungsmodus: Nur vollständige Aktualisierung

Feld Datentyp
catalog_object_id STRING
catalog_object_type STRING
state STRING
location_id STRING
quantity STRING
calculated_at STRING

loyalty

Primärschlüssel:idSynchronisierungsmodus: Nur vollständige Aktualisierung

Feld Datentyp
id STRING
program_id STRING
balance BIGINT
lifetime_points BIGINT
customer_id STRING
enrolled_at STRING
created_at STRING
updated_at STRING

payments

Primärschlüssel:idCursorfeld:created_at

Feld Datentyp
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

Primärschlüssel:idCursorfeld:created_at

Feld Datentyp
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

Primärschlüssel:idCursorfeld:updated_at

Feld Datentyp
id STRING
type STRING
updated_at STRING
version BIGINT
is_deleted BOOLEAN
present_at_all_locations BOOLEAN
item_data STRING

categories

Primärschlüssel:idCursorfeld:updated_at

Feld Datentyp
id STRING
type STRING
updated_at STRING
version BIGINT
is_deleted BOOLEAN
present_at_all_locations BOOLEAN
category_data STRING

discounts

Primärschlüssel:idCursorfeld:updated_at

Feld Datentyp
id STRING
type STRING
updated_at STRING
version BIGINT
is_deleted BOOLEAN
present_at_all_locations BOOLEAN
discount_data STRING

taxes

Primärschlüssel:idCursorfeld:updated_at

Feld Datentyp
id STRING
type STRING
updated_at STRING
version BIGINT
is_deleted BOOLEAN
present_at_all_locations BOOLEAN
tax_data STRING

modifier_lists

Primärschlüssel:idCursorfeld:updated_at

Feld Datentyp
id STRING
type STRING
updated_at STRING
version BIGINT
is_deleted BOOLEAN
present_at_all_locations BOOLEAN
modifier_list_data STRING

cash_drawers

Primärschlüssel:idSynchronisierungsmodus: Nur vollständige Aktualisierung

Feld Datentyp
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

Primärschlüssel:idCursorfeld:updated_at

Feld Datentyp
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

Erforderliche OAuth-Berechtigungen

Das Quadrat-Zugriffstoken muss über die folgenden OAuth-Berechtigungen verfügen. Der Satz von Berechtigungen, die der Connector benötigt, hängt davon ab, welche Tabellen Sie aufnehmen. Weitere Informationen finden Sie im Square OAuth-Berechtigungsverweis.

Erlaubnis Erforderlich für
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