他のツールからNotionにデータを同期する
GitHub、Jira、SalesforceなどのツールからNotionにデータを取り込み、自動的に更新される同期データベースを作成します。
Notionのデータベース同期機能を使用すると、チームの計画、ドキュメント、プロジェクトと並行して、他のツールの情報を活用し、充実させることができます。アカウントを接続して同期する対象を選択すると、Notionがデータベースを作成し、常に最新の状態に保ちます。
Notionがこれらの同期を管理するため、ユーザー自身でインテグレーションを構築・保守することなく、アカウントを接続して同期データベースを使用できます。
コネクション | 同期可能なデータ | 作成されたデータベース |
|---|---|---|
GitHub | 選択したリポジトリからのプルリクエスト | プルリクエスト |
Jira | 選択したJira Cloudスペースからのスペースおよび作業項目 | JiraスペースおよびJira作業項目 |
Salesforce | アカウント、連絡先、商談 | 選択に応じて、アカウント、連絡先、および/または商談 |
他のツールの各レコードは、Notionデータベースの1つのページになります。ソースのフィールドはデータベースのプロパティになります。
管理された同期は、接続されたツールからNotionへという一方向でデータを更新します。同期されたプロパティはNotionでは読み取り専用です。同期された値を変更するには、GitHub、Jira、またはSalesforceで更新してください。Notionに変更が反映されます。
同期はバックグラウンドで自動的に実行されます。更新のタイミングは、接続、データ量、およびソースツールのリクエスト制限によって異なります。
備考: 別のツールを接続する必要がありますか?接続したいツールがサポートされていない場合は、Notion Workersを使用してカスタム同期を構築するか、AsanaおよびGitLab向けの構築済みWorkersガイドに従ってください。
Notionワークスペースのメンバーであり、同期したいデータにアクセスできるアカウントを持っている必要があります。組織によっては、接続の承認やソースツールでのアクセスの付与に管理者の許可が必要な場合があります。
同期の作成に使用するアカウントによって、Notionが読み取れるデータが決まります。そのアカウントの権限が変更されたり、接続が期限切れになったりした場合は、再認証が必要になることがあります。
GitHub同期とJira同期にはビジネスプラン(またはモバイルビジネスアドオン)が必要です。Salesforce同期にはエンタープライズプランが必要です。
Notionワークスペースで 設定 → 接続 を開きます。
Browse または Installed から同期したい接続(GitHub、Jira、または Salesforce)を開き、その接続のオプションから Database sync を選択します。
アカウントを接続し、そのツールの認証手順を完了します。
同期するリポジトリ、スペース、またはオブジェクトタイプを選択します。
含める履歴の範囲を選択します。Jira や Salesforce など、カスタムプロパティを提供するソースについては、同期に含めるカスタムプロパティを選択することもできます。
Create sync を選択します。
Notion は プライベート サイドバーセクションにデータベースを作成します。最初のインポートはバックグラウンドで開始されます。レコードのインポート中であっても、データベースを開くことができます。
最初のインポート
Notion はデータベース構造を作成し、設定に一致するレコードをインポートします。Notion はデータをバッチで読み取り、ソースツールのリクエスト制限に従うため、大規模なインポートには時間がかかる場合があります。
最初のインポートの実行中は、データの一部のみが表示される場合があります。インポートを継続するために Notion を開いたままにしておく必要はありません。
継続的な更新
最初のインポート後、Notion は接続ツールを定期的にチェックして、新規または変更されたレコードを確認し、同期されたプロパティを更新します。同期は、誰もデータベースを表示していないときでもバックグラウンドで継続されます。
通常、変更は数分以内に Notion に同期されます。
タイミングは、接続、データ量、およびソースツールの可用性によって異なります。変更のチェックが行われても、すべての変更がすぐに Notion に反映されるとは限りません。Salesforce はデフォルトで毎分変更をチェックします。詳細については、各接続のガイドを参照してください。
ソースが一時的にリクエストを制限したり、利用できなくなったりした場合、Notion は再試行します。同期に新しい認証や異なる権限が必要な場合は、ステータスにその対処方法が表示されます。
履歴ウィンドウ
すべての利用可能な履歴を含めるか、過去 30 日、90 日、または 365 日以内に更新されたレコードに同期を制限することができます。履歴ウィンドウは、レコードの作成日ではなく、ソースレコードの最終更新時刻を使用します。Salesforce はシステム変更時刻を使用します。
ウィンドウは時間の経過とともに前方に移動します。レコードがそのウィンドウ内で更新されていない場合、ソースツールでまだ開いているかアクティブであっても、データベースから削除される可能性があります。
備考: 履歴ウィンドウによってページが削除される可能性があります。レコードがウィンドウの範囲外になると、その同期済みページはNotionから削除されます。これには、そのページにユーザー自身がプロパティとして追加した値も含まれます。古いレコードや変更されていないレコードを保持する必要がある場合は、利用可能なすべての履歴を選択してください。
ウィンドウを拡大すると、一致する追加のレコードがインポートされます。短縮すると、条件を満たさなくなったレコードが削除されます。これは、ビューの表示内容のみを変更する Notion データベースのフィルターとは異なります。
ビューの作成、レコードのフィルタリングや並べ替え、独自のNotionプロパティの追加が可能です。例えば、プルリクエストにチームの優先度を追加したり、Salesforceアカウントにアカウントプランニングのステータスを追加したりできます。これらのプロパティの値はNotion内に保持されます。
同期によって管理されるプロパティと競合しないよう、独自のプロパティには固有の名前を付けてください。
データベースは最初はプライベートなページとして作成されます。準備ができたら、Notionのページ権限を使用して共有してください。
備考: Notionの共有設定によって、同期されたデータを誰が閲覧できるかが制御されます。Notionデータベースへのアクセスを持つユーザーは、ソースツールではアクセスできないレコードを閲覧できる場合があります。ソースの権限は、Notionの各ビューアーにコピーされるわけではありません。共有する前にアクセスをレビューしてください。
ソースツールでの権限の変更により、Notionにすでにあるデータは削除されませんが、今後の更新が停止する可能性があります。ソースへのアクセス権が変更された場合は、Notionデータベースの共有設定を確認してください。
接続のDatabase sync設定に戻り、同期ステータス、最近の実行情報、およびエラーの詳細を確認してください。
ステータス | 対処方法 |
|---|---|
初期化中またはバックフィル中 | 同期が設定中、または既存のレコードをインポート中です。インポートを続行できるようにしてください。 |
正常 | 同期は正常に実行されています。最近のソースの変更はまだ処理中の場合があります。 |
低下または失敗 | 同期のエラー詳細を開いて、更新が遅延している原因を確認してください。 |
要アクション | アカウントの再接続やソースアクセスの復元など、表示された指示に従ってください。 |
無効 | 同期は一時停止されています。同期の設定で一時停止を解除できます。 |
利用不可 | ステータス情報は現在利用できません。後でもう一度確認してください。 |
最近の実行時間はアクティビティを示しています。すべてのソースの変更がすでにNotionに反映されていることを保証するものではありません。
サポートされている接続のいずれかに必要なデータと設定が含まれている場合は、管理された同期を使用してください。Notionが初期インポート、定期的なチェック、および接続固有の同期ロジックを処理します。
別のサービスからのインポートや、Notionにデータが到達する前の変換など、カスタム同期を構築する必要がある場合は、Notion Workerを使用してください。
必要なもの | 管理されたデータベース同期 | ワーカー |
|---|---|---|
コードなしでサポートされている接続を設定します。 | Notionでアカウント、データ、設定を選択します。 | コードとデプロイが必要です。 |
データ構造を選択します | 接続でサポートされているレコードとプロパティを使用します。 | カスタムスキーマと変換を定義します。 |
データの取得方法をカスタマイズします | 組み込みの同期動作を使用します。 | ワークフローに必要なソースリクエストと同期動作を実装します。 |
同期の維持 | Notionが組み込みの接続ロジックを維持します。 | チームがWorkerコードを維持し、NotionがそのWorkerを実行します。 |
例えば、管理されたGitHub同期を使用して、Notionでプルリクエストを追跡します。カスタムソース、追加のレコードタイプ、またはインポート前にデータを結合する計算が必要な場合は、Workerの使用を検討してください。
レコードが見つからない
選択したリポジトリ、スペース、オブジェクトタイプ、履歴ウィンドウ、および接続されたアカウントのソース権限を確認してください。また、最初のインポートがまだ実行中であるか、Notionのビューフィルターによってレコードが非表示になっていないかも確認してください。
リレーションが見つからない
同期されたページが別の同期されたページに関連付けられるはずなのにそうなっていない場合は、履歴ウィンドウが原因であるか、関連ページがまだインポート中である可能性があります。リレーションは、両方のページがNotionデータベースに同期された場合にのみ作成されます。
更新が停止した
同期のステータス詳細を開きます。認証の有効期限が切れている場合は再接続するか、ソースの管理者にアクセス権の復元を依頼してください。ソースの一時的な停止やリクエスト制限により、Notionが再試行している間、更新が遅れることがあります。
同期が行制限に達しました
選択したデータを減らすか、より短い履歴ウィンドウを選択してください。保存する前に影響を確認してください。ソースを削除したり履歴を短くしたりすると、同期されたページが削除される可能性があります。接続固有のガイドで、選択内容を変更した場合の動作について説明しています。
既存のAsanaまたはGitLabの同期については、Workerの置き換えガイドを使用してください:
