Zip コネクターのトラブルシューティング
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
このページでは、マネージドZipコネクタで発生する可能性のある一般的なエラーと、それらを解決する方法について説明します。
パイプラインの認証に失敗しました（HTTP 401）
原因： Unity Catalog接続に保存されているAPIキーが無効です。キーの入力ミス、期限切れ、または削除された場合に、Zipはステータス401を返します(The provided API key is not valid)。
ソリューション:
Unity Catalog接続に保存されている APIトークン が、Zipの APIキー タブでアクティブなキーと一致していることを確認してください。キーの有効期限が切れているか、存在しない場合は、キーを作成し、接続を更新してください。「Zipへの認証の構成」および「Zip接続の作成」を参照してください。
パイプラインが権限エラー（HTTP 403）で失敗します。
原因: パイプラインが、お客様の 制限付き API キーがアクセスを許可していないレコードタイプを取り込んでいます。Zip は、キー構成で空白になっているレコードタイプへのアクセスをブロックします。
ソリューション:
Zipで、制限付きキーを編集し、パイプラインが取り込むレコードタイプごとに少なくとも 読み取り専用 アクセスを選択します。代わりに、 Standard キーを使用します。「Zipへの認証を構成する」を参照してください。
パイプラインはレート制限されています (HTTP 429)
**原因:** ZipはAPIをAPIキーあたり1日150,000リクエストに制限します 。コネクタのAPIキーを共有する他のアプリケーションは、同じクォータを消費します。
ソリューション:
コネクタは、パイプラインの更新中にレート制限されたリクエストを自動的に待機して再試行します。更新が引き続き失敗する場合は、コネクタ専用のAPIキーを作成するか、パイプラインの実行頻度を減らすか、テーブルの取り込み数を減らしてください。Zipへの認証を構成するを参照してください。