Squareコネクタのリファレンス

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。

このページには、サポートされているソーステーブルと宛先テーブルのスキーマを含む、マネージド Square コネクタのリファレンス情報が記載されています。

対応ソーステーブル

Squareコネクタは、defaultソーススキーマ下の次のソーステーブルをサポートしています：

ソーステーブル	プライマリーキー	説明	同期モード	カーソルフィールド
`locations`	`id`	アカウントで構成された Square のビジネス拠点。通貨、タイムゾーン、機能を含みます。	フル更新のみ
`customers`	`id`	連絡先の詳細と作成元（ソース）を含む、Squareアカウント内の顧客情報。	フル更新のみ
`team_member_wages`	`id`	ジョブの役職とチップの受給資格を含む、チームメンバーの賃金設定。	フル更新のみ
`bank_accounts`	`id`	ステータスとアカウントタイプを含む、Square アカウントにリンクされている銀行アカウント。	フル更新のみ
`shifts`	`id`	チームメンバーが勤務した労働シフト。開始時刻と終了時刻、および賃金を含みます。	フル更新のみ
`team_members`	`id`	ステータス、割り当てられたロケーション、賃金設定を含む、Square アカウントのチームメンバー。	フル更新のみ
`inventory`	`catalog_object_id`	各ロケーションにおけるカタログオブジェクトのインベントリ数。	フル更新のみ
`loyalty`	`id`	ロイヤルティプログラムアカウント（ポイント残高、登録日などを含む）。	フル更新のみ
`payments`	`id`	Square を介して行われた支払いには、金額、ステータス、関連する注文が含まれます。	インクリメンタル	`created_at`
`refunds`	`id`	Squareを通じて処理された払い戻し。金額、ステータス、関連する支払いが含まれます。	インクリメンタル	`created_at`
`items`	`id`	項目詳細とバージョン管理を含む、Square アカウント内のカタログ項目。	インクリメンタル	`updated_at`
`categories`	`id`	項目を整理するために使用されるカタログカテゴリ。	インクリメンタル	`updated_at`
`discounts`	`id`	Squareアカウントで利用可能なカタログ割引。	インクリメンタル	`updated_at`
`taxes`	`id`	Squareアカウントで設定されたカタログ税。	インクリメンタル	`updated_at`
`modifier_lists`	`id`	アイテムに適用されるカタログ修飾子リスト。	インクリメンタル	`updated_at`
`cash_drawers`	`id`	各拠点におけるレジドロワーのシフト。開店時および閉店時の現金残高を含みます。	フル更新のみ
`orders`	`id`	Squareの拠点全体で行われた注文には、品目、合計、および履行状況が含まれます。	インクリメンタル	`updated_at`

コネクターオプション

Square コネクターには、すべてのマネージドコネクターで利用可能なパイプライン設定以外に追加の構成オプションはありません。Squareからのデータを取り込みを参照してください。

宛先テーブルスキーマ

`locations`

主キー： id 同期モード： 完全更新のみ

フィールド	データ型
`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`

主キー： id 同期モード： 完全更新のみ

フィールド	データ型
`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`

主キー： id 同期モード： 完全更新のみ

フィールド	データ型
`id`	`STRING`
`team_member_id`	`STRING`
`title`	`STRING`
`job_id`	`STRING`
`tip_eligible`	`BOOLEAN`

`bank_accounts`

主キー： id 同期モード： 完全更新のみ

フィールド	データ型
`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`

主キー： id 同期モード： 完全更新のみ

フィールド	データ型
`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`

主キー： id 同期モード： 完全更新のみ

フィールド	データ型
`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`

主キー： catalog_object_id 同期モード： 完全更新のみ

フィールド	データ型
`catalog_object_id`	`STRING`
`catalog_object_type`	`STRING`
`state`	`STRING`
`location_id`	`STRING`
`quantity`	`STRING`
`calculated_at`	`STRING`

`loyalty`

主キー： id 同期モード： 完全更新のみ

フィールド	データ型
`id`	`STRING`
`program_id`	`STRING`
`balance`	`BIGINT`
`lifetime_points`	`BIGINT`
`customer_id`	`STRING`
`enrolled_at`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`

`payments`

主キー: id カーソルフィールド: created_at

フィールド	データ型
`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`

主キー: id カーソルフィールド: created_at

フィールド	データ型
`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`

主キー: id カーソルフィールド: updated_at

フィールド	データ型
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`item_data`	`STRING`

`categories`

主キー: id カーソルフィールド: updated_at

フィールド	データ型
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`category_data`	`STRING`

`discounts`

主キー: id カーソルフィールド: updated_at

フィールド	データ型
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`discount_data`	`STRING`

`taxes`

主キー: id カーソルフィールド: updated_at

フィールド	データ型
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`tax_data`	`STRING`

`modifier_lists`

主キー: id カーソルフィールド: updated_at

フィールド	データ型
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`modifier_list_data`	`STRING`

`cash_drawers`

主キー： id 同期モード： 完全更新のみ

フィールド	データ型
`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`

主キー: id カーソルフィールド: updated_at

フィールド	データ型
`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`

必要な OAuth 権限

Squareのアクセストークンには、次のOAuth権限が必要です。コネクタが必要とする権限のセットは、取り込み先のテーブルによって異なります。詳細については、Square OAuth権限リファレンスを参照してください。

権限	〜に必須
`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`

対応ソーステーブル​

コネクターオプション​

宛先テーブルスキーマ​

locations​

customers​

team_member_wages​

bank_accounts​

shifts​

team_members​

inventory​

loyalty​

payments​

refunds​

items​

categories​

discounts​

taxes​

modifier_lists​

cash_drawers​

orders​

必要な OAuth 権限​

対応ソーステーブル

コネクターオプション

宛先テーブルスキーマ

`locations`

`customers`

`team_member_wages`

`bank_accounts`

`shifts`

`team_members`

`inventory`

`loyalty`

`payments`

`refunds`

`items`

`categories`

`discounts`

`taxes`

`modifier_lists`

`cash_drawers`

`orders`

必要な OAuth 権限