Referência do conector do Google Workspace

info

Beta

Esse recurso está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Previews . Consulte Gerenciar prévias do Databricks.

Esta página contém informações de referência para o conector gerenciado do Google Workspace, incluindo as tabelas de origem compatíveis e seu esquema de destino.

Tabelas de origem compatíveis

O conector do Google Workspace oferece suporte a 33 tabelas de origem, uma para cada aplicativo de atividade do Google Workspace, sob o esquema de origem default. Cada tabela oferece suporte à ingestão incremental. O conector usa o campo time como o campo de cursor para a ingestão incremental.

As tabelas suportadas são:

• 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

Cada tabela contém registros de atividade da Google Workspace Admin SDK Reports API. Todas as tabelas compartilham o mesmo esquema e são compatíveis com a ingestão incremental usando time como o campo de cursor.

Source tables	Chave primária	Descrição	Modo de sincronização	Campo de cursor
Todos os 33 aplicativos acima	lw_id	Google Workspace activity events from the Admin SDK Reports API for various applications.	Incremental	time

Source tables	Chave primária	Descrição	Modo de sincronização	Campo de cursor
Todos os 33 aplicativos acima	lw_id	Google Workspace activity events from the Admin SDK Reports API for various applications.	Incremental	time

nota

Os aplicativos gmail e drive não estão incluídos na lista acima. Use os conectores dedicados Gmail connector e Google Drive connector para ingerir essas fontes.

nota

O assistente de ingestão da interface do usuário do Databricks expõe 30 dessas tabelas em seu seletor de tabela de origem. Para ingerir login, groups ou groups_enterprise, use a criação de pipeline baseada em API ou os Pacotes de Automação Declarativa.

Opções do conector

O conector do Google Workspace oferece suporte às seguintes opções de configuração além das configurações de pipeline disponíveis para todos os conectores gerenciados:

• start_datetime (optional): The backfill start date in ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Quando não configurado, o conector usa por default 180 dias antes da primeira sincronização. Consulte Limitações do conector do Google Workspace.

Esquemas de tabelas de destino

All 33 application tables share the following schema, derived from the Google Workspace Admin SDK Reports API activity envelope:

key primária: lw_id Campo de cursor: time

campo	Tipo de dados
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

campo	Tipo de dados
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

nota

Essas tabelas não oferecem suporte ao SCD tipo 2 porque possuem colunas VARIANT.

Ingestão incremental

Cada tabela é ingerida de forma incremental, usando o campo time como o cursor. Quando nenhum start_datetime é configurado, o conector preenche os 180 dias anteriores de forma retroativa. A API de relatórios do SDK de administrador do Google Workspace retém logs de atividade por até 180 dias, portanto o conector não pode ingerir eventos anteriores a essa janela. Diferentes aplicativos relatam com diferentes janelas de atraso; o conector aplica um período de retrospectiva por aplicativo para absorver esse atraso. Consulte Limitações do conector do Google Workspace.