다른 도구의 데이터를 Notion으로 동기화

이 참조 문서에 있는 내용

GitHub, Jira, Salesforce와 같은 도구의 데이터를 자동으로 업데이트되는 Notion 데이터베이스로 가져오세요.


데이터베이스 동기화를 사용하면 팀의 계획, 문서, 프로젝트와 함께 다른 도구의 정보를 활용하고 보강할 수 있습니다. 계정을 연결하고 동기화할 항목을 선택하면 Notion이 데이터베이스를 생성하고 최신 상태로 유지합니다.

Notion이 이러한 동기화를 관리하므로 직접 통합을 구축하거나 유지 관리할 필요 없이 계정을 연결하고 동기화된 데이터베이스를 사용할 수 있습니다.

연결

동기화할 수 있는 데이터

생성된 데이터베이스

GitHub

선택한 리포지토리의 풀 리퀘스트

풀 리퀘스트

Jira

선택한 Jira Cloud 스페이스의 스페이스 및 작업 항목

Jira 스페이스 및 Jira 작업 항목

Salesforce

계정, 연락처 및 영업 기회

선택 항목에 따라 계정, 연락처 및/또는 영업 기회

다른 도구의 각 레코드는 Notion 데이터베이스의 페이지가 됩니다. 출처의 필드는 데이터베이스 속성이 됩니다.

관리형 동기화는 연결된 도구에서 Notion으로 단방향 데이터 업데이트를 수행합니다. 동기화된 속성은 Notion에서 읽기 전용입니다. 동기화된 값을 변경하려면 GitHub, Jira 또는 Salesforce에서 업데이트하세요. Notion에서 변경 사항을 확인할 수 있습니다.

동기화는 백그라운드에서 자동으로 실행됩니다. 업데이트 시점은 연결 상태, 데이터 양, 소스 도구의 요청 제한에 따라 다릅니다.

참고: 다른 도구를 연결해야 하나요? 연결하려는 도구가 지원되지 않는 경우 Notion Workers를 사용하여 사용자 지정 동기화를 구축하거나, Asana 및 GitLab에 대한 사전 구축된 Workers 가이드를 따르세요.

Notion 워크스페이스의 멤버여야 하며 동기화하려는 데이터에 사용 권한이 있는 계정이 있어야 합니다. 조직의 정책에 따라 관리자가 연결을 승인하거나 출처 도구에서 사용 권한을 부여해야 할 수도 있습니다.

동기화를 생성하는 데 사용하는 계정에 따라 Notion이 읽을 수 있는 데이터가 결정됩니다. 권한이 변경되거나 연결이 만료되면 동기화를 위해 다시 인증해야 할 수 있습니다.

GitHub 동기화 및 Jira 동기화에는 비즈니스 요금제(또는 모바일 비즈니스 추가 기능)가 필요합니다. Salesforce 동기화에는 엔터프라이즈 요금제가 필요합니다.

  1. Notion 워크스페이스에서 설정 → 연결을 엽니다.

  2. 탐색 또는 설치됨에서 동기화하려는 연결(GitHub, Jira 또는 Salesforce)을 열고 해당 연결 옵션에서 데이터베이스 동기화를 선택하세요.

  3. 계정을 연결하고 해당 도구에 대한 승인 단계를 완료하세요.

  4. 동기화하려는 리포지토리, 공간 또는 개체 유형을 선택하세요.

  5. 포함할 기록의 범위를 선택하세요. Jira 및 Salesforce와 같이 사용자 지정 속성을 제공하는 소스의 경우, 동기화에 포함할 사용자 지정 속성을 선택할 수도 있습니다.

  6. 동기화 생성을 선택하세요.

Notion은 개인 페이지 사이드바 섹션에 데이터베이스를 생성합니다. 첫 번째 가져오기가 백그라운드에서 시작됩니다. 레코드가 가져와지는 동안에도 데이터베이스를 열 수 있습니다.

첫 번째 가져오기

Notion은 데이터베이스 구조를 생성한 다음 설정과 일치하는 레코드를 가져옵니다. Notion은 데이터를 일괄적으로 읽고 소스 도구의 요청 제한을 따르기 때문에 대규모 가져오기는 시간이 더 걸릴 수 있습니다.

