개요
백업, 보고, 또는 마이그레이션을 위해 워크스페이스 데이터를 CSV로 내보내세요. 사용 사례:- 정기 백업 — 데이터 사본을 보관하세요
- 외부 보고 — Excel, Google Sheets 또는 BI 도구에서 데이터를 분석하세요
- 마이그레이션 — 데이터를 다른 시스템으로 이동하세요
- 대량 업데이트 — 내보내고, 편집한 후, 다시 가져와 레코드를 업데이트하세요
알아두어야 할 사항
내보내기 제한
- 내보내기 1회당 최대 20,000개 레코드
- 표시된 열만 내보내집니다
- 필터링된 레코드만 내보내집니다(현재 보기 기준)
더 큰 내보내기(20,000개 이상의 레코드)에는 필터를 사용해 배치로 내보내거나 API를 사용하세요.
권한
데이터를 내보내려면 “Export CSV” 권한이 필요합니다. 이 옵션이 없다면 워크스페이스 관리자에게 문의하세요.1단계: 객체로 이동
내보내려는 객체로 이동하세요:- People — 연락처
- Companies — 조직
- Opportunities — 거래
- 사용자 지정 객체 — 사용자가 생성한 모든 객체
2단계: 보기 구성
중요: 내보내기에는 현재 보기에서 보이는 내용만 포함됩니다.열 추가/제거
- 옵션 → 필드를 클릭합니다(또는 열 끝의 +).
- 내보내려는 필드를 선택하세요
- 불필요한 필드의 선택을 해제하세요
레코드 필터링(선택 사항)
일부 데이터만 필요하다면:- 필터를 클릭합니다
- 필터 조건을 추가하세요(예: “Created date > January 1, 2024”)
- 조건과 일치하는 레코드만 내보내집니다
레코드 정렬(선택 사항)
- 정렬하려면 열 헤더를 클릭하세요
- 내보내기는 정렬 순서를 따릅니다
내보내기 전용 보기를 만드세요. 내보내기에 맞게 구성한 보기를 저장해 매번 다시 구성할 필요가 없도록 하세요.
3단계: 데이터 내보내기
- 테이블 오른쪽 상단의 ⋮ 아이콘을 클릭하세요
- Export view를 선택하세요
- CSV 파일을 저장할 위치를 선택하세요
- 다운로드가 완료될 때까지 기다리세요
내보내지는 내용
| 포함됨 | 포함되지 않음 |
|---|---|
| 모든 표시된 열 | 숨김 열 |
| 현재 필터와 일치하는 레코드 | 필터로 제외된 레코드 |
| 사용자 지정 필드 값 | 보기에 없는 필드 |
| 레코드 ID | 파일 첨부 |
| 관계 ID | 이미지 |
관계 필드
관계 ID는 관계의 “many” 측에서만 내보내집니다:- People 내보내기에는
companyId열이 포함됩니다(People → Company 관계) - Companies 내보내기에는
peopleIds가 포함되지 않습니다(Companies는 “one” 측입니다)
용도별 내보내기
백업용
- 모든 필드가 보이도록 보기를 만들세요
- 모든 레코드를 포함하려면 모든 필터를 제거하세요
- 각 객체 유형을 별도로 내보내세요
- 내보낸 파일을 안전한 위치에 보관하세요
- 반복 알림을 설정하세요(매주/매월)
외부 보고용
- 분석에 필요한 필드만 포함하세요
- 관련 데이터에 집중할 수 있도록 필터를 적용하세요
- 분석할 필드로 정렬하는 것을 고려하세요
대량 업데이트용
- 업데이트하려는 레코드를 내보내세요
- 고유 식별자(
email,domain또는id)를 포함하세요 - 내보낸 파일을 편집하세요
- 다시 가져와 레코드를 업데이트하세요 참고: 기존 레코드를 업데이트하는 방법
마이그레이션용
다른 시스템으로 마이그레이션하기 위해 내보내는 경우:- 각 객체를 개별적으로 내보내세요 — People, Companies, Opportunities 등
- ID 필드를 포함하세요 — 관계를 유지하는 데 도움이 됩니다
- 필드 매핑을 문서화하세요 — Twenty의 필드가 대상 시스템에 어떻게 매핑되는지 기록하세요
대용량 데이터셋 처리(20,000개 이상 레코드)
내보내기 한도는 20,000개 레코드입니다. 더 큰 데이터셋의 경우:옵션 1: 배치로 내보내기
- 필터를 추가하세요(예: “Created date” 범위)
- 첫 번째 배치를 내보내세요
- 필터를 변경하세요
- 다음 배치를 내보내세요
- 스프레드시트에서 파일을 결합하세요
- 날짜 범위별(1월, 2월, 3월…)
- 소유자별(팀원 A, 팀원 B…)
- 상태별(활성, 비활성…)
옵션 2: API 사용
API에는 레코드 수 한도가 없습니다:- API 키를 설정 → 개발자에서 발급받으세요
- GraphQL API를 사용해 레코드를 쿼리하세요
- 애플리케이션에서 결과를 처리하세요
팁 및 모범 사례
내보내기용 보기 만들기
내보내기에 맞게 구성한 보기를 저장하세요:- 열과 필터를 구성하세요
- 보기 옵션 → 새 보기로 저장을 클릭하세요
- “Export - [Purpose]“로 이름을 지정하세요
내보낸 파일 보호
내보낸 파일에는 민감한 데이터가 포함될 수 있습니다:- 안전한 위치에 보관하세요
- 더 이상 필요하지 않은 내보낸 파일은 삭제하세요
- 내보낸 파일을 공유할 때 주의하세요
내보내기 전 확인 사항
올바른 열이 표시되어 있습니다
필터가 올바르게 설정되어 있습니다(전체 내보내기의 경우 제거)
내보내기 권한이 있습니다
FAQ
내보낸 파일에 일부 열이 없는 이유는 무엇인가요?
내보낸 파일에 일부 열이 없는 이유는 무엇인가요?
표시된 열만 내보내집니다. 내보내기 전에 옵션 → 필드에서 필요한 열을 추가하세요.
내보낸 파일에 모든 레코드가 포함되지 않은 이유는 무엇인가요?
내보낸 파일에 모든 레코드가 포함되지 않은 이유는 무엇인가요?
필터를 확인하세요. 내보내기에는 현재 보기의 필터와 일치하는 레코드만 포함됩니다. 모든 레코드를 내보내려면 필터를 제거하세요.
20,000개 이상의 레코드를 내보낼 수 있나요?
20,000개 이상의 레코드를 내보낼 수 있나요?
단일 내보내기로는 불가능합니다. 필터를 사용해 배치로 내보내거나, 더 큰 데이터셋에는 API를 사용하세요.
내보낸 파일의 형식은 무엇인가요?
내보낸 파일의 형식은 무엇인가요?
CSV(쉼표로 구분된 값). Excel, Google Sheets 또는 어떤 스프레드시트 애플리케이션에서도 열 수 있습니다.
관계 ID가 포함되나요?
관계 ID가 포함되나요?
예. 다만 관계의 “many” 측에서만 포함됩니다. 예를 들어 People 내보내기에는
companyId가 포함되지만, Companies 내보내기에는 people ID가 포함되지 않습니다.내보내기를 자동화할 수 있나요?
내보내기를 자동화할 수 있나요?
UI만으로는 불가능합니다. API를 사용해 자동화된 내보내기 워크플로우를 구축하세요.
다음 단계
- 기존 레코드를 업데이트하는 방법 — 내보낸 파일을 편집한 뒤 다시 가져오세요
- API로 데이터 가져오는 방법 — 대용량 데이터셋용
- API 문서 — 맞춤 내보내기 워크플로우를 구축하세요