GmailコネクタのFAQ
このページでは、Databricks Lakeflow Connect の Gmail コネクタに関してよく寄せられる質問に回答します。
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
マネージドコネクタに関する一般的なFAQ
マネージドコネクタの FAQ の回答は、Lakeflow Connect のすべてのマネージド コネクタに適用されます。Gmail 固有の FAQ については、引き続きお読みください。
コネクタ固有の FAQ
このセクションの回答は、Gmail コネクタに固有のものです。
コネクタはどのメールボックスから読み取りますか？
このコネクタは、接続ごとに1つのメールボックスから読み取ります。サービスアカウントは、ドメイン全体の委任と mailbox コネクタオプション（default me）で指定したメールボックスになりすまします。コネクタは、メールボックスの値をすべての行の mailbox 列としてスタンプします。
どのテーブルが増分同期され、どのテーブルが完全更新されるか？
messages および message_labels テーブルは、Gmail History API を使用して増分同期されます。profile、labels、labels_details、drafts、および filters テーブルは完全更新専用であり、パイプラインの実行ごとに完全にラン取り込み直されます。
添付ファイルはどのように取り込まれますか？
添付ファイルは、messagesテーブルのpayload列（payload.parts[].body.attachmentId）に含まれています。個別の添付ファイルテーブルはありません。
複数のメールボックスを取り込むにはどうすればよいですか？
各接続で取り込めるメールボックスは 1 つです。複数のメールボックスを取り込むには、メールボックスごとに個別の接続とパイプラインを作成します。mailbox 列を使用して、宛先テーブル内のメールボックスを区別できます。
historyId が期限切れになった場合はどうなりますか？
コネクタは、増分変更を取得するために historyId カーソルを保存します。Gmail がカーソルを期限切れにした場合（カーソルが Gmail の保持期間よりも古いため History API が 404 を返す場合）、コネクタは自動的に影響を受けるテーブルの完全更新にフォールバックします。これを回避するには、少なくとも 7 日に 1 回パイプラインを実行するようにスケジュールを設定してください。これにより、カーソルが Gmail の保持期間内に維持されます。
コネクタはメールボックスを変更できますか？
いいえ。このコネクタは読み取り専用です。https://www.googleapis.com/auth/gmail.readonly スコープが必要であり、https://gmail.googleapis.com とのみ通信します。ソースメールボックスを変更することはありません。