Shopify コネクタ リファレンス
ベータ版
この機能はベータ版です。使用するには、ワークスペース管理者は プレビュー ページから Lakeflow Connect for Shopify を有効にする必要があります。Databricksのプレビューを管理するを参照してください。
このページには、サポートされているソーステーブルや宛先テーブルのスキーマなど、マネージド Shopify コネクタのリファレンス情報が記載されています。
サポートされているソーステーブル
Shopify コネクタは、default ソーススキーマの下にある次のソーステーブルをサポートしています。
ソーステーブル | プライマリーキー | 説明 | 同期モード | カーソル フィールド |
|---|---|---|---|---|
|
| タイトル、ステータス、ベンダー、合計在庫を含む、ストア内の製品。 | インクリメンタル |
|
|
| 金融ステータス、フルフィルメントステータス、通貨を含め、ストアで行われた注文。 | インクリメンタル |
|
|
| 名前、連絡先詳細、注文数を含む顧客プロファイル。 | インクリメンタル |
|
|
| オンラインストアで作成された下書きの注文(ステータスや完了時間を含む)。 | インクリメンタル |
|
|
| タイトル、ハンドル、並べ替え順など、ストア内の製品コレクション。 | インクリメンタル |
|
|
| 手動でキュレーションされた製品コレクション。 | インクリメンタル |
|
|
| 自動化された製品コレクション(メンバーシップを決定するルールセットを含む)。 | インクリメンタル |
|
|
| オンラインストアのブログ記事(公開ステータスを含む)。 | インクリメンタル |
|
|
| 公開ステータスを含むオンラインストアのページ。 | インクリメンタル |
|
|
| SKU、価格、バーコード、在庫数を含む製品のバリエーション。 | インクリメンタル |
|
|
| オンラインストア内のブログ。 | インクリメンタル |
|
|
| SKU や追跡対象かどうかを含む在庫アイテム。 | インクリメンタル |
|
|
| 割引の設定を含む、コードベースの割引。 | インクリメンタル |
|
|
| 自動割引(割引構成を含む)。 | インクリメンタル |
|
|
| ストアの場所(各店舗が在庫を発送し、オンライン注文を履行するかどうかを含む)。 | 完全更新のみ | |
|
| ドメイン、通貨、タイムゾーンを含むストアプロファイル。 | 完全更新のみ | |
|
| 支払方法や金額を含む入出金取引。 | インクリメンタル |
|
|
| 製品とカスタムコレクション間の関連付け。 | 完全更新のみ | |
|
| ステータスやエビデンスの期限を含む、支払いの紛争とチャージバック。 | 完全更新のみ | |
|
| 合計やリカバリURLを含む、放棄されたチェックアウト。 | インクリメンタル |
|
|
| ステータスや割り当てられた場所を含む履行注文。 | インクリメンタル |
|
|
| ストアのメディアライブラリ内の画像ファイル。 | インクリメンタル |
|
|
| 画像、動画、3Dモデルなど、ストアのメディアライブラリにあるすべてのメディアファイル。 | インクリメンタル |
|
|
| 都道府県など、配送および税金用に構成された国。 | 完全更新のみ | |
|
| 金額、手数料、純額を含む Shopify Payments の残高トランザクション。 | インクリメンタル |
|
|
| 種類、ゲートウェイ、ステータス、金額を含む注文支払いトランザクション。 | インクリメンタル |
|
|
| 再入荷および明細項目の詳細を含む、注文に対して発行された返金。 | インクリメンタル |
|
|
| 追跡および出荷ステータスを含む注文の履行状況。 | インクリメンタル |
|
|
| 注文返金に含まれる明細行(数量と再入荷タイプを含む)。 | インクリメンタル |
|
|
| 金額や理由を含む、注文の返金に適用される調整。 | インクリメンタル |
|
|
| 製品バリアントに添付されたメディア(画像、動画、3Dモデルなど)。 | インクリメンタル |
|
|
| 注文の配送ライン(運送業者と価格を含む)。 | インクリメンタル |
|
|
| 注文に関する販売契約(種類や理由を含む)。 | インクリメンタル |
|
|
| 推奨事項を含む、注文に対する不正リスク評価。 | インクリメンタル |
|
|
| 都市、州、国、郵便番号を含む顧客の住所。 | インクリメンタル |
|
|
| 合計数量および残りの数量を含む、フルフィルメント注文の明細項目。 | インクリメンタル |
|
|
| 使用回数を含め、コードベースの割引のコードを引き換えます。 | インクリメンタル |
|
|
| コレクションとそれらに含まれる製品間の関連付け。 | 完全更新のみ | |
|
| 利用可能数、手持数、引当数を含む、アイテムおよびロケーションごとの在庫レベル。 | 完全更新のみ |
コネクターオプション
使用方法については、例を参照してください。
オプション | Type | スコープ | 必須 | 適用対象 | 説明 |
|---|---|---|---|---|---|
| 文字列 ( | パイプライン | No | すべてのインクリメンタルテーブル | データを取り込む最も早い日付と時間。default to 365 days before the first sync.各テーブルの初回同期にのみ適用されます。以降の同期は保存されたカーソルから再開されます。 |
宛先テーブル スキーマ
products
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
orders
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
customers
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
draft_orders
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
collections
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
custom_collections
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
smart_collections
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
articles
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
pages
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
product_variants
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
blogs
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
inventory_items
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
discount_codes
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
discount_automatic
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
locations
主キー: id
同期モード: 完全更新のみ
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
shop
主キー: id
同期モード: 完全更新のみ
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
tender_transactions
プライマリキー: id
カーソルフィールド: processedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
collects
主キー: id
同期モード: 完全更新のみ
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
disputes
主キー: id
同期モード: 完全更新のみ
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
abandoned_checkouts
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
fulfillment_orders
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
media_image
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
media
プライマリキー: id
カーソルフィールド: updatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
countries
主キー: id
同期モード: 完全更新のみ
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
balance_transactions
プライマリキー: id
カーソルフィールド: transactionDate
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
transactions
プライマリキー: id
カーソルフィールド: created_at
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
order_refunds
プライマリキー: id
カーソルフィールド: created_at
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
fulfillments
プライマリキー: id
カーソルフィールド: updated_at
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
order_line_refund
プライマリキー: id
カーソルフィールド: parentUpdatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
order_adjustment
プライマリキー: id
カーソルフィールド: parentUpdatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
product_variant_media
プライマリキー: id
カーソルフィールド: parentUpdatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
order_shipping_line
プライマリキー: id
カーソルフィールド: parentUpdatedAt
削除された配送ラインは、isRemoved 列を介して取得されます。
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
order_agreements
プライマリキー: id
カーソルフィールド: parentUpdatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
order_risks
プライマリキー: order_id
カーソルフィールド: parentUpdatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
customer_address
プライマリキー: id
カーソルフィールド: parentUpdatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
fulfillment_order_line_item
プライマリキー: id
カーソルフィールド: parentUpdatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
discount_redeem_code
プライマリキー: id
カーソルフィールド: parentUpdatedAt
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
このテーブルにはVARIANT列が含まれているため、SCDタイプ2がサポートされていません。
collection_product
プライマリキー: collection_id、product_id
同期モード: 完全更新のみ
フィールド | データ型 |
|---|---|
|
|
|
|
inventory_level
主キー: id
同期モード: 完全更新のみ
フィールド | データ型 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
必要なアクセススコープ
Shopifyアプリは、次のAdmin APIアクセススコープに対して承認されている必要があります。コネクタに必要なスコープは、取り込むテーブルによって異なります。詳細については、Shopifyアクセススコープリファレンスを参照してください。
アクセススコープ | 次の項目の必須項目: |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- 60 日よりも古い注文および注文から派生したテーブル(
orders、transactions、order_refunds、fulfillmentsなど)を取り込むには、アプリにread_ordersと組み合わせたread_all_ordersスコープも必要です。Shopify は承認によりread_all_ordersを付与します。これがない場合、read_ordersは過去 60 日間の注文のみを返します。 balance_transactionsおよびdisputesテーブルを使用するには、ストアで Shopify Payments が有効になっている必要があります。- 一部の
customers、customer_address、および注文フィールドは、保護された顧客データです。Shopify は、アプリが保護された顧客データの要件を満たした後にのみ、開発用ストア以外のストアからこれらのフィールドを返します。Shopify アクセススコープのリファレンスを参照してください。