Notion コネクタリファレンス

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 Notionコネクター のプレビューにオプトインすることで、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。

このページには、サポートされているソーステーブルや宛先テーブルのスキーマなど、管理された Notion コネクタに関するリファレンス情報が記載されています。

サポートされているソーステーブル

Notion コネクターは、すべて default ソーススキーマ配下の以下のデータソーステーブルをサポートしています。

ソーステーブル	プライマリーキー	説明	同期モード	カーソルフィールド
`pages`	`id`	親、プロパティ、編集メタデータなど、統合と共有されているワークスペース内のページ。	インクリメンタル	`last_edited_time`
`data_sources`	`id`	データソース（Notion データベースの背後にあるクエリ可能なテーブル）。タイトル、スキーマプロパティ、親が含まれます。	インクリメンタル	`last_edited_time`
`databases`	`id`, `data_source_id`	タイトル、インラインフラグ、親など、各共有データソースを通じて検出されたデータベース。	完全更新のみ
`blocks`	`id`	ページおよびデータソース内のコンテンツブロック。最大30レベルまで再帰的に走査されます。	完全更新のみ
`page_comments`	`id`	共有ページ上のページレベルのコメント。	完全更新のみ
`block_comments`	`id`	個々のブロックに付加されるブロックレベル（インライン）のコメント。	完全更新のみ
`users`	`id`	ワークスペース内のユーザーとボット。	完全更新のみ

ソーステーブル	プライマリーキー	説明	同期モード	カーソルフィールド
`pages`	`id`	親、プロパティ、編集メタデータなど、統合と共有されているワークスペース内のページ。	インクリメンタル	`last_edited_time`
`data_sources`	`id`	データソース（Notion データベースの背後にあるクエリ可能なテーブル）。タイトル、スキーマプロパティ、親が含まれます。	インクリメンタル	`last_edited_time`
`databases`	`id`, `data_source_id`	タイトル、インラインフラグ、親など、各共有データソースを通じて検出されたデータベース。	完全更新のみ
`blocks`	`id`	ページおよびデータソース内のコンテンツブロック。最大30レベルまで再帰的に走査されます。	完全更新のみ
`page_comments`	`id`	共有ページ上のページレベルのコメント。	完全更新のみ
`block_comments`	`id`	個々のブロックに付加されるブロックレベル（インライン）のコメント。	完全更新のみ
`users`	`id`	ワークスペース内のユーザーとボット。	完全更新のみ

注記

pagesおよびdata_sourcesテーブルは、last_edited_time上で増分同期されます。databases、blocks、page_comments、block_comments、およびusersテーブルは、NotionのEndpointが変更時刻の順序を公開していないため、同期のたびに完全に再スキャンされます。主キーでのアップサートにより、結果はべき等に保たれます。Notionコネクタの制限事項を参照してください。

コネクタオプション

Notion コネクタには、すべてのマネージドコネクタで利用可能なパイプライン設定以外の追加設定オプションはありません。「Notion からのデータの取り込み」を参照してください。

宛先テーブルのスキーマ

このコネクタは、parent、properties、icon、cover などのネストされたNotionオブジェクトを、JSONエンコードされた STRING 値として取り込みます。Notionコネクタの制限事項を参照してください。

`pages`

主キー: id カーソルフィールド: last_edited_time

フィールド	データ型
`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`

フィールド	データ型
`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`

主キー: id カーソルフィールド: last_edited_time

フィールド	データ型
`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`

フィールド	データ型
`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`

プライマリキー: id、data_source_id 同期モード: 完全更新のみ

フィールド	データ型
`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`

フィールド	データ型
`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`

主キー: id 同期モード: 完全更新のみ

content フィールドには、ブロックのタイプ固有のペイロード（例えば、リッチテキストを含む paragraph、heading_1、または to_do オブジェクト）が JSON エンコードされた STRING として保持されます。content の解析方法を決定するには、type フィールドを使用します。

フィールド	データ型
`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`

フィールド	データ型
`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`

主キー: id 同期モード: 完全更新のみ

フィールド	データ型
`id`	`STRING`
`object`	`STRING`
`parent`	`STRING`
`discussion_id`	`STRING`
`rich_text`	`STRING`
`created_time`	`TIMESTAMP`
`last_edited_time`	`TIMESTAMP`
`created_by`	`STRING`

`block_comments`

主キー: id 同期モード: 完全更新のみ

フィールド	データ型
`id`	`STRING`
`object`	`STRING`
`parent`	`STRING`
`discussion_id`	`STRING`
`rich_text`	`STRING`
`created_time`	`TIMESTAMP`
`last_edited_time`	`TIMESTAMP`
`created_by`	`STRING`

`users`

主キー: id 同期モード: 完全更新のみ

フィールド	データ型
`id`	`STRING`
`object`	`STRING`
`type`	`STRING`
`name`	`STRING`
`avatar_url`	`STRING`
`person`	`STRING`
`bot`	`STRING`

サポートされているソーステーブル​

コネクタ オプション​

宛先テーブルのスキーマ​

pages​

data_sources​

databases​

blocks​

page_comments​

block_comments​

users​

サポートされているソーステーブル

コネクタオプション

宛先テーブルのスキーマ

`pages`

`data_sources`

`databases`

`blocks`

`page_comments`

`block_comments`

`users`