---
title: "Экспорт"
description: "Кеңістікті немесе қалтаны Markdown-файлдардың жалғыз ZIP-архиві етіп жүктеп алу — құрылымы мен бірегейлігі сақталады, ешнәрсе жоғалмайды."
---

# Экспорт

Экспорт бүкіл кеңістікті (space) немесе жеке қалтаны Markdown-файлдардың жалғыз ZIP-архиві етіп жүктеп береді. Пайдаланушының файлдары — шындық көзі болғандықтан (file-first принципі), экспорт оларды индекстен қайта құрастырмай, дискіден тікелей оқиды: архивте **нақты файлдардың өзі** жатады, әр файлдың frontmatter-індегі `notarium-id`-мен қоса.

Экспорттың **қайтымды** болатыны да сондықтан: оны [импорт](/docs/import-export/import/) арқылы кері қайтаруға немесе құрылымын, бірегейлігі мен күндерін жоғалтпай басқа данаға көшіруге болады. Мәні бойынша экспорт — «деректерді сыртқа шығару» емес, дискіде сіздің файлдарыңыз болып әрдайым жатқан нәрсені ыңғайлы қаптамаға салу.

## Қалай экспорттау керек

Экспорт кеңістік параметрлеріндегі **Export** қойындысында тұрады:

- Түйме тапсырманы кезекке қояды, содан соң пайызы көрсетілген прогресс-жолақ (жазба саны белгілі болғанда) және **Cancel** түймесі шығады.
- Дайын болған соң архив өздігінен жүктеледі; қасында **Download .zip** (тағы жүктеп алу) және **Export again** (экспортты қайта жүргізу) түймелері қала береді.
- Қойындыдан кетіп, қайта оралу қауіпсіз: оралғанда жүріп жатқан тапсырманы немесе жүктеп алуға дайын файлды қайтадан көресіз.

**Жеке қалтаны** экспорттау ағаштың контекстік мәзірінен қолжетімді — **Export folder** тармағы. Бұл — қосалқы ағашпен шектелген сол баяғы тапсырма; прогресс бас тарту түймесі бар «жабысқақ» тостта көрінеді.

## Опциялар

Экспорттың екі жолы да параметрлердің бірдей жиынтығын қабылдайды:

| Параметр | Мәндер | Не істейді |
|---|---|---|
| `scope` | `user` (әдепкі) · `all` | `user` — тек өз жазбаларыңыз; `all` — кеңістіктегі бүкіл мазмұн, агент жадының mount-ын қоса (`.notarium/memory`). |
| `frontmatter` | `keep` (әдепкі) · `strip` | `keep` файлды сол күйінде салады; `strip` YAML-блокты қиып тастайды — оқуға арналған таза көшірме. |
| `folder` | жол | Экспортты қосалқы ағашпен шектеу (**Export folder** істейтін нәрсе). |

> [!warning] `frontmatter=strip` кері импортты бұзады
> Frontmatter-ды қию шығынды көшірме береді: YAML-блокпен бірге `notarium-id` мен тегтер де жоғалады. Мұндай архив жазбаларды оқуға беруге ыңғайлы, бірақ оны енді шығынсыз кері импорттай алмайсыз. Көшіру үшін `keep`-ті (әдепкі мән) қалдырыңыз.

> [!important] Экспорт — дананың сақтық көшірмесі емес
> `scope=all` болғанның өзінде экспорт архиві кеңістіктің Markdown-файлдарынан басқа ештеңе алып жүрмейді. Онда метадеректер дерекқоры жоқ: есептік жазбалар да, рұқсаттар да, нұсқалар тарихы да, тапсырмалардың күйі де жоқ. Одан дананы қалпына келтіру мүмкін емес. Сақтық көшірме — образдың кіріктірілген командасымен орындалатын бөлек операция, [Сақтық көшірме және қалпына келтіру](/docs/self-hosting/backup/) бөлімін қараңыз.

## Іші қалай жұмыс істейді

Экспорт ағынды түрде құрылған — білім қоры қаншалықты үлкен болса да, жадта жиналып қалмайды:

- **Әдепкіде — асинхронды тапсырма.** Хостта метадеректер дерекқоры болғанда (өзіндік хостинг үшін бұл — қалыпты жағдай), экспорт тұрақты тапсырма болады: фондық воркер ZIP-ті артефакт қоймасына жинайды да, дайын файлды жүктеуді жалғастыру мүмкіндігімен береді. Жабылған қойынды, үзілген байланыс, серверді қайта іске қосу — бұлардың бірде-бірі экспортты бұзбайды.
- **Жүктеу буферленбейді.** Дайын архивті браузер тікелей дискіге ағызады, файл атауы жауаптың HTTP-тақырыбынан (header) алынады — үлкен білім қоры қойынды жадында жиналып қалмайды.
- **Бас тарту жұмысты тоқтатады.** Бас тартылған жүктеу жазбаларды тартуды доғарады — сервер бүкіл білім қорын босқа оқып отырмайды.

```mermaid
flowchart LR
  notes[(Markdown-жазбалар)] -->|дискіден оқу| worker[Фондық воркер]
  worker -->|ZIP| artifact[Тапсырма артефактісі]
  artifact -->|download| user([Браузер])
```

> [!note] Метадеректер дерекқорынсыз экспорт
> Метадеректер дерекқоры жоқ хостта (ол тек `AUTH_MODE=none` режимінде ғана болмайды) тапсырма қабаты жоқ: экспорт синхронды ағынды жолмен жүреді — сол ZIP бір сұраныстың аясында тікелей жүктеумен беріледі, прогрессіз және жүктеуді жалғастырусыз. Тек жеткізу тәсілі өзгереді, нәтиже сол қалпында.

## Шектеулер

- **Бір мезгілде бір кеңістік.** Кеңістіктер — өз рұқсаттары бар оқшауланған қоймалар; бірнешеуін жүктеп алу үшін әрқайсысын бөлек экспорттаңыз.
- **Артефакт TTL бойынша тіршілік етеді.** Дайын ZIP шектеулі уақыт сақталады (әдепкіде — 7 күн), содан соң қоқыс жинағыш оны жояды; мерзімі өткенше қайта жүктеп алуға болады.
- **Бинарлық тіркемелер экспортталмайды.** Архив жазбалардың мәтінін — Markdown-файлдарды алып жүреді.
- **Бас тарту бар, кідірту жоқ.** Тапсырмадан бас тартуға болады; кідірту мен жалғастыру жоқ.

## Әрі қарай

- [Импорт](/docs/import-export/import/) — архивті кері қайтару немесе білім қорын басқа данаға көшіру.
- [Бөлімге шолу](/docs/import-export/) — file-first импорт пен экспортты неге арзан ететіні туралы.