メインコンテンツまでスキップ

Shopify コネクターのトラブルシューティング

備考

ベータ版

This feature is in Beta.To use it, a ワークスペース admin must turn on Lakeflow Connect for Shopify from the Previews page.See Manage Databricks previews.

このページでは、マネージド Shopify コネクタで発生する可能性のある一般的なエラーとその解決方法について説明します。

管理対象のインジェスト パイプラインすべてに適用される一般的なトラブルシューティング ガイダンスについては、管理対象のインジェスト パイプラインのトラブルシューティングを参照してください。

パイプラインの認証に失敗しました

原因: ShopifyがHTTP 401、402、または403の応答を返しました。通常、これは次のいずれかを意味します:クライアントIDまたはクライアントシークレットが無効である、Shopifyアプリがストアにインストールされていない、またはストアのサブドメインが正しくない。

ソリューション:

  1. Unity Catalog 接続の Store SubdomainClient ID 、および Client Secret が、Shopify Dev ダッシュボードのアプリと一致していることを確認します。
  2. 取り込み元のストアにアプリがインストールされていることを確認します。

認証情報を再度取得するには、Shopifyへの認証の構成を参照してください。

アプリに必要なアクセススコープがありません

エラーメッセージ:

Please check that your shopify app has access to the required scopes. See https://shopify.dev/docs/api/usage/access-scopes for more details.

原因: Shopify アプリには、取り込むテーブルに必要なアクセス スコープがありません。

ソリューション:

Shopify Dev Dashboard のアプリバージョンに必要なアクセススコープを追加し、アプリを再インストールします。各テーブルに必要なスコープについては、必要なアクセススコープを参照してください。

一括エクスポートを作成できませんでした

エラーメッセージ:

Shopify bulk query could not be created: <error details>

原因: collection_product テーブルと inventory_level テーブルが使用する一括エクスポート リクエストが Shopify によって拒否されました。Shopify はストアごとに一度に 1 つの一括エクスポートを実行するため、並列のエクスポートによって新しいエクスポートがブロックされる可能性があります。

ソリューション:

ストアに対する他のバルク エクスポートが完了するまで待ってから、パイプラインを再実行してください。エラーが解決しない場合は、アプリに影響を受けるテーブルのアクセス スコープがあることを確認してください。必要なアクセス スコープを参照してください。

Shopify API のレート制限を超えました

原因: コネクターがストアのAPIのレート制限に達したため、ShopifyがHTTP 429応答またはTHROTTLED GraphQLエラーを返しました。ShopifyはクエリーコストによってGraphQL Admin APIのレート制限を行っており、制限はShopifyプランによって異なります。Shopifyのレート制限リファレンスをご覧ください。

ソリューション:

コネクタは待機し、自動的に再試行します。これが頻繁に発生する場合は、パイプラインのスケジュールの頻度、または同じShopifyストアを共有する並列パイプラインの数を減らしてください。