# Batch와 대량

다른 입력을 가진 독립적인 쿼리를 위한 Batch를 선택하십시오. Bulk를 선택하여 모든 작업이 동일한 작업을 필요로하는 비디오 IDs의 파일을 선택하십시오.

Canonical 참고: https://flashdata.dev/ko/docs/reference/batch-and-bulk
검토: 2026-11-05 FlashData

<a id="choose"></a>

## 당신이해야 할 작업에 의해 선택

선택은 입력의 모양에 따라 달라집니다, 고정 항목의 수. 두 모드 모두 배경에서 실행합니다. 1개의 쿼리를 위해, realtime 또는 async를 직접 사용하십시오.

| 당신의 작업 | 제품 정보 |
| --- | --- |
| 일상의 간결에 대한 몇 가지 주제를 검색 | Batch: 각 쿼리는 자체 검색 조건, 위치 또는 언어가 있습니다. |
| Google 결과와 연구 작업에 YouTube 메타데이터를 결합 | Batch: 혼합 소스 및 각 쿼리에 대한 별도의 결과를 수집합니다. |
| metadata를 새로 고침하거나 비디오 카탈로그에 transcripts를 수집 | Bulk: 한 비디오-ID 파일, 하나의 소스 및 모든 비디오에 대한 같은 옵션. |
| 같은 형식으로 비디오의 목록을 버킷에 전달 | Bulk: youtube_download를 사용하여 공유 미디어 설정 및 목적지 저장. |
| 각 영상을 위한 다른 산출 조정을 사용하십시오 | Batch: Per-query 모수는 다를 수 있습니다; Bulk는 전체 파일에 1 세트를 적용합니다. |

- [Realtime 및 동기화](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#choose)

<a id="batch"></a>

## Batch: 독립적인 쿼리

쿼리를 포함하는 JSON 개체를 전송합니다. 각 품목에는 그것의 자신의 근원, 입력 및 params가 있습니다. Google 검색, YouTube 검색, 혼합 소스, 또는 다른 옵션이 필요한 비디오에 Batch를 사용하십시오.

### Batch 입력 · 두 가지 다른 작업

```json
{
  "queries": [
    {
      "source": "google_search",
      "query": "open source speech recognition",
      "params": {
        "num": 5
      }
    },
    {
      "source": "youtube_metadata",
      "video_id": "dQw4w9WgXcQ",
      "params": {}
    }
  ]
}
```

- [Batch 요청을 실행하고 결과를 수집](https://flashdata.dev/ko/docs/guides/async-batch/reference.md#batch)
- [소스에 대한 Batch 요청 구축](https://flashdata.dev/ko/docs/guides/async-batch/reference.md#customize)

<a id="bulk"></a>

## Bulk: 파일에 1개의 가동

UTF-8 파일을 하나의 YouTube 비디오 ID로 업로드하십시오. 지원된 소스를 선택 하 고 전체 파일에 대 한 옵션의 한 세트. Bulk는 파일을 검사하고, 계정 용량 및 패키지 결과 내의 작업을 다운로드 가능한 부품으로 제출합니다.

1. metadata, transcript, captions, license 분류 또는 다운로드를 선택하십시오. Bulk 비디오 IDs; 키워드 검색에 Batch를 사용합니다.
2. 소스 또는 옵션 변경시 별도의 작업을 사용합니다. 예를 들어, 같은 파일에 대한 메타 데이터 및 성적표는 Bulk 작업입니다.
3. 다운로드를 위해, youtube_download 권한을 가진 목적지 저장 및 소유자 접근을 제공합니다. 결과 행은 매체를 설명합니다; 매체 파일은 당신의 물통에서 저장됩니다.

### video-ids.txt

```text
dQw4w9WgXcQ
jNQXAC9IVRw
```

- [Bulk API 운동장 열기](https://flashdata.dev/ko/docs/reference/bulk-processing/reference.md#playground)
- [Bulk 엔드포인트 및 요청 필드](https://flashdata.dev/ko/docs/reference/bulk-processing/reference.md#endpoints)
- [CLI로 비디오 데이터셋을 준비하고 감사하십시오.](https://flashdata.dev/ko/docs/guides/bulk/reference.md)

<a id="batch-results"></a>

## 결과를 수집하는 방법 계획

| 책임 | Batch | Bulk |
| --- | --- | --- |
| 제출 후 저장 | 모든 queries[].id는 원본 입력에 연결했습니다. Batch 작업은 없습니다. ID. | 1 Bulk 작업 ID 및 변하지 않은 입력 파일. |
| 트랙 완료 | 각 일은 자주적으로 끝납니다; 1개의 실패는 전체적인 배치를 설명하지 않습니다. | 한 작업 노출 진행 수. 완료된 결과 패키지, 하지 그 모든 비디오 성공. |
| 수집 산출 | 각 완료된 작업의 결과를 Fetch하고 입력-to-ID 매핑을 유지합니다. | 나타날과 모든 압축 NDJSON 부분을 잡아라. 인덱스 및 video_id에 의해 가입, 줄 순서. |
| 중단 후에 Resume | 새 제출을 고려하기 전에 저장된 작업 IDs를 읽으십시오. | 저장된 Bulk ID를 검사하십시오. pauseReason를 해결하고 일시 중지하는 경우 작업을 재개합니다. |

- [Batch 결과 수집](https://flashdata.dev/ko/docs/guides/async-batch/reference.md#batch-results)
- [Bulk와 부품](https://flashdata.dev/ko/docs/reference/bulk-processing/reference.md#downloadBulkJobManifest)
- [expiry의 앞에 결과를 저장하십시오](https://flashdata.dev/ko/docs/guides/save-results/reference.md)

<a id="limits"></a>

## 시작하기 전에 수용량과 비용을 검사하십시오

| 확인 | 계정 정보 |
| --- | --- |
| Batch | 플랜의 maxBatchSize는 제출 당 쿼리를 제한합니다. 더 큰 세트를 더 작은 그룹으로 분할하고 pending-job 수용량을 존중하십시오. |
| Bulk | 최대 2 GiB 당 ID 파일. 작업은 공유 계정 용량 내에서 점차 제출됩니다. 업로드하기 전에 중복 제거하십시오. |
| 크레딧 | Grouping는 1개의 편평한 책임이 없습니다. 쿼리 사용 per-source 가격; 다운로드는 전달된 데이터 크기에 의해 미터. |
| 오시는 길 | 열쇠는 각 요구한 근원을 허용해야 합니다. 활성 계정의 제한을 확인; 체험은 전체 용량 계정이 아닙니다. |

- [계정 제한](https://flashdata.dev/ko/docs/guides/usage-and-limits/reference.md)
- [크레딧 및 가격](https://flashdata.dev/ko/docs/guides/credits-and-billing/reference.md)