첫 번째 가져오기가 진행되는 동안 데이터베이스에 데이터의 일부만 표시될 수 있습니다. 가져오기가 계속되도록 Notion을 열어둘 필요는 없습니다.

진행 중인 업데이트

첫 번째 가져오기 후, Notion은 연결된 도구에서 새 레코드나 변경된 레코드를 정기적으로 확인하고 동기화된 속성을 업데이트합니다. 동기화는 아무도 데이터베이스를 보고 있지 않을 때도 백그라운드에서 계속됩니다.

일반적으로 변경 사항이 Notion에 동기화되는 데 몇 분 이내의 시간이 소요됩니다.

소요 시간은 연결 상태, 데이터 양, 출처 도구의 가용성에 따라 다릅니다. 변경 사항 확인이 곧 모든 변경 사항이 Notion에 즉시 나타난다는 의미는 아닙니다. Salesforce는 기본적으로 1분마다 변경 사항을 확인합니다. 자세한 내용은 각 연결 가이드를 참조하세요.

출처에서 일시적으로 요청을 제한하거나 사용할 수 없게 되면 Notion이 재시도합니다. 동기화에 새로운 승인이나 다른 권한이 필요한 경우, 상태 표시를 통해 수행할 작업을 확인할 수 있습니다.

기록 창

사용 가능한 모든 레코드를 포함하거나 최근 30일, 90일 또는 365일 이내에 업데이트된 레코드로 동기화를 제한할 수 있습니다. 기록 창은 생성 날짜가 아닌 출처 레코드의 마지막 업데이트 시간을 기준으로 합니다. Salesforce는 시스템 수정 시간을 사용합니다.

기록 창은 시간이 지남에 따라 앞으로 이동합니다. 출처 도구에서 여전히 열려 있거나 활성 상태인 레코드라도 해당 창 내에 업데이트되지 않으면 데이터베이스에서 제거될 수 있습니다.

참고: 기록 기간으로 인해 페이지가 삭제될 수 있습니다. 녹음이 기간을 벗어나면 해당 동기화된 페이지는 사용자가 고유 속성에 추가한 값을 포함하여 Notion에서 삭제됩니다. 이전의 변경되지 않은 녹음을 유지해야 하는 경우 사용 가능한 모든 기록을 선택하세요.

창을 확장하면 일치하는 추가 레코드가 가져와집니다. 창을 단축하면 더 이상 조건에 맞지 않는 레코드가 제거됩니다. 이는 보기에서 표시되는 내용만 변경하는 Notion 데이터베이스 필터와는 다릅니다.

뷰를 생성하고, 레코드를 필터링 및 정렬하며, 고유한 Notion 속성을 추가할 수 있습니다. 예를 들어, 풀 리퀘스트에 팀 우선순위를 추가하거나 Salesforce 계정에 계정 계획 상태를 추가할 수 있습니다. 이러한 속성의 값은 Notion에 유지됩니다.

동기화에 의해 관리되는 속성과 충돌하지 않도록 고유한 속성 이름을 지정하세요.

데이터베이스는 개인 페이지로 시작됩니다. 준비가 되면 Notion의 페이지 권한을 사용하여 공유하세요.

참고: Notion 공유는 동기화된 데이터를 볼 수 있는 사람을 제어합니다. Notion 데이터베이스에 사용 권한이 있는 사람은 출처 도구에서 권한이 없는 녹음을 볼 수 있을 수도 있습니다. 출처 권한은 Notion의 각 뷰어에게 복사되지 않습니다. 공유하기 전에 사용 권한을 검토하세요.

출처 도구의 권한 변경으로 인해 Notion에 이미 있는 데이터는 삭제되지 않지만 향후 업데이트가 중단될 수 있습니다. 출처 사용 권한이 변경되면 Notion 데이터베이스의 공유 설정을 검토하세요.

연결의 데이터베이스 동기화 설정으로 돌아가 동기화 상태, 최근 실행 정보 및 오류 세부 정보를 검토하세요.

상태

수행할 작업

초기화 또는 백필 중

동기화가 설정 중이거나 기존 레코드를 가져오는 중입니다. 가져오기가 계속되도록 두세요.

정상

동기화가 정상적으로 실행 중입니다. 최근 출처 변경 사항이 여전히 처리 중일 수 있습니다.

성능 저하 또는 실패

동기화의 오류 세부 정보를 열어 업데이트가 지연되는 원인을 확인하세요.

조치 필요

계정 재연결 또는 출처 사용 권한 복원과 같이 표시된 지침을 따르세요.

비활성화됨

동기화가 일시정지되었습니다. 동기화 설정에서 일시정지를 해제할 수 있습니다.

사용할 수 없음

현재 상태 정보를 사용할 수 없습니다. 나중에 다시 확인하세요.

최근 실행 시간은 활동을 보여줍니다. 모든 출처 변경 사항이 이미 Notion에 도달했음을 보장하지는 않습니다.

지원되는 연결 중 하나에 필요한 데이터와 설정이 포함되어 있는 경우 관리형 동기화를 사용하세요. Notion이 초기 가져오기, 주기적인 확인 및 연결별 동기화 로직을 처리합니다.

다른 서비스에서 가져오거나 Notion에 도달하기 전에 데이터를 변환하는 등 사용자 지정 동기화를 구축해야 할 때는 Notion Worker를 사용하세요.

필요한 사항

관리형 데이터베이스 동기화

Worker

/코드 없이 지원되는 연결 설정

Notion에서 계정, 데이터 및 설정을 선택하세요.

/코드 및 배포가 필요합니다.

데이터 구조 선택

연결에서 지원하는 녹음 및 속성을 사용하세요.

사용자 지정 스키마 및 변환을 정의하세요.

데이터 가져오는 방식을 사용자 지정하세요.

내장 동기화 동작을 사용하세요.

워크플로에 필요한 출처 요청 및 동기화 동작을 구현하세요.

동기화를 유지 관리하세요.

Notion이 내장 연결 로직을 유지 관리합니다.

팀에서 Worker 코드를 유지 관리하고, Notion이 Worker를 실행합니다.

예를 들어, 관리형 GitHub 동기화를 사용하여 Notion에서 풀 리퀘스트를 추적하세요. 사용자 지정 출처, 추가 녹음 유형 또는 가져오기 전에 데이터를 결합하는 계산이 필요한 경우 Worker 사용을 고려하세요.

녹음이 누락됨

선택한 리포지토리, 스페이스 또는 개체 유형, 기록 기간 및 연결된 계정의 출처 권한을 확인하세요. 또한 첫 번째 가져오기가 여전히 실행 중인지, Notion 보기 필터가 녹음을 숨기고 있는지 확인하세요.

관계형(데이터베이스)이 누락됨

동기화된 페이지가 다른 동기화된 페이지와 연결되어야 하는데 그렇지 않은 경우, 기록 기간 때문이거나 관련 페이지가 아직 가져오는 중일 수 있습니다. 두 페이지가 모두 Notion 데이터베이스로 동기화된 경우에만 관계형(데이터베이스)가 생성됩니다.

업데이트가 중단됨

동기화 상태 세부 정보를 엽니다. 인증이 만료된 경우 다시 연결하거나, 출처 관리자에게 권한 복원을 요청하세요. 일시적인 출처 중단 및 요청 제한으로 인해 Notion이 재시도하는 동안 업데이트가 지연될 수 있습니다.

동기화가 행 제한에 도달했습니다

선택한 데이터를 줄이거나 더 짧은 기록 기간을 선택하세요. 저장하기 전에 영향을 검토하세요. 출처를 제거하거나 기록을 단축하면 동기화된 페이지가 삭제될 수 있습니다. 연결별 가이드에서 선택 항목을 변경할 때 발생하는 상황을 설명합니다.

기존 Asana 또는 GitLab 동기화의 경우 Worker 교체 가이드를 사용하세요:


피드백 보내기

이 내용이 도움이 되었나요?


Powered by Fruition