> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 데이터 익스포트

> 데이터 뽑기 — 트레이스, 메모리, 문서, Flow, 감사.

Nora 의 모든 것이 익스포트 가능. 백업, 워크스페이스 간 마이그레이션, 컴플라이언스 (데이터 이동성), 오프라인 분석에 중요.

## 익스포트 가능한 것

| 카테고리                 | 포맷                 | 위치                                                |
| -------------------- | ------------------ | ------------------------------------------------- |
| **Flow 페이로드**        | JSON               | `nora flows get <slug>`                           |
| **Flow 스냅샷 (편집 가능)** | JSON               | `nora flows snapshot <slug>`                      |
| **파이프라인 페이로드**       | JSON               | `nora pipelines get <id>`                         |
| **문서**               | 원본 파일 + 메타데이터 JSON | Data → Documents → Export                         |
| **메모리 노트/노드/엣지**     | JSON               | `nora memory {notes,nodes,edges} list ... --json` |
| **트레이스**             | JSONL              | `nora traces list ... --json`                     |
| **데이터셋**             | JSONL / CSV        | Datasets → 익스포트 버튼                                |
| **감사 트레일**           | JSON / CSV / PDF   | Audit → Export                                    |
| **모든 것 (전체 워크스페이스)** | ZIP                | Settings → Data → Full export                     |

## 전체 워크스페이스 익스포트

**Settings → Data → Full export**:

1. 스코프 선택 (모든 것 또는 특정 카테고리).
2. 옵션으로 날짜 범위 필터 적용.
3. 제출.
4. Nora 가 익스포트 비동기 준비. 준비되면 알림 (보통 분; 큰 워크스페이스는 시간).
5. 서명된 ZIP 다운로드.

ZIP 포함:

* `manifest.json` — 콘텐츠 인덱스, 체크섬, 익스포트 타임스탬프.
* `flows/*.json` — Flow 당 파일 하나.
* `pipelines/*.json` — 파이프라인당 파일 하나.
* `documents/` — 원본 파일 + 메타데이터.
* `memory/*.json` — 메모리 스페이스당 파일 하나.
* `traces/*.jsonl` — 일별 그룹핑.
* `datasets/*.jsonl` — 데이터셋당 하나.
* `audit.jsonl` — 전체 감사 트레일.
* `signature.sig` — `manifest.json` 위 서명.

다운로드 URL 이 보안상 7일 후 만료.

## 프로그래매틱 익스포트

대부분 `--json` CLI 명령이 파싱 가능한 출력 생성:

```bash theme={null}
# 모든 Flow 를 디렉토리로
mkdir -p export/flows
for slug in $(nora flows list --json | jq -r '.[].slug'); do
  nora flows get $slug > export/flows/$slug.json
done

# 날짜 범위 모든 트레이스
nora traces list --from 2026-07-01 --to 2026-07-31 --limit 100000 --json > export/traces-jul.json
```

주기 백업 위해 cron 과 결합.

## 워크스페이스 간 데이터 마이그레이션

흔한 레시피: 스테이징 → 프로드:

```bash theme={null}
# 스테이징에서 스냅샷
nora --workspace staging flows snapshot support > support.json
nora --workspace staging vars list --json > vars.json

# 프로드에 적용
nora --workspace prod flows apply support support.json
# (vars 는 수동으로 재선언 — vars 는 워크스페이스별)

nora --workspace prod flows publish support --note "staging → prod"
```

일부는 직접 마이그레이션 안 됨:

* **커넥터와 provider 키** — 목적지에 재생성해야 (자격증명 자체가 소스 못 떠남).
* **메모리 콘텐츠** — `nora memory ... list --json` 로 익스포트하고 재삽입 가능, 하지만 스코프 키가 다를 수 있음.
* **트레이스** — 이력이 새 워크스페이스의 Flow 에 붙지 않음.

## 개별 사용자 데이터 익스포트 (GDPR)

사용자 데이터 이동성 요청:

**Settings → Data → User exports → New**:

1. 사용자 식별자 (Flow 에 쓰인 이메일이나 스코프 키) 입력.
2. Nora 가 모든 워크스페이스 데이터 순회:
   * 스코프 매치되는 트레이스.
   * 사용자에 스코프된 메모리 항목.
   * 사용자에 귀속된 피드백.
   * 사용자가 결정한 승인.
3. 사용자별 ZIP 생성.

서명되고 타임스탬프됨.

이동성 요청이 감사 로깅됨 (익스포트된 콘텐츠 아닌 요청 자체).

## 포맷과 관례

* **JSONL** — 라인당 JSON 객체 하나. 데이터베이스와 로그 도구로 스트리밍에 이상적.
* **JSON** — 예쁘게 인쇄. 사람과 작은 데이터셋에 이상적.
* **CSV** — 스프레드시트와 QA 워크플로우용.
* **PDF** — 인쇄 가능 아티팩트 원하는 컴플라이언스 리뷰어용.

CLI 가 `--json` 수용하는 곳에 추가하면 스크립팅용 기계 읽기 가능 출력.

## 서명된 익스포트

모든 익스포트 ZIP 이 manifest 위 서명 포함. 워크스페이스의 익스포트 공개 키로 검증:

```bash theme={null}
openssl dgst -sha256 -verify workspace-export-pubkey.pem \
  -signature signature.sig \
  manifest.json
```

익스포트가 전송 중 변조 안 됐음 확인.

## 요율 제한

* 전체 워크스페이스 익스포트: 워크스페이스당 최대 1 동시, 24h 마다 하나.
* 개별 카테고리 익스포트: CLI 로 무제한.
* 개별 사용자 익스포트: 워크스페이스당 최대 10 동시.

Enterprise 플랜 워크스페이스가 이걸 올릴 수 있음.

## 관련

* [보존](/ko/settings/data/retention) — 만료 정책 (나이 들기 전 익스포트).
* [컴플라이언스](/ko/settings/data/compliance) — 규제 익스포트 요구사항.
* [`nora flows`](/ko/cli/flows) — Flow 스냅샷.
* [`nora memory`](/ko/cli/memory) — list 명령으로 메모리 익스포트.