Google Workspace connector limitations

Beta

This feature is in Beta. Workspace admins can control access to this feature from the Previews page. See Manage Databricks previews.

This page contains information about known limitations of the managed Google Workspace connector in Lakeflow Connect.

General software as a service (SaaS) connector limitations

The limitations in this section apply to all SaaS connectors in Lakeflow Connect.

When you run a scheduled pipeline, alerts don't trigger immediately. Instead, they trigger when the next update runs.
When a source table is deleted, the destination table is not automatically deleted. You must delete the destination table manually. This behavior is not consistent with Spark Declarative Pipelines on Lakeflow behavior.
During source maintenance periods, Databricks might not be able to access your data.
If a source table name conflicts with an existing destination table name, the pipeline update fails.
Multi-destination pipeline support is API-only.
You can optionally rename a table that you ingest. If you rename a table in your pipeline, it becomes an API-only pipeline, and you can no longer edit the pipeline in the UI.
If you select a column after a pipeline has already started, the connector does not automatically backfill data for the new column. To ingest historical data, manually run a full refresh on the table.
Databricks can't ingest two or more tables with the same name in the same pipeline, even if they come from different source schemas.
The source system assumes that the cursor columns are monotonically increasing.
The connector ingests raw data without transformations. Use downstream Spark Declarative Pipelines on Lakeflow pipelines for transformations.

The limitations in this section apply to the Google Workspace connector.

The connector ingests one table per Google Workspace activity application (33 tables total): access_evaluation, access_transparency, admin, assignments, calendar, chat, chrome, classroom, cloud_search, contacts, context_aware_access, data_migration, data_studio, directory_sync, gcp, gemini_in_workspace_apps, graduation, groups, groups_enterprise, keep, ldap, login, meet, meet_hardware, mobile, profile, rules, saml, takeout, tasks, token, user_accounts, and vault. The gmail and drive applications aren't included; use the dedicated Gmail connector and Google Drive connector connectors instead. For details, see Supported source tables.
SCD Type 2 isn't supported. Activity records have VARIANT columns, and audit events are append-only.
The Google Workspace Admin SDK Reports API retains activity logs for up to 180 days. The connector can't ingest events older than the source retention window.
Different Google Workspace applications report with different lag windows. Per-application lookback is applied to accommodate this lag. In particular, the takeout application's "process finished" event can lag by up to several days; very large exports finishing beyond the per-application lookback window may not be captured.
Without a configured start_datetime, the connector backfills the previous 180 days of audit activity by default.