Zendesk Supportコネクタのトラブルシューティング
このページでは、Zendesk Support コネクタの使用時に発生する一般的なエラーについて説明します。
リソースが存在しないか、アクセスが禁止されています
エラーメッセージ:
Error suggests either resource does not exist or access to resource is forbidden
原因: 現在の Zendesk プランでは、取り込まれるエンティティにアクセスできない可能性があります。
解決策: 現在の Zendesk プランが取り込まれているエンティティにアクセスできることを確認してください。 一部のテーブルと機能は、特定の Zendesk サブスクリプション プランでのみご利用いただけます。
パイプラインの実行速度が遅すぎる
症状: 取り込みパイプラインの実行速度が予想よりも遅くなっています。
原因: Zendesk には厳格な API レート制限があり、同時に取り込むテーブルが多すぎるとスロットルが発生する可能性があります。
解決策: スロットリングを防ぐために、多くのテーブルが同時に取り込まれていないことを確認してください。 テーブルを複数のパイプラインに分割し、異なる時間にスケジュールすることで、Zendesk のレート制限内で動作するようにできます。
クライアントIDとクライアントシークレットを入力しても、Zendeskのログインページにリダイレクトされてしまいます。
クライアントID に正しい値を使用していることを確認してください。正しい値は、Zendesk管理コンソールのOAuthクライアントの Identifier フィールドです。これは内部的な、コード上で使用される名前（例： my_new_app ）であり、エンドユーザーに表示される表示名ではありません。識別子の代わりに表示名を入力すると、リダイレクトループが発生します。
値を確認するには：
- Zendeskで、 [管理] > [ アプリと統合 ] > APIs > [Zendesk API > OAuthクライアント] に移動します。
- OAuthクライアントを開き、 識別子 フィールドの値（クライアント名ではない）をコピーしてください。
- その値をDatabricksの クライアントID として再入力してください。
認証情報が正しくても問題が解決しない場合は、ワークスペース ID、パイプライン ID、および完全なエラー メッセージを含むサポート チケットを作成してください。 「ヘルプを見る」を参照してください。
Zendesk APIの特定のエンドポイントでエラーが発生しています。
Zendesk APIエンドポイントの一部の動作は、コネクタでは制御できません。同期を調整しても問題が解決しない場合は、ワークスペース ID、パイプライン ID、および完全なエラー メッセージを含むサポート チケットを作成してください。 「ヘルプを見る」を参照してください。
取り込まれた監査レコードのフィールドが空であるか、期限切れです
**症状:** テーブルのネストされたフィールドticket_audits (例:ChatStartedEvent イベントのチャットトランスクリプト) が空であるか、同じ監査に対してZendesk APIが返すよりも宛先テーブルでのレコードが少ないです。エラーは報告されず、他のレコードは正しく取り込まれます。
原因： Zendeskはチケット監査を不変としていますが、監査作成後も監査内のいくつかのフィールドは変更され続ける可能性があります。コネクタはcreated_atカーソルを使用してticket_auditsを増分的に取り込むため、各監査を一度読み込み、再訪問しません。したがって、取り込み後に加えられた変更をコネクタは検出しません。これはコネクタではなく、Zendesk APIの制限です。詳細については、監査レコードは作成後に変更される可能性がありますを参照してください。
ソリューション： ticket_audits テーブルの 完全な更新 を実行して、Zendesk から現在の値を再読み込みします。