Notionコネクターのトラブルシューティング
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページで Notion コネクタ のプレビューにオプトインすることで、この機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
このページでは、マネージドNotionコネクタで発生する可能性のある一般的なエラーとその解決方法について説明します。
すべてのマネージド インジェスト パイプラインに適用される一般的なトラブルシューティングのガイダンスについては、「マネージド インジェスト パイプラインのトラブルシューティング」を参照してください。
接続の作成が 401 Unauthorized または invalid_client エラーで失敗する
原因： クライアントIDまたはクライアントシークレットがNotionのパブリック統合と一致していないか、統合のリダイレクトURIがDatabricksワークスペースのコールバックURLと一致していません。
ソリューション:
クライアントIDとクライアントシークレットがNotionのパブリック統合と一致していること、および統合のリダイレクトURIがDatabricksワークスペースのコールバックURL（https://<your-workspace-domain>/login/oauth/http.html）と完全に一致していることを確認します。Notionへの認証を構成するを参照してください。
取り込まれたデータにページまたはデータベースがありません
原因: 接続設定時にNotionのページピッカーでページやデータソースが統合と共有されませんでした。コネクタは、あなたが明示的に共有したコンテンツにのみアクセスできます。
ソリューション:
Notion ページピッカーで、ページまたはデータソースが統合と共有されていることを確認してください。追加のコンテンツを共有するには、Notion で共有選択を編集してから、パイプラインを再実行してください。Notion 接続の作成を参照してください。
パイプラインがレート制限されています
原因: パイプラインがNotion APIのレート制限を超えました。NotionはHTTP 429を返し、待機間隔をRetry-After応答ヘッダーで報告します。
ソリューション:
コネクタは、Notionがリクエストのレート制限を設定した場合、自動的に待機して再試行します。速度制限が続く場合は、パイプラインの実行頻度を減らしましょう。Notionからのデータ取り込みを参照してください。
パイプラインの認証に失敗しました
原因: 接続認証が無効になったか、NotionでOAuthクライアントの秘密がローテーションされたことがあります。
ソリューション:
コネクタはアクセストークンを自動的に更新します。認証が失敗する場合は、接続上のクライアントIDとクライアントシークレットを確認してください。ローテーションされた資格情報を更新するには、「Notion接続の作成」を参照してください。