Vimeo コネクタのトラブルシューティング
ベータ版
この機能はプレビュー版です。使用するには、ワークスペース管理者は プレビュー ページから Lakeflow Connect for Vimeo を有効にする必要があります。Databricksのプレビューを管理するを参照してください。
Vimeoコネクタのエラーのほとんどは、無効な個人用アクセストークン、または必要なスコープが不足していること（HTTP 401または403）、必要なVimeoプランに加入していないアカウント（HTTP 404）、あるいはAPIのレート制限（HTTP 429）が原因です。次のセクションでは、各エラーの原因とその解決方法について説明します。
管理されるインジェクションパイプラインのすべてに適用される一般的なトラブルシューティング ガイダンスについては、 管理されるインジェクションパイプラインのトラブルシューティングを参照してください。
パイプラインの認証が失敗したか、権限がありません
原因： VimeoからHTTP 401または403の応答が返されました。これは通常、個人用アクセストークンが無効または期限切れであるか、トークンに必要なスコープが含まれていないことを意味します。audit_logsの場合、監査Logsが有効になっているEnterpriseアカウントで作成されたアプリを使用しているアカウントオーナーまたは管理者からトークンが発行されていないことを意味する場合もあります。
ソリューション:
- Unity Catalog接続の 個人用アクセストークン と アカウント所有者ユーザーID が、ソース設定の認証情報と一致していることを確認します。
- トークンに
public、private、およびstatsのスコープが含まれていることを確認します。スコープはトークンの生成時に固定されるため、スコープが欠落している場合は新しいトークンを生成してください。 audit_logsをインジェストするには、アカウントが監査Logsが有効なエンタープライズアカウントであること、トークンの所有者がアカウント所有者または管理者であること、そしてAPIアプリがエンタープライズアカウントで作成されたことを確認してください。アプリが別のアカウントで作成された場合は、エンタープライズアカウントで新しいアプリを作成し、そのアプリから新しいトークンを生成します。
詳細は、「Vimeoへの認証を構成する」を参照してください。
パイプラインが HTTP 404 エラーで失敗する
原因: Vimeo が、チームまたは監査ログ Endpoint に対して HTTP 404 応答を返しました。これは通常、トークンのアカウントが無料アカウントのようなチーム機能を持つプランにないことを意味します。audit_logs の場合、アカウントがEnterpriseアカウントでないことも意味します。
ソリューション:
- 個人用アクセストークンで
GET https://api.vimeo.com/meを呼び出し、accountフィールドを確認します。チーム、チームメンバー、チームロールのデータには有料のチームプランまたはエンタープライズプランが必要であり、audit_logsにはenterpriseが必要です。 - Unity Catalog 接続の アカウント所有者ユーザー ID がチーム所有者の ID であることを確認してください。アカウント所有者ユーザー ID を検索するを参照してください。
audit_logsを取り込むには、エンタープライズアカウントでAPIアプリが作成されたことを確認し、そこから新しいトークンを生成します。
Vimeo APIレート制限を超過
原因: Vimeo が、リクエストが API レート制限を超えたため、HTTP 429 応答を返しました。
ソリューション:
コネクタは待機し、エクスポネンシャルバックオフで自動的に再試行します。これが繰り返し発生する場合は、同じパーソナルアクセストークンを共有する並列パイプラインの数を減らしてください。
Vimeo APIは一時的に利用できません
原因： Vimeoから一時的なサーバーエラー（HTTP 500、502、503、または504）が返されました。
ソリューション:
コネクタは自動的にリトライします。問題が解決しない場合は、待機してからパイプラインを再度ランしてください。