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

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

備考

ベータ版

この機能はベータ版です。使用するには、ワークスペース管理者が [プレビュー] ページから Lakeflow Connect for GitLab を有効にする必要があります。Databricksのプレビューを管理するを参照してください。

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

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

プレミアムまたはアルティメットの特徴量テーブルの処理に失敗しました​

エラーメッセージ:

GitLab returned 403 for epics. Epics require a Premium or Ultimate group with the epics feature enabled.
GitLab returned 403 for iterations. Iterations require a Premium or Ultimate group with the feature enabled.
GitLab returned 403 for epic_boards. Epic boards require a Premium or Ultimate group with the epics feature enabled.

原因: epics、epic_issues、epic_boards、またはgroup_iterationsのテーブルが選択されましたが、グループがGitLabのPremiumまたはUltimateティアにないか、機能が有効になっていません。

ソリューション:

パイプラインからテーブルを削除するか、GitLabグループを機能が含まれる階層にアップグレードします。テーブルごとの階層要件については、GitLabコネクタの FAQ を参照してください。機能が有効になっていない場合、GitLabは 404 コードとともに同じメッセージを返します。

Ultimate セキュリティの特徴量テーブルでエラーが発生しました​

エラーメッセージ:

GitLab returned 403 for vulnerabilities. Vulnerabilities require an Ultimate project with the security feature enabled.
GitLab returned 403 for compliance_frameworks. Compliance frameworks require an Ultimate group with the feature enabled.

原因: vulnerabilitiesまたはcompliance_frameworksテーブルが選択されましたが、プロジェクトまたはグループがGitLab Ultimate階層にないか、セキュリティ機能が有効になっていません。

ソリューション:

パイプラインからテーブルを削除するか、GitLab プロジェクトまたはグループを Ultimate にアップグレードします。GitLab がこれらのテーブルに対して GraphQL エラーを返した場合、コネクタも同様の要件を報告します。

パイプラインはレート制限されています​

原因: gitlab.comでは、認証済みAPIトラフィックはユーザーあたり1分間に2,000リクエストに制限されており、一部のEndpointにはより厳しいEndpointごとの制限があります。GitLabのレート制限を参照してください。GitLabが429を返すと、コネクタはRetry-Afterレスポンスヘッダーの間隔だけ待機して再試行します。

ソリューション:

パイプラインの実行頻度を減らすか、パイプラインあたりの取り込みテーブル数を減らします。See Ingest data from GitLab.