Référence du connecteur Google Workspace

info

Bêta

Cette fonctionnalité est en bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Manage Databricks previews.

Cette page contient des informations de référence pour le connecteur Google Workspace géré, notamment les tables sources prises en charge et leur schéma de destination.

Tables sources prises en charge

Le connecteur Google Workspace prend en charge 33 tables sources, une pour chaque application d’activité Google Workspace, sous le schéma source default. Chaque table prend en charge l’ingestion incrémentielle. Le connecteur utilise le champ time comme champ curseur pour l’ingestion incrémentielle.

Les tables prises en charge sont les suivantes :

• 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
• vault

Chaque table contient des enregistrements d’activité provenant de Google Workspace Admin SDK Reports API. Toutes les tables partagent le même schéma et prennent en charge l’ingestion incrémentielle avec time comme champ curseur.

Tables sources	Clé primaire	Description	Mode de synchronisation	Champ de curseur
Les 33 applications ci-dessus	lw_id	Événements d'activité Google Workspace provenant de l'API Admin SDK Reports pour différentes applications.	Incrémentiel	time

Tables sources	Clé primaire	Description	Mode de synchronisation	Champ de curseur
Les 33 applications ci-dessus	lw_id	Événements d'activité Google Workspace provenant de l'API Admin SDK Reports pour différentes applications.	Incrémentiel	time

remarque

Les applications gmail et drive ne sont pas incluses dans la liste ci-dessus. Utilisez le connecteur Gmail et le connecteur Google Drive dédiés pour ingérer ces sources.

remarque

L'assistant d'ingestion de l'interface utilisateur de Databricks expose 30 de ces tables dans son sélecteur de table source. Pour ingérer login, groups ou groups_enterprise, utilisez la création de pipeline basée sur l'API ou des bundles d'automatisation déclarative.

Options du connecteur

Le connecteur Google Workspace prend en charge les options de configuration suivantes au-delà des paramètres de pipeline disponibles pour tous les connecteurs gérés :

• start_datetime (en option) : date de start du remplissage au format ISO 8601 (par exemple, 2024-01-01T00:00:00Z). Lorsqu’il n’est pas configuré, le connecteur définit par default une période de 180 jours avant la première synchronisation. Consultez la page Google Workspace connector limitations.

Schémas de tables de destination

Les 33 tables d’application partagent le schéma suivant, dérivé de l’enveloppe d’activité de l’API Google Workspace Admin SDK Reports :

Clé principale : lw_id Champ de curseur : time

Champ	Type de données
lw_id	STRING
time	TIMESTAMP
kind	STRING
etag	STRING
id	STRUCT<time: STRING, uniqueQualifier: STRING, applicationName: STRING, customerId: STRING>
actor	STRUCT<profileId: STRING, email: STRING, callerType: STRING, key: STRING, applicationInfo: STRUCT<oauthClientId: STRING, applicationName: STRING, impersonation: BOOLEAN>>
ownerDomain	STRING
ipAddress	STRING
isAgenticAction	BOOLEAN
networkInfo	STRUCT<ipAsn: ARRAY<INT>, regionCode: STRING, subdivisionCode: STRING>
events	ARRAY<STRUCT<type: STRING, name: STRING, status: STRING, resourceIds: ARRAY<STRING>, parameters: ARRAY<STRUCT<name: STRING, value: STRING, intValue: STRING, boolValue: BOOLEAN, multiValue: ARRAY<STRING>, multiIntValue: ARRAY<STRING>, messageValue: VARIANT, multiMessageValue: VARIANT>>>>
userDeviceInfo	VARIANT
resourceDetails	VARIANT

Champ	Type de données
lw_id	STRING
time	TIMESTAMP
kind	STRING
etag	STRING
id	STRUCT<time: STRING, uniqueQualifier: STRING, applicationName: STRING, customerId: STRING>
actor	STRUCT<profileId: STRING, email: STRING, callerType: STRING, key: STRING, applicationInfo: STRUCT<oauthClientId: STRING, applicationName: STRING, impersonation: BOOLEAN>>
ownerDomain	STRING
ipAddress	STRING
isAgenticAction	BOOLEAN
networkInfo	STRUCT<ipAsn: ARRAY<INT>, regionCode: STRING, subdivisionCode: STRING>
events	ARRAY<STRUCT<type: STRING, name: STRING, status: STRING, resourceIds: ARRAY<STRING>, parameters: ARRAY<STRUCT<name: STRING, value: STRING, intValue: STRING, boolValue: BOOLEAN, multiValue: ARRAY<STRING>, multiIntValue: ARRAY<STRING>, messageValue: VARIANT, multiMessageValue: VARIANT>>>>
userDeviceInfo	VARIANT
resourceDetails	VARIANT

remarque

Ces tables ne prennent pas en charge le SCD de type 2 car elles contiennent des colonnes VARIANT.

Ingestion incrémentielle

Chaque table est ingérée de manière incrémentielle, en utilisant le champ time comme curseur. Lorsqu’aucun start_datetime n’est configuré, le connecteur remplit les données des 180 derniers jours. L’API Google Workspace Admin SDK Reports conserve les logs pendant une période maximale de 180 jours, de sorte que le connecteur ne peut pas ingérer d’événements antérieurs à cette fenêtre. Différentes applications signalent leurs données avec des fenêtres de retard variables ; le connecteur applique une période de rétrospection par application pour absorber ce retard. Voir Limitations du connecteur Google Workspace.