Referência do conector do Notion

info

Beta

Esse recurso está em Beta. Os administradores do Workspace podem controlar o acesso a esse recurso na página de pré-visualizações , ativando a pré-visualização do conector do Notion . Consulte Gerenciar prévias do Databricks.

Esta página contém informações de referência para o conector gerenciado do Notion, incluindo tabelas de origem e esquemas de tabelas de destino suportados.

Tabelas de origem compatíveis

O conector do Notion suporta as seguintes tabelas de origem, todas sob o esquema de origem default:

Tabela de origem	Chave primária	Descrição	Modo de sincronização	Campo do cursor
pages	id	Páginas no workspace compartilhadas com a integração, incluindo pai, propriedades e metadados de edição.	Incremental	last_edited_time
data_sources	id	Fontes de dados (as tabelas consultáveis por trás dos bancos de dados do Notion), incluindo título, propriedades de esquema e pai.	Incremental	last_edited_time
databases	id, data_source_id	Bancos de dados descobertos por meio de cada fonte de dados compartilhada, incluindo título, sinalizador inline e pai.	Apenas refresh completo
blocks	id	Blocos de conteúdo dentro de páginas e fontes de dados, percorridos recursivamente até 30 níveis de profundidade.	Apenas refresh completo
page_comments	id	Comentários em nível de página em páginas compartilhadas.	Apenas refresh completo
block_comments	id	Comentários em nível de bloco (em linha) anexados a blocos individuais.	Apenas refresh completo
users	id	Usuários e bots no workspace.	Apenas refresh completo

Tabela de origem	Chave primária	Descrição	Modo de sincronização	Campo do cursor
pages	id	Páginas no workspace compartilhadas com a integração, incluindo pai, propriedades e metadados de edição.	Incremental	last_edited_time
data_sources	id	Fontes de dados (as tabelas consultáveis por trás dos bancos de dados do Notion), incluindo título, propriedades de esquema e pai.	Incremental	last_edited_time
databases	id, data_source_id	Bancos de dados descobertos por meio de cada fonte de dados compartilhada, incluindo título, sinalizador inline e pai.	Apenas refresh completo
blocks	id	Blocos de conteúdo dentro de páginas e fontes de dados, percorridos recursivamente até 30 níveis de profundidade.	Apenas refresh completo
page_comments	id	Comentários em nível de página em páginas compartilhadas.	Apenas refresh completo
block_comments	id	Comentários em nível de bloco (em linha) anexados a blocos individuais.	Apenas refresh completo
users	id	Usuários e bots no workspace.	Apenas refresh completo

nota

As tabelas pages e data_sources são sincronizadas incrementalmente em last_edited_time. As tabelas databases, blocks, page_comments, block_comments e users são verificadas novamente na íntegra a cada sincronização, pois seus Endpoint do Notion não expõem ordenação por tempo de alteração. Upserts na chave primária mantêm os resultados idempotentes. Consulte limitações do conector Notion.

Opções de conector

O conector do Notion não possui opções de configuração adicionais além das configurações de pipeline disponíveis para todos os conectores gerenciados. Consulte Ingerir dados do Notion.

Esquemas de tabela de destino

O conector ingere objetos Notion aninhados, como parent, properties, icon e cover, como valores STRING codificados em JSON. Consulte as limitações do conector Notion.

pages

Chave primária: id Campo do cursor: last_edited_time

campo	Tipo de dados
id	STRING
object	STRING
parent	STRING
properties	STRING
url	STRING
public_url	STRING
created_by	STRING
last_edited_by	STRING
created_time	TIMESTAMP
last_edited_time	TIMESTAMP
in_trash	BOOLEAN
is_locked	BOOLEAN
icon	STRING
cover	STRING

campo	Tipo de dados
id	STRING
object	STRING
parent	STRING
properties	STRING
url	STRING
public_url	STRING
created_by	STRING
last_edited_by	STRING
created_time	TIMESTAMP
last_edited_time	TIMESTAMP
in_trash	BOOLEAN
is_locked	BOOLEAN
icon	STRING
cover	STRING

data_sources

Chave primária: id Campo do cursor: last_edited_time

campo	Tipo de dados
id	STRING
object	STRING
title	STRING
description	STRING
parent	STRING
database_parent	STRING
properties	STRING
url	STRING
public_url	STRING
is_inline	BOOLEAN
created_by	STRING
last_edited_by	STRING
created_time	TIMESTAMP
last_edited_time	TIMESTAMP
in_trash	BOOLEAN

campo	Tipo de dados
id	STRING
object	STRING
title	STRING
description	STRING
parent	STRING
database_parent	STRING
properties	STRING
url	STRING
public_url	STRING
is_inline	BOOLEAN
created_by	STRING
last_edited_by	STRING
created_time	TIMESTAMP
last_edited_time	TIMESTAMP
in_trash	BOOLEAN

databases

Chave primária: id, data_source_id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
data_source_id	STRING
object	STRING
title	STRING
description	STRING
is_inline	BOOLEAN
parent	STRING
data_sources	STRING
created_time	TIMESTAMP
last_edited_time	TIMESTAMP
in_trash	BOOLEAN
is_locked	BOOLEAN
icon	STRING
cover	STRING
url	STRING
public_url	STRING

campo	Tipo de dados
id	STRING
data_source_id	STRING
object	STRING
title	STRING
description	STRING
is_inline	BOOLEAN
parent	STRING
data_sources	STRING
created_time	TIMESTAMP
last_edited_time	TIMESTAMP
in_trash	BOOLEAN
is_locked	BOOLEAN
icon	STRING
cover	STRING
url	STRING
public_url	STRING

blocks

Chave primária: id Modo de sincronização: Apenas refresh completo

O campo content contém o payload específico do tipo do bloco (por exemplo, o objeto paragraph, heading_1 ou to_do, incluindo seu rich text) como um STRING codificado em JSON. Use o campo type para determinar como analisar content.

campo	Tipo de dados
id	STRING
object	STRING
type	STRING
content	STRING
parent	STRING
has_children	BOOLEAN
created_by	STRING
last_edited_by	STRING
created_time	TIMESTAMP
last_edited_time	TIMESTAMP
in_trash	BOOLEAN

campo	Tipo de dados
id	STRING
object	STRING
type	STRING
content	STRING
parent	STRING
has_children	BOOLEAN
created_by	STRING
last_edited_by	STRING
created_time	TIMESTAMP
last_edited_time	TIMESTAMP
in_trash	BOOLEAN

page_comments

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
object	STRING
parent	STRING
discussion_id	STRING
rich_text	STRING
created_time	TIMESTAMP
last_edited_time	TIMESTAMP
created_by	STRING

campo	Tipo de dados
id	STRING
object	STRING
parent	STRING
discussion_id	STRING
rich_text	STRING
created_time	TIMESTAMP
last_edited_time	TIMESTAMP
created_by	STRING

block_comments

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
object	STRING
parent	STRING
discussion_id	STRING
rich_text	STRING
created_time	TIMESTAMP
last_edited_time	TIMESTAMP
created_by	STRING

campo	Tipo de dados
id	STRING
object	STRING
parent	STRING
discussion_id	STRING
rich_text	STRING
created_time	TIMESTAMP
last_edited_time	TIMESTAMP
created_by	STRING

users

Chave primária: id Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
id	STRING
object	STRING
type	STRING
name	STRING
avatar_url	STRING
person	STRING
bot	STRING

campo	Tipo de dados
id	STRING
object	STRING
type	STRING
name	STRING
avatar_url	STRING
person	STRING
bot	STRING